LibrePilot/flight/PiOS/inc/pios_hmc5883.h

/**
 ******************************************************************************
 * @addtogroup PIOS PIOS Core hardware abstraction layer
 * @{
 * @addtogroup PIOS_HMC5883 HMC5883 Functions
 * @brief Deals with the hardware interface to the magnetometers
 * @{
 *
 * @file       pios_hmc5883.h
 * @author     The OpenPilot Team, http://www.openpilot.org Copyright (C) 2012.
 * @brief      HMC5883 functions header.
 * @see        The GNU Public License (GPL) Version 3
 *
 *****************************************************************************/
/* 
 * This program is free software; you can redistribute it and/or modify 
 * it under the terms of the GNU General Public License as published by 
 * the Free Software Foundation; either version 3 of the License, or 
 * (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful, but 
 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 
 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 
 * for more details.
 * 
 * You should have received a copy of the GNU General Public License along 
 * with this program; if not, write to the Free Software Foundation, Inc., 
 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 */

#ifndef PIOS_HMC5883_H
#define PIOS_HMC5883_H

/* HMC5883 Addresses */
#define PIOS_HMC5883_I2C_ADDR			0x1E
#define PIOS_HMC5883_I2C_READ_ADDR      0x3D
#define PIOS_HMC5883_I2C_WRITE_ADDR     0x3C
#define PIOS_HMC5883_CONFIG_REG_A		(uint8_t)0x00
#define PIOS_HMC5883_CONFIG_REG_B		(uint8_t)0x01
#define PIOS_HMC5883_MODE_REG			(uint8_t)0x02
#define PIOS_HMC5883_DATAOUT_XMSB_REG		0x03
#define PIOS_HMC5883_DATAOUT_XLSB_REG		0x04
#define PIOS_HMC5883_DATAOUT_ZMSB_REG		0x05
#define PIOS_HMC5883_DATAOUT_ZLSB_REG		0x06
#define PIOS_HMC5883_DATAOUT_YMSB_REG		0x07
#define PIOS_HMC5883_DATAOUT_YLSB_REG		0x08
#define PIOS_HMC5883_DATAOUT_STATUS_REG		0x09
#define PIOS_HMC5883_DATAOUT_IDA_REG		0x0A
#define PIOS_HMC5883_DATAOUT_IDB_REG		0x0B
#define PIOS_HMC5883_DATAOUT_IDC_REG		0x0C

/* Output Data Rate */
#define PIOS_HMC5883_ODR_0_75		0x00
#define PIOS_HMC5883_ODR_1_5		0x04
#define PIOS_HMC5883_ODR_3			0x08
#define PIOS_HMC5883_ODR_7_5		0x0C
#define PIOS_HMC5883_ODR_15			0x10
#define PIOS_HMC5883_ODR_30			0x14
#define PIOS_HMC5883_ODR_75			0x18

/* Measure configuration */
#define PIOS_HMC5883_MEASCONF_NORMAL		0x00
#define PIOS_HMC5883_MEASCONF_BIAS_POS		0x01
#define PIOS_HMC5883_MEASCONF_BIAS_NEG		0x02

/* Gain settings */
#define PIOS_HMC5883_GAIN_0_88			0x00
#define PIOS_HMC5883_GAIN_1_3			0x20
#define PIOS_HMC5883_GAIN_1_9			0x40
#define PIOS_HMC5883_GAIN_2_5			0x60
#define PIOS_HMC5883_GAIN_4_0			0x80
#define PIOS_HMC5883_GAIN_4_7			0xA0
#define PIOS_HMC5883_GAIN_5_6			0xC0
#define PIOS_HMC5883_GAIN_8_1			0xE0

/* Modes */
#define PIOS_HMC5883_MODE_CONTINUOUS	0x00
#define PIOS_HMC5883_MODE_SINGLE		0x01
#define PIOS_HMC5883_MODE_IDLE			0x02
#define PIOS_HMC5883_MODE_SLEEP			0x03

/* Sensitivity Conversion Values */
#define PIOS_HMC5883_Sensitivity_0_88Ga		1370	// LSB/Ga
#define PIOS_HMC5883_Sensitivity_1_3Ga		1090	// LSB/Ga
#define PIOS_HMC5883_Sensitivity_1_9Ga		820	// LSB/Ga
#define PIOS_HMC5883_Sensitivity_2_5Ga		660	// LSB/Ga
#define PIOS_HMC5883_Sensitivity_4_0Ga		440	// LSB/Ga
#define PIOS_HMC5883_Sensitivity_4_7Ga		390	// LSB/Ga
#define PIOS_HMC5883_Sensitivity_5_6Ga		330	// LSB/Ga
#define PIOS_HMC5883_Sensitivity_8_1Ga		230	// LSB/Ga  --> NOT RECOMMENDED


struct pios_hmc5883_cfg {
#ifdef PIOS_HMC5883_HAS_GPIOS
	const struct pios_exti_cfg * exti_cfg; /* Pointer to the EXTI configuration */
#endif
	uint8_t M_ODR;		/* OUTPUT DATA RATE --> here below the relative define (See datasheet page 11 for more details) */
	uint8_t Meas_Conf;	/* Measurement Configuration,: Normal, positive bias, or negative bias --> here below the relative define */
	uint8_t Gain;		/* Gain Configuration, select the full scale --> here below the relative define (See datasheet page 11 for more details) */
	uint8_t Mode;
	
};

/* Public Functions */
extern void PIOS_HMC5883_Init(const struct pios_hmc5883_cfg * cfg);
extern bool PIOS_HMC5883_NewDataAvailable(void);
extern int32_t PIOS_HMC5883_ReadMag(int16_t out[3]);
extern uint8_t PIOS_HMC5883_ReadID(uint8_t out[4]);
extern int32_t PIOS_HMC5883_Test(void);
extern bool PIOS_HMC5883_IRQHandler();

#endif /* PIOS_HMC5883_H */

/** 
  * @}
  * @}
  */