mirror of https://github.com/ArduPilot/ardupilot
999 lines
35 KiB
C++
999 lines
35 KiB
C++
/// -*- tab-width: 4; Mode: C++; c-basic-offset: 4; indent-tabs-mode: nil -*-
|
|
|
|
#include <assert.h>
|
|
|
|
#include <AP_HAL/AP_HAL.h>
|
|
#include "AP_InertialSensor_MPU6000.h"
|
|
|
|
extern const AP_HAL::HAL& hal;
|
|
|
|
// MPU6000 accelerometer scaling
|
|
#define MPU6000_ACCEL_SCALE_1G (GRAVITY_MSS / 4096.0f)
|
|
|
|
#if CONFIG_HAL_BOARD == HAL_BOARD_LINUX
|
|
#include <AP_HAL_Linux/GPIO.h>
|
|
#if CONFIG_HAL_BOARD_SUBTYPE == HAL_BOARD_SUBTYPE_LINUX_ERLEBOARD || CONFIG_HAL_BOARD_SUBTYPE == HAL_BOARD_SUBTYPE_LINUX_PXF
|
|
#define MPU6000_DRDY_PIN BBB_P8_14
|
|
#elif CONFIG_HAL_BOARD_SUBTYPE == HAL_BOARD_SUBTYPE_LINUX_RASPILOT
|
|
#define MPU6000_DRDY_PIN RPI_GPIO_24
|
|
#elif CONFIG_HAL_BOARD_SUBTYPE == HAL_BOARD_SUBTYPE_LINUX_MINLURE
|
|
#define MPU6000_DRDY_PIN MINNOW_GPIO_I2S_CLK
|
|
#endif
|
|
#endif
|
|
|
|
// MPU 6000 registers
|
|
#define MPUREG_XG_OFFS_TC 0x00
|
|
#define MPUREG_YG_OFFS_TC 0x01
|
|
#define MPUREG_ZG_OFFS_TC 0x02
|
|
#define MPUREG_X_FINE_GAIN 0x03
|
|
#define MPUREG_Y_FINE_GAIN 0x04
|
|
#define MPUREG_Z_FINE_GAIN 0x05
|
|
#define MPUREG_XA_OFFS_H 0x06 // X axis accelerometer offset (high byte)
|
|
#define MPUREG_XA_OFFS_L 0x07 // X axis accelerometer offset (low byte)
|
|
#define MPUREG_YA_OFFS_H 0x08 // Y axis accelerometer offset (high byte)
|
|
#define MPUREG_YA_OFFS_L 0x09 // Y axis accelerometer offset (low byte)
|
|
#define MPUREG_ZA_OFFS_H 0x0A // Z axis accelerometer offset (high byte)
|
|
#define MPUREG_ZA_OFFS_L 0x0B // Z axis accelerometer offset (low byte)
|
|
#define MPUREG_PRODUCT_ID 0x0C // Product ID Register
|
|
#define MPUREG_XG_OFFS_USRH 0x13 // X axis gyro offset (high byte)
|
|
#define MPUREG_XG_OFFS_USRL 0x14 // X axis gyro offset (low byte)
|
|
#define MPUREG_YG_OFFS_USRH 0x15 // Y axis gyro offset (high byte)
|
|
#define MPUREG_YG_OFFS_USRL 0x16 // Y axis gyro offset (low byte)
|
|
#define MPUREG_ZG_OFFS_USRH 0x17 // Z axis gyro offset (high byte)
|
|
#define MPUREG_ZG_OFFS_USRL 0x18 // Z axis gyro offset (low byte)
|
|
#define MPUREG_SMPLRT_DIV 0x19 // sample rate. Fsample= 1Khz/(<this value>+1) = 200Hz
|
|
# define MPUREG_SMPLRT_1000HZ 0x00
|
|
# define MPUREG_SMPLRT_500HZ 0x01
|
|
# define MPUREG_SMPLRT_250HZ 0x03
|
|
# define MPUREG_SMPLRT_200HZ 0x04
|
|
# define MPUREG_SMPLRT_100HZ 0x09
|
|
# define MPUREG_SMPLRT_50HZ 0x13
|
|
#define MPUREG_CONFIG 0x1A
|
|
#define MPUREG_GYRO_CONFIG 0x1B
|
|
// bit definitions for MPUREG_GYRO_CONFIG
|
|
# define BITS_GYRO_FS_250DPS 0x00
|
|
# define BITS_GYRO_FS_500DPS 0x08
|
|
# define BITS_GYRO_FS_1000DPS 0x10
|
|
# define BITS_GYRO_FS_2000DPS 0x18
|
|
# define BITS_GYRO_FS_MASK 0x18 // only bits 3 and 4 are used for gyro full scale so use this to mask off other bits
|
|
# define BITS_GYRO_ZGYRO_SELFTEST 0x20
|
|
# define BITS_GYRO_YGYRO_SELFTEST 0x40
|
|
# define BITS_GYRO_XGYRO_SELFTEST 0x80
|
|
#define MPUREG_ACCEL_CONFIG 0x1C
|
|
#define MPUREG_MOT_THR 0x1F // detection threshold for Motion interrupt generation. Motion is detected when the absolute value of any of the accelerometer measurements exceeds this
|
|
#define MPUREG_MOT_DUR 0x20 // duration counter threshold for Motion interrupt generation. The duration counter ticks at 1 kHz, therefore MOT_DUR has a unit of 1 LSB = 1 ms
|
|
#define MPUREG_ZRMOT_THR 0x21 // detection threshold for Zero Motion interrupt generation.
|
|
#define MPUREG_ZRMOT_DUR 0x22 // duration counter threshold for Zero Motion interrupt generation. The duration counter ticks at 16 Hz, therefore ZRMOT_DUR has a unit of 1 LSB = 64 ms.
|
|
#define MPUREG_FIFO_EN 0x23
|
|
# define BIT_TEMP_FIFO_EN 0x80
|
|
# define BIT_XG_FIFO_EN 0x40
|
|
# define BIT_YG_FIFO_EN 0x20
|
|
# define BIT_ZG_FIFO_EN 0x10
|
|
# define BIT_ACCEL_FIFO_EN 0x08
|
|
# define BIT_SLV2_FIFO_EN 0x04
|
|
# define BIT_SLV1_FIFO_EN 0x02
|
|
# define BIT_SLV0_FIFI_EN0 0x01
|
|
#define MPUREG_I2C_MST_CTRL 0x24
|
|
# define BIT_I2C_MST_P_NSR 0x10
|
|
# define BIT_I2C_MST_CLK_400KHZ 0x0D
|
|
#define MPUREG_I2C_SLV0_ADDR 0x25
|
|
#define MPUREG_I2C_SLV1_ADDR 0x28
|
|
#define MPUREG_I2C_SLV2_ADDR 0x2B
|
|
#define MPUREG_I2C_SLV3_ADDR 0x2E
|
|
#define MPUREG_INT_PIN_CFG 0x37
|
|
# define BIT_INT_RD_CLEAR 0x10 // clear the interrupt when any read occurs
|
|
# define BIT_LATCH_INT_EN 0x20 // latch data ready pin
|
|
#define MPUREG_I2C_SLV4_CTRL 0x34
|
|
#define MPUREG_INT_ENABLE 0x38
|
|
// bit definitions for MPUREG_INT_ENABLE
|
|
# define BIT_RAW_RDY_EN 0x01
|
|
# define BIT_DMP_INT_EN 0x02 // enabling this bit (DMP_INT_EN) also enables RAW_RDY_EN it seems
|
|
# define BIT_UNKNOWN_INT_EN 0x04
|
|
# define BIT_I2C_MST_INT_EN 0x08
|
|
# define BIT_FIFO_OFLOW_EN 0x10
|
|
# define BIT_ZMOT_EN 0x20
|
|
# define BIT_MOT_EN 0x40
|
|
# define BIT_FF_EN 0x80
|
|
#define MPUREG_INT_STATUS 0x3A
|
|
// bit definitions for MPUREG_INT_STATUS (same bit pattern as above because this register shows what interrupt actually fired)
|
|
# define BIT_RAW_RDY_INT 0x01
|
|
# define BIT_DMP_INT 0x02
|
|
# define BIT_UNKNOWN_INT 0x04
|
|
# define BIT_I2C_MST_INT 0x08
|
|
# define BIT_FIFO_OFLOW_INT 0x10
|
|
# define BIT_ZMOT_INT 0x20
|
|
# define BIT_MOT_INT 0x40
|
|
# define BIT_FF_INT 0x80
|
|
#define MPUREG_ACCEL_XOUT_H 0x3B
|
|
#define MPUREG_ACCEL_XOUT_L 0x3C
|
|
#define MPUREG_ACCEL_YOUT_H 0x3D
|
|
#define MPUREG_ACCEL_YOUT_L 0x3E
|
|
#define MPUREG_ACCEL_ZOUT_H 0x3F
|
|
#define MPUREG_ACCEL_ZOUT_L 0x40
|
|
#define MPUREG_TEMP_OUT_H 0x41
|
|
#define MPUREG_TEMP_OUT_L 0x42
|
|
#define MPUREG_GYRO_XOUT_H 0x43
|
|
#define MPUREG_GYRO_XOUT_L 0x44
|
|
#define MPUREG_GYRO_YOUT_H 0x45
|
|
#define MPUREG_GYRO_YOUT_L 0x46
|
|
#define MPUREG_GYRO_ZOUT_H 0x47
|
|
#define MPUREG_GYRO_ZOUT_L 0x48
|
|
#define MPUREG_EXT_SENS_DATA_00 0x49
|
|
#define MPUREG_I2C_SLV0_DO 0x63
|
|
#define MPUREG_I2C_MST_DELAY_CTRL 0x67
|
|
# define BIT_I2C_SLV0_DLY_EN 0x01
|
|
# define BIT_I2C_SLV1_DLY_EN 0x02
|
|
# define BIT_I2C_SLV2_DLY_EN 0x04
|
|
# define BIT_I2C_SLV3_DLY_EN 0x08
|
|
#define MPUREG_USER_CTRL 0x6A
|
|
// bit definitions for MPUREG_USER_CTRL
|
|
# define BIT_USER_CTRL_SIG_COND_RESET 0x01 // resets signal paths and results registers for all sensors (gyros, accel, temp)
|
|
# define BIT_USER_CTRL_I2C_MST_RESET 0x02 // reset I2C Master (only applicable if I2C_MST_EN bit is set)
|
|
# define BIT_USER_CTRL_FIFO_RESET 0x04 // Reset (i.e. clear) FIFO buffer
|
|
# define BIT_USER_CTRL_DMP_RESET 0x08 // Reset DMP
|
|
# define BIT_USER_CTRL_I2C_IF_DIS 0x10 // Disable primary I2C interface and enable hal.spi->interface
|
|
# define BIT_USER_CTRL_I2C_MST_EN 0x20 // Enable MPU to act as the I2C Master to external slave sensors
|
|
# define BIT_USER_CTRL_FIFO_EN 0x40 // Enable FIFO operations
|
|
# define BIT_USER_CTRL_DMP_EN 0x80 // Enable DMP operations
|
|
#define MPUREG_PWR_MGMT_1 0x6B
|
|
# define BIT_PWR_MGMT_1_CLK_INTERNAL 0x00 // clock set to internal 8Mhz oscillator
|
|
# define BIT_PWR_MGMT_1_CLK_XGYRO 0x01 // PLL with X axis gyroscope reference
|
|
# define BIT_PWR_MGMT_1_CLK_YGYRO 0x02 // PLL with Y axis gyroscope reference
|
|
# define BIT_PWR_MGMT_1_CLK_ZGYRO 0x03 // PLL with Z axis gyroscope reference
|
|
# define BIT_PWR_MGMT_1_CLK_EXT32KHZ 0x04 // PLL with external 32.768kHz reference
|
|
# define BIT_PWR_MGMT_1_CLK_EXT19MHZ 0x05 // PLL with external 19.2MHz reference
|
|
# define BIT_PWR_MGMT_1_CLK_STOP 0x07 // Stops the clock and keeps the timing generator in reset
|
|
# define BIT_PWR_MGMT_1_TEMP_DIS 0x08 // disable temperature sensor
|
|
# define BIT_PWR_MGMT_1_CYCLE 0x20 // put sensor into cycle mode. cycles between sleep mode and waking up to take a single sample of data from active sensors at a rate determined by LP_WAKE_CTRL
|
|
# define BIT_PWR_MGMT_1_SLEEP 0x40 // put sensor into low power sleep mode
|
|
# define BIT_PWR_MGMT_1_DEVICE_RESET 0x80 // reset entire device
|
|
#define MPUREG_PWR_MGMT_2 0x6C // allows the user to configure the frequency of wake-ups in Accelerometer Only Low Power Mode
|
|
#define MPUREG_BANK_SEL 0x6D // DMP bank selection register (used to indirectly access DMP registers)
|
|
#define MPUREG_MEM_START_ADDR 0x6E // DMP memory start address (used to indirectly write to dmp memory)
|
|
#define MPUREG_MEM_R_W 0x6F // DMP related register
|
|
#define MPUREG_DMP_CFG_1 0x70 // DMP related register
|
|
#define MPUREG_DMP_CFG_2 0x71 // DMP related register
|
|
#define MPUREG_FIFO_COUNTH 0x72
|
|
#define MPUREG_FIFO_COUNTL 0x73
|
|
#define MPUREG_FIFO_R_W 0x74
|
|
#define MPUREG_WHOAMI 0x75
|
|
|
|
#define BIT_READ_FLAG 0x80
|
|
#define BIT_I2C_SLVX_EN 0x80
|
|
|
|
// Configuration bits MPU 3000 and MPU 6000 (not revised)?
|
|
#define BITS_DLPF_CFG_256HZ_NOLPF2 0x00
|
|
#define BITS_DLPF_CFG_188HZ 0x01
|
|
#define BITS_DLPF_CFG_98HZ 0x02
|
|
#define BITS_DLPF_CFG_42HZ 0x03
|
|
#define BITS_DLPF_CFG_20HZ 0x04
|
|
#define BITS_DLPF_CFG_10HZ 0x05
|
|
#define BITS_DLPF_CFG_5HZ 0x06
|
|
#define BITS_DLPF_CFG_2100HZ_NOLPF 0x07
|
|
#define BITS_DLPF_CFG_MASK 0x07
|
|
|
|
// Product ID Description for MPU6000
|
|
// high 4 bits low 4 bits
|
|
// Product Name Product Revision
|
|
#define MPU6000ES_REV_C4 0x14 // 0001 0100
|
|
#define MPU6000ES_REV_C5 0x15 // 0001 0101
|
|
#define MPU6000ES_REV_D6 0x16 // 0001 0110
|
|
#define MPU6000ES_REV_D7 0x17 // 0001 0111
|
|
#define MPU6000ES_REV_D8 0x18 // 0001 1000
|
|
#define MPU6000_REV_C4 0x54 // 0101 0100
|
|
#define MPU6000_REV_C5 0x55 // 0101 0101
|
|
#define MPU6000_REV_D6 0x56 // 0101 0110
|
|
#define MPU6000_REV_D7 0x57 // 0101 0111
|
|
#define MPU6000_REV_D8 0x58 // 0101 1000
|
|
#define MPU6000_REV_D9 0x59 // 0101 1001
|
|
|
|
#define int16_val(v, idx) ((int16_t)(((uint16_t)v[2*idx] << 8) | v[2*idx+1]))
|
|
#define uint16_val(v, idx)(((uint16_t)v[2*idx] << 8) | v[2*idx+1])
|
|
|
|
/* SPI bus driver implementation */
|
|
|
|
AP_MPU6000_BusDriver_SPI::AP_MPU6000_BusDriver_SPI(void) :
|
|
_error_count(0)
|
|
{
|
|
_spi = hal.spi->device(AP_HAL::SPIDevice_MPU6000);
|
|
}
|
|
|
|
void AP_MPU6000_BusDriver_SPI::init()
|
|
{
|
|
/* Disable I2C bus if SPI selected (Recommended in Datasheet to be done
|
|
* just after the device is reset) */
|
|
write8(MPUREG_USER_CTRL, BIT_USER_CTRL_I2C_IF_DIS);
|
|
}
|
|
|
|
void AP_MPU6000_BusDriver_SPI::start(bool &fifo_mode, uint8_t &max_samples)
|
|
{
|
|
fifo_mode = false;
|
|
_error_count = 0;
|
|
/* maximum number of samples read by a burst
|
|
* a sample is an array containing :
|
|
* gyro_x
|
|
* gyro_y
|
|
* gyro_z
|
|
* accel_x
|
|
* accel_y
|
|
* accel_z
|
|
*/
|
|
max_samples = 1;
|
|
};
|
|
|
|
/*
|
|
* This implementation is limited to a block of at most 32 bytes
|
|
*/
|
|
void AP_MPU6000_BusDriver_SPI::read_block(uint8_t reg, uint8_t *buf, uint32_t size)
|
|
{
|
|
assert(size < 32);
|
|
|
|
reg |= BIT_READ_FLAG;
|
|
uint8_t tx[32] = { reg, };
|
|
uint8_t rx[32] = { };
|
|
|
|
_spi->transaction(tx, rx, size + 1);
|
|
memcpy(buf, rx + 1, size);
|
|
}
|
|
|
|
void AP_MPU6000_BusDriver_SPI::read8(uint8_t reg, uint8_t *val)
|
|
{
|
|
uint8_t addr = reg | 0x80; // Set most significant bit
|
|
|
|
uint8_t tx[2];
|
|
uint8_t rx[2];
|
|
|
|
tx[0] = addr;
|
|
tx[1] = 0;
|
|
_spi->transaction(tx, rx, 2);
|
|
|
|
*val = rx[1];
|
|
}
|
|
|
|
void AP_MPU6000_BusDriver_SPI::write8(uint8_t reg, uint8_t val)
|
|
{
|
|
uint8_t tx[2];
|
|
uint8_t rx[2];
|
|
|
|
tx[0] = reg;
|
|
tx[1] = val;
|
|
_spi->transaction(tx, rx, 2);
|
|
}
|
|
|
|
void AP_MPU6000_BusDriver_SPI::set_bus_speed(AP_HAL::SPIDeviceDriver::bus_speed speed)
|
|
{
|
|
_spi->set_bus_speed(speed);
|
|
}
|
|
|
|
void AP_MPU6000_BusDriver_SPI::read_data_transaction(uint8_t *samples,
|
|
AP_HAL::DigitalSource *_drdy_pin,
|
|
uint8_t &n_samples)
|
|
{
|
|
/* one register address followed by seven 2-byte registers */
|
|
struct PACKED {
|
|
uint8_t cmd;
|
|
uint8_t int_status;
|
|
uint8_t d[14];
|
|
} rx, tx = { cmd : MPUREG_INT_STATUS | 0x80, };
|
|
|
|
_spi->transaction((const uint8_t *)&tx, (uint8_t *)&rx, sizeof(rx));
|
|
|
|
/*
|
|
detect a bad SPI bus transaction by looking for all 14 bytes
|
|
zero. This can happen with some boards with hw that end up
|
|
needing a lower bus speed
|
|
*/
|
|
uint8_t i;
|
|
for (i=0; i<14; i++) {
|
|
if (rx.d[i] != 0) break;
|
|
}
|
|
if (i == 14) {
|
|
// likely a bad bus transaction
|
|
if (++_error_count > 4) {
|
|
set_bus_speed(AP_HAL::SPIDeviceDriver::SPI_SPEED_LOW);
|
|
}
|
|
}
|
|
|
|
n_samples = 1;
|
|
/* remove cmd from data sample */
|
|
memcpy(&samples[0], &rx.d[0], 14);
|
|
|
|
return;
|
|
}
|
|
|
|
AP_HAL::Semaphore* AP_MPU6000_BusDriver_SPI::get_semaphore()
|
|
{
|
|
return _spi->get_semaphore();
|
|
}
|
|
|
|
bool AP_MPU6000_BusDriver_SPI::has_auxiliary_bus()
|
|
{
|
|
return true;
|
|
}
|
|
|
|
/* I2C bus driver implementation */
|
|
AP_MPU6000_BusDriver_I2C::AP_MPU6000_BusDriver_I2C(AP_HAL::I2CDriver *i2c, uint8_t addr) :
|
|
_addr(addr),
|
|
_i2c(i2c),
|
|
_i2c_sem(NULL)
|
|
{}
|
|
|
|
void AP_MPU6000_BusDriver_I2C::init()
|
|
{
|
|
}
|
|
|
|
void AP_MPU6000_BusDriver_I2C::start(bool &fifo_mode, uint8_t &max_samples)
|
|
{
|
|
// enable fifo mode
|
|
fifo_mode = true;
|
|
write8(MPUREG_FIFO_EN, BIT_XG_FIFO_EN | BIT_YG_FIFO_EN |
|
|
BIT_ZG_FIFO_EN | BIT_ACCEL_FIFO_EN | BIT_TEMP_FIFO_EN);
|
|
write8(MPUREG_USER_CTRL, 0);
|
|
write8(MPUREG_USER_CTRL, BIT_USER_CTRL_FIFO_RESET);
|
|
write8(MPUREG_USER_CTRL, BIT_USER_CTRL_FIFO_EN);
|
|
/* maximum number of samples read by a burst
|
|
* a sample is an array containing :
|
|
* gyro_x
|
|
* gyro_y
|
|
* gyro_z
|
|
* temperature
|
|
* accel_x
|
|
* accel_y
|
|
* accel_z
|
|
*/
|
|
max_samples = MPU6000_MAX_FIFO_SAMPLES;
|
|
}
|
|
|
|
void AP_MPU6000_BusDriver_I2C::read8(uint8_t reg, uint8_t *val)
|
|
{
|
|
_i2c->readRegister(_addr, reg, val);
|
|
}
|
|
|
|
void AP_MPU6000_BusDriver_I2C::read_block(uint8_t reg, uint8_t *buf, uint32_t size)
|
|
{
|
|
_i2c->readRegisters(_addr, reg, size, buf);
|
|
}
|
|
|
|
void AP_MPU6000_BusDriver_I2C::write8(uint8_t reg, uint8_t val)
|
|
{
|
|
_i2c->writeRegister(_addr, reg, val);
|
|
}
|
|
|
|
void AP_MPU6000_BusDriver_I2C::set_bus_speed(AP_HAL::SPIDeviceDriver::bus_speed speed)
|
|
{}
|
|
|
|
void AP_MPU6000_BusDriver_I2C::read_data_transaction(uint8_t *samples,
|
|
AP_HAL::DigitalSource *_drdy_pin,
|
|
uint8_t &n_samples)
|
|
{
|
|
uint16_t bytes_read;
|
|
uint8_t ret = 0;
|
|
|
|
ret = _i2c->readRegisters(_addr, MPUREG_FIFO_COUNTH, 2, _rx);
|
|
if(ret != 0) {
|
|
hal.console->printf("MPU6000: error in i2c read\n");
|
|
n_samples = 0;
|
|
return;
|
|
}
|
|
|
|
bytes_read = uint16_val(_rx, 0);
|
|
|
|
n_samples = bytes_read / MPU6000_SAMPLE_SIZE;
|
|
|
|
if(n_samples > MPU6000_MAX_FIFO_SAMPLES) {
|
|
hal.console->printf("bytes_read = %d, n_samples %d > 3, dropping samples\n",
|
|
bytes_read, n_samples);
|
|
|
|
/* Too many samples, do a FIFO RESET */
|
|
write8(MPUREG_USER_CTRL, 0);
|
|
write8(MPUREG_USER_CTRL, BIT_USER_CTRL_FIFO_RESET);
|
|
write8(MPUREG_USER_CTRL, BIT_USER_CTRL_FIFO_EN);
|
|
n_samples = 0;
|
|
return;
|
|
}
|
|
else if (n_samples == 0) {
|
|
/* Not enough data in FIFO */
|
|
return;
|
|
}
|
|
else {
|
|
ret = _i2c->readRegisters(_addr, MPUREG_FIFO_R_W, n_samples * MPU6000_SAMPLE_SIZE, _rx);
|
|
}
|
|
|
|
if(ret != 0) {
|
|
hal.console->printf("MPU6000: error in i2c read %d bytes\n",
|
|
n_samples * MPU6000_SAMPLE_SIZE);
|
|
n_samples = 0;
|
|
return;
|
|
}
|
|
|
|
memcpy(samples, _rx, n_samples * MPU6000_SAMPLE_SIZE);
|
|
|
|
return;
|
|
}
|
|
|
|
AP_HAL::Semaphore* AP_MPU6000_BusDriver_I2C::get_semaphore()
|
|
{
|
|
return _i2c->get_semaphore();
|
|
}
|
|
|
|
bool AP_MPU6000_BusDriver_I2C::has_auxiliary_bus()
|
|
{
|
|
return false;
|
|
}
|
|
|
|
/*
|
|
* RM-MPU-6000A-00.pdf, page 33, section 4.25 lists LSB sensitivity of
|
|
* gyro as 16.4 LSB/DPS at scale factor of +/- 2000dps (FS_SEL==3)
|
|
*/
|
|
const float AP_InertialSensor_MPU6000::_gyro_scale = (0.0174532f / 16.4f);
|
|
|
|
/*
|
|
* RM-MPU-6000A-00.pdf, page 31, section 4.23 lists LSB sensitivity of
|
|
* accel as 4096 LSB/mg at scale factor of +/- 8g (AFS_SEL==2)
|
|
*
|
|
* See note below about accel scaling of engineering sample MPU6k
|
|
* variants however
|
|
*/
|
|
|
|
AP_InertialSensor_MPU6000::AP_InertialSensor_MPU6000(AP_InertialSensor &imu, AP_MPU6000_BusDriver *bus) :
|
|
AP_InertialSensor_Backend(imu),
|
|
_drdy_pin(NULL),
|
|
_bus(bus),
|
|
_bus_sem(NULL),
|
|
_temp_filter(1000, 1),
|
|
_samples(NULL)
|
|
{
|
|
|
|
}
|
|
|
|
AP_InertialSensor_MPU6000::~AP_InertialSensor_MPU6000()
|
|
{
|
|
delete _bus;
|
|
delete _auxiliary_bus;
|
|
delete _samples;
|
|
}
|
|
|
|
/* Detect the sensor on SPI bus. It must have a corresponding device on
|
|
* SPIDriver table */
|
|
AP_InertialSensor_Backend *AP_InertialSensor_MPU6000::detect_spi(AP_InertialSensor &imu)
|
|
{
|
|
AP_MPU6000_BusDriver *bus = new AP_MPU6000_BusDriver_SPI();
|
|
if (!bus)
|
|
return nullptr;
|
|
return _detect(imu, bus, HAL_INS_MPU60XX_SPI);
|
|
}
|
|
|
|
/* Detect the sensor on the specified I2C bus and address */
|
|
AP_InertialSensor_Backend *AP_InertialSensor_MPU6000::detect_i2c(AP_InertialSensor &imu,
|
|
AP_HAL::I2CDriver *i2c,
|
|
uint8_t addr)
|
|
{
|
|
AP_MPU6000_BusDriver *bus = new AP_MPU6000_BusDriver_I2C(i2c, addr);
|
|
if (!bus)
|
|
return nullptr;
|
|
return _detect(imu, bus);
|
|
}
|
|
|
|
/* Common detection method - it takes ownership of the bus, freeing it if it's
|
|
* not possible to return an AP_InertialSensor_Backend */
|
|
AP_InertialSensor_Backend *AP_InertialSensor_MPU6000::_detect(AP_InertialSensor &_imu,
|
|
AP_MPU6000_BusDriver *bus,
|
|
int16_t id)
|
|
{
|
|
AP_InertialSensor_MPU6000 *sensor = new AP_InertialSensor_MPU6000(_imu, bus);
|
|
if (sensor == NULL) {
|
|
delete bus;
|
|
return nullptr;
|
|
}
|
|
if (!sensor->_init_sensor()) {
|
|
delete sensor;
|
|
return nullptr;
|
|
}
|
|
|
|
sensor->_id = id;
|
|
|
|
return sensor;
|
|
}
|
|
|
|
bool AP_InertialSensor_MPU6000::_init_sensor(void)
|
|
{
|
|
_bus_sem = _bus->get_semaphore();
|
|
|
|
#ifdef MPU6000_DRDY_PIN
|
|
_drdy_pin = hal.gpio->channel(MPU6000_DRDY_PIN);
|
|
_drdy_pin->mode(HAL_GPIO_INPUT);
|
|
#endif
|
|
|
|
hal.scheduler->suspend_timer_procs();
|
|
bool success = _hardware_init();
|
|
hal.scheduler->resume_timer_procs();
|
|
|
|
#if MPU6000_DEBUG
|
|
_dump_registers();
|
|
#endif
|
|
|
|
return success;
|
|
}
|
|
|
|
void AP_InertialSensor_MPU6000::start()
|
|
{
|
|
uint8_t max_samples;
|
|
|
|
hal.scheduler->suspend_timer_procs();
|
|
|
|
if (!_bus_sem->take(100)) {
|
|
AP_HAL::panic("MPU6000: Unable to get semaphore");
|
|
}
|
|
|
|
// initially run the bus at low speed
|
|
_bus->set_bus_speed(AP_HAL::SPIDeviceDriver::SPI_SPEED_LOW);
|
|
|
|
// only used for wake-up in accelerometer only low power mode
|
|
_register_write(MPUREG_PWR_MGMT_2, 0x00);
|
|
hal.scheduler->delay(1);
|
|
|
|
_bus->start(_fifo_mode, max_samples);
|
|
|
|
/* each sample is on 16 bits */
|
|
_samples = new uint8_t[max_samples * MPU6000_SAMPLE_SIZE];
|
|
hal.scheduler->delay(1);
|
|
|
|
// disable sensor filtering
|
|
_set_filter_register(256);
|
|
|
|
// set sample rate to 1000Hz and apply a software filter
|
|
// In this configuration, the gyro sample rate is 8kHz
|
|
// Therefore the sample rate value is 8kHz/(SMPLRT_DIV + 1)
|
|
// So we have to set it to 7 to have a 1kHz sampling
|
|
// rate on the gyro
|
|
_register_write(MPUREG_SMPLRT_DIV, 7);
|
|
|
|
hal.scheduler->delay(1);
|
|
|
|
_register_write(MPUREG_GYRO_CONFIG, BITS_GYRO_FS_2000DPS); // Gyro scale 2000º/s
|
|
hal.scheduler->delay(1);
|
|
|
|
// read the product ID rev c has 1/2 the sensitivity of rev d
|
|
_product_id = _register_read(MPUREG_PRODUCT_ID);
|
|
//Serial.printf("Product_ID= 0x%x\n", (unsigned) _mpu6000_product_id);
|
|
|
|
if ((_product_id == MPU6000ES_REV_C4) ||
|
|
(_product_id == MPU6000ES_REV_C5) ||
|
|
(_product_id == MPU6000_REV_C4) ||
|
|
(_product_id == MPU6000_REV_C5)) {
|
|
// Accel scale 8g (4096 LSB/g)
|
|
// Rev C has different scaling than rev D
|
|
_register_write(MPUREG_ACCEL_CONFIG,1<<3);
|
|
} else {
|
|
// Accel scale 8g (4096 LSB/g)
|
|
_register_write(MPUREG_ACCEL_CONFIG,2<<3);
|
|
}
|
|
hal.scheduler->delay(1);
|
|
|
|
// configure interrupt to fire when new data arrives
|
|
_register_write(MPUREG_INT_ENABLE, BIT_RAW_RDY_EN);
|
|
hal.scheduler->delay(1);
|
|
|
|
// clear interrupt on any read, and hold the data ready pin high
|
|
// until we clear the interrupt
|
|
_register_write(MPUREG_INT_PIN_CFG, BIT_INT_RD_CLEAR | BIT_LATCH_INT_EN);
|
|
|
|
// now that we have initialised, we set the SPI bus speed to high
|
|
_bus->set_bus_speed(AP_HAL::SPIDeviceDriver::SPI_SPEED_HIGH);
|
|
|
|
_bus_sem->give();
|
|
|
|
// grab the used instances
|
|
_gyro_instance = _imu.register_gyro(1000);
|
|
_accel_instance = _imu.register_accel(1000);
|
|
|
|
hal.scheduler->resume_timer_procs();
|
|
|
|
// start the timer process to read samples
|
|
hal.scheduler->register_timer_process(
|
|
FUNCTOR_BIND_MEMBER(&AP_InertialSensor_MPU6000::_poll_data, void));
|
|
}
|
|
|
|
/*
|
|
process any
|
|
*/
|
|
bool AP_InertialSensor_MPU6000::update( void )
|
|
{
|
|
update_accel(_accel_instance);
|
|
update_gyro(_gyro_instance);
|
|
|
|
_publish_temperature(_accel_instance, _temp_filtered);
|
|
|
|
/* give the temperature to the control loop in order to keep it constant*/
|
|
hal.util->set_imu_temp(_temp_filtered);
|
|
|
|
return true;
|
|
}
|
|
|
|
AuxiliaryBus *AP_InertialSensor_MPU6000::get_auxiliary_bus()
|
|
{
|
|
if (_auxiliary_bus)
|
|
return _auxiliary_bus;
|
|
|
|
if (_bus->has_auxiliary_bus())
|
|
_auxiliary_bus = new AP_MPU6000_AuxiliaryBus(*this);
|
|
|
|
return _auxiliary_bus;
|
|
}
|
|
|
|
/*================ HARDWARE FUNCTIONS ==================== */
|
|
|
|
/**
|
|
* Return true if the MPU6000 has new data available for reading.
|
|
*
|
|
* We use the data ready pin if it is available. Otherwise, read the
|
|
* status register.
|
|
*/
|
|
bool AP_InertialSensor_MPU6000::_data_ready()
|
|
{
|
|
if (_drdy_pin) {
|
|
return _drdy_pin->read() != 0;
|
|
}
|
|
uint8_t status = _register_read(MPUREG_INT_STATUS);
|
|
return (status & BIT_RAW_RDY_INT) != 0;
|
|
}
|
|
|
|
/**
|
|
* Timer process to poll for new data from the MPU6000.
|
|
*/
|
|
void AP_InertialSensor_MPU6000::_poll_data(void)
|
|
{
|
|
if (!_bus_sem->take_nonblocking()) {
|
|
return;
|
|
}
|
|
if (_fifo_mode || _data_ready()) {
|
|
_read_data_transaction();
|
|
}
|
|
_bus_sem->give();
|
|
}
|
|
|
|
void AP_InertialSensor_MPU6000::_accumulate(uint8_t *samples, uint8_t n_samples)
|
|
{
|
|
for(uint8_t i=0; i < n_samples; i++) {
|
|
uint8_t *data = samples + MPU6000_SAMPLE_SIZE * i;
|
|
Vector3f accel, gyro;
|
|
float temp;
|
|
|
|
accel = Vector3f(int16_val(data, 1),
|
|
int16_val(data, 0),
|
|
-int16_val(data, 2));
|
|
accel *= MPU6000_ACCEL_SCALE_1G;
|
|
|
|
gyro = Vector3f(int16_val(data, 5),
|
|
int16_val(data, 4),
|
|
-int16_val(data, 6));
|
|
gyro *= _gyro_scale;
|
|
|
|
temp = int16_val(data, 3);
|
|
/* scaling/offset values from the datasheet */
|
|
temp = temp/340 + 36.53;
|
|
|
|
#if CONFIG_HAL_BOARD_SUBTYPE == HAL_BOARD_SUBTYPE_LINUX_PXF
|
|
accel.rotate(ROTATION_PITCH_180_YAW_90);
|
|
gyro.rotate(ROTATION_PITCH_180_YAW_90);
|
|
#elif CONFIG_HAL_BOARD_SUBTYPE == HAL_BOARD_SUBTYPE_LINUX_BEBOP
|
|
accel.rotate(ROTATION_YAW_270);
|
|
gyro.rotate(ROTATION_YAW_270);
|
|
#elif CONFIG_HAL_BOARD_SUBTYPE == HAL_BOARD_SUBTYPE_LINUX_MINLURE
|
|
accel.rotate(ROTATION_YAW_90);
|
|
gyro.rotate(ROTATION_YAW_90);
|
|
#endif
|
|
|
|
_rotate_and_correct_accel(_accel_instance, accel);
|
|
_rotate_and_correct_gyro(_gyro_instance, gyro);
|
|
|
|
_notify_new_accel_raw_sample(_accel_instance, accel);
|
|
_notify_new_gyro_raw_sample(_gyro_instance, gyro);
|
|
|
|
_temp_filtered = _temp_filter.apply(temp);
|
|
}
|
|
}
|
|
|
|
void AP_InertialSensor_MPU6000::_read_data_transaction()
|
|
{
|
|
uint8_t n_samples;
|
|
|
|
_bus->read_data_transaction(_samples, _drdy_pin, n_samples);
|
|
_accumulate(_samples, n_samples);
|
|
}
|
|
|
|
void AP_InertialSensor_MPU6000::_read_block(uint8_t reg, uint8_t *buf,
|
|
uint32_t size)
|
|
{
|
|
_bus->read_block(reg, buf, size);
|
|
}
|
|
|
|
uint8_t AP_InertialSensor_MPU6000::_register_read( uint8_t reg )
|
|
{
|
|
uint8_t val;
|
|
|
|
_bus->read8(reg, &val);
|
|
return val;
|
|
}
|
|
|
|
void AP_InertialSensor_MPU6000::_register_write(uint8_t reg, uint8_t val)
|
|
{
|
|
_bus->write8(reg, val);
|
|
}
|
|
|
|
/*
|
|
useful when debugging SPI bus errors
|
|
*/
|
|
void AP_InertialSensor_MPU6000::_register_write_check(uint8_t reg, uint8_t val)
|
|
{
|
|
uint8_t readed;
|
|
_register_write(reg, val);
|
|
readed = _register_read(reg);
|
|
if (readed != val){
|
|
hal.console->printf("Values doesn't match; written: %02x; read: %02x ", val, readed);
|
|
}
|
|
#if MPU6000_DEBUG
|
|
hal.console->printf("Values written: %02x; readed: %02x ", val, readed);
|
|
#endif
|
|
}
|
|
|
|
/*
|
|
set the DLPF filter frequency. Assumes caller has taken semaphore
|
|
*/
|
|
void AP_InertialSensor_MPU6000::_set_filter_register(uint16_t filter_hz)
|
|
{
|
|
uint8_t filter;
|
|
// choose filtering frequency
|
|
if (filter_hz == 0) {
|
|
filter = BITS_DLPF_CFG_256HZ_NOLPF2;
|
|
} else if (filter_hz <= 5) {
|
|
filter = BITS_DLPF_CFG_5HZ;
|
|
} else if (filter_hz <= 10) {
|
|
filter = BITS_DLPF_CFG_10HZ;
|
|
} else if (filter_hz <= 20) {
|
|
filter = BITS_DLPF_CFG_20HZ;
|
|
} else if (filter_hz <= 42) {
|
|
filter = BITS_DLPF_CFG_42HZ;
|
|
} else if (filter_hz <= 98) {
|
|
filter = BITS_DLPF_CFG_98HZ;
|
|
} else {
|
|
filter = BITS_DLPF_CFG_256HZ_NOLPF2;
|
|
}
|
|
_register_write(MPUREG_CONFIG, filter);
|
|
}
|
|
|
|
|
|
bool AP_InertialSensor_MPU6000::_hardware_init(void)
|
|
{
|
|
if (!_bus_sem->take(100)) {
|
|
AP_HAL::panic("MPU6000: Unable to get semaphore");
|
|
}
|
|
|
|
// initially run the bus at low speed
|
|
_bus->set_bus_speed(AP_HAL::SPIDeviceDriver::SPI_SPEED_LOW);
|
|
|
|
// Chip reset
|
|
uint8_t tries;
|
|
for (tries = 0; tries<5; tries++) {
|
|
uint8_t user_ctrl = _register_read(MPUREG_USER_CTRL);
|
|
|
|
/* First disable the master I2C to avoid hanging the slaves on the
|
|
* aulixiliar I2C bus - it will be enabled again if the AuxiliaryBus
|
|
* is used */
|
|
if (user_ctrl & BIT_USER_CTRL_I2C_MST_EN) {
|
|
_register_write(MPUREG_USER_CTRL, user_ctrl & ~BIT_USER_CTRL_I2C_MST_EN);
|
|
hal.scheduler->delay(10);
|
|
}
|
|
|
|
/* reset device */
|
|
_register_write(MPUREG_PWR_MGMT_1, BIT_PWR_MGMT_1_DEVICE_RESET);
|
|
hal.scheduler->delay(100);
|
|
|
|
/* bus-dependent initialization*/
|
|
_bus->init();
|
|
|
|
// Wake up device and select GyroZ clock. Note that the
|
|
// MPU6000 starts up in sleep mode, and it can take some time
|
|
// for it to come out of sleep
|
|
_register_write(MPUREG_PWR_MGMT_1, BIT_PWR_MGMT_1_CLK_ZGYRO);
|
|
hal.scheduler->delay(5);
|
|
|
|
// check it has woken up
|
|
if (_register_read(MPUREG_PWR_MGMT_1) == BIT_PWR_MGMT_1_CLK_ZGYRO)
|
|
break;
|
|
|
|
hal.scheduler->delay(10);
|
|
if (_data_ready())
|
|
break;
|
|
|
|
#if MPU6000_DEBUG
|
|
_dump_registers();
|
|
#endif
|
|
}
|
|
if (tries == 5) {
|
|
hal.console->println("Failed to boot MPU6000 5 times");
|
|
goto fail_tries;
|
|
}
|
|
|
|
_bus->set_bus_speed(AP_HAL::SPIDeviceDriver::SPI_SPEED_HIGH);
|
|
_bus_sem->give();
|
|
|
|
return true;
|
|
|
|
fail_tries:
|
|
_bus->set_bus_speed(AP_HAL::SPIDeviceDriver::SPI_SPEED_HIGH);
|
|
_bus_sem->give();
|
|
return false;
|
|
}
|
|
|
|
#if MPU6000_DEBUG
|
|
// dump all config registers - used for debug
|
|
void AP_InertialSensor_MPU6000::_dump_registers(void)
|
|
{
|
|
hal.console->println("MPU6000 registers");
|
|
if (_bus_sem->take(100)) {
|
|
for (uint8_t reg=MPUREG_PRODUCT_ID; reg<=108; reg++) {
|
|
uint8_t v = _register_read(reg);
|
|
hal.console->printf("%02x:%02x ", (unsigned)reg, (unsigned)v);
|
|
if ((reg - (MPUREG_PRODUCT_ID-1)) % 16 == 0) {
|
|
hal.console->println();
|
|
}
|
|
}
|
|
hal.console->println();
|
|
_bus_sem->give();
|
|
}
|
|
}
|
|
#endif
|
|
|
|
AP_MPU6000_AuxiliaryBusSlave::AP_MPU6000_AuxiliaryBusSlave(AuxiliaryBus &bus, uint8_t addr,
|
|
uint8_t instance)
|
|
: AuxiliaryBusSlave(bus, addr, instance)
|
|
, _mpu6000_addr(MPUREG_I2C_SLV0_ADDR + _instance * 3)
|
|
, _mpu6000_reg(_mpu6000_addr + 1)
|
|
, _mpu6000_ctrl(_mpu6000_addr + 2)
|
|
, _mpu6000_do(MPUREG_I2C_SLV0_DO + _instance)
|
|
{
|
|
}
|
|
|
|
int AP_MPU6000_AuxiliaryBusSlave::_set_passthrough(uint8_t reg, uint8_t size,
|
|
uint8_t *out)
|
|
{
|
|
auto &backend = AP_InertialSensor_MPU6000::from(_bus.get_backend());
|
|
uint8_t addr;
|
|
|
|
/* Ensure the slave read/write is disabled before changing the registers */
|
|
backend._register_write(_mpu6000_ctrl, 0);
|
|
|
|
if (out) {
|
|
backend._register_write(_mpu6000_do, *out);
|
|
addr = _addr;
|
|
} else {
|
|
addr = _addr | BIT_READ_FLAG;
|
|
}
|
|
|
|
backend._register_write(_mpu6000_addr, addr);
|
|
backend._register_write(_mpu6000_reg, reg);
|
|
backend._register_write(_mpu6000_ctrl, BIT_I2C_SLVX_EN | size);
|
|
|
|
return 0;
|
|
}
|
|
|
|
int AP_MPU6000_AuxiliaryBusSlave::passthrough_read(uint8_t reg, uint8_t *buf,
|
|
uint8_t size)
|
|
{
|
|
assert(buf);
|
|
|
|
if (_registered) {
|
|
hal.console->println("Error: can't passthrough when slave is already configured");
|
|
return -1;
|
|
}
|
|
|
|
int r = _set_passthrough(reg, size);
|
|
if (r < 0)
|
|
return r;
|
|
|
|
/* wait the value to be read from the slave and read it back */
|
|
hal.scheduler->delay(10);
|
|
|
|
auto &backend = AP_InertialSensor_MPU6000::from(_bus.get_backend());
|
|
backend._read_block(MPUREG_EXT_SENS_DATA_00 + _ext_sens_data, buf, size);
|
|
|
|
/* disable new reads */
|
|
backend._register_write(_mpu6000_ctrl, 0);
|
|
|
|
return size;
|
|
}
|
|
|
|
int AP_MPU6000_AuxiliaryBusSlave::passthrough_write(uint8_t reg, uint8_t val)
|
|
{
|
|
if (_registered) {
|
|
hal.console->println("Error: can't passthrough when slave is already configured");
|
|
return -1;
|
|
}
|
|
|
|
int r = _set_passthrough(reg, 1, &val);
|
|
if (r < 0)
|
|
return r;
|
|
|
|
/* wait the value to be written to the slave */
|
|
hal.scheduler->delay(10);
|
|
|
|
auto &backend = AP_InertialSensor_MPU6000::from(_bus.get_backend());
|
|
|
|
/* disable new writes */
|
|
backend._register_write(_mpu6000_ctrl, 0);
|
|
|
|
return 0;
|
|
}
|
|
|
|
int AP_MPU6000_AuxiliaryBusSlave::read(uint8_t *buf)
|
|
{
|
|
if (!_registered) {
|
|
hal.console->println("Error: can't read before configuring slave");
|
|
return -1;
|
|
}
|
|
|
|
auto &backend = AP_InertialSensor_MPU6000::from(_bus.get_backend());
|
|
backend._read_block(MPUREG_EXT_SENS_DATA_00 + _ext_sens_data, buf, _sample_size);
|
|
|
|
return 0;
|
|
}
|
|
|
|
/* MPU6000 provides up to 5 slave devices, but the 5th is way too different to
|
|
* configure and is seldom used */
|
|
AP_MPU6000_AuxiliaryBus::AP_MPU6000_AuxiliaryBus(AP_InertialSensor_MPU6000 &backend)
|
|
: AuxiliaryBus(backend, 4)
|
|
{
|
|
}
|
|
|
|
AP_HAL::Semaphore *AP_MPU6000_AuxiliaryBus::get_semaphore()
|
|
{
|
|
return static_cast<AP_InertialSensor_MPU6000&>(_ins_backend)._bus_sem;
|
|
}
|
|
|
|
AuxiliaryBusSlave *AP_MPU6000_AuxiliaryBus::_instantiate_slave(uint8_t addr, uint8_t instance)
|
|
{
|
|
/* Enable slaves on MPU6000 if this is the first time */
|
|
if (_ext_sens_data == 0)
|
|
_configure_slaves();
|
|
|
|
return new AP_MPU6000_AuxiliaryBusSlave(*this, addr, instance);
|
|
}
|
|
|
|
void AP_MPU6000_AuxiliaryBus::_configure_slaves()
|
|
{
|
|
auto &backend = AP_InertialSensor_MPU6000::from(_ins_backend);
|
|
|
|
uint8_t user_ctrl;
|
|
user_ctrl = backend._register_read(MPUREG_USER_CTRL);
|
|
backend._register_write(MPUREG_USER_CTRL, user_ctrl | BIT_USER_CTRL_I2C_MST_EN);
|
|
|
|
/* stop condition between reads; clock at 400kHz */
|
|
backend._register_write(MPUREG_I2C_MST_CTRL,
|
|
BIT_I2C_MST_P_NSR | BIT_I2C_MST_CLK_400KHZ);
|
|
|
|
/* Hard-code divider for internal sample rate, 1 kHz, resulting in a
|
|
* sample rate of 100Hz */
|
|
backend._register_write(MPUREG_I2C_SLV4_CTRL, 9);
|
|
|
|
/* All slaves are subject to the sample rate */
|
|
backend._register_write(MPUREG_I2C_MST_DELAY_CTRL,
|
|
BIT_I2C_SLV0_DLY_EN | BIT_I2C_SLV1_DLY_EN |
|
|
BIT_I2C_SLV2_DLY_EN | BIT_I2C_SLV3_DLY_EN);
|
|
}
|
|
|
|
int AP_MPU6000_AuxiliaryBus::_configure_periodic_read(AuxiliaryBusSlave *slave,
|
|
uint8_t reg, uint8_t size)
|
|
{
|
|
if (_ext_sens_data + size > MAX_EXT_SENS_DATA)
|
|
return -1;
|
|
|
|
AP_MPU6000_AuxiliaryBusSlave *mpu_slave =
|
|
static_cast<AP_MPU6000_AuxiliaryBusSlave*>(slave);
|
|
mpu_slave->_set_passthrough(reg, size);
|
|
mpu_slave->_ext_sens_data = _ext_sens_data;
|
|
_ext_sens_data += size;
|
|
|
|
return 0;
|
|
}
|