drivers: Added MPU-9150 9-Axis motion sensor driver

dev/timer
Fabian Nack 8 years ago
parent b2fb894c90
commit ae4616c5d8

@ -37,3 +37,6 @@ endif
ifneq (,$(filter mag3110,$(USEMODULE)))
USEMODULE_INCLUDES += $(RIOTBASE)/drivers/mag3110/include
endif
ifneq (,$(filter mpu9150,$(USEMODULE)))
USEMODULE_INCLUDES += $(RIOTBASE)/drivers/mpu9150/include
endif

@ -0,0 +1,340 @@
/*
* Copyright (C) 2015 Freie Universität Berlin
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @defgroup drivers_mpu9150 MPU-9150
* @ingroup drivers
* @brief Device driver interface for the MPU-9150
* @{
*
* @file
* @brief Device driver interface for the MPU-9150
*
* @author Fabian Nack <nack@inf.fu-berlin.de>
*/
#ifndef MPU9150_H_
#define MPU9150_H_
#include "periph/i2c.h"
#ifdef __cplusplus
extern "C" {
#endif
/**
* @name Sample rate macro definitions
* @{
*/
#define MPU9150_MIN_SAMPLE_RATE (4)
#define MPU9150_MAX_SAMPLE_RATE (1000)
#define MPU9150_DEFAULT_SAMPLE_RATE (50)
#define MPU9150_MIN_COMP_SMPL_RATE (1)
#define MPU9150_MAX_COMP_SMPL_RATE (100)
/** @} */
/**
* @name Power Management 1 register macros
* @{
*/
#define MPU9150_PWR_WAKEUP (0x00)
#define MPU9150_PWR_PLL (0x01)
#define MPU9150_PWR_RESET (0x80)
/** @} */
/**
* @name Power Management 2 register macros
* @{
*/
#define MPU9150_PWR_GYRO (0x07)
#define MPU9150_PWR_ACCEL (0x38)
/** @} */
/**
* @name Sleep times in microseconds
* @{
*/
#define MPU9150_COMP_MODE_SLEEP_US (1000)
#define MPU9150_BYPASS_SLEEP_US (3000)
#define MPU9150_PWR_CHANGE_SLEEP_US (50000)
#define MPU9150_RESET_SLEEP_US (100000)
/** @} */
/**
* @name MPU-9150 compass operating modes and reg values
* @{
*/
#define MPU9150_COMP_POWER_DOWN (0x00)
#define MPU9150_COMP_SINGLE_MEASURE (0x01)
#define MPU9150_COMP_SELF_TEST (0x08)
#define MPU9150_COMP_FUSE_ROM (0x0F)
#define MPU9150_COMP_WHOAMI_ANSWER (0x48)
/** @} */
/**
* @brief Power enum values
*/
typedef enum {
MPU9150_SENSOR_PWR_OFF = 0x00,
MPU9150_SENSOR_PWR_ON = 0x01,
} mpu9150_pwr_t;
/**
* @brief Possible MPU-9150 hardware addresses (wiring specific)
*/
typedef enum {
MPU9150_HW_ADDR_HEX_68 = 0x68,
MPU9150_HW_ADDR_HEX_69 = 0x69,
} mpu9150_hw_addr_t;
/**
* @brief Possible compass addresses (wiring specific)
*/
typedef enum {
MPU9150_COMP_ADDR_HEX_0C = 0x0C,
MPU9150_COMP_ADDR_HEX_0D = 0x0D,
MPU9150_COMP_ADDR_HEX_0E = 0x0E,
MPU9150_COMP_ADDR_HEX_0F = 0x0F,
} mpu9150_comp_addr_t;
/**
* @brief Possible full scale ranges for the gyroscope
*/
typedef enum {
MPU9150_GYRO_FSR_250DPS = 0x00,
MPU9150_GYRO_FSR_500DPS = 0x01,
MPU9150_GYRO_FSR_1000DPS = 0x02,
MPU9150_GYRO_FSR_2000DPS = 0x03,
} mpu9150_gyro_ranges_t;
/**
* @brief Possible full scale ranges for the accelerometer
*/
typedef enum {
MPU9150_ACCEL_FSR_2G = 0x00,
MPU9150_ACCEL_FSR_4G = 0x01,
MPU9150_ACCEL_FSR_8G = 0x02,
MPU9150_ACCEL_FSR_16G = 0x03,
} mpu9150_accel_ranges_t;
/**
* @brief Possible low pass filter values
*/
typedef enum {
MPU9150_FILTER_188HZ = 0x01,
MPU9150_FILTER_98HZ = 0x02,
MPU9150_FILTER_42HZ = 0x03,
MPU9150_FILTER_20HZ = 0x04,
MPU9150_FILTER_10HZ = 0x05,
MPU9150_FILTER_5HZ = 0x06,
} mpu9150_lpf_t;
/**
* @brief MPU-9150 result vector struct
*/
typedef struct {
int16_t x_axis; /**< X-Axis measurement result */
int16_t y_axis; /**< Y-Axis measurement result */
int16_t z_axis; /**< Z-Axis measurement result */
} mpu9150_results_t;
/**
* @brief Configuration struct for the MPU-9150 sensor
*/
typedef struct {
mpu9150_pwr_t accel_pwr; /**< Accel power status (on/off) */
mpu9150_pwr_t gyro_pwr; /**< Gyro power status (on/off) */
mpu9150_pwr_t compass_pwr; /**< Compass power status (on/off) */
mpu9150_gyro_ranges_t gyro_fsr; /**< Configured gyro full-scale range */
mpu9150_accel_ranges_t accel_fsr; /**< Configured accel full-scale range */
uint16_t sample_rate; /**< Configured sample rate for accel and gyro */
uint8_t compass_sample_rate; /**< Configured compass sample rate */
uint8_t compass_x_adj; /**< Compass X-Axis sensitivity adjustment value */
uint8_t compass_y_adj; /**< Compass Y-Axis sensitivity adjustment value */
uint8_t compass_z_adj; /**< Compass Z-Axis sensitivity adjustment value */
} mpu9150_status_t;
/**
* @brief Device descriptor for the MPU-9150 sensor
*/
typedef struct {
i2c_t i2c_dev; /**< I2C device which is used */
uint8_t hw_addr; /**< Hardware address of the MPU-9150 */
uint8_t comp_addr; /**< Address of the MPU-9150s compass */
mpu9150_status_t conf; /**< Device configuration */
} mpu9150_t;
/**
* @brief Initialize the given MPU9150 device
*
* @param[out] dev Initialized device descriptor of MPU9150 device
* @param[in] i2c I2C bus the sensor is connected to
* @param[in] hw_addr The device's address on the I2C bus
* @param[in] comp_addr The compass address on the I2C bus
*
* @return 0 on success
* @return -1 if given I2C is not enabled in board config
*/
int mpu9150_init(mpu9150_t *dev, i2c_t i2c, mpu9150_hw_addr_t hw_addr,
mpu9150_comp_addr_t comp_addr);
/**
* @brief Enable or disable accelerometer power
*
* @param[in] dev Device descriptor of MPU9150 device
* @param[in] pwr_conf Target power setting: PWR_ON or PWR_OFF
*
* @return 0 on success
* @return -1 if given I2C is not enabled in board config
*/
int mpu9150_set_accel_power(mpu9150_t *dev, mpu9150_pwr_t pwr_conf);
/**
* @brief Enable or disable gyroscope power
*
* @param[in] dev Device descriptor of MPU9150 device
* @param[in] pwr_conf Target power setting: PWR_ON or PWR_OFF
*
* @return 0 on success
* @return -1 if given I2C is not enabled in board config
*/
int mpu9150_set_gyro_power(mpu9150_t *dev, mpu9150_pwr_t pwr_conf);
/**
* @brief Enable or disable compass power
*
* @param[in] dev Device descriptor of MPU9150 device
* @param[in] pwr_conf Target power setting: PWR_ON or PWR_OFF
*
* @return 0 on success
* @return -1 if given I2C is not enabled in board config
*/
int mpu9150_set_compass_power(mpu9150_t *dev, mpu9150_pwr_t pwr_conf);
/**
* @brief Read angular speed values from the given MPU9150 device, returned in dps
*
* The raw gyroscope data is read from the sensor and normalized with respect to
* the configured gyroscope full-scale range.
*
* @param[in] dev Device descriptor of MPU9150 device to read from
* @param[out] output Result vector in dps per axis
*
* @return 0 on success
* @return -1 if device's I2C is not enabled in board config
* @return -2 if gyro full-scale range is configured wrong
*/
int mpu9150_read_gyro(mpu9150_t *dev, mpu9150_results_t *output);
/**
* @brief Read acceleration values from the given MPU9150 device, returned in mG
*
* The raw acceleration data is read from the sensor and normalized with respect to
* the configured accelerometer full-scale range.
*
* @param[in] dev Device descriptor of MPU9150 device to read from
* @param[out] output Result vector in mG per axis
*
* @return 0 on success
* @return -1 if device's I2C is not enabled in board config
* @return -2 if accel full-scale range is configured wrong
*/
int mpu9150_read_accel(mpu9150_t *dev, mpu9150_results_t *output);
/**
* @brief Read magnetic field values from the given MPU9150 device, returned in mikroT
*
* The raw compass data is read from the sensor and normalized with respect to
* the compass full-scale range (which can not be configured).
*
* @param[in] dev Device descriptor of MPU9150 device to read from
* @param[out] output Result vector in mikroT per axis
*
* @return 0 on success
* @return -1 if device's I2C is not enabled in board config
*/
int mpu9150_read_compass(mpu9150_t *dev, mpu9150_results_t *output);
/**
* @brief Read temperature value from the given MPU9150 device, returned in m°C
*
* @note
* The measured temperature is slightly higher than the real room temperature.
* Tests showed that the offset varied around 2-3 °C (but no warranties here).
*
* @param[in] dev Device descriptor of MPU9150 device to read from
* @param[out] output Temperature in m°C
*
* @return 0 on success
* @return -1 if device's I2C is not enabled in board config
*/
int mpu9150_read_temperature(mpu9150_t *dev, int32_t *output);
/**
* @brief Set the full-scale range for raw gyroscope data
*
* @param[in] dev Device descriptor of MPU9150 device
* @param[in] fsr Target full-scale range
*
* @return 0 on success
* @return -1 if device's I2C is not enabled in board config
* @return -2 if given full-scale target value is not valid
*/
int mpu9150_set_gyro_fsr(mpu9150_t *dev, mpu9150_gyro_ranges_t fsr);
/**
* @brief Set the full-scale range for raw accelerometer data
*
* @param[in] dev Device descriptor of MPU9150 device
* @param[in] fsr Target full-scale range
*
* @return 0 on success
* @return -1 if device's I2C is not enabled in board config
* @return -2 if given full-scale target value is not valid
*/
int mpu9150_set_accel_fsr(mpu9150_t *dev, mpu9150_accel_ranges_t fsr);
/**
* @brief Set the rate at which the gyroscope and accelerometer data is sampled
*
* Sample rate can be chosen between 4 Hz and 1kHz. The actual set value might
* slightly differ. If necessary, check the actual set value in the device's
* config member afterwards.
*
* @param[in] dev Device descriptor of MPU9150 device
* @param[in] rate Target sample rate in Hz
*
* @return 0 on success
* @return -1 if device's I2C is not enabled in board config
* @return -2 if given target sample rate is not valid
*/
int mpu9150_set_sample_rate(mpu9150_t *dev, uint16_t rate);
/**
* @brief Set the rate at which the compass data is sampled
*
* Sample rate can be chosen between 1 Hz and 100 Hz but has to be a fraction
* of the configured accel/gyro sample rate. The actual set value might
* slightly differ. If necessary, check the actual set value in the device's
* config member afterwards.
*
* @param[in] dev Device descriptor of MPU9150 device
* @param[in] rate Target sample rate in Hz
*
* @return 0 on success
* @return -1 if device's I2C is not enabled in board config
* @return -2 if given target sample rate is not valid
*/
int mpu9150_set_compass_sample_rate(mpu9150_t *dev, uint8_t rate);
#ifdef __cplusplus
}
#endif
#endif /* MPU9150_H_ */
/** @} */

@ -0,0 +1,3 @@
MODULE = mpu9150
include $(RIOTBASE)/Makefile.base

@ -0,0 +1,103 @@
/*
* Copyright (C) 2015 Freie Universität Berlin
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup drivers_mpu9150
* @{
*
* @file
* @brief Register and bit definitions for the MPU-9150 9-Axis Motion Sensor
*
* @author Fabian Nack <nack@inf.fu-berlin.de>
*/
#ifndef MPU9150_REGS_H_
#define MPU9150_REGS_H_
#ifdef __cplusplus
extern "C" {
#endif
/**
* @name MPU-9150 register definitions
* @{
*/
#define MPU9150_YG_OFFS_TC_REG (0x01)
#define MPU9150_RATE_DIV_REG (0x19)
#define MPU9150_LPF_REG (0x1A)
#define MPU9150_GYRO_CFG_REG (0x1B)
#define MPU9150_ACCEL_CFG_REG (0x1C)
#define MPU9150_FIFO_EN_REG (0x23)
#define MPU9150_I2C_MST_REG (0x24)
#define MPU9150_SLAVE0_ADDR_REG (0x25)
#define MPU9150_SLAVE0_REG_REG (0x26)
#define MPU9150_SLAVE0_CTRL_REG (0x27)
#define MPU9150_SLAVE1_ADDR_REG (0x28)
#define MPU9150_SLAVE1_REG_REG (0x29)
#define MPU9150_SLAVE1_CTRL_REG (0x2A)
#define MPU9150_SLAVE4_CTRL_REG (0x34)
#define MPU9150_INT_PIN_CFG_REG (0x37)
#define MPU9150_INT_ENABLE_REG (0x38)
#define MPU9150_DMP_INT_STATUS (0x39)
#define MPU9150_INT_STATUS (0x3A)
#define MPU9150_ACCEL_START_REG (0x3B)
#define MPU9150_TEMP_START_REG (0x41)
#define MPU9150_GYRO_START_REG (0x43)
#define MPU9150_EXT_SENS_DATA_START_REG (0x49)
#define MPU9150_COMPASS_DATA_START_REG (0x4A)
#define MPU9150_SLAVE0_DATA_OUT_REG (0x63)
#define MPU9150_SLAVE1_DATA_OUT_REG (0x64)
#define MPU9150_SLAVE2_DATA_OUT_REG (0x65)
#define MPU9150_SLAVE3_DATA_OUT_REG (0x66)
#define MPU9150_I2C_DELAY_CTRL_REG (0x67)
#define MPU9150_USER_CTRL_REG (0x6A)
#define MPU9150_PWR_MGMT_1_REG (0x6B)
#define MPU9150_PWR_MGMT_2_REG (0x6C)
#define MPU9150_FIFO_COUNT_START_REG (0x72)
#define MPU9150_FIFO_RW_REG (0x74)
#define MPU9150_WHO_AM_I_REG (0x75)
/** @} */
/**
* @name Compass register definitions
* @{
*/
#define COMPASS_WHOAMI_REG (0x00)
#define COMPASS_ST1_REG (0x02)
#define COMPASS_DATA_START_REG (0x03)
#define COMPASS_ST2_REG (0x09)
#define COMPASS_CNTL_REG (0x0A)
#define COMPASS_ASTC_REG (0x0C)
#define COMPASS_ASAX_REG (0x10)
#define COMPASS_ASAY_REG (0x11)
#define COMPASS_ASAZ_REG (0x12)
/** @} */
/**
* @name MPU9150 bitfield definitions
* @{
*/
#define BIT_SLV0_DELAY_EN (0x01)
#define BIT_SLV1_DELAY_EN (0x02)
#define BIT_I2C_BYPASS_EN (0x02)
#define BIT_I2C_MST_EN (0x20)
#define BIT_PWR_MGMT1_SLEEP (0x40)
#define BIT_WAIT_FOR_ES (0x40)
#define BIT_I2C_MST_VDDIO (0x80)
#define BIT_SLAVE_RW (0x80)
#define BIT_SLAVE_EN (0x80)
#define BIT_DMP_EN (0x80)
/** @} */
#ifdef __cplusplus
}
#endif
#endif /* MPU9150_REGS_H_ */
/** @} */

@ -0,0 +1,619 @@
/*
* Copyright (C) 2015 Freie Universität Berlin
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup drivers_mpu9150
* @{
*
* @file
* @brief Device driver implementation for the MPU-9150 9-Axis Motion Sensor
*
* @author Fabian Nack <nack@inf.fu-berlin.de>
*
* @}
*/
#include "mpu9150.h"
#include "mpu9150-regs.h"
#include "periph/i2c.h"
#include "hwtimer.h"
#define ENABLE_DEBUG (0)
#include "debug.h"
#define REG_RESET (0x00)
#define MAX_VALUE (0x7FFF)
/* Default config settings */
static const mpu9150_status_t DEFAULT_STATUS = {
.accel_pwr = MPU9150_SENSOR_PWR_ON,
.gyro_pwr = MPU9150_SENSOR_PWR_ON,
.compass_pwr = MPU9150_SENSOR_PWR_ON,
.gyro_fsr = MPU9150_GYRO_FSR_250DPS,
.accel_fsr = MPU9150_ACCEL_FSR_16G,
.sample_rate = 0,
.compass_sample_rate = 0,
.compass_x_adj = 0,
.compass_y_adj = 0,
.compass_z_adj = 0,
};
/* Internal function prototypes */
static int compass_init(mpu9150_t *dev);
static void conf_bypass(mpu9150_t *dev, uint8_t bypass_enable);
static void conf_lpf(mpu9150_t *dev, uint16_t rate);
/*---------------------------------------------------------------------------*
* MPU9150 Core API *
*---------------------------------------------------------------------------*/
int mpu9150_init(mpu9150_t *dev, i2c_t i2c, mpu9150_hw_addr_t hw_addr,
mpu9150_comp_addr_t comp_addr)
{
char temp;
dev->i2c_dev = i2c;
dev->hw_addr = hw_addr;
dev->comp_addr = comp_addr;
dev->conf = DEFAULT_STATUS;
/* Initialize I2C interface */
if (i2c_init_master(dev->i2c_dev, I2C_SPEED_FAST)) {
DEBUG("[Error] I2C device not enabled\n");
return -1;
}
/* Acquire exclusive access */
i2c_acquire(dev->i2c_dev);
/* Reset MPU9150 registers and afterwards wake up the chip */
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_PWR_MGMT_1_REG, MPU9150_PWR_RESET);
hwtimer_wait(HWTIMER_TICKS(MPU9150_RESET_SLEEP_US));
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_PWR_MGMT_1_REG, MPU9150_PWR_WAKEUP);
/* Release the bus, it is acquired again inside each function */
i2c_release(dev->i2c_dev);
/* Set default full scale ranges and sample rate */
mpu9150_set_gyro_fsr(dev, MPU9150_GYRO_FSR_2000DPS);
mpu9150_set_accel_fsr(dev, MPU9150_ACCEL_FSR_2G);
mpu9150_set_sample_rate(dev, MPU9150_DEFAULT_SAMPLE_RATE);
/* Disable interrupt generation */
i2c_acquire(dev->i2c_dev);
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_INT_ENABLE_REG, REG_RESET);
/* Initialize magnetometer */
if (compass_init(dev)) {
return -2;
}
/* Release the bus, it is acquired again inside each function */
i2c_release(dev->i2c_dev);
mpu9150_set_compass_sample_rate(dev, 10);
/* Enable all sensors */
i2c_acquire(dev->i2c_dev);
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_PWR_MGMT_1_REG, MPU9150_PWR_PLL);
i2c_read_reg(dev->i2c_dev, dev->hw_addr, MPU9150_PWR_MGMT_2_REG, &temp);
temp &= ~(MPU9150_PWR_ACCEL | MPU9150_PWR_GYRO);
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_PWR_MGMT_2_REG, temp);
i2c_release(dev->i2c_dev);
hwtimer_wait(HWTIMER_TICKS(MPU9150_PWR_CHANGE_SLEEP_US));
return 0;
}
int mpu9150_set_accel_power(mpu9150_t *dev, mpu9150_pwr_t pwr_conf)
{
char pwr_1_setting, pwr_2_setting;
if (dev->conf.accel_pwr == pwr_conf) {
return 0;
}
/* Acquire exclusive access */
if (i2c_acquire(dev->i2c_dev)) {
return -1;
}
/* Read current power management 2 configuration */
i2c_read_reg(dev->i2c_dev, dev->hw_addr, MPU9150_PWR_MGMT_2_REG, &pwr_2_setting);
/* Prepare power register settings */
if (pwr_conf == MPU9150_SENSOR_PWR_ON) {
pwr_1_setting = MPU9150_PWR_WAKEUP;
pwr_2_setting &= ~(MPU9150_PWR_ACCEL);
}
else {
pwr_1_setting = BIT_PWR_MGMT1_SLEEP;
pwr_2_setting |= MPU9150_PWR_ACCEL;
}
/* Configure power management 1 register if needed */
if ((dev->conf.gyro_pwr == MPU9150_SENSOR_PWR_OFF)
&& (dev->conf.compass_pwr == MPU9150_SENSOR_PWR_OFF)) {
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_PWR_MGMT_1_REG, pwr_1_setting);
}
/* Enable/disable accelerometer standby in power management 2 register */
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_PWR_MGMT_2_REG, pwr_2_setting);
/* Release the bus */
i2c_release(dev->i2c_dev);
dev->conf.accel_pwr = pwr_conf;
hwtimer_wait(HWTIMER_TICKS(MPU9150_PWR_CHANGE_SLEEP_US));
return 0;
}
int mpu9150_set_gyro_power(mpu9150_t *dev, mpu9150_pwr_t pwr_conf)
{
char pwr_2_setting;
if (dev->conf.gyro_pwr == pwr_conf) {
return 0;
}
/* Acquire exclusive access */
if (i2c_acquire(dev->i2c_dev)) {
return -1;
}
/* Read current power management 2 configuration */
i2c_read_reg(dev->i2c_dev, dev->hw_addr, MPU9150_PWR_MGMT_2_REG, &pwr_2_setting);
/* Prepare power register settings */
if (pwr_conf == MPU9150_SENSOR_PWR_ON) {
/* Set clock to pll */
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_PWR_MGMT_1_REG, MPU9150_PWR_PLL);
pwr_2_setting &= ~(MPU9150_PWR_GYRO);
}
else {
/* Configure power management 1 register */
if ((dev->conf.accel_pwr == MPU9150_SENSOR_PWR_OFF)
&& (dev->conf.compass_pwr == MPU9150_SENSOR_PWR_OFF)) {
/* All sensors turned off, put the MPU-9150 to sleep */
i2c_write_reg(dev->i2c_dev, dev->hw_addr,
MPU9150_PWR_MGMT_1_REG, BIT_PWR_MGMT1_SLEEP);
}
else {
/* Reset clock to internal oscillator */
i2c_write_reg(dev->i2c_dev, dev->hw_addr,
MPU9150_PWR_MGMT_1_REG, MPU9150_PWR_WAKEUP);
}
pwr_2_setting |= MPU9150_PWR_GYRO;
}
/* Enable/disable gyroscope standby in power management 2 register */
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_PWR_MGMT_2_REG, pwr_2_setting);
/* Release the bus */
i2c_release(dev->i2c_dev);
dev->conf.gyro_pwr = pwr_conf;
hwtimer_wait(HWTIMER_TICKS(MPU9150_PWR_CHANGE_SLEEP_US));
return 0;
}
int mpu9150_set_compass_power(mpu9150_t *dev, mpu9150_pwr_t pwr_conf)
{
char pwr_1_setting, usr_ctrl_setting, s1_do_setting;
if (dev->conf.compass_pwr == pwr_conf) {
return 0;
}
/* Acquire exclusive access */
if (i2c_acquire(dev->i2c_dev)) {
return -1;
}
/* Read current user control configuration */
i2c_read_reg(dev->i2c_dev, dev->hw_addr, MPU9150_USER_CTRL_REG, &usr_ctrl_setting);
/* Prepare power register settings */
if (pwr_conf == MPU9150_SENSOR_PWR_ON) {
pwr_1_setting = MPU9150_PWR_WAKEUP;
s1_do_setting = MPU9150_COMP_SINGLE_MEASURE;
usr_ctrl_setting |= BIT_I2C_MST_EN;
}
else {
pwr_1_setting = BIT_PWR_MGMT1_SLEEP;
s1_do_setting = MPU9150_COMP_POWER_DOWN;
usr_ctrl_setting &= ~(BIT_I2C_MST_EN);
}
/* Configure power management 1 register if needed */
if ((dev->conf.gyro_pwr == MPU9150_SENSOR_PWR_OFF)
&& (dev->conf.accel_pwr == MPU9150_SENSOR_PWR_OFF)) {
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_PWR_MGMT_1_REG, pwr_1_setting);
}
/* Configure mode writing by slave line 1 */
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_SLAVE1_DATA_OUT_REG, s1_do_setting);
/* Enable/disable I2C master mode */
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_USER_CTRL_REG, usr_ctrl_setting);
/* Release the bus */
i2c_release(dev->i2c_dev);
dev->conf.compass_pwr = pwr_conf;
hwtimer_wait(HWTIMER_TICKS(MPU9150_PWR_CHANGE_SLEEP_US));
return 0;
}
int mpu9150_read_gyro(mpu9150_t *dev, mpu9150_results_t *output)
{
char data[6];
int16_t temp;
float fsr;
switch (dev->conf.gyro_fsr) {
case MPU9150_GYRO_FSR_250DPS:
fsr = 250.0;
break;
case MPU9150_GYRO_FSR_500DPS:
fsr = 500.0;
break;
case MPU9150_GYRO_FSR_1000DPS:
fsr = 1000.0;
break;
case MPU9150_GYRO_FSR_2000DPS:
fsr = 2000.0;
break;
default:
return -2;
}
/* Acquire exclusive access */
if (i2c_acquire(dev->i2c_dev)) {
return -1;
}
/* Read raw data */
i2c_read_regs(dev->i2c_dev, dev->hw_addr, MPU9150_GYRO_START_REG, data, 6);
/* Release the bus */
i2c_release(dev->i2c_dev);
/* Normalize data according to configured full scale range */
temp = (data[0] << 8) | data[1];
output->x_axis = (temp * fsr) / MAX_VALUE;
temp = (data[2] << 8) | data[3];
output->y_axis = (temp * fsr) / MAX_VALUE;
temp = (data[4] << 8) | data[5];
output->z_axis = (temp * fsr) / MAX_VALUE;
return 0;
}
int mpu9150_read_accel(mpu9150_t *dev, mpu9150_results_t *output)
{
char data[6];
int16_t temp;
float fsr;
switch (dev->conf.accel_fsr) {
case MPU9150_ACCEL_FSR_2G:
fsr = 2000.0;
break;
case MPU9150_ACCEL_FSR_4G:
fsr = 4000.0;
break;
case MPU9150_ACCEL_FSR_8G:
fsr = 8000.0;
break;
case MPU9150_ACCEL_FSR_16G:
fsr = 16000.0;
break;
default:
return -2;
}
/* Acquire exclusive access */
if (i2c_acquire(dev->i2c_dev)) {
return -1;
}
/* Read raw data */
i2c_read_regs(dev->i2c_dev, dev->hw_addr, MPU9150_ACCEL_START_REG, data, 6);
/* Release the bus */
i2c_release(dev->i2c_dev);
/* Normalize data according to configured full scale range */
temp = (data[0] << 8) | data[1];
output->x_axis = (temp * fsr) / MAX_VALUE;
temp = (data[2] << 8) | data[3];
output->y_axis = (temp * fsr) / MAX_VALUE;
temp = (data[4] << 8) | data[5];
output->z_axis = (temp * fsr) / MAX_VALUE;
return 0;
}
int mpu9150_read_compass(mpu9150_t *dev, mpu9150_results_t *output)
{
char data[6];
/* Acquire exclusive access */
if (i2c_acquire(dev->i2c_dev)) {
return -1;
}
/* Read raw data */
i2c_read_regs(dev->i2c_dev, dev->hw_addr, MPU9150_EXT_SENS_DATA_START_REG, data, 6);
/* Release the bus */
i2c_release(dev->i2c_dev);
output->x_axis = (data[1] << 8) | data[0];
output->y_axis = (data[3] << 8) | data[2];
output->z_axis = (data[5] << 8) | data[4];
/* Compute sensitivity adjustment */
output->x_axis = (int16_t) (((float)output->x_axis) *
((((dev->conf.compass_x_adj - 128) * 0.5) / 128.0) + 1));
output->y_axis = (int16_t) (((float)output->y_axis) *
((((dev->conf.compass_y_adj - 128) * 0.5) / 128.0) + 1));
output->z_axis = (int16_t) (((float)output->z_axis) *
((((dev->conf.compass_z_adj - 128) * 0.5) / 128.0) + 1));
/* Normalize data according to full-scale range */
output->x_axis = output->x_axis * 0.3;
output->y_axis = output->y_axis * 0.3;
output->z_axis = output->z_axis * 0.3;
return 0;
}
int mpu9150_read_temperature(mpu9150_t *dev, int32_t *output)
{
char data[2];
int16_t temp;
/* Acquire exclusive access */
if (i2c_acquire(dev->i2c_dev)) {
return -1;
}
/* Read raw temperature value */
i2c_read_regs(dev->i2c_dev, dev->hw_addr, MPU9150_TEMP_START_REG, data, 2);
/* Release the bus */
i2c_release(dev->i2c_dev);
temp = (data[0] << 8) | data[1];
*output = ((((int32_t)temp) * 1000) / 340) + (35*1000);
return 0;
}
int mpu9150_set_gyro_fsr(mpu9150_t *dev, mpu9150_gyro_ranges_t fsr)
{
if (dev->conf.gyro_fsr == fsr) {
return 0;
}
switch (fsr) {
case MPU9150_GYRO_FSR_250DPS:
case MPU9150_GYRO_FSR_500DPS:
case MPU9150_GYRO_FSR_1000DPS:
case MPU9150_GYRO_FSR_2000DPS:
if (i2c_acquire(dev->i2c_dev)) {
return -1;
}
i2c_write_reg(dev->i2c_dev, dev->hw_addr,
MPU9150_GYRO_CFG_REG, (char)(fsr << 3));
i2c_release(dev->i2c_dev);
dev->conf.gyro_fsr = fsr;
break;
default:
return -2;
}
return 0;
}
int mpu9150_set_accel_fsr(mpu9150_t *dev, mpu9150_accel_ranges_t fsr)
{
if (dev->conf.accel_fsr == fsr) {
return 0;
}
switch (fsr) {
case MPU9150_ACCEL_FSR_2G:
case MPU9150_ACCEL_FSR_4G:
case MPU9150_ACCEL_FSR_8G:
case MPU9150_ACCEL_FSR_16G:
if (i2c_acquire(dev->i2c_dev)) {
return -1;
}
i2c_write_reg(dev->i2c_dev, dev->hw_addr,
MPU9150_ACCEL_CFG_REG, (char)(fsr << 3));
i2c_release(dev->i2c_dev);
dev->conf.accel_fsr = fsr;
break;
default:
return -2;
}
return 0;
}
int mpu9150_set_sample_rate(mpu9150_t *dev, uint16_t rate)
{
uint8_t divider;
if ((rate < MPU9150_MIN_SAMPLE_RATE) || (rate > MPU9150_MAX_SAMPLE_RATE)) {
return -2;
}
else if (dev->conf.sample_rate == rate) {
return 0;
}
/* Compute divider to achieve desired sample rate and write to rate div register */
divider = (1000 / rate - 1);
if (i2c_acquire(dev->i2c_dev)) {
return -1;
}
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_RATE_DIV_REG, (char) divider);
/* Store configured sample rate */
dev->conf.sample_rate = 1000 / (((uint16_t) divider) + 1);
/* Always set LPF to a maximum of half the configured sampling rate */
conf_lpf(dev, (dev->conf.sample_rate >> 1));
i2c_release(dev->i2c_dev);
return 0;
}
int mpu9150_set_compass_sample_rate(mpu9150_t *dev, uint8_t rate)
{
uint8_t divider;
if ((rate < MPU9150_MIN_COMP_SMPL_RATE) || (rate > MPU9150_MAX_COMP_SMPL_RATE)
|| (rate > dev->conf.sample_rate)) {
return -2;
}
else if (dev->conf.compass_sample_rate == rate) {
return 0;
}
/* Compute divider to achieve desired sample rate and write to slave ctrl register */
divider = (dev->conf.sample_rate / rate - 1);
if (i2c_acquire(dev->i2c_dev)) {
return -1;
}
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_SLAVE4_CTRL_REG, (char) divider);
i2c_release(dev->i2c_dev);
/* Store configured sample rate */
dev->conf.compass_sample_rate = dev->conf.sample_rate / (((uint16_t) divider) + 1);
return 0;
}
/*------------------------------------------------------------------------------------*/
/* Internal functions */
/*------------------------------------------------------------------------------------*/
/**
* Initialize compass
* Caution: This internal function does not acquire exclusive access to the I2C bus.
* Acquisation and release is supposed to be handled by the calling function.
*/
static int compass_init(mpu9150_t *dev)
{
char data[3];
/* Enable Bypass Mode to speak to compass directly */
conf_bypass(dev, 1);
/* Check whether compass answers correctly */
i2c_read_reg(dev->i2c_dev, dev->comp_addr, COMPASS_WHOAMI_REG, data);
if (data[0] != MPU9150_COMP_WHOAMI_ANSWER) {
DEBUG("[Error] Wrong answer from compass\n");
return -1;
}
/* Configure Power Down mode */
i2c_write_reg(dev->i2c_dev, dev->comp_addr, COMPASS_CNTL_REG, MPU9150_COMP_POWER_DOWN);
hwtimer_wait(HWTIMER_TICKS(MPU9150_COMP_MODE_SLEEP_US));
/* Configure Fuse ROM access */
i2c_write_reg(dev->i2c_dev, dev->comp_addr, COMPASS_CNTL_REG, MPU9150_COMP_FUSE_ROM);
hwtimer_wait(HWTIMER_TICKS(MPU9150_COMP_MODE_SLEEP_US));
/* Read sensitivity adjustment values from Fuse ROM */
i2c_read_regs(dev->i2c_dev, dev->comp_addr, COMPASS_ASAX_REG, data, 3);
dev->conf.compass_x_adj = data[0];
dev->conf.compass_y_adj = data[1];
dev->conf.compass_z_adj = data[2];
/* Configure Power Down mode again */
i2c_write_reg(dev->i2c_dev, dev->comp_addr, COMPASS_CNTL_REG, MPU9150_COMP_POWER_DOWN);
hwtimer_wait(HWTIMER_TICKS(MPU9150_COMP_MODE_SLEEP_US));
/* Disable Bypass Mode to configure MPU as master to the compass */
conf_bypass(dev, 0);
/* Configure MPU9150 for single master mode */
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_I2C_MST_REG, BIT_WAIT_FOR_ES);
/* Set up slave line 0 */
/* Slave line 0 reads the compass data */
i2c_write_reg(dev->i2c_dev, dev->hw_addr,
MPU9150_SLAVE0_ADDR_REG, (BIT_SLAVE_RW | dev->comp_addr));
/* Slave line 0 read starts at compass data register */
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_SLAVE0_REG_REG, COMPASS_DATA_START_REG);
/* Enable slave line 0 and configure read length to 6 consecutive registers */
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_SLAVE0_CTRL_REG, (BIT_SLAVE_EN | 0x06));
/* Set up slave line 1 */
/* Slave line 1 writes to the compass */
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_SLAVE1_ADDR_REG, dev->comp_addr);
/* Slave line 1 write starts at compass control register */
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_SLAVE1_REG_REG, COMPASS_CNTL_REG);
/* Enable slave line 1 and configure write length to 1 register */
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_SLAVE1_CTRL_REG, (BIT_SLAVE_EN | 0x01));
/* Configure data which is written by slave line 1 to compass control */
i2c_write_reg(dev->i2c_dev, dev->hw_addr,
MPU9150_SLAVE1_DATA_OUT_REG, MPU9150_COMP_SINGLE_MEASURE);
/* Slave line 0 and 1 operate at each sample */
i2c_write_reg(dev->i2c_dev, dev->hw_addr,
MPU9150_I2C_DELAY_CTRL_REG, (BIT_SLV0_DELAY_EN | BIT_SLV1_DELAY_EN));
/* Set I2C bus to VDD */
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_YG_OFFS_TC_REG, BIT_I2C_MST_VDDIO);
return 0;
}
/**
* Configure bypass mode
* Caution: This internal function does not acquire exclusive access to the I2C bus.
* Acquisation and release is supposed to be handled by the calling function.
*/
static void conf_bypass(mpu9150_t *dev, uint8_t bypass_enable)
{
char data;
i2c_read_reg(dev->i2c_dev, dev->hw_addr, MPU9150_USER_CTRL_REG, &data);
if (bypass_enable) {
data &= ~(BIT_I2C_MST_EN);
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_USER_CTRL_REG, data);
hwtimer_wait(HWTIMER_TICKS(MPU9150_BYPASS_SLEEP_US));
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_INT_PIN_CFG_REG, BIT_I2C_BYPASS_EN);
}
else {
data |= BIT_I2C_MST_EN;
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_USER_CTRL_REG, data);
hwtimer_wait(HWTIMER_TICKS(MPU9150_BYPASS_SLEEP_US));
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_INT_PIN_CFG_REG, REG_RESET);
}
}
/**
* Configure low pass filter
* Caution: This internal function does not acquire exclusive access to the I2C bus.
* Acquisation and release is supposed to be handled by the calling function.
*/
static void conf_lpf(mpu9150_t *dev, uint16_t half_rate)
{
mpu9150_lpf_t lpf_setting;
/* Get target LPF configuration setting */
if (half_rate >= 188) {
lpf_setting = MPU9150_FILTER_188HZ;
}
else if (half_rate >= 98) {
lpf_setting = MPU9150_FILTER_98HZ;
}
else if (half_rate >= 42) {
lpf_setting = MPU9150_FILTER_42HZ;
}
else if (half_rate >= 20) {
lpf_setting = MPU9150_FILTER_20HZ;
}
else if (half_rate >= 10) {
lpf_setting = MPU9150_FILTER_10HZ;
}
else {
lpf_setting = MPU9150_FILTER_5HZ;
}
/* Write LPF setting to configuration register */
i2c_write_reg(dev->i2c_dev, dev->hw_addr, MPU9150_LPF_REG, (char)lpf_setting);
}
Loading…
Cancel
Save