boards/shields/x_nucleo_iks4a1/doc/index.rst
.. _x-nucleo-iks4a1:
X-NUCLEO-IKS4A1: MEMS Inertial and Environmental Multi sensor shield ####################################################################
Overview
The X-NUCLEO-IKS4A1 is a motion MEMS and environmental sensor expansion board for the STM32 Nucleo. It is equipped with Arduino UNO R3 connector layout, and allows application development with features like sensor HUB (LSM6DSO16IS and LSM6DSV16X), camera module integration and Qvar touch/swipe gestures (thanks to the equipped electrode).
.. image:: img/x-nucleo-iks4a1.jpg :align: center :alt: X-NUCLEO-IKS4A1
More general information about the board can be found at the
X-NUCLEO-IKS4A1 website_.
Hardware Description
X-NUCLEO-IKS4A1 provides the following key features:
Hardware Configuration
X-NUCLEO-IKS4A1 board can be configured in five different modes, which can be
selected through J4 and J5 jumpers. Additional information about X-NUCLEO-IKS4A1
configuration modes and how sensors are connected together can be found in the
X-NUCLEO-IKS4A1 user manual_
.. _x-nucleo-iks4a1-mode-1:
In standard I2C mode, all devices are connected to an external main board via the same I2C bus.
The board configuration is:
.. _x-nucleo-iks4a1-mode-2:
In this sensor hub I2C mode, it is possible to power-up the 6-axes IMU (Inertial Measurement Unit) functionalities by collecting external data through a direct control of the on-board environmental sensors (temperature, pressure and magnetometer) and external sensor (DIL24) through the auxiliary I2Cz bus "SENS_I2C". LSM6DSV16X, LIS2DUXS12 and SHT40AD1B remains connected to the main bus "uC_I2C" coming from the external board.
The board configuration is:
.. _x-nucleo-iks4a1-mode-3:
In this sensor hub, it is possible to power-up the 6-axes IMU (Inertial Measurement Unit) functionalities by collecting external data through a direct control of the on-board environmental sensors (temperature, pressure and magnetometer) and external sensor (DIL24) through the auxiliary I2C bus "SENS_I2C". LSM6DSO16IS, LIS2DUXS12 and SHT40AD1B remains connected to the main bus "uC_I2C" coming from the external board.
The board configuration is:
In case a sensor with sensor hub embedded functionality is mounted to the board through DIL24 adapter, it is possible to exploit this functionality as for LSM6DSO16IS and the LSM6DSV16X. In this configuration, may be necessary to connect the DIL24 to the external board through SPI lines in order to avoid an address conflict on I2C bus with the LSM6DSO16IS and the LSM6DSV16X. This is done by changing the SBx configuration.
The board configuration is:
In this configuration, it is possible to use the equipped Qvar swipe electrode (by plugging it on JP6 and JP7 connectors) through the LSM6DSO16IS.
The board configuration is:
Devicetree Overlays
There are three predefined DT overlays in the board:
boards/shields/x_nucleo_iks4a1/x_nucleo_iks4a1.overlay
This overlay describes sensor connections (and matching h/w configuration to be done)
as explained in Standard Mode (:ref:x-nucleo-iks4a1-mode-1)boards/shields/x_nucleo_iks4a1/x_nucleo_iks4a1_shub1.overlay
This overlay describes sensor connections (and matching h/w configuration to be done)
as explained in SHUB1 Mode (:ref:x-nucleo-iks4a1-mode-3)boards/shields/x_nucleo_iks4a1/x_nucleo_iks4a1_shub2.overlay
This overlay describes sensor connections (and matching h/w configuration to be done)
as explained in SHUB2 Mode (:ref:x-nucleo-iks4a1-mode-2)Examples
Three samples are provided as examples for x-nucleo-iks4a1 shield, each one associated
with one of the overlays described above:
x-nucleo-iks4a1-std-sample application, to be used when the shield is configured
in Standard Mode (Mode 1)x-nucleo-iks4a1-shub1-sample application, to be used when the shield is configured
in SHUB1 Mode (Mode 3)x-nucleo-iks4a1-shub2-sample application, to be used when the shield is configured
in SHUB2 Mode (Mode 2)See also :ref:shields for more details.
.. _X-NUCLEO-IKS4A1 website: http://www.st.com/en/ecosystems/x-nucleo-iks4a1.html
.. _X-NUCLEO-IKS4A1 user manual: https://www.st.com/resource/en/user_manual/um3239-getting-started-with-the-xnucleoiks4a1-motion-mems-and-environmental-sensor-expansion-board-for-stm32-nucleo-stmicroelectronics.pdf