1.. _st7789v_generic:
2
3Generic ST7789V Display Shield
4##############################
5
6Overview
7********
8
9This is a generic shield for display shields based on ST7789V display
10controller. More information about the controller can be found in
11`ST7789V Datasheet`_.
12
13Pins Assignment of the Generic ST7789V Display Shield
14=====================================================
15
16+-----------------------+--------------------------------------------+
17| Arduino Connector Pin | Function                                   |
18+=======================+===============+============================+
19| D8                    | ST7789V Reset |                            |
20+-----------------------+---------------+----------------------------+
21| D9                    | ST7789V DC    | (Data/Command)             |
22+-----------------------+---------------+----------------------------+
23| D10                   | SPI SS        | (Serial Slave Select)      |
24+-----------------------+---------------+----------------------------+
25| D11                   | SPI MOSI      | (Serial Data Input)        |
26+-----------------------+---------------+----------------------------+
27| D12                   | SPI MISO      | (Serial Data Out)          |
28+-----------------------+---------------+----------------------------+
29| D13                   | SPI SCK       | (Serial Clock Input)       |
30+-----------------------+---------------+----------------------------+
31
32Current supported displays
33==========================
34
35+----------------------+------------------------------+
36| Display              | Shield Designation           |
37|                      |                              |
38+======================+==============================+
39| TL019FQV01           | st7789v_tl019fqv01           |
40|                      |                              |
41+----------------------+------------------------------+
42| Waveshare 240x240    | st7789v_waveshare_240x240    |
43| 1.3inch IPS LCD      |                              |
44+----------------------+------------------------------+
45
46Requirements
47************
48
49This shield can only be used with a board that provides a configuration
50for Arduino connectors and defines node aliases for SPI and GPIO interfaces
51(see :ref:`shields` for more details).
52
53Programming
54***********
55
56Set ``--shield st7789v_tl019fqv01`` when you invoke ``west build``. For example:
57
58.. zephyr-app-commands::
59   :zephyr-app: samples/subsys/display/lvgl
60   :board: nrf52840dk/nrf52840
61   :shield: st7789v_tl019fqv01
62   :goals: build
63
64References
65**********
66
67.. target-notes::
68
69.. _ST7789V Datasheet:
70   https://www.newhavendisplay.com/appnotes/datasheets/LCDs/ST7789V.pdf
71