mirror of
https://github.com/esphome/esphome-docs.git
synced 2024-12-27 17:37:45 +01:00
39d5fc6312
Four of the variables in the sample codeblock don't include underscores as defined in the variables section. This throws an error when using this sample code. To avoid others getting these errors I have updated the sample so it uses the right variables.
82 lines
2.2 KiB
ReStructuredText
82 lines
2.2 KiB
ReStructuredText
ST7735 Display
|
|
==============
|
|
|
|
.. seo::
|
|
:description: Instructions for setting up a ST7735 display drivers.
|
|
:keywords: ST7735
|
|
:image: ST7735.png
|
|
|
|
ST7735 Display Driver.
|
|
|
|
Usage
|
|
-----
|
|
|
|
The ST7735 component allows you to use a ST7735 display
|
|
(`datasheet and information <https://learn.adafruit.com/1-8-tft-display/downloads>`__,
|
|
`Adafruit <https://www.adafruit.com/product/358>`__) in ESPHome.
|
|
It uses the :ref:`SPI Bus <spi>` for communication.
|
|
|
|
.. figure:: images/st7735.jpg
|
|
:align: center
|
|
:width: 75.0%
|
|
|
|
ST7735 Display
|
|
|
|
There are numerous board types out there. Some initialize differently as well. This driver will take a few options to narrow down the right settings.
|
|
|
|
.. code-block:: yaml
|
|
|
|
# Example configuration entry
|
|
display:
|
|
- platform: st7735
|
|
model: "INITR_18BLACKTAB"
|
|
reset_pin: D4
|
|
cs_pin: D1
|
|
dc_pin: D2
|
|
rotation: 0
|
|
device_width: 128
|
|
device_height: 160
|
|
col_start: 0
|
|
row_start: 0
|
|
eightbitcolor: true
|
|
update_interval: 5s
|
|
|
|
Configuration variables:
|
|
************************
|
|
|
|
- **model** (**Required**, "See Models Below"): This the model to use. INITR_BLACKTAB is the default
|
|
- **cs_pin** (**Required**, :ref:`Pin Schema <config-pin_schema>`): The CS pin.
|
|
- **dc_pin** (**Required**, :ref:`Pin Schema <config-pin_schema>`): The DC pin.
|
|
- **device_width** (**Required**, int): The device width. 128 is default
|
|
- **device_height** (**Required**, int): The device height. 160 is default
|
|
- **col_start** (**Required**, int): The device height. 160 is default
|
|
- **row_start** (**Required**, int): The device height. 160 is default
|
|
- **eight_bit_color** (*Optional*, "True/False" ): 8bit mode. Default is False. This saves 50% of the buffer required for the display.
|
|
- **reset_pin** (*Optional*, :ref:`Pin Schema <config-pin_schema>`): The RESET pin.
|
|
|
|
Memory notes:
|
|
*************
|
|
|
|
- 8Bit color saves 50% of the buffer required.
|
|
- eightbitcolor: True 160x128 = 20480 *Important for memory constrained devices*
|
|
- eightbitcolor: False 160x128x2 = 40960
|
|
|
|
|
|
Models:
|
|
*******
|
|
|
|
- INITR_GREENTAB
|
|
- INITR_REDTAB
|
|
- INITR_BLACKTAB
|
|
- INITR_MINI160X80
|
|
- INITR_18BLACKTAB
|
|
- INITR_18REDTAB
|
|
|
|
|
|
See Also
|
|
--------
|
|
|
|
- :ref:`spi`
|
|
- :apiref:`st7735/st7735.h`
|
|
- :ghedit:`Edit`
|