mirror of
https://github.com/esphome/esphome-docs.git
synced 2024-09-21 03:21:20 +02:00
Replace ili9341 with ili9xxx documentation (#2729)
Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
This commit is contained in:
parent
badc454254
commit
5176b16150
@ -8,3 +8,4 @@
|
|||||||
/devices/esp32.html /components/esp32.html
|
/devices/esp32.html /components/esp32.html
|
||||||
|
|
||||||
/changelog/2022.12.4.html /changelog/2022.12.0.html 301
|
/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::
|
.. seo::
|
||||||
:description: Instructions for setting up ILI9341 TFT LCD display drivers.
|
:description: Instructions for setting up ILI9xxx TFT LCD display drivers.
|
||||||
:image: ili9341.jpg
|
:image: ili9341.jpg
|
||||||
|
|
||||||
.. _ili9341:
|
.. _ili9xxx:
|
||||||
|
|
||||||
Usage
|
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>`__,
|
ILI9341 (`datasheet <https://cdn-shop.adafruit.com/datasheets/ILI9341.pdf>`__,
|
||||||
`Aliexpress <https://www.aliexpress.com/af/Ili9341.html>`__)
|
`Aliexpress <https://www.aliexpress.com/af/Ili9341.html>`__) and other
|
||||||
displays with ESPHome. As this is a somewhat higher resolution display and may require pins
|
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.
|
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
|
.. figure:: images/ili9341-full.jpg
|
||||||
:align: center
|
:align: center
|
||||||
:width: 75.0%
|
: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
|
# Example minimal configuration entry
|
||||||
display:
|
display:
|
||||||
- platform: ili9341
|
- platform: ili9xxx
|
||||||
model: TFT 2.4
|
model: ili9341
|
||||||
cs_pin: 14
|
cs_pin: 14
|
||||||
dc_pin: 27
|
dc_pin: 27
|
||||||
led_pin: 32 ### see note below ###
|
|
||||||
reset_pin: 33
|
reset_pin: 33
|
||||||
|
|
||||||
lambda: |-
|
lambda: |-
|
||||||
it.fill(Color::BLACK);
|
it.fill(COLOR_BLACK);
|
||||||
it.print(0, 0, id(my_font), id(my_red), TextAlign::TOP_LEFT, "Hello World!");
|
it.print(0, 0, id(my_font), id(my_red), TextAlign::TOP_LEFT, "Hello World!");
|
||||||
|
|
||||||
Configuration variables:
|
Configuration variables:
|
||||||
@ -43,15 +45,12 @@ Configuration variables:
|
|||||||
|
|
||||||
- **model** (**Required**): The model of the display. Options are:
|
- **model** (**Required**): The model of the display. Options are:
|
||||||
|
|
||||||
- ``M5STACK``
|
- ``M5STACK``, ``TFT 2.4``, ``TFT 2.4R``
|
||||||
- ``TFT 2.4``
|
- ``ILI9341``, ``ILI9342``, ``ILI9481``, ``ILI9486``, ``ILI9488``, ``ST7796``
|
||||||
- ``TFT 2.4R`` (ILI9342)
|
|
||||||
|
|
||||||
- **cs_pin** (*Optional*, :ref:`Pin Schema <config-pin_schema>`): The CS pin.
|
- **cs_pin** (*Optional*, :ref:`Pin Schema <config-pin_schema>`): The CS pin.
|
||||||
- **dc_pin** (**Required**, :ref:`Pin Schema <config-pin_schema>`): The DC 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.
|
- **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
|
- **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°``.
|
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.
|
- **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:
|
light:
|
||||||
- platform: monochromatic
|
- platform: monochromatic
|
||||||
output: gpio_32_backlight_pwm
|
output: gpio_32_backlight_pwm
|
||||||
name: "ILI9341 Display Backlight"
|
name: "Display Backlight"
|
||||||
id: back_light
|
id: back_light
|
||||||
restore_mode: ALWAYS_ON
|
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
|
type: RGB24
|
||||||
|
|
||||||
display:
|
display:
|
||||||
- platform: ili9341
|
- platform: ili9xxx
|
||||||
model: TFT 2.4
|
model: ili9341
|
||||||
cs_pin: 5
|
cs_pin: 5
|
||||||
dc_pin: 4
|
dc_pin: 4
|
||||||
led_pin: 15
|
|
||||||
reset_pin: 22
|
reset_pin: 22
|
||||||
rotation: 90
|
rotation: 90
|
||||||
id: tft_ha
|
id: tft_ha
|
||||||
@ -158,5 +156,5 @@ See Also
|
|||||||
--------
|
--------
|
||||||
|
|
||||||
- :doc:`index`
|
- :doc:`index`
|
||||||
- :apiref:`ili9341/ili9341_display.h`
|
- :apiref:`ili9xxx/ili9xxx_display.h`
|
||||||
- :ghedit:`Edit`
|
- :ghedit:`Edit`
|
@ -565,7 +565,7 @@ Display Components
|
|||||||
ST7735, components/display/st7735, st7735.jpg
|
ST7735, components/display/st7735, st7735.jpg
|
||||||
ST7789V, components/display/st7789v, st7789v.jpg
|
ST7789V, components/display/st7789v, st7789v.jpg
|
||||||
ST7920, components/display/st7920, st7920.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
|
Waveshare E-Paper, components/display/waveshare_epaper, waveshare_epaper.jpg
|
||||||
Inkplate, components/display/inkplate6, inkplate6.jpg
|
Inkplate, components/display/inkplate6, inkplate6.jpg
|
||||||
PCD8544 (Nokia 5110/ 3310), components/display/pcd8544, pcd8544.jpg
|
PCD8544 (Nokia 5110/ 3310), components/display/pcd8544, pcd8544.jpg
|
||||||
|
Loading…
Reference in New Issue
Block a user