Merge branch 'next' into lvgl-containers

Author: clydebarrow

content/automations/actions.md

@@ -460,7 +460,21 @@ on_...:
 
 - **condition** (**Required**, [condition](#config-condition)): The condition to check.
 
-{{< anchor "lambda_condition" >}}
+### `component.is_idle` Condition
+
+This condition checks if a given component is idle. A component is considered to be idle if it has completed
+setup, has not been marked as failed, and is not currently being called by the loop task. This is useful for
+synchronizing actions with the state of the component, for example, an e-paper display component that requires
+a significant amount of time to update the display panel.
+
+```yaml
+on_...:
+  then:
+    - if:
+        condition:
+          component.is_idle: some_component
+        # ...
+```
 
 ### `lambda` Condition
 

content/components/display/epaper_spi.md

@@ -15,28 +15,34 @@ better integration with ESPHome's async architecture.
 The communication method uses 4-wire [SPI](#spi), so you need to have an `spi:` section in your
 configuration.
 
+The driver supports a number of displays and there are also specific configurations for ESP32 boards with integrated displays.
+For those boards the predefined configuration will set the correct pins and dimensions for the display.
+
 ```yaml
 display:
   - platform: epaper_spi
-    cs_pin: GPIOXX
-    dc_pin: GPIOXX
-    busy_pin: GPIOXX
-    reset_pin: GPIOXX
-    model: 7.3in-spectra-e6
+    model: Seeed-reTerminal-E1002
     lambda: |-
       it.filled_circle(it.get_width() / 2, it.get_height() / 2, 50, Color::BLACK);
 ```
 
-## Configuration variables
+## Supported displays
 
-- **cs_pin** (**Required**, [Pin Schema](#config-pin_schema)): The CS pin.
-- **dc_pin** (**Required**, [Pin Schema](#config-pin_schema)): The DC pin.
-- **model** (**Required**): The model of the ePaper display. Currently supported:
+| Model name             | Manufacturer | Product Description                                        |
+|------------------------|--------------|------------------------------------------------------------|
+| Spectra-E6             | Eink         | <https://www.eink.com/brand/detail/Spectra6>               |
+| Seeed-reTerminal-E1002 | Seeed Studio | <https://www.seeedstudio.com/reTerminal-E1002-p-6533.html> |
+
+## Configuration variables
 
-  - `7.3in-spectra-e6` - 7.3" Spectra E6 6-color display (800×480 pixels)
+When using a model defining an integrated ESP32 display board most of the configuration such as the pins and dimensions will be set by default,
+but can be overridden if needed.
 
-- **busy_pin** (*Optional*, [Pin Schema](#config-pin_schema)): The BUSY pin. Defaults to not connected.
-- **reset_pin** (*Optional*, [Pin Schema](#config-pin_schema)): The RESET pin. Defaults to not connected.
+- **model** (**Required**): The model of the ePaper display. See the table above for options.
+- **cs_pin** (**Required**, [Pin Schema](#config-pin_schema)): The CS pin. Predefined for integrated boards.
+- **dc_pin** (**Required**, [Pin Schema](#config-pin_schema)): The DC pin. Predefined for integrated boards.
+- **busy_pin** (*Optional*, [Pin Schema](#config-pin_schema)): The BUSY pin, if used.
+- **reset_pin** (*Optional*, [Pin Schema](#config-pin_schema)): The RESET pin, if used.
   Make sure you pull this pin high (by connecting it to 3.3V with a resistor) if not connected to a GPIO pin.
 
 - **rotation** (*Optional*): Set the rotation of the display. Everything you draw in `lambda:` will be rotated

content/components/display/mipi_spi.md

@@ -29,7 +29,7 @@ boards and chips, but the driver is also designed to be customisable in YAML for
 ## Supported boards and driver chips
 
 The driver supports a number of display driver chips, and can be configured for custom displays. As well as support for
-driver chips, there are also specific configurations for several ESP32 boards with integrated displays. For tbose boards
+driver chips, there are also specific configurations for several ESP32 boards with integrated displays. For those boards
 the predefined configuration will set the correct pins and dimensions for the display.
 
 For custom displays, the driver can be configured with the correct pins and dimensions, and the driver chip can be

content/components/esp32.md

@@ -148,6 +148,10 @@ esp32:
 - **enable_idf_experimental_features** (*Optional*, boolean): Can be set to `true` to enable experimental features. Use of
   experimental features may cause instability or other issues.
 
+- **loop_task_stack_size** (*Optional*, int): Loop task stack size in bytes. Increase if experiencing stack overflow
+  errors (e.g., with complex code or deep recursion). Higher values reduce heap availability. Valid range is 8192-32768
+  bytes. Defaults to 8192 bytes.
+
 **LWIP Optimization Options (ESP-IDF only):**
 
 The following options are available under the `advanced` section when using the ESP-IDF framework to optimize

content/components/i2c.md

@@ -9,7 +9,7 @@ params:
 
 {{< anchor "i2c" >}}
 
-This component sets up the I²C bus for your ESP32 or ESP8266. In order for these components
+This component sets up the I²C bus for your ESP32, ESP8266, RP2040 or NRF52. In order for these components
 to work correctly, you need to define the I²C bus in your configuration. Please note the ESP
 will enable its internal 10kΩ pullup resistors for these pins, so you usually don't need to
 put on external ones. You can use multiple devices on one I²C bus as each device is given a
@@ -39,7 +39,8 @@ i2c:
   Defaults to `true`.
 
 - **frequency** (*Optional*, float): Set the frequency the I²C bus should operate on.
-  Defaults to `50kHz`. Values are `10kHz`, `50kHz`, `100kHz`, `200kHz`, ... `800kHz`
+  Defaults to `50kHz`. Default for NRF52 is `100kHz`. Values are `10kHz`, `50kHz`, `100kHz`, `200kHz`, ... `800kHz`.
+  NRF52 supports only `100kHz` and `400kHz`.
 
 - **timeout** (*Optional*, [Time](#config-time)): Set the I²C bus timeout.
   Defaults to the framework defaults (`100us` on `esp32` with `esp-idf`, `50ms` on `esp32` with `Arduino`,

content/components/lvgl/_index.md

@@ -16,7 +16,10 @@ embedded graphics library to create beautiful UIs for any MCU, MPU and display t
 
 To use LVGL with a [display](#display-hw) in ESPHome, you'll need an ESP32 or RP2040. PSRAM is not a strict requirement but it is generally recommended, especially for large color displays.
 
-The graphic display should be configured with `auto_clear_enabled: false` and should not have any `lambda` set. The LVGL component will take care of the display rendering. For most displays, the `update_interval` should be set to `never`, but note that some displays such as OLED and ePaper will need the update interval set to a suitable value.
+The graphic display should be configured with `auto_clear_enabled: false` and should not have any `lambda` set.
+The LVGL component will take care of the display rendering. For most displays, the `update_interval` should be
+set to `never`, but note that some displays such as OLED and e-paper will need the update interval set to a suitable
+interval, or make use of the [`on_draw_end`](#on_draw_end) trigger to manually update the display.
 
 For interactivity, a {{< docref "/components/touchscreen/index" "Touchscreen" >}} (capacitive highly preferred), a {{< docref "/components/sensor/rotary_encoder" >}} or a custom keypad made up from discrete {{< docref "/components/binary_sensor/index" "Binary Sensors" >}} can be used.
 
@@ -827,6 +830,22 @@ This [trigger](#lvgl-automation-triggers) is triggered when LVGL is resumed. Thi
 
 This [trigger](#lvgl-automation-triggers) is triggered after LVGL has been setup. It is also available on any widget, but the timing is the same.
 
+### `on_draw_start`
+
+This [trigger](#lvgl-automation-triggers) is executed before each LVGL drawing operation.
+
+### `on_draw_end`
+
+This [trigger](#lvgl-automation-triggers) is executed after LVGL has completed drawing all updated screen elements. It
+may be used for example to trigger an update of a display component like an e-paper screen that requires the buffer
+to be sent to the display for it to be updated.
+
+```yaml
+lvgl:
+  on_draw_end:
+    component.update: my_display_id
+```
+
 ## See Also
 
 - {{< docref "/cookbook/lvgl" "LVGL Examples in the Cookbook" >}}