This is the documentation for the latest (main) development branch of Zephyr. If you are looking for the documentation of previous releases, use the drop-down menu on the left and select the desired version.

X-NUCLEO-IKS01A2: shield Standard (Mode 1) sample

Overview

This sample enables all sensors of a X-NUCLEO-IKS01A2 shield, and then periodically reads and displays data from the shield sensors:

  • HTS221: Ambient temperature and relative humidity

  • LPS22HB: Atmospheric pressure and ambient temperature

  • LSM6DSL: 3-Axis Acceleration and 3-Axis Angular Velocity

  • LSM303AGR 3-Axis Acceleration and 3-axis Magnetic field intensity

Requirements

This sample communicates over I2C with the X-NUCLEO-IKS01A2 shield stacked on a board with an Arduino connector. The board’s I2C must be configured for the I2C Arduino connector in the devicetree. See for example the ST Nucleo F401RE board source code:

Please note that this sample can’t be used with boards already supporting one of the sensors available on the shield (such as disco_l475_iot1) as zephyr does not yet support sensors multiple instances.

References

-X-NUCLEO-IKS01A2: http://www.st.com/en/ecosystems/x-nucleo-iks01a2.html

Building and Running

This sample runs with X-NUCLEO-IKS01A2 stacked on any board with a matching Arduino connector. For this example, we use a ST Nucleo F401RE board.

west build -b nucleo_f401re samples/shields/x_nucleo_iks01a2/standard

Sample Output

X-NUCLEO-IKS01A2 sensor dashboard

HTS221: Temperature: 26.3 C
HTS221: Relative Humidity: 44.5%
LPS22HB: Pressure:99.220 kpa
LPS22HB: Temperature: 26.1 C
LSM6DSL: Accel (m.s-2): x: -0.0, y: -0.1, z: 10.0
LSM6DSL: Gyro (dps): x: 0.028, y: -0.025, z: 0.014
LSM303AGR: Accel (m.s-2): x: 0.3, y: -0.1, z: 9.7
LSM303AGR: Magn (gauss): x: -0.221, y: -0.042, z: -0.458

<updated endlessly every 2 seconds>