bno055 0.1.1

Bosch Sensortec BNO055 9-axis IMU driver
Documentation

Bosch Sensortec BNO055 embedded-hal driver

What is this?

This is a embedded-hal driver for Bosch's inertial measurement unit (IMU) BNO055.

It is device-agnostic and uses I2c and Delay embedded-hal traits for its operation.

Uses and re-exports nalgebra's Quaternion for quaternion reading and Rotation3 for Euler angles.

Usage

  1. Add dependency to Cargo.toml:

    cargo add bno055

  2. Instantiate and init the device:

    // ... declare and configure your I2c and Delay implementations ...

// Init BNO055 IMU
let imu = bno055::Bno055::new(i2c, delay);

imu.init()?;

// Enable 9-degrees-of-freedom sensor fusion mode with fast magnetometer calibration
imu.set_mode(bno055::BNO055OperationMode::NDOF)?;

Ok(imu)

  3. Read orientation data: quaternion or euler angles (roll, pitch, yaw/heading)

    let quat = imu.quaternion()?;
// or:
let euler = imu.euler_angles()?;

Setup details

Remapping axes to correspond your mounting

BNO055 allows to change default axes to meet chip orientation with actual physical device orientation, thus providing possibility to place BNO055 chip on PCB as suitable for designer and to match chip's axes to and physical axes in software later.

use bno055::{AxisRemap, BNO055AxisConfig};
// ...

// Build remap configuration example with X and Y axes swapped:
let remap = AxisRemap::builder()
    .swap_x_with(BNO055AxisConfig::AXIS_AS_Y)
    .build()
    .expect("Failed to build axis remap config");
    
bno055.set_axis_remap(remap)?;

Please note that AxisRemap (and the chip itself) builder doesn't allow invalid state to be constructed, that is, when one axis is swapped with multiple of others. For example, swapping axis X with both Y and Z at the same time is not allowed:

AxisRemap::builder()
    .swap_x_with(BNO055AxisConfig::AXIS_AS_Y)
    .swap_x_with(BNO055AxisConfig::AXIS_AS_Z)
    .build()
    .unwrap(); // <- panics, .build() returned Err

Using external 32k crystal

For better performance, it is advised to connect and use external 32k quartz crystal.

User could enable or disable it by calling set_external_crystal:

bno055
    .set_external_crystal(true)
    .expect("Failed to set to external crystal");

Status

What is done and tested and what is not yet:

  • Sensor initialization
  • Device mode setup
  • Device status readout
  • Calibration status readout
  • External crystal selection
  • Axis remap
  • Axis sign change
  • Calibration data readout
  • Calibration data setup
  • Orientation data readout
    • Quaternions
    • Euler angles
    • Raw accelerometer data readout
    • Raw gyroscope data readout
    • Raw magnetometer data readout