1765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang/* 2765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Author: Brendan Le Foll <brendan.le.foll@intel.com> 3765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Contributions: Mihai Tudor Panu <mihai.tudor.panu@intel.com> 4765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Copyright (c) 2014 Intel Corporation. 5765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 6765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Permission is hereby granted, free of charge, to any person obtaining 7765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * a copy of this software and associated documentation files (the 8765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * "Software"), to deal in the Software without restriction, including 9765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * without limitation the rights to use, copy, modify, merge, publish, 10765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * distribute, sublicense, and/or sell copies of the Software, and to 11765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * permit persons to whom the Software is furnished to do so, subject to 12765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * the following conditions: 13765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 14765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * The above copyright notice and this permission notice shall be 15765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * included in all copies or substantial portions of the Software. 16765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 17765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 18765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 19765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 20765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE 21765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 22765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION 23765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 24765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang */ 25765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang#pragma once 26765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 27765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang#include <mraa/i2c.hpp> 28765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 29765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang#define MAX_BUFFER_LENGTH 6 30765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 31765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhangnamespace upm { 32765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 33765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang/** 34765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @brief HMC5883L Magnometer library 35765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @defgroup hmc5883l libupm-hmc5883l 36765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @ingroup seeed i2c compass robok 37765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang */ 38765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 39765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang/** 40765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @library hmc5883l 41765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @sensor hmc5883l 42765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @comname HMC5883L 3-Axis Digital Compass 43765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @altname Grove 3-Axis Digital Compass 44765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @type compass 45765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @man seeed 46765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @con i2c 47765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @kit robok 48765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 49765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @brief API for the HMC5883L 3-Axis Digital Compass 50765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 51765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Honeywell [HMC5883L] 52765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * (http://www.adafruit.com/datasheets/HMC5883L_3-Axis_Digital_Compass_IC.pdf) 53765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * is a 3-axis digital compass. Communication with HMC5883L is simple and 54765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * all done through an I2C interface. Different breakout boards are available. 55765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Typically, a 3V supply is all that is needed to power the sensor. 56765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 57765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @image html hmc5883l.jpeg 58765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @snippet hmc5883l.cxx Interesting 59765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang */ 60765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhangclass Hmc5883l { 61765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhangpublic: 62765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang /** 63765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Creates an Hmc5883l object 64765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 65765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @param bus Number of the used I2C bus 66765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang */ 67765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang Hmc5883l(int bus); 68765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 69765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang /* 70765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Returns the direction 71765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang */ 72765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang float direction(); 73765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 74765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang /* 75765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Returns the heading 76765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang */ 77765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang float heading(); 78765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 79765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang /** 80765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Returns a pointer to an int[3] that contains the coordinates as ints 81765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 82765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @return *int to an int[3] 83765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang */ 84765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang int16_t* coordinates(); 85765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 86765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang /** 87765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Updates the values by reading from I2C 88765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 89765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @return 0 if successful 90765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang */ 91765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang mraa::Result update(); 92765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 93765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang /** 94765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Sets the magnetic declination for better calibration 95765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang */ 96765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang void set_declination(float dec); 97765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 98765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang /** 99765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Gets the current magnetic declination value 100765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 101765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @return Magnetic declination as a floating-point value 102765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang */ 103765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang float get_declination(); 104765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhangprivate: 105765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang int16_t m_coor[3]; 106765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang float m_declination; 107765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang uint8_t m_rx_tx_buf[MAX_BUFFER_LENGTH]; 108765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang mraa::I2c m_i2c; 109765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang}; 110765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 111765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang} 112