zephyrproject-rtos/zephyr
0
0
Fork 0
mirror of https://github.com/zephyrproject-rtos/zephyr synced 2025-08-08 02:25:25 +00:00
Code Issues Packages Projects Releases Wiki Activity
407b49b35c
zephyr/samples/shields/x_nucleo_iks01a3/standard
History
Torsten Rasmussen 407b49b35c cmake: use find_package to locate Zephyr 
Using find_package to locate Zephyr.

Old behavior was to use $ENV{ZEPHYR_BASE} for inclusion of boiler plate
code.

Whenever an automatic run of CMake happend by the build system / IDE
then it was required that ZEPHYR_BASE was defined.
Using ZEPHYR_BASE only to locate the Zephyr package allows CMake to
cache the base variable and thus allowing subsequent invocation even
if ZEPHYR_BASE is not set in the environment.

It also removes the risk of strange build results if a user switchs
between different Zephyr based project folders and forgetting to reset
ZEPHYR_BASE before running ninja / make.

Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
2020-03-27 16:23:46 +01:00
..
src treewide: use full path to sensor.h header 2020-01-26 17:52:12 +01:00
CMakeLists.txt cmake: use find_package to locate Zephyr 2020-03-27 16:23:46 +01:00
prj.conf drivers/i2c: Kconfig.stm32: Enable interrupts usage by default 2020-01-24 21:34:45 -05:00
README.rst doc: s/device tree/devicetree/ 2019-10-08 11:53:40 +02:00
sample.yaml tests: remove duplicate names for tests 2020-02-13 14:45:56 -06:00

README.rst 

.. _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>