From 196997439bccb116081d5b563603be48944e6bff Mon Sep 17 00:00:00 2001 From: Armando Visconti Date: Mon, 28 Jan 2019 17:08:58 +0100 Subject: [PATCH] boards: add support for shields x-nucleo-iks01a3 x-nucleo-iks01a3 shield is an arduino compatible companion board which can be used on top of Nucleo standard boards. It extend the Nucleo functionalities adding following MEMS sensor support: - LSM6DSO accel and gyro - LIS2MDL magnetometer - LIS2DW12 accel - LPS22HH pressure - HTS221 humidity Signed-off-by: Armando Visconti --- .../doc/img/x-nucleo-iks01a3.jpg | Bin 0 -> 79396 bytes boards/shields/x_nucleo_iks01a3/doc/index.rst | 103 ++++++++++++++++++ .../x_nucleo_iks01a3/x_nucleo_iks01a3.overlay | 41 +++++++ .../x_nucleo_iks01a3_shub.overlay | 22 ++++ 4 files changed, 166 insertions(+) create mode 100644 boards/shields/x_nucleo_iks01a3/doc/img/x-nucleo-iks01a3.jpg create mode 100644 boards/shields/x_nucleo_iks01a3/doc/index.rst create mode 100644 boards/shields/x_nucleo_iks01a3/x_nucleo_iks01a3.overlay create mode 100644 boards/shields/x_nucleo_iks01a3/x_nucleo_iks01a3_shub.overlay diff --git a/boards/shields/x_nucleo_iks01a3/doc/img/x-nucleo-iks01a3.jpg b/boards/shields/x_nucleo_iks01a3/doc/img/x-nucleo-iks01a3.jpg new file mode 100644 index 0000000000000000000000000000000000000000..1d24a439fd2962cf460156d6f0ec54e753d897c2 GIT binary patch literal 79396 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 1-2, 3-4 (I2C1 = I2C2, I2Cx=GND) +- JP8 => 1-2, 3-4 (I2C1 = I2C2, I2Cx=GND) + + +Mode 2: SensorHub Mode +====================== + +In SensorHub mode LSM6DSO and LIS2DW12 are connected to I2C2 and are accessible from the main board. +All the other devices are connected to LSM6DSO master thru I2C1. + +The jumper configuration to activate this mode is: + +- JP7 => 2-3 (I2C1 = I2Cx) +- JP8 => 2-3 (I2C1 = I2Cx) + +More information about X-NUCLEO-IKS01A3 configuration modes can be found in the +`X-NUCLEO-IKS01A3 user manual`_ + +Programming +*********** + +Two samples are provided as examples for ``x-nucleo-iks01a3`` shield: + +- :ref:`x-nucleo-iks01a3-std-sample` application, to be used when the shield is configured + in Standard Mode +- :ref:`x-nucleo-iks01a3-shub-sample` application, to be used when the shield is configured + in SensorHub Mode + +See also :ref:`shields` for more details. + +References +********** + +.. target-notes:: + +.. _X-NUCLEO-IKS01A3 website: + http://www.st.com/en/ecosystems/x-nucleo-iks01a3.html + +.. _X-NUCLEO-IKS01A3 user manual: + https://www.st.com/resource/en/user_manual/dm00601501.pdf diff --git a/boards/shields/x_nucleo_iks01a3/x_nucleo_iks01a3.overlay b/boards/shields/x_nucleo_iks01a3/x_nucleo_iks01a3.overlay new file mode 100644 index 00000000000..16db5b1d05b --- /dev/null +++ b/boards/shields/x_nucleo_iks01a3/x_nucleo_iks01a3.overlay @@ -0,0 +1,41 @@ +/* + * Copyright (c) 2019 STMicroelectronics + * + * SPDX-License-Identifier: Apache-2.0 + */ + +&arduino_i2c { + + hts221@5f { + compatible = "st,hts221"; + reg = <0x5f>; + label = "HTS221"; + }; + + lps22hh@5d { + compatible = "st,lps22hh"; + reg = <0x5d>; + drdy-gpios = <&arduino_header 12 0>; /* D6 */ + label = "LPS22HH"; + }; + + lis2mdl@1e { + compatible = "st,lis2mdl-magn"; + reg = <0x1e>; + label = "LIS2MDL"; + }; + + lis2dw12@19 { + compatible = "st,lis2dw12"; + reg = <0x19>; + irq-gpios = <&arduino_header 3 0>; /* A3 */ + label = "LIS2DW12"; + }; + + lsm6dso@6b { + compatible = "st,lsm6dso"; + reg = <0x6b>; + irq-gpios = <&arduino_header 10 0>; /* D4 */ + label = "LSM6DSO"; + }; +}; diff --git a/boards/shields/x_nucleo_iks01a3/x_nucleo_iks01a3_shub.overlay b/boards/shields/x_nucleo_iks01a3/x_nucleo_iks01a3_shub.overlay new file mode 100644 index 00000000000..72e04648a65 --- /dev/null +++ b/boards/shields/x_nucleo_iks01a3/x_nucleo_iks01a3_shub.overlay @@ -0,0 +1,22 @@ +/* + * Copyright (c) 2019 STMicroelectronics + * + * SPDX-License-Identifier: Apache-2.0 + */ + +&arduino_i2c { + + lis2dw12@19 { + compatible = "st,lis2dw12"; + reg = <0x19>; + irq-gpios = <&arduino_header 3 0>; /* A3 */ + label = "LIS2DW12"; + }; + + lsm6dso@6b { + compatible = "st,lsm6dso"; + reg = <0x6b>; + irq-gpios = <&arduino_header 10 0>; /* D4 */ + label = "LSM6DSO"; + }; +};