1.. _max7219_shield:
2
3MAX7219 LED display driver shield
4#################################
5
6Overview
7********
8
9This is a generic shield for LED matrix based on MAX7219.
10These displays have an SPI interface and usually
11only five pins: VCC, GND, DIN, CS, and CLK.
12
13Current supported displays
14==========================
15
16+---------------------+---------------------+---------------------+
17| Display             | Controller          | Shield Designation  |
18|                     |                     |                     |
19+=====================+=====================+=====================+
20| No Name             | MAX7219             | max7219_8x8         |
21| 8x8 pixel           |                     |                     |
22+---------------------+---------------------+---------------------+
23
24Requirements
25************
26
27This shield can only be used with a board which provides a configuration
28for Arduino connectors and defines a node alias for the SPI interface
29(see :ref:`shields` for more details).
30
31Programming
32***********
33
34Set ``--shield max7219_8x8`` when you invoke ``west build``. For example:
35
36.. zephyr-app-commands::
37   :zephyr-app: samples/drivers/display/
38   :board: nrf52840dk/nrf52840
39   :shield: max7219_8x8
40   :goals: build
41