1.. zephyr:code-sample:: nrf_led_matrix
2   :name: LED matrix
3
4   Use the nRF LED matrix display driver to drive an LED matrix.
5
6Overview
7********
8
9This is a simple application intended to present the nRF LED matrix display
10driver in action and to serve as a test ensuring that this driver is buildable
11for both the :zephyr:board:`bbc_microbit_v2` and :zephyr:board:`bbc_microbit` boards.
12
13Requirements
14************
15
16The sample has been tested on the bbc_microbit_v2 and bbc_microbit boards,
17but it could be ported to any board with an nRF SoC and the proper number
18of GPIOs available for driving an LED matrix. To do it, one needs to add an
19overlay file with the corresponding ``"nordic,nrf-led-matrix"`` compatible
20node.
21
22Building and Running
23********************
24
25The code can be found in :zephyr_file:`samples/boards/nordic/nrf_led_matrix`.
26
27To build and flash the application:
28
29.. zephyr-app-commands::
30   :zephyr-app: samples/boards/nordic/nrf_led_matrix
31   :board: bbc_microbit_v2
32   :goals: build flash
33   :compact:
34