mirror of
https://github.com/esphome/esphome-docs.git
synced 2024-12-28 17:48:35 +01:00
commit
6be6f7631d
2
Doxygen
2
Doxygen
@ -38,7 +38,7 @@ PROJECT_NAME = "ESPHome"
|
|||||||
# could be handy for archiving the generated documentation or if some version
|
# could be handy for archiving the generated documentation or if some version
|
||||||
# control system is used.
|
# control system is used.
|
||||||
|
|
||||||
PROJECT_NUMBER = 2023.3.0b1
|
PROJECT_NUMBER = 2023.3.0b2
|
||||||
|
|
||||||
# Using the PROJECT_BRIEF tag one can provide an optional one line description
|
# Using the PROJECT_BRIEF tag one can provide an optional one line description
|
||||||
# for a project that appears at the top of each page and should give viewer a
|
# for a project that appears at the top of each page and should give viewer a
|
||||||
|
2
Makefile
2
Makefile
@ -1,5 +1,5 @@
|
|||||||
ESPHOME_PATH = ../esphome
|
ESPHOME_PATH = ../esphome
|
||||||
ESPHOME_REF = 2023.3.0b1
|
ESPHOME_REF = 2023.3.0b2
|
||||||
|
|
||||||
.PHONY: html html-strict cleanhtml deploy help live-html Makefile netlify netlify-api api netlify-dependencies svg2png copy-svg2png minify
|
.PHONY: html html-strict cleanhtml deploy help live-html Makefile netlify netlify-api api netlify-dependencies svg2png copy-svg2png minify
|
||||||
|
|
||||||
|
@ -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 +1 @@
|
|||||||
2023.3.0b1
|
2023.3.0b2
|
@ -61,6 +61,16 @@ Breaking Changes
|
|||||||
- Sprinkler "v2" updates :esphomepr:`4159` by :ghuser:`kbx81` (breaking-change)
|
- Sprinkler "v2" updates :esphomepr:`4159` by :ghuser:`kbx81` (breaking-change)
|
||||||
- sn74hc165 fixes :esphomepr:`4457` by :ghuser:`jesserockz` (breaking-change)
|
- sn74hc165 fixes :esphomepr:`4457` by :ghuser:`jesserockz` (breaking-change)
|
||||||
|
|
||||||
|
Beta Changes
|
||||||
|
^^^^^^^^^^^^
|
||||||
|
|
||||||
|
- Fix ethernet clk_mode for GPIO0_OUT :esphomepr:`4307` by :ghuser:`jorticus`
|
||||||
|
- Add ESP32-S3 support in NeoPixelBus component :esphomepr:`4114` by :ghuser:`rcloran`
|
||||||
|
- Renaming and extending the ili9341 to the ili9xxx component :esphomepr:`4275` by :ghuser:`nielsnl68` (new-integration) (breaking-change)
|
||||||
|
- Drop unused, broken logging macros :esphomepr:`4534` by :ghuser:`oxan`
|
||||||
|
- Revert storing Font glyphs in manually-allocated memory :esphomepr:`4516` by :ghuser:`oxan`
|
||||||
|
- Correct BME680 gas calculation and heater_off :esphomepr:`4498` by :ghuser:`CarlosGS`
|
||||||
|
|
||||||
All changes
|
All changes
|
||||||
^^^^^^^^^^^
|
^^^^^^^^^^^
|
||||||
|
|
||||||
|
@ -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`
|
@ -127,7 +127,8 @@ settings vary by method:
|
|||||||
- **async** (*Optional*, boolean): Use an asynchronous transfer. Defaults to ``false``. If enabled,
|
- **async** (*Optional*, boolean): Use an asynchronous transfer. Defaults to ``false``. If enabled,
|
||||||
the logger must be disabled even if bus 1 is used.
|
the logger must be disabled even if bus 1 is used.
|
||||||
|
|
||||||
- **esp32_i2s**: The recommended method for ESP32. Available on all output pins. Additional options:
|
- **esp32_i2s**: The recommended method for ESP32, but not available on the ESP32-S3 or ESP32-C3.
|
||||||
|
Available on all output pins. Additional options:
|
||||||
|
|
||||||
- **bus** (*Optional*): The I2S bus to use. The ESP32 has bus 0 or 1 available, but the ESP32-S2 only bus 0.
|
- **bus** (*Optional*): The I2S bus to use. The ESP32 has bus 0 or 1 available, but the ESP32-S2 only bus 0.
|
||||||
One of ``0``, ``1``, ``dynamic``.
|
One of ``0``, ``1``, ``dynamic``.
|
||||||
@ -135,7 +136,7 @@ settings vary by method:
|
|||||||
- **esp32_rmt**: An alternative method for ESP32 that uses the RMT peripheral to send data.
|
- **esp32_rmt**: An alternative method for ESP32 that uses the RMT peripheral to send data.
|
||||||
Available on all output pins. Additional options:
|
Available on all output pins. Additional options:
|
||||||
|
|
||||||
- **channel** (*Optional*): The RMT channel to use. The ESP32 has channels 0-7, ESP32-S2 0-3 and ESP32-C3 0-1.
|
- **channel** (*Optional*): The RMT channel to use. The ESP32 has channels 0-7, ESP32-S2 0-3, ESP32-S3 0-3, and ESP32-C3 0-1.
|
||||||
Defaults to 6 on ESP32, and 1 on other ESP32 variants.
|
Defaults to 6 on ESP32, and 1 on other ESP32 variants.
|
||||||
|
|
||||||
The following method is available only for two-wire chips (specify ``data_pin`` and ``clock_pin``):
|
The following method is available only for two-wire chips (specify ``data_pin`` and ``clock_pin``):
|
||||||
|
@ -1,3 +1,5 @@
|
|||||||
|
.. _logger:
|
||||||
|
|
||||||
Logger Component
|
Logger Component
|
||||||
================
|
================
|
||||||
|
|
||||||
|
@ -11,7 +11,7 @@ instrument in ESPHome. It uses :ref:`UART <uart>` (ModBUS) for communication.
|
|||||||
Once configured you can use sensors as described below for your projects.
|
Once configured you can use sensors as described below for your projects.
|
||||||
|
|
||||||
|
|
||||||
.. figure:: ../images/kuntze.jpg
|
.. figure:: ../../images/kuntze.jpg
|
||||||
:align: center
|
:align: center
|
||||||
|
|
||||||
Kuntze Neon® Multi instrument
|
Kuntze Neon® Multi instrument
|
||||||
@ -30,14 +30,14 @@ The device communicates at ``19200`` baud ``8E1``. To connect to ESPHome, an RS4
|
|||||||
transceiver is needed. Choose a type which does not need a trigger to send and
|
transceiver is needed. Choose a type which does not need a trigger to send and
|
||||||
receive data, for example:
|
receive data, for example:
|
||||||
|
|
||||||
.. figure:: ../images/rs485.jpg
|
.. figure:: ../../images/rs485.jpg
|
||||||
|
|
||||||
The controller connects to the UART of the MCU. For ESP32 GPIO `16` to `TXD` and `17`
|
The controller connects to the UART of the MCU. For ESP32 GPIO `16` to `TXD` and `17`
|
||||||
to RXD are the default ones but any other pins can be used as well. 3.3V to VCC and GND to GND.
|
to RXD are the default ones but any other pins can be used as well. 3.3V to VCC and GND to GND.
|
||||||
|
|
||||||
.. warning::
|
.. warning::
|
||||||
|
|
||||||
If you are using the :doc:`logger` make sure you are not using the same pins for it or otherwise disable the UART
|
If you are using the :ref:`logger` make sure you are not using the same pins for it or otherwise disable the UART
|
||||||
logging with the ``baud_rate: 0`` option.
|
logging with the ``baud_rate: 0`` option.
|
||||||
|
|
||||||
Component
|
Component
|
||||||
@ -52,7 +52,7 @@ A configured modbus component is optional. It will be automatically created.
|
|||||||
- id: uart_bus
|
- id: uart_bus
|
||||||
tx_pin: GPIO16
|
tx_pin: GPIO16
|
||||||
rx_pin: GPIO17
|
rx_pin: GPIO17
|
||||||
baud_rate: 19600
|
baud_rate: 19200
|
||||||
parity: EVEN
|
parity: EVEN
|
||||||
|
|
||||||
sensor:
|
sensor:
|
||||||
@ -81,7 +81,7 @@ See Also
|
|||||||
--------
|
--------
|
||||||
|
|
||||||
- :ref:`uart`
|
- :ref:`uart`
|
||||||
- :doc:`logger`
|
- :ref:`logger`
|
||||||
- :ref:`Sensor <config-sensor>`
|
- :ref:`Sensor <config-sensor>`
|
||||||
- `Kuntze manuals <https://www.kuntze.com/en/downloads-2/>`__
|
- `Kuntze manuals <https://www.kuntze.com/en/downloads-2/>`__
|
||||||
- `Communication protocol <https://www.kuntze.com/wp-content/uploads/2021/05/2019_Manual_Modbus-RTU_ENG.pdf>`__
|
- `Communication protocol <https://www.kuntze.com/wp-content/uploads/2021/05/2019_Manual_Modbus-RTU_ENG.pdf>`__
|
2
conf.py
2
conf.py
@ -69,7 +69,7 @@ author = "ESPHome"
|
|||||||
# The short X.Y version.
|
# The short X.Y version.
|
||||||
version = "2023.3"
|
version = "2023.3"
|
||||||
# The full version, including alpha/beta/rc tags.
|
# The full version, including alpha/beta/rc tags.
|
||||||
release = "2023.3.0b1"
|
release = "2023.3.0b2"
|
||||||
|
|
||||||
# The language for content autogenerated by Sphinx. Refer to documentation
|
# The language for content autogenerated by Sphinx. Refer to documentation
|
||||||
# for a list of supported languages.
|
# for a list of supported languages.
|
||||||
|
@ -360,7 +360,6 @@ Contributors
|
|||||||
- `Antoine GRÉA (@grea09) <https://github.com/grea09>`__
|
- `Antoine GRÉA (@grea09) <https://github.com/grea09>`__
|
||||||
- `Gil Peeters (@grillp) <https://github.com/grillp>`__
|
- `Gil Peeters (@grillp) <https://github.com/grillp>`__
|
||||||
- `George (@grob6000) <https://github.com/grob6000>`__
|
- `George (@grob6000) <https://github.com/grob6000>`__
|
||||||
- `Stefan Grufman (@GruffyPuffy) <https://github.com/GruffyPuffy>`__
|
|
||||||
- `gsexton (@gsexton) <https://github.com/gsexton>`__
|
- `gsexton (@gsexton) <https://github.com/gsexton>`__
|
||||||
- `Gabriel Sieben (@gsieben) <https://github.com/gsieben>`__
|
- `Gabriel Sieben (@gsieben) <https://github.com/gsieben>`__
|
||||||
- `Jadson Santos (@gtjadsonsantos) <https://github.com/gtjadsonsantos>`__
|
- `Jadson Santos (@gtjadsonsantos) <https://github.com/gtjadsonsantos>`__
|
||||||
@ -474,6 +473,7 @@ Contributors
|
|||||||
- `JonnyaiR (@jonnyair) <https://github.com/jonnyair>`__
|
- `JonnyaiR (@jonnyair) <https://github.com/jonnyair>`__
|
||||||
- `Jonathan V (@jonofmac) <https://github.com/jonofmac>`__
|
- `Jonathan V (@jonofmac) <https://github.com/jonofmac>`__
|
||||||
- `Joppy (@JoppyFurr) <https://github.com/JoppyFurr>`__
|
- `Joppy (@JoppyFurr) <https://github.com/JoppyFurr>`__
|
||||||
|
- `Jared Sanson (@jorticus) <https://github.com/jorticus>`__
|
||||||
- `Joshua Spence (@joshuaspence) <https://github.com/joshuaspence>`__
|
- `Joshua Spence (@joshuaspence) <https://github.com/joshuaspence>`__
|
||||||
- `Joscha Wagner (@jowgn) <https://github.com/jowgn>`__
|
- `Joscha Wagner (@jowgn) <https://github.com/jowgn>`__
|
||||||
- `Javier Peletier (@jpeletier) <https://github.com/jpeletier>`__
|
- `Javier Peletier (@jpeletier) <https://github.com/jpeletier>`__
|
||||||
@ -729,6 +729,7 @@ Contributors
|
|||||||
- `randomllama (@randomllama) <https://github.com/randomllama>`__
|
- `randomllama (@randomllama) <https://github.com/randomllama>`__
|
||||||
- `rbaron (@rbaron) <https://github.com/rbaron>`__
|
- `rbaron (@rbaron) <https://github.com/rbaron>`__
|
||||||
- `Robert Cambridge (@rcambrj) <https://github.com/rcambrj>`__
|
- `Robert Cambridge (@rcambrj) <https://github.com/rcambrj>`__
|
||||||
|
- `Russell Cloran (@rcloran) <https://github.com/rcloran>`__
|
||||||
- `Rebbe Pod (@RebbePod) <https://github.com/RebbePod>`__
|
- `Rebbe Pod (@RebbePod) <https://github.com/RebbePod>`__
|
||||||
- `Alex (@redwngsrul) <https://github.com/redwngsrul>`__
|
- `Alex (@redwngsrul) <https://github.com/redwngsrul>`__
|
||||||
- `Regev Brody (@regevbr) <https://github.com/regevbr>`__
|
- `Regev Brody (@regevbr) <https://github.com/regevbr>`__
|
||||||
|
@ -365,6 +365,7 @@ Miscellaneous
|
|||||||
uFire ISE sensor, components/sensor/ufire_ise, ufire_ise.png, pH & Temperature
|
uFire ISE sensor, components/sensor/ufire_ise, ufire_ise.png, pH & Temperature
|
||||||
Resol VBus, components/vbus, resol_deltasol_bs_plus.jpg
|
Resol VBus, components/vbus, resol_deltasol_bs_plus.jpg
|
||||||
Person Sensor (SEN21231), components/sensor/sen21231, sen21231.png
|
Person Sensor (SEN21231), components/sensor/sen21231, sen21231.png
|
||||||
|
Kuntze pool sensor, components/sensor/kuntze, kuntze.jpg
|
||||||
|
|
||||||
|
|
||||||
Motion
|
Motion
|
||||||
@ -564,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