Paparazzi UAS  v5.14.0_stable-0-g3f680d1
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 IMU_MPU_LOWPASS_FILTER and IMU_MPU_SMPLRT_DIV.
57 #endif
58 #endif
59 PRINT_CONFIG_VAR(IMU_MPU_LOWPASS_FILTER)
60 PRINT_CONFIG_VAR(IMU_MPU_SMPLRT_DIV)
61 
62 PRINT_CONFIG_VAR(IMU_MPU_GYRO_RANGE)
63 PRINT_CONFIG_VAR(IMU_MPU_ACCEL_RANGE)
64 
65 // Default channels order
66 #ifndef IMU_MPU_CHAN_X
67 #define IMU_MPU_CHAN_X 0
68 #endif
69 PRINT_CONFIG_VAR(IMU_MPU_CHAN_X)
70 #ifndef IMU_MPU_CHAN_Y
71 #define IMU_MPU_CHAN_Y 1
72 #endif
73 PRINT_CONFIG_VAR(IMU_MPU_CHAN_Y)
74 #ifndef IMU_MPU_CHAN_Z
75 #define IMU_MPU_CHAN_Z 2
76 #endif
77 PRINT_CONFIG_VAR(IMU_MPU_CHAN_Z)
78 
79 #ifndef IMU_MPU_X_SIGN
80 #define IMU_MPU_X_SIGN 1
81 #endif
82 PRINT_CONFIG_VAR(IMU_MPU_X_SIGN)
83 #ifndef IMU_MPU_Y_SIGN
84 #define IMU_MPU_Y_SIGN 1
85 #endif
86 PRINT_CONFIG_VAR(IMU_MPU_Y_SIGN)
87 #ifndef IMU_MPU_Z_SIGN
88 #define IMU_MPU_Z_SIGN 1
89 #endif
90 PRINT_CONFIG_VAR(IMU_MPU_Z_SIGN)
91 
92 /* mag by default rotated by 90deg around z axis relative to MPU */
93 #ifndef IMU_HMC_CHAN_X
94 #define IMU_HMC_CHAN_X 1
95 #endif
96 PRINT_CONFIG_VAR(IMU_HMC_CHAN_X)
97 #ifndef IMU_HMC_CHAN_Y
98 #define IMU_HMC_CHAN_Y 0
99 #endif
100 PRINT_CONFIG_VAR(IMU_HMC_CHAN_Y)
101 #ifndef IMU_HMC_CHAN_Z
102 #define IMU_HMC_CHAN_Z 2
103 #endif
104 PRINT_CONFIG_VAR(IMU_HMC_CHAN_Z)
105 
106 #ifndef IMU_HMC_X_SIGN
107 #define IMU_HMC_X_SIGN 1
108 #endif
109 PRINT_CONFIG_VAR(IMU_HMC_X_SIGN)
110 #ifndef IMU_HMC_Y_SIGN
111 #define IMU_HMC_Y_SIGN -1
112 #endif
113 PRINT_CONFIG_VAR(IMU_HMC_Y_SIGN)
114 #ifndef IMU_HMC_Z_SIGN
115 #define IMU_HMC_Z_SIGN 1
116 #endif
117 PRINT_CONFIG_VAR(IMU_HMC_Z_SIGN)
118 
119 
121 
123 {
124  mpu60x0_spi_init(&imu_mpu_hmc.mpu, &IMU_MPU_SPI_DEV, IMU_MPU_SPI_SLAVE_IDX);
125  // change the default configuration
126  imu_mpu_hmc.mpu.config.smplrt_div = IMU_MPU_SMPLRT_DIV;
127  imu_mpu_hmc.mpu.config.dlpf_cfg = IMU_MPU_LOWPASS_FILTER;
128  imu_mpu_hmc.mpu.config.gyro_range = IMU_MPU_GYRO_RANGE;
130 
131  /* initialize mag and set default options */
132  hmc58xx_init(&imu_mpu_hmc.hmc, &IMU_HMC_I2C_DEV, HMC58XX_ADDR);
133 }
134 
135 
137 {
139 
140  /* Read HMC58XX every 10 times of main freq
141  * at ~50Hz (main loop for rotorcraft: 512Hz)
142  */
143  RunOnceEvery(10, hmc58xx_periodic(&imu_mpu_hmc.hmc));
144 }
145 
147 {
148  uint32_t now_ts = get_sys_time_usec();
149 
152  // set channel order
153  struct Int32Vect3 accel = {
157  };
158  struct Int32Rates rates = {
162  };
163  // unscaled vector
164  VECT3_COPY(imu.accel_unscaled, accel);
165  RATES_COPY(imu.gyro_unscaled, rates);
166 
170  AbiSendMsgIMU_GYRO_INT32(IMU_MPU6000_HMC_ID, now_ts, &imu.gyro);
171  AbiSendMsgIMU_ACCEL_INT32(IMU_MPU6000_HMC_ID, now_ts, &imu.accel);
172  }
173 
174  /* HMC58XX event task */
177  /* mag by default rotated by 90deg around z axis relative to MPU */
182  imu_scale_mag(&imu);
183  AbiSendMsgIMU_MAG_INT32(IMU_MPU6000_HMC_ID, now_ts, &imu.mag);
184  }
185 }
angular rates
void mpu60x0_spi_init(struct Mpu60x0_Spi *mpu, struct spi_periph *spi_p, uint8_t slave_idx)
Definition: mpu60x0_spi.c:31
volatile bool data_available
data ready flag
Definition: hmc58xx.h:65
#define IMU_HMC_CHAN_X
#define IMU_MPU_X_SIGN
#define IMU_HMC_Z_SIGN
#define IMU_MPU_CHAN_Z
struct Mpu60x0_Spi mpu
struct Mpu60x0Config config
Definition: mpu60x0_spi.h:67
void mpu60x0_spi_event(struct Mpu60x0_Spi *mpu)
Definition: mpu60x0_spi.c:110
#define VECT3_COPY(_a, _b)
Definition: pprz_algebra.h:140
Main include for ABI (AirBorneInterface).
uint8_t smplrt_div
Sample rate divider.
Definition: mpu60x0.h:125
#define IMU_HMC_CHAN_Y
struct Imu imu
global IMU state
Definition: imu.c:108
enum Mpu60x0GyroRanges gyro_range
deg/s Range
Definition: mpu60x0.h:127
union Hmc58xx::@303 data
enum Mpu60x0AccelRanges accel_range
g Range
Definition: mpu60x0.h:128
struct ImuMpu6000Hmc5883 imu_mpu_hmc
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:126
Architecture independent SPI (Serial Peripheral Interface) API.
struct Int32Vect3 mag_unscaled
unscaled magnetometer measurements
Definition: imu.h:48
struct Int32Rates gyro_unscaled
unscaled gyroscope measurements
Definition: imu.h:46
struct Int32Vect3 accel
accelerometer measurements in m/s^2 in BFP with INT32_ACCEL_FRAC
Definition: imu.h:39
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_MPU_Z_SIGN
#define IMU_MPU6000_HMC_ID
#define IMU_MPU_CHAN_Y
#define IMU_HMC_Y_SIGN
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:40
Inertial Measurement Unit interface.
void imu_scale_gyro(struct Imu *_imu)
Definition: imu_vectornav.c:43
signed long int32_t
Definition: types.h:19
volatile bool data_available
data ready flag
Definition: mpu60x0_spi.h:56
Register defs for Honeywell HMC5843 and HMC5883 magnetometers.
union Mpu60x0_Spi::@316 data_rates
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
union Mpu60x0_Spi::@315 data_accel
#define IMU_HMC_CHAN_Z
void imu_mpu_hmc_periodic(void)
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
struct Int32Vect3 accel_unscaled
unscaled accelerometer measurements
Definition: imu.h:47
void imu_mpu_hmc_init(void)
#define IMU_MPU_GYRO_RANGE
Definition: imu_mpu6000.h:37
void imu_scale_accel(struct Imu *_imu)
Definition: imu_vectornav.c:44
#define RATES_COPY(_a, _b)
Definition: pprz_algebra.h:337
#define IMU_MPU_Y_SIGN
uint32_t get_sys_time_usec(void)
Get the time in microseconds since startup.
Definition: sys_time_arch.c:68
#define IMU_MPU_ACCEL_RANGE
Definition: imu_mpu6000.h:41
void hmc58xx_event(struct Hmc58xx *hmc)
Definition: hmc58xx.c:152
#define IMU_HMC_X_SIGN
#define IMU_MPU_CHAN_X
struct Int32Rates gyro
gyroscope measurements in rad/s in BFP with INT32_RATE_FRAC
Definition: imu.h:38