80 lines
2.4 KiB
ReStructuredText
80 lines
2.4 KiB
ReStructuredText
.. _x-nucleo-iks01a3-std-sample:
|
|
|
|
X-NUCLEO-IKS01A3: shield Standard (Mode 1) sample
|
|
#################################################
|
|
|
|
Overview
|
|
********
|
|
This sample is provided as an example to test the X-NUCLEO-IKS01A3 shield
|
|
configured in Standard mode (Mode 1).
|
|
Please refer to :ref:`x-nucleo-iks01a3` for more info on this configuration.
|
|
|
|
This sample enables all sensors of a X-NUCLEO-IKS01A3 shield, and then
|
|
periodically reads and displays data from the shield sensors:
|
|
|
|
- HTS221: ambient temperature and relative humidity
|
|
- LPS22HH ambient temperature and atmospheric pressure
|
|
- LIS2MDL 3-Axis magnetic field intensity
|
|
- LIS2DW12 3-Axis acceleration
|
|
- LSM6DSO 6-Axis acceleration and angular velocity
|
|
- STTS751 temperature sensor
|
|
|
|
Requirements
|
|
************
|
|
|
|
This sample communicates over I2C with the X-NUCLEO-IKS01A3 shield
|
|
stacked on a board with an Arduino connector. The board's I2C must be
|
|
configured for the I2C Arduino connector (both for pin muxing
|
|
and devicetree). See for example the :ref:`nucleo_f401re_board` board
|
|
source code:
|
|
|
|
- :file:`$ZEPHYR_BASE/boards/arm/nucleo_f401re/nucleo_f401re.dts`
|
|
- :file:`$ZEPHYR_BASE/boards/arm/nucleo_f401re/pinmux.c`
|
|
|
|
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 sensors multiple instances are not supported.
|
|
|
|
References
|
|
**********
|
|
|
|
- X-NUCLEO-IKS01A3: http://www.st.com/en/ecosystems/x-nucleo-iks01a3.html
|
|
|
|
Building and Running
|
|
********************
|
|
|
|
This sample runs with X-NUCLEO-IKS01A3 stacked on any board with a matching
|
|
Arduino connector. For this example, we use a :ref:`nucleo_f401re_board` board.
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/shields/x_nucleo_iks01a3/standard/
|
|
:host-os: unix
|
|
:board: nucleo_f401re
|
|
:goals: build
|
|
:compact:
|
|
|
|
Sample Output
|
|
=============
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
X-NUCLEO-IKS01A3 sensor dashboard
|
|
|
|
HTS221: Temperature: 27.5 C
|
|
HTS221: Relative Humidity: 27.0%
|
|
LPS22HH: Temperature: 27.3 C
|
|
LPS22HH: Pressure:99.150 kpa
|
|
STTS751: Temperature: 27.6 C
|
|
LIS2MDL: Magn (gauss): x: -0.445, y: -0.054, z: -0.066
|
|
LIS2MDL: Temperature: 26.8 C
|
|
LIS2DW12: Accel (m.s-2): x: -0.413, y: 0.077, z: 10.337
|
|
LSM6DSO: Accel (m.s-2): x: 0.133, y: -0.133, z: 10.102
|
|
LSM6DSO: GYro (dps): x: 0.000, y: -0.006, z: -0.058
|
|
1:: lis2mdl trig 208
|
|
1:: lps22hh trig 214
|
|
1:: lsm6dso acc trig 426
|
|
1:: lsm6dso gyr trig 426
|
|
|
|
<updated endlessly every 2 seconds>
|