MKR IMU Shield Basics

Learn the basics to get started with the MKR IMU Shield.


The IMU shield is a great addition to any of your MKR family boards. It comes equipped with the BNO055 absolute orientation sensor, developed by Bosch.

We will create a simple sketch using the accelerometer, where we will first do a reading on the sensor, and then find a specific threshold that will activate something when reached.


The goals of this project are:

  • Record data from the accelerometer.
  • Print out the data in the Serial Monitor.
  • Create a trigger when a certain axis reaches a specific range.

Hardware & Software Needed


An accelerometer is an electromechanical device used to measure acceleration forces. Such forces may be static, like the continuous force of gravity or, as is the case with many mobile devices, dynamic to sense movement or vibrations.

It is an excellent sensor for projects involving wearables, or projects that feature something that is in the air. In fact, every airborne machine such as airplanes, drones or helicopters have a similar sensors to calculate their orientation.

How an accelerometer works.
How an accelerometer works.

The accelerometer uses the x, y and z coordinates. For example, they can be used to detect acceleration (if we quickly shake the component back and forth, there will be change in the values) but are also commonly used for measuring vibration, such as earthquakes.


The circuit in this tutorial is very easy. Simply mount the MKR IMU Shield on top of an Arduino MKR board.

Simple circuit with board and shield.
Simple circuit with board and shield.

Programming the Board

We will now get to the programming part of this tutorial.

1. First, let's make sure we have the drivers installed for the board we are using. If we are using the Web Editor, we do not need to install anything. If we are using an offline editor, we need to install it manually. This can be done by navigating to Tools > Board > Board Manager.... Here we need to look for the Arduino SAMD boards (32-bits ARM Cortex M0+) and install it.

2. Now, we need to install the libraries needed. If we are using the Web Editor, there is no need to install anything. If we are using an offline editor, simply go to Tools > Manage libraries.., and search for MKRIMU and install it.

3. Here are some of the core functions of this sketch:

  • IMU.begin()
    - initializes the library.
  • IMU.accelerationSampleRate()
    - reads the sampling rate in Hz.
  • IMU.accelerationAvailable()
    - checks if there's data available from the IMU.
  • IMU.readAcceleration(x, y, z)
    - reads the accelerometer, and returns the value of the x, y and z axis.

The sketch can be found in the snippet below. Upload the sketch to the board.

1#include <MKRIMU.h>
3void setup() {
4 Serial.begin(9600);
5 while (!Serial);
7 if (!IMU.begin()) {
8 Serial.println("Failed to initialize IMU!");
10 while (1);
11 }
13 Serial.print("Accelerometer sample rate = ");
14 Serial.print(IMU.accelerationSampleRate());
15 Serial.println(" Hz");
16 Serial.println();
17 Serial.println("Acceleration in G's");
18 Serial.println("X\tY\tZ");
21void loop() {
22 float x, y, z;
24 if (IMU.accelerationAvailable()) {
25 IMU.readAcceleration(x, y, z);
27 Serial.print(x);
28 Serial.print('\t');
29 Serial.print(y);
30 Serial.print('\t');
31 Serial.println(z);
33 if (x > 0.9 || x < -0.9) {
34 Serial.println("X threshold met");
35 delay(1000);
36 }
37 if (y > 0.9 || y < -0.9) {
38 Serial.println("Y threshold met");
39 delay(1000);
40 }
41 if (z > 0.9 || z < -0.9) {
42 Serial.println("Z threshold met");
43 delay(1000);
44 }
45 }
46 delay(500);

Testing It Out

After we have uploaded the code to the board, open the Serial Monitor to initialize the program. When we open it, the x, y and z values will be printed every 0.5 seconds (due to the 500 millisecond delay in the code).

When X, Y or Z thresholds are met, print it.
When X, Y or Z thresholds are met, print it.

The way this program works is that when a threshold is met (either x, y or z), we print something specific in the Serial Monitor. In this example, we simply print a string in the Serial Monitor.

For example, when the value of

is larger than 0.9 or smaller than -0.9, the condition is met, and
"Z threshold met"
is printed.

10.05 -0.05 0.98
2Z threshold met

This certain threshold is met when the board lies flat on a table, where as if it facing up, the

value will be around
, and if upside down, it will be close to

You can now test out the board by moving it around, and notice how both the

values change and trigger their own conditionals.


If the code is not working, there are some common issues we can troubleshoot:

  • We have not installed the core for the board we are using (a MKR family board is required).
  • We have not installed the MKRIMU library.
  • We have mounted the shield the wrong way around. Check that the pins on the board are aligned with the pins on the shield.


In this tutorial we have tested out the accelerometer on the MKR IMU Shield together with a MKR family board. The shield is a great start for any project involving the use of IMUs, and hopefully this tutorial helped you get started with your own IMU project.

Feel free to explore the MKRIMU library further, and try out some of the many cool functions.