mirror of
https://github.com/esphome/esphome-docs.git
synced 2025-01-26 22:21:38 +01:00
Replace ili9341 with ili9xxx documentation (#2729)
Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
This commit is contained in:
parent
ee3083a9c5
commit
12e0073cb0
@ -8,3 +8,4 @@
|
||||
/devices/esp32.html /components/esp32.html
|
||||
|
||||
/changelog/2022.12.4.html /changelog/2022.12.0.html 301
|
||||
/components/display/ili9341.html /components/display/ili9xxx.html 301
|
||||
|
@ -1,21 +1,25 @@
|
||||
ILI9341 TFT LCD
|
||||
===============
|
||||
|
||||
ILI9xxx TFT LCD Series
|
||||
======================
|
||||
|
||||
.. seo::
|
||||
:description: Instructions for setting up ILI9341 TFT LCD display drivers.
|
||||
:description: Instructions for setting up ILI9xxx TFT LCD display drivers.
|
||||
:image: ili9341.jpg
|
||||
|
||||
.. _ili9341:
|
||||
.. _ili9xxx:
|
||||
|
||||
Usage
|
||||
-----
|
||||
This component is the successor of the ILI9341 component allowing to control more display drivers and use 16bit colors when enough free ram.
|
||||
|
||||
The ``ili9341`` display platform allows you to use
|
||||
The ``ILI9xxx`` display platform allows you to use
|
||||
ILI9341 (`datasheet <https://cdn-shop.adafruit.com/datasheets/ILI9341.pdf>`__,
|
||||
`Aliexpress <https://www.aliexpress.com/af/Ili9341.html>`__)
|
||||
displays with ESPHome. As this is a somewhat higher resolution display and may require pins
|
||||
`Aliexpress <https://www.aliexpress.com/af/Ili9341.html>`__) and other
|
||||
displays from the same chip family with ESPHome. As this is a somewhat higher resolution display and may require pins
|
||||
beyond the typical SPI connections, it is better suited for use with the ESP32.
|
||||
|
||||
**Note:** To use 16bit instead of 8bit colors use a esp32 with enough PSRAM the display.
|
||||
|
||||
.. figure:: images/ili9341-full.jpg
|
||||
:align: center
|
||||
:width: 75.0%
|
||||
@ -27,15 +31,13 @@ beyond the typical SPI connections, it is better suited for use with the ESP32.
|
||||
|
||||
# Example minimal configuration entry
|
||||
display:
|
||||
- platform: ili9341
|
||||
model: TFT 2.4
|
||||
- platform: ili9xxx
|
||||
model: ili9341
|
||||
cs_pin: 14
|
||||
dc_pin: 27
|
||||
led_pin: 32 ### see note below ###
|
||||
reset_pin: 33
|
||||
|
||||
lambda: |-
|
||||
it.fill(Color::BLACK);
|
||||
it.fill(COLOR_BLACK);
|
||||
it.print(0, 0, id(my_font), id(my_red), TextAlign::TOP_LEFT, "Hello World!");
|
||||
|
||||
Configuration variables:
|
||||
@ -43,15 +45,12 @@ Configuration variables:
|
||||
|
||||
- **model** (**Required**): The model of the display. Options are:
|
||||
|
||||
- ``M5STACK``
|
||||
- ``TFT 2.4``
|
||||
- ``TFT 2.4R`` (ILI9342)
|
||||
- ``M5STACK``, ``TFT 2.4``, ``TFT 2.4R``
|
||||
- ``ILI9341``, ``ILI9342``, ``ILI9481``, ``ILI9486``, ``ILI9488``, ``ST7796``
|
||||
|
||||
- **cs_pin** (*Optional*, :ref:`Pin Schema <config-pin_schema>`): The CS pin.
|
||||
- **dc_pin** (**Required**, :ref:`Pin Schema <config-pin_schema>`): The DC pin.
|
||||
- **reset_pin** (*Optional*, :ref:`Pin Schema <config-pin_schema>`): The RESET pin.
|
||||
- **led_pin** (*Optional*, :ref:`Pin Schema <config-pin_schema>`): The display's backlight pin. **Note:** Connect to a
|
||||
PWM-capable pin to switch/dim the display's backlight **or** save a pin by connecting it through a 3.3K resistor to the +3V supply.
|
||||
- **rotation** (*Optional*): Set the rotation of the display. Everything drawn in the ``lambda:`` will be rotated
|
||||
per this option. One of ``0°`` (default), ``90°``, ``180°``, or ``270°``.
|
||||
- **lambda** (*Optional*, :ref:`lambda <config-lambda>`): The lambda to use for rendering the content on the display.
|
||||
@ -124,7 +123,7 @@ To configure a dimmable backlight:
|
||||
light:
|
||||
- platform: monochromatic
|
||||
output: gpio_32_backlight_pwm
|
||||
name: "ILI9341 Display Backlight"
|
||||
name: "Display Backlight"
|
||||
id: back_light
|
||||
restore_mode: ALWAYS_ON
|
||||
|
||||
@ -139,11 +138,10 @@ To configure an image adaptive color pallet to show greater than 8 bit color dep
|
||||
type: RGB24
|
||||
|
||||
display:
|
||||
- platform: ili9341
|
||||
model: TFT 2.4
|
||||
- platform: ili9xxx
|
||||
model: ili9341
|
||||
cs_pin: 5
|
||||
dc_pin: 4
|
||||
led_pin: 15
|
||||
reset_pin: 22
|
||||
rotation: 90
|
||||
id: tft_ha
|
||||
@ -158,5 +156,5 @@ See Also
|
||||
--------
|
||||
|
||||
- :doc:`index`
|
||||
- :apiref:`ili9341/ili9341_display.h`
|
||||
- :apiref:`ili9xxx/ili9xxx_display.h`
|
||||
- :ghedit:`Edit`
|
@ -565,7 +565,7 @@ Display Components
|
||||
ST7735, components/display/st7735, st7735.jpg
|
||||
ST7789V, components/display/st7789v, st7789v.jpg
|
||||
ST7920, components/display/st7920, st7920.jpg
|
||||
ILI9341, components/display/ili9341, ili9341.jpg
|
||||
ILI9xxx, components/display/ili9xxx, ili9341.jpg
|
||||
Waveshare E-Paper, components/display/waveshare_epaper, waveshare_epaper.jpg
|
||||
Inkplate, components/display/inkplate6, inkplate6.jpg
|
||||
PCD8544 (Nokia 5110/ 3310), components/display/pcd8544, pcd8544.jpg
|
||||
|
Loading…
Reference in New Issue
Block a user