nanoFramework.Iot.Device.Mpu9250 1.2.704

Prefix Reserved
dotnet add package nanoFramework.Iot.Device.Mpu9250 --version 1.2.704                
NuGet\Install-Package nanoFramework.Iot.Device.Mpu9250 -Version 1.2.704                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="nanoFramework.Iot.Device.Mpu9250" Version="1.2.704" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add nanoFramework.Iot.Device.Mpu9250 --version 1.2.704                
#r "nuget: nanoFramework.Iot.Device.Mpu9250, 1.2.704"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install nanoFramework.Iot.Device.Mpu9250 as a Cake Addin
#addin nuget:?package=nanoFramework.Iot.Device.Mpu9250&version=1.2.704

// Install nanoFramework.Iot.Device.Mpu9250 as a Cake Tool
#tool nuget:?package=nanoFramework.Iot.Device.Mpu9250&version=1.2.704                

MPU6050/MPU6500/MPU9250 - Gyroscope, Accelerometer, Temperature and Magnetometer (MPU9250 only)

MPU6050/MPU6500 are 3 axis Gyroscope, 3 axis Accelerometer and Temperature sensors that can be accessed either thru I2C or SPI. This implementation is only for I2C. The sensor can be found in various implementation but its main usage is in the MPU9250.

MPU9250 is a 3 axis Gyroscope, 3 axis Accelerometer, 3 axis Magnetometer and Temperature sensor that can be accessed either thru I2C or SPI. This implementation is only for I2C. The sensor can be found in various implementation like Grove or Sparkfun. MPU9250 incorporate a MPU6500 and an AK8963.

The Magnetometer used is an AK8963. In general, it is managed thru the main MPU9250 and setup as a replica I2C. All operations go thru the MPU9250. In some cases, the AK8963 is exposed and the operations are not going thru the MPU9250 but directly.

Documentation

Usage

Important: make sure you properly setup the I2C pins especially for ESP32 before creating the I2cDevice, make sure you install the nanoFramework.Hardware.ESP32 nuget:

//////////////////////////////////////////////////////////////////////
// when connecting to an ESP32 device, need to configure the I2C GPIOs
// used for the bus
Configuration.SetPinFunction(21, DeviceFunction.I2C1_DATA);
Configuration.SetPinFunction(22, DeviceFunction.I2C1_CLOCK);

For other devices like STM32, please make sure you're using the preset pins for the I2C bus you want to use.

General case with AK8963 is not exposed (where you can't find it on the I2C bus at the address 0x0C)

var mpui2CConnectionSettingmpus = new I2cConnectionSettings(1, Mpu9250.DefaultI2cAddress);
Mpu9250 mpu9250 = new Mpu9250(I2cDevice.Create(mpui2CConnectionSettingmpus));

In case the AK8963 is exposed, so you can reach it directly, you can then use the following code:

var mpui2CConnectionSettingmpus = new I2cConnectionSettings(1, Mpu9250.DefaultI2cAddress);
using Mpu9250 mpu9250 = new Mpu9250(I2cDevice.Create(mpui2CConnectionSettingmpus), i2CDeviceAk8963: I2cDevice.Create(new I2cConnectionSettings(1, Ak8963.DefaultI2cAddress)));

You can find an example in the sample directory. Usage is straightforward including the possibility to have a calibration for all sub sensors.

var mpui2CConnectionSettingmpus = new I2cConnectionSettings(1, Mpu9250.DefaultI2cAddress);
Mpu9250 mpu9250 = new Mpu9250(I2cDevice.Create(mpui2CConnectionSettingmpus));
var gyro = mpu9250.GetGyroscope();
Debug.WriteLine($"Gyro X = {gyro.X, 15}");
Debug.WriteLine($"Gyro Y = {gyro.Y, 15}");
Debug.WriteLine($"Gyro Z = {gyro.Z, 15}");
var acc = mpu9250.GetAccelerometer();
Debug.WriteLine($"Acc X = {acc.X, 15}");
Debug.WriteLine($"Acc Y = {acc.Y, 15}");
Debug.WriteLine($"Acc Z = {acc.Z, 15}");
Debug.WriteLine($"Temp = {mpu9250.Temperature.Celsius.ToString("0.00")} °C");
var magne = mpu9250.ReadMagnetometer(true);
Debug.WriteLine($"Mag X = {magne.X, 15}");
Debug.WriteLine($"Mag Y = {magne.Y, 15}");
Debug.WriteLine($"Mag Z = {magne.Z, 15}");

Self-test

A self-test is available for the gyroscope and the accelerometer.

var resSelfTest = mpu9250.RunGyroscopeAccelerometerSelfTest();
Debug.WriteLine($"Self test:");
Debug.WriteLine($"Gyro X = {resSelfTest.Item1.X} vs >0.005");
Debug.WriteLine($"Gyro Y = {resSelfTest.Item1.Y} vs >0.005");
Debug.WriteLine($"Gyro Z = {resSelfTest.Item1.Z} vs >0.005");
Debug.WriteLine($"Acc X = {resSelfTest.Item2.X} vs >0.005 & <0.015");
Debug.WriteLine($"Acc Y = {resSelfTest.Item2.Y} vs >0.005 & <0.015");
Debug.WriteLine($"Acc Z = {resSelfTest.Item2.Z} vs >0.005 & <0.015");

The returned data are the raw data and allows you to estimate the quality of the test. The first item of the tuple is the gyroscope and the second one the accelerometer.

No self-test is available for the magnetometer.

Calibration and bias

You can calibrate the Gyroscope and the Accelerometer at the same time. This action is as well correcting the registers directly in the MPU9250 chip. Those data are lost in case of power stop but stays in case of soft reset.

Debug.WriteLine("Running Gyroscope and Accelerometer calibration");
mpu9250.CalibrateGyroscopeAccelerometer();
Debug.WriteLine("Calibration results:");
Debug.WriteLine($"Gyro X bias = {mpu9250.GyroscopeBias.X}");
Debug.WriteLine($"Gyro Y bias = {mpu9250.GyroscopeBias.Y}");
Debug.WriteLine($"Gyro Z bias = {mpu9250.GyroscopeBias.Z}");
Debug.WriteLine($"Acc X bias = {mpu9250.AccelerometerBias.X}");
Debug.WriteLine($"Acc Y bias = {mpu9250.AccelerometerBias.Y}");
Debug.WriteLine($"Acc Z bias = {mpu9250.AccelerometerBias.Z}");

Calibration is as well available for the magnetometer (the AK8963). For this sensor.

Debug.WriteLine("Magnetometer calibration is taking couple of seconds, please be patient!");
Debug.WriteLine("Please make sure you are not close to any magnetic field like magnet or phone. Move the sensor in all possible directions");
var mag = mpu9250.CalibrateMagnetometer();
Debug.WriteLine($"Correction factor bias:");
Debug.WriteLine($"Mag X = {mpu9250.MagnometerBias.X}");
Debug.WriteLine($"Mag Y = {mpu9250.MagnometerBias.Y}");
Debug.WriteLine($"Mag Z = {mpu9250.MagnometerBias.Z}");

See AK8963 calibration for more information on how Magnetometer calibration is working. Please note that you have a full code sample to read and save data in a file to go deeper into the Magnetometer calibration.

Note: AK8963 calibration must be performed before other calibrations and before using any other part of the sensors.

Units

Al axis are oriented this way: +Z +Y \ | / \ | / |/ /|
/ |
/ |
+X

Gyroscope

The unit used for the gyroscope are degree per seconds.

Accelerometer

The unit used for the accelerometer is G.

Magnetometer

The unit used for the magnetometer is µTesla.

Temperature

The Temperature is a normalized Units.Temperature which can provide Celsius, Kelvin or Fahrenheit degrees.

Measurement modes

The MPU9250 offers a large variety of measurement modes. They can be changed and adjusted thru the properties like:

  • MagnetometerMeasurementMode to adjust the type of measurement for the magnetometer
  • MagnetometerOutputBitMode to select between 14 and 16 bits precision of the magnetometer
  • AccelerometerRange to adjust the range of the accelerometer between 2, 4, 8 or 16 G
  • AccelerometionScale to adjust the frequency of measurement from 5 Hz to 1130 Hz
  • GyroscopeRange to adjust the range of the gyroscope from 250, 500, 1000 and 2000 degrees per second
  • GyroscopeScale to adjust the frequency of measurement from 5 Hz to 8800 Hz
  • SampleRateDivider allows you to reduce the number of samples for the gyroscope and the accelerometer. This feature is only available for some of the bandwidth modes.
  • DisableModes allows you to disable any of the gyroscope and accelerometer axis

Wake on motion

A unique SetWakeOnMotion mode is available. It puts the MPU9250 in a low consumption, low measurement rate mode and trigger an interruption on the INT pin.

mpu9250.SetWakeOnMotion(300, AccelerometerLowPowerFrequency.Frequency0Dot24Hz);
// You'll need to attach the INT pin to a GPIO and read the level. Once going up, you have
// some data and the sensor is awake
// In order to simulate this without a GPIO pin, you will see that the refresh rate is very low
// Setup here at 0.24Hz which means, about every 4 seconds

while (true)
{
    var acc = mpu9250.GetAccelerometer();
    Debug.WriteLine($"Acc X = {acc.X, 15}");
    Debug.WriteLine($"Acc Y = {acc.Y, 15}");
    Debug.WriteLine($"Acc Z = {acc.Z, 15}");
    Thread.Sleep(100);
}

FIFO mode

The Fifo mode allows you to get the data by batch. You can select the mode thru FifoModes, then read the FifoCount property. You can then read the data thru ReadFifo Make sure you'll size the Span<byte> with FifoCount length.

Data are in the order of the Register from 0x3B to 0x60 so you'll get your data in this order:

  • ACCEL_XOUT_H and ACCEL_XOUT_L
  • ACCEL_YOUT_H and ACCEL_YOUT_L
  • ACCEL_ZOUT_H and ACCEL_ZOUT_L
  • TEMP_OUT_H and TEMP_OUT_L
  • GYRO_XOUT_H and GYRO_XOUT_L
  • GYRO_YOUT_H and GYRO_YOUT_L
  • GYRO_ZOUT_H and GYRO_ZOUT_L
  • EXT_SENS_DATA_00 to EXT_SENS_DATA_24

It is then up to you to transform them into the correct data. You can multiply your raw data by AccelerometionScale and GyroscopeScale to convert them properly.

I2C replica primitives

2 primitive functions allow to read and write any register in any of the replica devices.

  • I2cWrite(I2cChannel i2cChannel, byte address, byte register, byte data)
    • i2cChannel: The replica channel to attached to the I2C device
    • address: The I2C address of the replica I2C element
    • register: The register to write to the replica I2C element
    • data: The byte data to write to the replica I2C element
  • I2cRead(I2cChannel i2cChannel, byte address, byte register, SpanByte readBytes)
    • i2cChannel: The replica channel to attached to the I2C device
    • address: The I2C address of the replica I2C element
    • register: The register to write to the replica I2C element
    • readBytes: The read data

Circuit

The following fritzing diagram illustrates one way to wire up the MPU9250 with a MCU like ESP32 using I2C.

ESP32 Breadboard diagram

Product Compatible and additional computed target framework versions.
.NET Framework net is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.2.704 41 12/18/2024
1.2.696 64 12/16/2024
1.2.673 93 10/23/2024
1.2.662 96 10/11/2024
1.2.656 92 10/3/2024
1.2.639 119 9/6/2024
1.2.631 94 8/28/2024
1.2.613 119 8/9/2024
1.2.601 87 7/26/2024
1.2.590 102 7/17/2024
1.2.573 113 6/19/2024
1.2.570 96 6/14/2024
1.2.536 128 4/15/2024
1.2.514 126 3/22/2024
1.2.494 134 2/28/2024
1.2.462 189 1/5/2024
1.2.458 134 12/20/2023
1.2.436 196 11/10/2023
1.2.416 141 11/8/2023
1.2.403 166 10/6/2023
1.2.396 146 9/27/2023
1.2.384 181 9/6/2023
1.2.378 180 8/16/2023
1.2.369 213 8/2/2023
1.2.363 171 7/28/2023
1.2.357 191 7/19/2023
1.2.354 186 7/14/2023
1.2.345 191 6/21/2023
1.2.341 189 6/14/2023
1.2.337 202 6/7/2023
1.2.335 192 6/2/2023
1.2.329 186 5/26/2023
1.2.313 188 5/12/2023
1.2.302 194 5/10/2023
1.2.297 164 5/3/2023
1.2.273 255 3/17/2023
1.2.267 298 3/10/2023
1.2.263 299 3/8/2023
1.2.259 310 2/27/2023
1.2.256 296 2/24/2023
1.2.253 312 2/22/2023
1.2.222 365 1/9/2023
1.2.217 349 1/6/2023
1.2.212 348 1/5/2023
1.2.208 355 1/3/2023
1.2.203 368 12/28/2022
1.2.159 442 11/14/2022
1.2.153 430 11/5/2022
1.2.141 443 10/25/2022
1.2.128 438 10/22/2022
1.2.110 430 10/7/2022
1.2.87 551 9/15/2022
1.2.63 466 9/3/2022
1.2.47 445 8/15/2022
1.2.40 469 8/6/2022
1.2.38 455 8/5/2022
1.2.28 483 8/1/2022
1.2.13 480 7/24/2022
1.2.10 453 7/23/2022
1.1.142.3202 498 7/7/2022
1.1.133.52556 497 6/30/2022
1.1.121.35854 527 6/26/2022
1.1.116.8772 495 6/24/2022
1.1.113.2032 487 6/23/2022
1.1.102.51394 486 6/15/2022
1.1.99.36719 476 6/14/2022
1.1.97.17326 466 6/13/2022
1.1.92.53000 475 6/8/2022
1.1.72.29765 510 5/31/2022
1.1.64.21380 495 5/26/2022
1.1.58.10097 509 5/23/2022
1.1.54.28879 526 5/23/2022
1.1.40 507 5/5/2022
1.1.3 517 4/15/2022
1.1.1 502 4/14/2022
1.0.300 498 3/31/2022
1.0.288-preview.114 134 3/25/2022
1.0.288-preview.113 122 3/25/2022
1.0.288-preview.106 124 3/23/2022
1.0.288-preview.104 109 3/22/2022
1.0.288-preview.103 114 3/21/2022
1.0.288-preview.100 121 3/19/2022
1.0.288-preview.98 117 3/18/2022
1.0.288-preview.95 131 3/15/2022
1.0.288-preview.93 124 3/15/2022
1.0.288-preview.87 127 3/10/2022
1.0.288-preview.86 125 3/8/2022
1.0.288-preview.77 130 2/27/2022
1.0.288-preview.75 118 2/26/2022
1.0.288-preview.65 123 2/18/2022
1.0.288-preview.63 119 2/16/2022
1.0.288-preview.61 123 2/12/2022
1.0.288-preview.58 122 2/10/2022
1.0.288-preview.53 122 2/9/2022
1.0.288-preview.48 139 2/4/2022
1.0.288-preview.41 133 1/31/2022
1.0.288-preview.29 136 1/28/2022
1.0.288-preview.20 140 1/27/2022
1.0.288-preview.18 137 1/27/2022
1.0.288-preview.5 138 1/24/2022
1.0.272 538 1/10/2022
1.0.259 376 12/9/2021
1.0.258 340 12/7/2021
1.0.155 389 8/31/2021
1.0.130 169 7/6/2021
1.0.129 168 7/6/2021
1.0.125 202 7/5/2021
1.0.121 207 6/29/2021
1.0.119 232 6/28/2021
1.0.56 218 5/25/2021