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