LSM303DLHC MEMS interface module header. More...

#include "ex_accelerometer.h"
#include "ex_compass.h"

Data Structures
struct	LSM303DLHCConfig
	LSM303DLHC configuration structure. More...
struct	LSM303DLHCVMT
	`LSM303DLHC` virtual methods table. More...
struct	LSM303DLHCDriver
	LSM303DLHC 6-axis accelerometer/compass class. More...

Macros
#define	lsm303dlhcAccelerometerGetAxesNumber(devp)
	Return the number of axes of the BaseAccelerometer.
#define	lsm303dlhcAccelerometerReadRaw(devp, axes)
	Retrieves raw data from the BaseAccelerometer.
#define	lsm303dlhcAccelerometerReadCooked(devp, axes)
	Retrieves cooked data from the BaseAccelerometer.
#define	lsm303dlhcAccelerometerSetBias(devp, bp)
	Set bias values for the BaseAccelerometer.
#define	lsm303dlhcAccelerometerResetBias(devp)
	Reset bias values for the BaseAccelerometer.
#define	lsm303dlhcAccelerometerSetSensitivity(devp, sp)
	Set sensitivity values for the BaseAccelerometer.
#define	lsm303dlhcAccelerometerResetSensitivity(devp)
	Reset sensitivity values for the BaseAccelerometer.
#define	lsm303dlhcAccelerometerSetFullScale(devp, fs)
	Changes the LSM303DLHCDriver accelerometer fullscale value.
#define	lsm303dlhcCompassGetAxesNumber(devp)
	Return the number of axes of the BaseCompass.
#define	lsm303dlhcCompassReadRaw(devp, axes)
	Retrieves raw data from the BaseCompass.
#define	lsm303dlhcCompassReadCooked(devp, axes)
	Retrieves cooked data from the BaseCompass.
#define	lsm303dlhcCompassSetBias(devp, bp)
	Set bias values for the BaseCompass.
#define	lsm303dlhcCompassResetBias(devp)
	Reset bias values for the BaseCompass.
#define	lsm303dlhcCompassSetSensitivity(devp, sp)
	Set sensitivity values for the BaseCompass.
#define	lsm303dlhcCompassResetSensitivity(devp)
	Reset sensitivity values for the BaseCompass.
#define	lsm303dlhcCompassSetFullScale(devp, fs)
	Changes the LSM303DLHCDriver compass fullscale value.
Version identification
#define	EX_LSM303DLHC_VERSION "1.1.2"
	LSM303DLHC driver version string.
#define	EX_LSM303DLHC_MAJOR 1
	LSM303DLHC driver version major number.
#define	EX_LSM303DLHC_MINOR 1
	LSM303DLHC driver version minor number.
#define	EX_LSM303DLHC_PATCH 2
	LSM303DLHC driver version patch number.

#define	LSM303DLHC_ACC_NUMBER_OF_AXES 3U
	LSM303DLHC accelerometer subsystem characteristics.
#define	LSM303DLHC_ACC_2G 2.0f
#define	LSM303DLHC_ACC_4G 4.0f
#define	LSM303DLHC_ACC_8G 8.0f
#define	LSM303DLHC_ACC_16G 16.0f
#define	LSM303DLHC_ACC_SENS_2G 0.0610f
#define	LSM303DLHC_ACC_SENS_4G 0.1221f
#define	LSM303DLHC_ACC_SENS_8G 0.2442f
#define	LSM303DLHC_ACC_SENS_16G 0.4884f
#define	LSM303DLHC_ACC_BIAS 0.0f

#define	LSM303DLHC_COMP_NUMBER_OF_AXES 3U
	LSM303DLHC compass subsystem characteristics.
#define	LSM303DLHC_COMP_1P3GA 1.3f
#define	LSM303DLHC_COMP_1P9GA 1.9f
#define	LSM303DLHC_COMP_2P5GA 2.5f
#define	LSM303DLHC_COMP_4P0GA 4.0f
#define	LSM303DLHC_COMP_4P7GA 4.7f
#define	LSM303DLHC_COMP_5P6GA 5.6f
#define	LSM303DLHC_COMP_8P1GA 8.1f
#define	LSM303DLHC_COMP_SENS_XY_1P3GA 0.000909f
#define	LSM303DLHC_COMP_SENS_XY_1P9GA 0.001169f
#define	LSM303DLHC_COMP_SENS_XY_2P5GA 0.0014925f
#define	LSM303DLHC_COMP_SENS_XY_4P0GA 0.0022222f
#define	LSM303DLHC_COMP_SENS_XY_4P7GA 0.0025000f
#define	LSM303DLHC_COMP_SENS_XY_5P6GA 0.0030303f
#define	LSM303DLHC_COMP_SENS_XY_8P1GA 0.0043478f
#define	LSM303DLHC_COMP_SENS_Z_1P3GA 0.0010204f
#define	LSM303DLHC_COMP_SENS_Z_1P9GA 0.0013071f
#define	LSM303DLHC_COMP_SENS_Z_2P5GA 0.0016666f
#define	LSM303DLHC_COMP_SENS_Z_4P0GA 0.0025000f
#define	LSM303DLHC_COMP_SENS_Z_4P7GA 0.0028169f
#define	LSM303DLHC_COMP_SENS_Z_5P6GA 0.0033898f
#define	LSM303DLHC_COMP_SENS_Z_8P1GA 0.0048780f
#define	LSM303DLHC_COMP_BIAS 0.0f
LSM303DLHC communication interfaces related bit masks
#define	LSM303DLHC_DI_MASK 0xFF
#define	LSM303DLHC_DI(n)
#define	LSM303DLHC_AD_MASK 0x7F
#define	LSM303DLHC_AD(n)
#define	LSM303DLHC_MS (1 << 7)
LSM303DLHC register addresses
#define	LSM303DLHC_AD_ACC_CTRL_REG1 0x20
#define	LSM303DLHC_AD_ACC_CTRL_REG2 0x21
#define	LSM303DLHC_AD_ACC_CTRL_REG3 0x22
#define	LSM303DLHC_AD_ACC_CTRL_REG4 0x23
#define	LSM303DLHC_AD_ACC_CTRL_REG5 0x24
#define	LSM303DLHC_AD_ACC_CTRL_REG6 0x25
#define	LSM303DLHC_AD_ACC_REFERENCE 0x26
#define	LSM303DLHC_AD_ACC_STATUS_REG 0x27
#define	LSM303DLHC_AD_ACC_OUT_X_L 0x28
#define	LSM303DLHC_AD_ACC_OUT_X_H 0x29
#define	LSM303DLHC_AD_ACC_OUT_Y_L 0x2A
#define	LSM303DLHC_AD_ACC_OUT_Y_H 0x2B
#define	LSM303DLHC_AD_ACC_OUT_Z_L 0x2C
#define	LSM303DLHC_AD_ACC_OUT_Z_H 0x2D
#define	LSM303DLHC_AD_ACC_FIFO_CTRL_REG 0x2E
#define	LSM303DLHC_AD_ACC_FIFO_SRC_REG 0x2F
#define	LSM303DLHC_AD_ACC_INT1_CFG 0x30
#define	LSM303DLHC_AD_ACC_INT1_SRC 0x31
#define	LSM303DLHC_AD_ACC_INT1_THS 0x32
#define	LSM303DLHC_AD_ACC_INT1_DURATION 0x33
#define	LSM303DLHC_AD_ACC_INT2_CFG 0x34
#define	LSM303DLHC_AD_ACC_INT2_SRC 0x35
#define	LSM303DLHC_AD_ACC_INT2_THS 0x36
#define	LSM303DLHC_AD_ACC_INT2_DURATION 0x37
#define	LSM303DLHC_AD_ACC_CLICK_CFG 0x38
#define	LSM303DLHC_AD_ACC_CLICK_SRC 0x39
#define	LSM303DLHC_AD_ACC_CLICK_THS 0x3A
#define	LSM303DLHC_AD_ACC_TIME_LIMIT 0x3B
#define	LSM303DLHC_AD_ACC_TIME_LATENCY 0x3C
#define	LSM303DLHC_AD_ACC_TIME_WINDOW 0x3D
#define	LSM303DLHC_AD_COMP_CRA_REG 0x00
#define	LSM303DLHC_AD_COMP_CRB_REG 0x01
#define	LSM303DLHC_AD_COMP_MR_REG 0x02
#define	LSM303DLHC_AD_COMP_OUT_X_H 0x03
#define	LSM303DLHC_AD_COMP_OUT_X_L 0x04
#define	LSM303DLHC_AD_COMP_OUT_Z_H 0x05
#define	LSM303DLHC_AD_COMP_OUT_Z_L 0x06
#define	LSM303DLHC_AD_COMP_OUT_Y_H 0x07
#define	LSM303DLHC_AD_COMP_OUT_Y_L 0x08
#define	LSM303DLHC_AD_COMP_SR_REG 0x09
#define	LSM303DLHC_AD_COMP_IRA_REG 0x0A
#define	LSM303DLHC_AD_COMP_IRB_REG 0x0B
#define	LSM303DLHC_AD_COMP_IRC_REG 0x0C
#define	LSM303DLHC_AD_COMP_TEMP_OUT_H 0x31
#define	LSM303DLHC_AD_COMP_TEMP_OUT_L 0x32
LSM303DLHC_CTRL_REG1_A register bits definitions
#define	LSM303DLHC_CTRL_REG1_A_MASK 0xFF
#define	LSM303DLHC_CTRL_REG1_A_XEN (1 << 0)
#define	LSM303DLHC_CTRL_REG1_A_YEN (1 << 1)
#define	LSM303DLHC_CTRL_REG1_A_ZEN (1 << 2)
#define	LSM303DLHC_CTRL_REG1_A_LPEN (1 << 3)
#define	LSM303DLHC_CTRL_REG1_A_ODR0 (1 << 4)
#define	LSM303DLHC_CTRL_REG1_A_ODR1 (1 << 5)
#define	LSM303DLHC_CTRL_REG1_A_ODR2 (1 << 6)
#define	LSM303DLHC_CTRL_REG1_A_ODR3 (1 << 7)
LSM303DLHC_CTRL_REG2_A register bits definitions
#define	LSM303DLHC_CTRL_REG2_A_MASK 0xFF
#define	LSM303DLHC_CTRL_REG2_A_HPIS1 (1 << 0)
#define	LSM303DLHC_CTRL_REG2_A_HPIS2 (1 << 1)
#define	LSM303DLHC_CTRL_REG2_A_HPCLICK (1 << 2)
#define	LSM303DLHC_CTRL_REG2_A_FDS (1 << 3)
#define	LSM303DLHC_CTRL_REG2_A_HPCF1 (1 << 4)
#define	LSM303DLHC_CTRL_REG2_A_HPCF2 (1 << 5)
#define	LSM303DLHC_CTRL_REG2_A_HPM0 (1 << 6)
#define	LSM303DLHC_CTRL_REG2_A_HPM1 (1 << 7)
LSM303DLHC_CTRL_REG3_A register bits definitions
#define	LSM303DLHC_CTRL_REG3_A_MASK 0xFD
#define	LSM303DLHC_CTRL_REG3_A_I1_OVERRUN (1 << 1)
#define	LSM303DLHC_CTRL_REG3_A_I1_WTM (1 << 2)
#define	LSM303DLHC_CTRL_REG3_A_I1_DRDY2 (1 << 3)
#define	LSM303DLHC_CTRL_REG3_A_I1_DRDY1 (1 << 4)
#define	LSM303DLHC_CTRL_REG3_A_I1_AOI2 (1 << 5)
#define	LSM303DLHC_CTRL_REG3_A_I1_AOI1 (1 << 6)
#define	LSM303DLHC_CTRL_REG3_A_I1_CLICK (1 << 7)
LSM303DLHC_CTRL_REG4_A register bits definitions
#define	LSM303DLHC_CTRL_REG4_A_MASK 0xF9
#define	LSM303DLHC_CTRL_REG4_A_SIM (1 << 0)
#define	LSM303DLHC_CTRL_REG4_A_HR (1 << 3)
#define	LSM303DLHC_CTRL_REG4_A_FS_MASK 0x30
#define	LSM303DLHC_CTRL_REG4_A_FS0 (1 << 4)
#define	LSM303DLHC_CTRL_REG4_A_FS1 (1 << 5)
#define	LSM303DLHC_CTRL_REG4_A_BLE (1 << 6)
#define	LSM303DLHC_CTRL_REG4_A_BDU (1 << 7)
LSM303DLHC_CTRL_REG5_A register bits definitions
#define	LSM303DLHC_CTRL_REG5_A_MASK 0xCF
#define	LSM303DLHC_CTRL_REG5_A_D4D_INT2 (1 << 0)
#define	LSM303DLHC_CTRL_REG5_A_LIR_INT2 (1 << 1)
#define	LSM303DLHC_CTRL_REG5_A_D4D_INT1 (1 << 2)
#define	LSM303DLHC_CTRL_REG5_A_LIR_INT1 (1 << 3)
#define	LSM303DLHC_CTRL_REG5_A_FIFO_EN (1 << 6)
#define	LSM303DLHC_CTRL_REG5_A_BOOT (1 << 7)
LSM303DLHC_CTRL_REG6_A register bits definitions
#define	LSM303DLHC_CTRL_REG6_A_MASK 0xFA
#define	LSM303DLHC_CTRL_REG6_A_H_LACTIVE (1 << 1)
#define	LSM303DLHC_CTRL_REG6_A_P2_ACT (1 << 3)
#define	LSM303DLHC_CTRL_REG6_A_BOOT_I1 (1 << 4)
#define	LSM303DLHC_CTRL_REG6_A_I2_INT2 (1 << 5)
#define	LSM303DLHC_CTRL_REG6_A_I2_INT1 (1 << 6)
#define	LSM303DLHC_CTRL_REG6_A_I2_CLICKEN (1 << 7)
LSM303DLHC_CRA_REG_M register bits definitions
#define	LSM303DLHC_CRA_REG_M_MASK 0x9C
#define	LSM303DLHC_CRA_REG_M_DO0 (1 << 2)
#define	LSM303DLHC_CRA_REG_M_DO1 (1 << 3)
#define	LSM303DLHC_CRA_REG_M_DO2 (1 << 4)
#define	LSM303DLHC_CRA_REG_M_TEMP_EN (1 << 7)
LSM303DLHC_CRB_REG_M register bits definitions
#define	LSM303DLHC_CRB_REG_M_MASK 0xE0
#define	LSM303DLHC_CRB_REG_M_GN_MASK 0xE0
#define	LSM303DLHC_CRB_REG_M_GN0 (1 << 5)
#define	LSM303DLHC_CRB_REG_M_GN1 (1 << 6)
#define	LSM303DLHC_CRB_REG_M_GN2 (1 << 7)
#define	LSM303DLHC_MR_REG_M_MASK 0x03
#define	LSM303DLHC_MR_REG_M_MD0 (1 << 0)
#define	LSM303DLHC_MR_REG_M_MD1 (1 << 1)
Configuration options
#define	LSM303DLHC_USE_SPI FALSE
	LSM303DLHC SPI interface switch.
#define	LSM303DLHC_SHARED_SPI FALSE
	LSM303DLHC shared SPI switch.
#define	LSM303DLHC_USE_I2C TRUE
	LSM303DLHC I2C interface switch.
#define	LSM303DLHC_SHARED_I2C FALSE
	LSM303DLHC shared I2C switch.
#define	LSM303DLHC_USE_ADVANCED FALSE
	LSM303DLHC advanced configurations switch.

Enumerations
LSM303DLHC compass subsystem data structures and types.
enum	lsm303dlhc_comp_fs_t { LSM303DLHC_COMP_FS_1P3GA = 0x20 , LSM303DLHC_COMP_FS_1P9GA = 0x40 , LSM303DLHC_COMP_FS_2P5GA = 0x60 , LSM303DLHC_COMP_FS_4P0GA = 0x80 , LSM303DLHC_COMP_FS_4P7GA = 0xA0 , LSM303DLHC_COMP_FS_5P6GA = 0xC0 , LSM303DLHC_COMP_FS_8P1GA = 0xE0 }
	LSM303DLHC compass subsystem full scale. More...
enum	lsm303dlhc_comp_odr_t { LSM303DLHC_COMP_ODR_0P75HZ = 0x00 , LSM303DLHC_COMP_ODR_1P5HZ = 0x04 , LSM303DLHC_COMP_ODR_3P0HZ = 0x08 , LSM303DLHC_COMP_ODR_7P5HZ = 0x0C , LSM303DLHC_COMP_ODR_15HZ = 0x10 , LSM303DLHC_COMP_ODR_30HZ = 0x14 , LSM303DLHC_COMP_ODR_75HZ = 0x18 , LSM303DLHC_COMP_ODR_220HZ = 0x1C }
	LSM303DLHC compass subsystem output data rate. More...
enum	lsm303dlhc_comp_md_t { LSM303DLHC_COMP_MD_CONT = 0x00 , LSM303DLHC_COMP_MD_BLOCK = 0x01 , LSM303DLHC_COMP_MD_SLEEP = 0x02 }
	LSM303DLHC compass subsystem working mode. More...

Functions
void	lsm303dlhcObjectInit (LSM303DLHCDriver *devp)
	Initializes an instance.
void	lsm303dlhcStart (LSM303DLHCDriver devp, const LSM303DLHCConfig config)
	Configures and activates LSM303DLHC Complex Driver peripheral.
void	lsm303dlhcStop (LSM303DLHCDriver *devp)
	Deactivates the LSM303DLHC Complex Driver peripheral.

LSM303DLHC main system data structures and types.
#define	_lsm303dlhc_methods_alone
	`LSM303DLHC` specific methods.
#define	_lsm303dlhc_methods
	`LSM303DLHC` specific methods with inherited ones.
#define	_lsm303dlhc_data
	`LSM303DLHCDriver` specific data.
enum	lsm303dlhc_state_t { LSM303DLHC_UNINIT = 0 , LSM303DLHC_STOP = 1 , LSM303DLHC_READY = 2 }
	Driver state machine possible states. More...

LSM303DLHC accelerometer subsystem data structures and types.
enum	lsm303dlhc_acc_fs_t { LSM303DLHC_ACC_FS_2G = 0x00 , LSM303DLHC_ACC_FS_4G = 0x10 , LSM303DLHC_ACC_FS_8G = 0x20 , LSM303DLHC_ACC_FS_16G = 0x30 }
	LSM303DLHC accelerometer subsystem full scale. More...
enum	lsm303dlhc_acc_odr_t { LSM303DLHC_ACC_ODR_PD = 0x00 , LSM303DLHC_ACC_ODR_1Hz = 0x10 , LSM303DLHC_ACC_ODR_10Hz = 0x20 , LSM303DLHC_ACC_ODR_25Hz = 0x30 , LSM303DLHC_ACC_ODR_50Hz = 0x40 , LSM303DLHC_ACC_ODR_100Hz = 0x50 , LSM303DLHC_ACC_ODR_200Hz = 0x60 , LSM303DLHC_ACC_ODR_400Hz = 0x70 , LSM303DLHC_ACC_ODR_1620Hz = 0x80 , LSM303DLHC_ACC_ODR_1344Hz = 0x90 }
	LSM303DLHC accelerometer subsystem output data rate. More...
enum	lsm303dlhc_acc_ae_t { LSM303DLHC_ACC_AE_DISABLED = 0x00 , LSM303DLHC_ACC_AE_X = 0x01 , LSM303DLHC_ACC_AE_Y = 0x02 , LSM303DLHC_ACC_AE_XY = 0x03 , LSM303DLHC_ACC_AE_Z = 0x04 , LSM303DLHC_ACC_AE_XZ = 0x05 , LSM303DLHC_ACC_AE_YZ = 0x06 , LSM303DLHC_ACC_AE_XYZ = 0x07 }
	LSM303DLHC accelerometer subsystem axes enabling. More...
enum	lsm303dlhc_acc_lp_t { LSM303DLHC_ACC_LP_DISABLED = 0x00 , LSM303DLHC_ACC_LP_ENABLED = 0x40 }
	LSM303DLHC accelerometer subsystem low power mode. More...
enum	lsm303dlhc_acc_hr_t { LSM303DLHC_ACC_HR_DISABLED = 0x00 , LSM303DLHC_ACC_HR_ENABLED = 0x08 }
	LSM303DLHC accelerometer subsystem high resolution mode. More...
enum	lsm303dlhc_acc_bdu_t { LSM303DLHC_ACC_BDU_CONT = 0x00 , LSM303DLHC_ACC_BDU_BLOCK = 0x80 }
	LSM303DLHC accelerometer subsystem block data update. More...
enum	lsm303dlhc_acc_end_t { LSM303DLHC_ACC_END_LITTLE = 0x00 , LSM303DLHC_ACC_END_BIG = 0x40 }
	LSM303DLHC accelerometer endianness. More...
typedef struct LSM303DLHCDriver	LSM303DLHCDriver
	Structure representing a LSM303DLHC driver.

Detailed Description

LSM303DLHC MEMS interface module header.

Definition in file lsm303dlhc.h.

Data Structures

Macros

Enumerations

Functions

LSM303DLHC main system data structures and types.

LSM303DLHC accelerometer subsystem data structures and types.

Detailed Description