boards: shields: x_nucleo_53l0a1: new shield

Add support for the X-NUCLEO-53L0A1 expansion board and an
accompanying sample application

Signed-off-by: Titouan Christophe <moiandme@gmail.com>

boards/shields/x_nucleo_53l0a1/Kconfig.defconfig

@@ -0,0 +1,24 @@
+# Copyright (c) 2021 Titouan Christophe
+# SPDX-License-Identifier: Apache-2.0
+
+if SHIELD_X_NUCLEO_53L0A1
+
+config GPIO
+	default y
+
+config GPIO_STMPE1600
+	default y
+
+config I2C
+	default y
+
+config SENSOR
+	default y
+
+config VL53L0X
+	default y
+
+config VL53L0X_RECONFIGURE_ADDRESS
+	default y
+
+endif # SHIELD_X_NUCLEO_53L0A1

boards/shields/x_nucleo_53l0a1/Kconfig.shield

@@ -0,0 +1,5 @@
+# Copyright (c) 2021 Titouan Christophe
+# SPDX-License-Identifier: Apache-2.0
+
+config SHIELD_X_NUCLEO_53L0A1
+	def_bool $(shields_list_contains,x_nucleo_53l0a1)

boards/shields/x_nucleo_53l0a1/doc/index.rst

@@ -0,0 +1,86 @@
+.. _x_nucleo_53l0a1_shield:
+
+X-NUCLEO-53L0A1 ranging and gesture detection sensor expansion board
+####################################################################
+
+Overview
+********
+
+The X-NUCLEO-53L0A1 expansion board features the VL53L0X ranging and gesture
+detection sensor, based on ST’s FlightSense™, Time-of-Flight technology. It is
+an evaluation board that provides an introduction to the ranging and gesture
+detection capabilities of the VL53L0X module.
+
+One VL53L0X is soldered on the expansion board itself. A set of spacers and
+a cover glass are provided with the board, and can be fitted onto this center
+sensor.
+
+Two VL53L0X satellites can be connected using the two 10 pin connectors.
+The expansion board is compatible with the STM32 Nucleo board family,
+and with the Arduino UNO R3 connector layout.
+
+.. figure:: ./x_nucleo_53l0a1.jpg
+   :width: 371px
+   :align: center
+   :alt: X-NUCLEO-53L0A1
+
+More information about the board can be found at the
+`X-NUCLEO-53L0A1 website`_.
+
+Requirements
+************
+
+This shield can only be used with a development board that provides a
+configuration for Arduino connectors and defines a node alias for the
+I2C interface (see :ref:`shields` for more details).
+
+Peripherals
+***********
+
+The sensors have the following device tree labels and I2C addresses:
+
+* **Center sensor** (soldered on the shield): ``VL53L0X_C``, 0x30
+* **Left satellite sensor**: ``VL53L0X_L``, 0x31
+* **Right satellite sensor**: ``VL53L0X_R``, 0x32
+
+The 7 segment display is connected to two GPIO expanders, each of one handles
+2 digits x 7 segments = 14 pins:
+
+* **Rightmost two digits**: ``EXPANDER1``, 0x42
+* **Leftmost two digits**: ``EXPANDER2``, 0x43
+
+External links
+**************
+
+- `X-NUCLEO-53L0A1 ranging and gesture detection sensor expansion board User Manual`_
+- `VL53L0X Time-of-Flight ranging and gesture detection sensor Datasheet`_
+
+
+Samples
+*******
+
+The sample :ref:`vl53l0x` demonstrates how to use the ranging sensor VL53L0X
+using the center sensor only.
+
+The sample :ref:`x-nucleo-53l0a1-sample` demonstrates how to use the three
+sensors (soldered + 2 satellites) and the 7 segments display.
+
+Programming
+***********
+
+Set ``-DSHIELD=x_nucleo_53l0a1`` when you invoke ``west build``. For example:
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/sensor/vl53l0x
+   :board: nucleo_f429zi
+   :shield: x_nucleo_53l0a1
+   :goals: build
+
+.. _X-NUCLEO-53L0A1 website:
+   https://www.st.com/en/evaluation-tools/x-nucleo-53l0a1.html
+
+.. _X-NUCLEO-53L0A1 ranging and gesture detection sensor expansion board User Manual:
+   https://www.st.com/resource/en/user_manual/dm00285104-xnucleo53l0a1-ranging-and-gesture-detection-sensor-expansion-board-based-on-vl53l0x-for-stm32-nucleo-stmicroelectronics.pdf
+
+.. _VL53L0X Time-of-Flight ranging and gesture detection sensor Datasheet:
+   https://www.st.com/resource/en/datasheet/vl53l0x.pdf

boards/shields/x_nucleo_53l0a1/x_nucleo_53l0a1.overlay

@@ -0,0 +1,45 @@
+/*
+ * Copyright (c) 2021 Titouan Christophe
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+&arduino_i2c {
+	expander1: stmpe1600@42 {
+		compatible = "st,stmpe1600";
+		label = "EXPANDER1";
+		reg = <0x42>;
+		ngpios = <16>;
+		gpio-controller;
+		#gpio-cells = <2>;
+	};
+	expander2: stmpe1600@43 {
+		compatible = "st,stmpe1600";
+		label = "EXPANDER2";
+		reg = <0x43>;
+		ngpios = <16>;
+		gpio-controller;
+		#gpio-cells = <2>;
+	};
+
+	/* Center sensor soldered on the shield */
+	vl53l0x_c: vl53l0x@30 {
+		compatible = "st,vl53l0x";
+		label = "VL53L0X_C";
+		reg = <0x30>;
+		xshut-gpios = <&expander1 15 0>;
+	};
+
+	/* Satellites optional sensors */
+	vl53l0x_l: vl53l0x@31 {
+		compatible = "st,vl53l0x";
+		label = "VL53L0X_L";
+		reg = <0x31>;
+		xshut-gpios = <&expander2 14 0>;
+	};
+	vl53l0x_r: vl53l0x@32 {
+		compatible = "st,vl53l0x";
+		label = "VL53L0X_R";
+		reg = <0x32>;
+		xshut-gpios = <&expander2 15 0>;
+	};
+};