Paparazzi UAS  v5.8.2_stable-0-g6260b7c
Paparazzi is a free software Unmanned Aircraft System.
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Modules Pages
imu_mpu6000_hmc5883.c
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2013 Felix Ruess <felix.ruess@gmail.com>
3  *
4  * This file is part of paparazzi.
5  *
6  * paparazzi is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2, or (at your option)
9  * any later version.
10  *
11  * paparazzi is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with paparazzi; see the file COPYING. If not, write to
18  * the Free Software Foundation, 59 Temple Place - Suite 330,
19  * Boston, MA 02111-1307, USA.
20  */
21 
27 #include "subsystems/imu.h"
28 #include "subsystems/abi.h"
29 #include "mcu_periph/spi.h"
31 
32 
33 /* SPI/I2C defaults set in subsystem makefile, can be configured from airframe file */
34 PRINT_CONFIG_VAR(IMU_MPU_SPI_SLAVE_IDX)
35 PRINT_CONFIG_VAR(IMU_MPU_SPI_DEV)
36 PRINT_CONFIG_VAR(IMU_HMC_I2C_DEV)
37 
38 
39 /* MPU60x0 gyro/accel internal lowpass frequency */
40 #if !defined IMU_MPU_LOWPASS_FILTER && !defined IMU_MPU_SMPLRT_DIV
41 #if (PERIODIC_FREQUENCY == 60) || (PERIODIC_FREQUENCY == 120)
42 /* Accelerometer: Bandwidth 44Hz, Delay 4.9ms
43  * Gyroscope: Bandwidth 42Hz, Delay 4.8ms sampling 1kHz
44  */
45 #define IMU_MPU_LOWPASS_FILTER MPU60X0_DLPF_42HZ
46 #define IMU_MPU_SMPLRT_DIV 9
47 PRINT_CONFIG_MSG("Gyro/Accel output rate is 100Hz at 1kHz internal sampling")
48 #elif PERIODIC_FREQUENCY == 512
49 /* Accelerometer: Bandwidth 260Hz, Delay 0ms
50  * Gyroscope: Bandwidth 256Hz, Delay 0.98ms sampling 8kHz
51  */
52 #define IMU_MPU_LOWPASS_FILTER MPU60X0_DLPF_256HZ
53 #define IMU_MPU_SMPLRT_DIV 3
54 PRINT_CONFIG_MSG("Gyro/Accel output rate is 2kHz at 8kHz internal sampling")
55 #else
56 #error Non-default PERIODIC_FREQUENCY: please define MPU_HMC_LOWPASS_FILTER and MPU_HMC_SMPLRT_DIV.
57 #endif
58 #endif
59 PRINT_CONFIG_VAR(IMU_MPU_LOWPASS_FILTER)
60 PRINT_CONFIG_VAR(IMU_MPU_SMPLRT_DIV)
61 
62 #ifndef IMU_MPU_GYRO_RANGE
63 #define IMU_MPU_GYRO_RANGE MPU60X0_GYRO_RANGE_2000
64 #endif
65 PRINT_CONFIG_VAR(IMU_MPU_GYRO_RANGE)
66 
67 #ifndef IMU_MPU_ACCEL_RANGE
68 #define IMU_MPU_ACCEL_RANGE MPU60X0_ACCEL_RANGE_16G
69 #endif
70 PRINT_CONFIG_VAR(IMU_MPU_ACCEL_RANGE)
71 
72 
74 
75 void imu_impl_init(void)
76 {
77  mpu60x0_spi_init(&imu_mpu_hmc.mpu, &IMU_MPU_SPI_DEV, IMU_MPU_SPI_SLAVE_IDX);
78  // change the default configuration
79  imu_mpu_hmc.mpu.config.smplrt_div = IMU_MPU_SMPLRT_DIV;
80  imu_mpu_hmc.mpu.config.dlpf_cfg = IMU_MPU_LOWPASS_FILTER;
83 
84  /* initialize mag and set default options */
85  hmc58xx_init(&imu_mpu_hmc.hmc, &IMU_HMC_I2C_DEV, HMC58XX_ADDR);
86 }
87 
88 
89 void imu_periodic(void)
90 {
92 
93  /* Read HMC58XX every 10 times of main freq
94  * at ~50Hz (main loop for rotorcraft: 512Hz)
95  */
96  RunOnceEvery(10, hmc58xx_periodic(&imu_mpu_hmc.hmc));
97 }
98 
100 {
101  uint32_t now_ts = get_sys_time_usec();
102 
110  AbiSendMsgIMU_GYRO_INT32(IMU_MPU6000_HMC_ID, now_ts, &imu.gyro);
111  AbiSendMsgIMU_ACCEL_INT32(IMU_MPU6000_HMC_ID, now_ts, &imu.accel);
112  }
113 
114  /* HMC58XX event task */
117  /* mag rotated by 90deg around z axis relative to MPU */
119  imu.mag_unscaled.y = -imu_mpu_hmc.hmc.data.vect.x;
122  imu_scale_mag(&imu);
123  AbiSendMsgIMU_MAG_INT32(IMU_MPU6000_HMC_ID, now_ts, &imu.mag);
124  }
125 }
void mpu60x0_spi_init(struct Mpu60x0_Spi *mpu, struct spi_periph *spi_p, uint8_t slave_idx)
Definition: mpu60x0_spi.c:31
#define IMU_MPU_ACCEL_RANGE
void imu_scale_gyro(struct Imu *_imu)
Definition: ahrs_gx3.c:349
struct Mpu60x0_Spi mpu
void imu_scale_accel(struct Imu *_imu)
Definition: ahrs_gx3.c:350
volatile bool_t data_available
data ready flag
Definition: mpu60x0_spi.h:56
struct Mpu60x0Config config
Definition: mpu60x0_spi.h:67
void mpu60x0_spi_event(struct Mpu60x0_Spi *mpu)
Definition: mpu60x0_spi.c:100
#define VECT3_COPY(_a, _b)
Definition: pprz_algebra.h:139
Main include for ABI (AirBorneInterface).
uint8_t smplrt_div
Sample rate divider.
Definition: mpu60x0.h:74
enum Mpu60x0GyroRanges gyro_range
deg/s Range
Definition: mpu60x0.h:76
union Mpu60x0_Spi::@43 data_accel
enum Mpu60x0AccelRanges accel_range
g Range
Definition: mpu60x0.h:77
struct ImuMpu6000Hmc5883 imu_mpu_hmc
#define IMU_MPU_GYRO_RANGE
void imu_mpu_hmc_event(void)
#define HMC58XX_ADDR
Definition: hmc58xx_regs.h:31
enum Mpu60x0DLPF dlpf_cfg
Digital Low Pass Filter.
Definition: mpu60x0.h:75
#define FALSE
Definition: std.h:5
static uint32_t get_sys_time_usec(void)
Get the time in microseconds since startup.
Definition: sys_time_arch.h:39
Architecture independent SPI (Serial Peripheral Interface) API.
struct Int32Vect3 mag_unscaled
unscaled magnetometer measurements
Definition: imu.h:52
struct Int32Rates gyro_unscaled
unscaled gyroscope measurements
Definition: imu.h:50
struct Int32Vect3 accel
accelerometer measurements in m/s^2 in BFP with INT32_ACCEL_FRAC
Definition: imu.h:43
static void mpu60x0_spi_periodic(struct Mpu60x0_Spi *mpu)
convenience function: read or start configuration if not already initialized
Definition: mpu60x0_spi.h:78
#define IMU_MPU6000_HMC_ID
void imu_impl_init(void)
must be defined by underlying hardware
struct Imu imu
global IMU state
Definition: imu_aspirin2.c:43
unsigned long uint32_t
Definition: types.h:18
PRINT_CONFIG_MSG("USE_INS_NAV_INIT defaulting to TRUE")
struct Int32Vect3 mag
magnetometer measurements scaled to 1 in BFP with INT32_MAG_FRAC
Definition: imu.h:44
Inertial Measurement Unit interface.
volatile bool_t data_available
data ready flag
Definition: hmc58xx.h:65
union Hmc58xx::@33 data
Register defs for Honeywell HMC5843 and HMC5883 magnetometers.
void imu_scale_mag(struct Imu *_imu)
Definition: ahrs_gx3.c:351
static void hmc58xx_periodic(struct Hmc58xx *hmc)
convenience function: read or start configuration if not already initialized
Definition: hmc58xx.h:85
void imu_periodic(void)
optional.
void hmc58xx_init(struct Hmc58xx *hmc, struct i2c_periph *i2c_p, uint8_t addr)
Initialize Hmc58xx struct and set default config options.
Definition: hmc58xx.c:75
union Mpu60x0_Spi::@44 data_rates
struct Int32Vect3 accel_unscaled
unscaled accelerometer measurements
Definition: imu.h:51
#define RATES_COPY(_a, _b)
Definition: pprz_algebra.h:336
void hmc58xx_event(struct Hmc58xx *hmc)
Definition: hmc58xx.c:152
struct Int32Rates gyro
gyroscope measurements in rad/s in BFP with INT32_RATE_FRAC
Definition: imu.h:42