1.. zephyr:code-sample:: x-nucleo-53l0a1
2   :name: X-NUCLEO-53L0A1 shield
3   :relevant-api: sensor_interface gpio_interface
4
5   Interact with the 7-segment display and VL53L0X ranging sensor of an X-NUCLEO-53L0A1 shield.
6
7Overview
8********
9This sample demonstrate the usage of the 4 digits x 7 segments display and the
10three VL53L0X ranging sensors on the :ref:`x_nucleo_53l0a1_shield`.
11
12When flashed on a board, 2 modes are available. To switch from one mode to the
13other, press the button ``sw0``.
14
15Distance (onboard sensor)
16-------------------------
17
18This is the default mode when starting up. In this mode, if the distance to
19the center sensor (soldered on the shield) is lower than 1.25m, then the
204x7 segment display shows the distance in cm.
21
22Proximity (onboard + satellites)
23--------------------------------
24
25In this mode, the 4x7 segment display shows 3 stacked horizontal bars if there
26is something in proximity for each sensor. The left sensor is shown on the
27leftmost digit, then the center sensor, then the right sensor.
28The proximity threshold is configured in
29:kconfig:option:`CONFIG_VL53L0X_PROXIMITY_THRESHOLD`
30
31To switch from one mode to another, press the button ``sw0``
32
33Requirements
34************
35
36This sample communicates over I2C with the X-NUCLEO-53L0A1 shield
37stacked on a board with an Arduino connector. The board's I2C must be
38configured for the I2C Arduino connector (both for pin muxing
39and devicetree). The board must also have a button with the alias ``sw0``
40in its device tree.
41
42References
43**********
44
45* `X-NUCLEO-53L0A1 website`_
46
47Building and Running
48********************
49
50This sample runs with X-NUCLEO-53L0A1 stacked on any board with a matching
51Arduino connector. For this example, we use a :ref:`nucleo_f429zi_board` board.
52
53.. zephyr-app-commands::
54   :zephyr-app: samples/shields/x_nucleo_53l0a1
55   :board: nucleo_f429zi
56   :goals: build
57   :compact:
58
59.. _X-NUCLEO-53L0A1 website:
60   https://www.st.com/en/evaluation-tools/x-nucleo-53l0a1.html
61