README.rst
1.. zephyr:code-sample:: auxdisplay_digits
2 :name: Auxiliary digits display
3 :relevant-api: auxdisplay_interface
4
5 Output increasing numbers to an auxiliary display.
6
7Overview
8********
9
10This sample demonstrates the use of the
11:ref:`auxiliary display driver <auxdisplay_api>` for digit-based displays, such
12as 7-segment displays.
13
14Building and Running
15********************
16
17Note that this sample requires a board with a 7-segment display setup. You can
18build your own setup by fly-wiring a 7-segment display to any board you have.
19
20A sample overlay is provided for the ``native_sim`` target. See the overlay file
21:zephyr_file:`samples/drivers/auxdisplay_digits/boards/native_sim.overlay` for a
22demonstration.
23
24.. zephyr-app-commands::
25 :zephyr-app: samples/drivers/auxdisplay_digits
26 :host-os: unix
27 :board: native_sim
28 :goals: build
29 :compact:
30
31If successful, the display first lights up all segments (e.g., 8.8.8. on a
323-digit display), blinks once, sequentially lights up each digit from left to
33right, and then counts up from 0 to the maximum number that can be displayed.
34