bmm150.hpp

/*
 * Author: Jon Trulson <jtrulson@ics.com>
 * Copyright (c) 2016-2017 Intel Corporation.
 *
 * The MIT License
 *
 * Permission is hereby granted, free of charge, to any person obtaining
 * a copy of this software and associated documentation files (the
 * "Software"), to deal in the Software without restriction, including
 * without limitation the rights to use, copy, modify, merge, publish,
 * distribute, sublicense, and/or sell copies of the Software, and to
 * permit persons to whom the Software is furnished to do so, subject to
 * the following conditions:
 *
 * The above copyright notice and this permission notice shall be
 * included in all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
 * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */
#pragma once

#include <string>
#include <vector>

#include <mraa/gpio.hpp>
#include "bmm150.h"

namespace upm {

    class BMM150 {
    public:
        BMM150(int bus=BMM150_DEFAULT_I2C_BUS,
               int addr=BMM150_DEFAULT_ADDR,
               int cs=-1);

        ~BMM150();

        void update();

        uint8_t getChipID();

        void getMagnetometer(float *x, float *y, float *z);

        std::vector<float> getMagnetometer();

        void init(BMM150_USAGE_PRESETS_T usage=BMM150_USAGE_HIGH_ACCURACY);

        void setPresetMode(BMM150_USAGE_PRESETS_T usage);

        void reset();

        void setOutputDataRate(BMM150_DATA_RATE_T odr);

        void setPowerBit(bool power);

        void setOpmode(BMM150_OPERATION_MODE_T opmode);

        BMM150_OPERATION_MODE_T getOpmode();

        uint8_t getInterruptEnable();

        void setInterruptEnable(uint8_t bits);

        uint8_t getInterruptConfig();

        void setInterruptConfig(uint8_t bits);

        uint8_t getInterruptStatus();

        void setRepetitionsXY(uint8_t reps);

        void setRepetitionsZ(uint8_t reps);

        void installISR(BMM150_INTERRUPT_PINS_T intr, int gpio,
                        mraa::Edge level,
                        void (*isr)(void *), void *arg);

        void uninstallISR(BMM150_INTERRUPT_PINS_T intr);

        uint8_t readReg(uint8_t reg);

        int readRegs(uint8_t reg, uint8_t *buffer, int len);

        void writeReg(uint8_t reg, uint8_t val);

    protected:
        bmm150_context m_bmm150;

    private:
        /* Disable implicit copy and assignment operators */
        BMM150(const BMM150&) = delete;
        BMM150 &operator=(const BMM150&) = delete;

    };
}