2019-11-11 18:52:35 +08:00
|
|
|
.. _st7789v_generic:
|
|
|
|
|
|
|
|
|
|
Generic ST7789V Display Shield
|
|
|
|
|
##############################
|
|
|
|
|
|
|
|
|
|
Overview
|
|
|
|
|
********
|
|
|
|
|
|
|
|
|
|
This is a generic shield for display shields based on ST7789V display
|
|
|
|
|
controller. More information about the controller can be found in
|
|
|
|
|
`ST7789V Datasheet`_.
|
|
|
|
|
|
|
|
|
|
Pins Assignment of the Generic ST7789V Display Shield
|
|
|
|
|
=====================================================
|
|
|
|
|
|
|
|
|
|
+-----------------------+--------------------------------------------+
|
|
|
|
|
| Arduino Connector Pin | Function |
|
|
|
|
|
+=======================+===============+============================+
|
|
|
|
|
| D8 | ST7789V Reset | |
|
|
|
|
|
+-----------------------+---------------+----------------------------+
|
|
|
|
|
| D9 | ST7789V DC | (Data/Command) |
|
|
|
|
|
+-----------------------+---------------+----------------------------+
|
|
|
|
|
| D10 | SPI SS | (Serial Slave Select) |
|
|
|
|
|
+-----------------------+---------------+----------------------------+
|
|
|
|
|
| D11 | SPI MOSI | (Serial Data Input) |
|
|
|
|
|
+-----------------------+---------------+----------------------------+
|
|
|
|
|
| D12 | SPI MISO | (Serial Data Out) |
|
|
|
|
|
+-----------------------+---------------+----------------------------+
|
|
|
|
|
| D13 | SPI SCK | (Serial Clock Input) |
|
|
|
|
|
+-----------------------+---------------+----------------------------+
|
|
|
|
|
|
2019-11-19 06:15:25 +08:00
|
|
|
Current supported displays
|
|
|
|
|
==========================
|
|
|
|
|
|
|
|
|
|
+----------------------+------------------------------+
|
|
|
|
|
| Display | Shield Designation |
|
|
|
|
|
| | |
|
|
|
|
|
+======================+==============================+
|
|
|
|
|
| TL019FQV01 | st7789v_tl019fqv01 |
|
|
|
|
|
| | |
|
|
|
|
|
+----------------------+------------------------------+
|
2019-11-19 06:29:05 +08:00
|
|
|
| Waveshare 240x240 | st7789v_waveshare_240x240 |
|
|
|
|
|
| 1.3inch IPS LCD | |
|
|
|
|
|
+----------------------+------------------------------+
|
2019-11-19 06:15:25 +08:00
|
|
|
|
2019-11-11 18:52:35 +08:00
|
|
|
Requirements
|
|
|
|
|
************
|
|
|
|
|
|
|
|
|
|
This shield can only be used with a board that provides a configuration
|
|
|
|
|
for Arduino connectors and defines node aliases for SPI and GPIO interfaces
|
|
|
|
|
(see :ref:`shields` for more details).
|
|
|
|
|
|
|
|
|
|
Programming
|
|
|
|
|
***********
|
|
|
|
|
|
2019-11-19 06:15:25 +08:00
|
|
|
Set ``-DSHIELD=st7789v_tl019fqv01`` when you invoke ``west build``. For example:
|
2019-11-11 18:52:35 +08:00
|
|
|
|
|
|
|
|
.. zephyr-app-commands::
|
2021-03-24 10:41:34 +08:00
|
|
|
:zephyr-app: samples/subsys/display/lvgl
|
2020-03-17 19:41:28 +08:00
|
|
|
:board: nrf52840dk_nrf52840
|
2019-11-19 06:15:25 +08:00
|
|
|
:shield: st7789v_tl019fqv01
|
2019-11-11 18:52:35 +08:00
|
|
|
:goals: build
|
|
|
|
|
|
|
|
|
|
References
|
|
|
|
|
**********
|
|
|
|
|
|
|
|
|
|
.. target-notes::
|
|
|
|
|
|
|
|
|
|
.. _ST7789V Datasheet:
|
|
|
|
|
https://www.newhavendisplay.com/appnotes/datasheets/LCDs/ST7789V.pdf
|
