mag3110.hpp

/*
 * Author: Norbert Wesp <nwesp@phytec.de>
 * Copyright (c) 2017 Phytec Messtechnik GmbH.
 *
 * based on: RIOT-driver mag3110 by Johann Fischer <j.fischer@phytec.de>
 *
 * 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 <mraa/i2c.hpp>
#include <stdint.h>
#include <stdbool.h>

#define MAG3110_NAME "MAG3110"
#define MAG3110_I2C_ADDRESS   0x0E
#define MAG3110_DEVICE_ID     0xC4
#define MAG3110_DEVICE_ID_REG 0x07

/* MAG3110 Register Map */
#define MAG3110_DR_STATUS            0x00 
#define MAG3110_OUT_X_MSB            0x01 
#define MAG3110_OUT_X_LSB            0x02 
#define MAG3110_OUT_Y_MSB            0x03 
#define MAG3110_OUT_Y_LSB            0x04 
#define MAG3110_OUT_Z_MSB            0x05 
#define MAG3110_OUT_Z_LSB            0x06 
#define MAG3110_SYSMOD               0x08 
#define MAG3110_OFF_X_MSB            0x09 
#define MAG3110_OFF_X_LSB            0x0A 
#define MAG3110_OFF_Y_MSB            0x0B 
#define MAG3110_OFF_Y_LSB            0x0C 
#define MAG3110_OFF_Z_MSB            0x0D 
#define MAG3110_OFF_Z_LSB            0x0E 
#define MAG3110_DIE_TEMP             0x0F 
#define MAG3110_CTRL_REG1            0x10 
#define MAG3110_CTRL_REG2            0x11 
/* MAG3110 DR-STATUS Register */
#define MAG3110_DR_STATUS_ZYXOW           (1 << 7)
#define MAG3110_DR_STATUS_ZOW             (1 << 6)
#define MAG3110_DR_STATUS_YOW             (1 << 5)
#define MAG3110_DR_STATUS_XOW             (1 << 4)
#define MAG3110_DR_STATUS_ZYXDR           (1 << 3)
#define MAG3110_DR_STATUS_ZDR             (1 << 2)
#define MAG3110_DR_STATUS_YDR             (1 << 1)
#define MAG3110_DR_STATUS_XDR             (1 << 0)

/* MAG3110 SYSMOD Register */
#define MAG3110_SYSMOD_STANDBY            0
#define MAG3110_SYSMOD_ACTIVE_RAW         1
#define MAG3110_SYSMOD_ACTIVE             2

/* MAG3110 Control Register 1 */
#define MAG3110_CTRL_REG1_DROS_SHIFT      3
#define MAG3110_CTRL_REG1_DROS_MASK       0xF8
#define MAG3110_CTRL_REG1_DROS(x)         (((uint8_t)(((uint8_t)(x))<<\
                                          MAG3110_CTRL_REG1_DROS_SHIFT))\
                                          &MAG3110_CTRL_REG1_DROS_MASK)
#define MAG3110_CTRL_REG1_FR              (1 << 2)
#define MAG3110_CTRL_REG1_TM              (1 << 1)
#define MAG3110_CTRL_REG1_AC              (1 << 0)

/* MAG3110 Control Register 2 */
#define MAG3110_CTRL_REG2_AUTO_MRST_EN    (1 << 7)
#define MAG3110_CTRL_REG2_RAW             (1 << 5)
#define MAG3110_CTRL_REG2_MAG_RST         (1 << 4)

/* MAG3110 Output Rate (DR) and Over Sample (OS) Ratio for CTRL_REG1 */
#define MAG3110_DROS_8000_16     0 /* DR 80   Hz, OS Ratio 16 */
#define MAG3110_DROS_4000_32     1 /* DR 40   Hz, OS Ratio 32 */
#define MAG3110_DROS_2000_64     2 /* DR 20   Hz, OS Ratio 64 */
#define MAG3110_DROS_1000_128    3 /* DR 10   Hz, OS Ratio 128 */
#define MAG3110_DROS_4000_16     4 /* DR 40   Hz, OS Ratio 16 */
#define MAG3110_DROS_2000_32     5 /* DR 20   Hz, OS Ratio 32 */
#define MAG3110_DROS_1000_64     6 /* DR 10   Hz, OS Ratio 64 */
#define MAG3110_DROS_0500_128    7 /* DR 5    Hz, OS Ratio 128 */
#define MAG3110_DROS_2000_16     8 /* DR 20   Hz, OS Ratio 16 */
#define MAG3110_DROS_1000_32     9 /* DR 10   Hz, OS Ratio 32 */
#define MAG3110_DROS_0500_64    10 /* DR 5    Hz, OS Ratio 64 */
#define MAG3110_DROS_0250_128   11 /* DR 2.5  Hz, OS Ratio 128 */
#define MAG3110_DROS_1000_16    12 /* DR 10   Hz, OS Ratio 16 */
#define MAG3110_DROS_0500_32    13 /* DR 5    Hz, OS Ratio 32 */
#define MAG3110_DROS_0250_64    14 /* DR 2.5  Hz, OS Ratio 64 */
#define MAG3110_DROS_0125_128   15 /* DR 1.25 Hz, OS Ratio 128 */
#define MAG3110_DROS_0500_16    16 /* DR 5    Hz, OS Ratio 16 */
#define MAG3110_DROS_0250_32    17 /* DR 2.5  Hz, OS Ratio 32 */
#define MAG3110_DROS_0125_64    18 /* DR 1.25 Hz, OS Ratio 64 */
#define MAG3110_DROS_0063_128   19 /* DR 0.63 Hz, OS Ratio 128 */
#define MAG3110_DROS_0250_16    20 /* DR 2.5  Hz, OS Ratio 16 */
#define MAG3110_DROS_0125_32    21 /* DR 1.25 Hz, OS Ratio 32 */
#define MAG3110_DROS_0063_64    22 /* DR 0.63 Hz, OS Ratio 64 */
#define MAG3110_DROS_0031_128   23 /* DR 0.31 Hz, OS Ratio 128 */
#define MAG3110_DROS_0125_16    24 /* DR 1.25 Hz, OS Ratio 16 */
#define MAG3110_DROS_0063_32    25 /* DR 0.63 Hz, OS Ratio 32 */
#define MAG3110_DROS_0031_64    26 /* DR 0.31 Hz, OS Ratio 64 */
#define MAG3110_DROS_0016_128   27 /* DR 0.16 Hz, OS Ratio 128 */
#define MAG3110_DROS_0063_16    28 /* DR 0.63 Hz, OS Ratio 16 */
#define MAG3110_DROS_0031_32    29 /* DR 0.31 Hz, OS Ratio 32 */
#define MAG3110_DROS_0016_64    30 /* DR 0.16 Hz, OS Ratio 64 */
#define MAG3110_DROS_0008_128   31 /* DR 0.08 Hz, OS Ratio 128 */
#define MAG3110_DROS_DEFAULT    MAG3110_DROS_0125_128 
                                /* Default Setting for testing*/

namespace upm {

typedef struct {
    int16_t x;
    int16_t y;
    int16_t z;
    uint8_t status;
    int8_t dtemp;
} mag3110_data_t;

class MAG3110 {
    public:
        MAG3110 (int bus, uint8_t dros=MAG3110_DROS_DEFAULT,
                             int devAddr=MAG3110_I2C_ADDRESS);

        int checkID(void);

        int setUserOffset(int16_t x, int16_t y, int16_t z);

        int setActive(void);

        int setStandby(void);

        int isReady(void);

        int sampleData(void);

        int16_t getX(int bSampleData = 0);

        int16_t getY(int bSampleData = 0);

        int16_t getZ(int bSampleData = 0);

        uint8_t getStatus(void);

        int8_t getDieTemperature(void);

        int getData(mag3110_data_t* data, int bSampleData = 0);

    private:

        std::string m_name;

        int m_controlAddr;
        int m_bus;
        mraa::I2c m_i2ControlCtx;

        mag3110_data_t s_data[1];
};

}