esphome · swoboda1337 · Nov 19, 2025 · Oct 8, 2025 · Oct 9, 2025 · Oct 9, 2025
diff --git a/.gitignore b/.gitignore
@@ -19,6 +19,9 @@ __pycache__/
 *.py[cod]
 *$py.class
 
+# Release notes generator cache (persistent PR cache + version-specific data)
+script/cache/
+
 venv
 
 *.DS_Store

diff --git a/all_automations.json b/all_automations.json
@@ -287,6 +287,7 @@
     "remote_transmitter.transmit_dish",
     "remote_transmitter.transmit_dooya",
     "remote_transmitter.transmit_drayton",
+    "remote_transmitter.transmit_dyson",
     "remote_transmitter.transmit_haier",
     "remote_transmitter.transmit_jvc",
     "remote_transmitter.transmit_keeloq",

diff --git a/content/automations/actions.md b/content/automations/actions.md
@@ -462,7 +462,21 @@ on_...:
 
 - **condition** (**Required**, [condition](#all-conditions)): 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
 

diff --git a/content/automations/all_actions.md b/content/automations/all_actions.md
@@ -23,6 +23,7 @@ title: ""
 - **dfrobot_sen0395:** `reset`, `settings`
 - **display_menu:** `down`, `enter`, `hide`, `left`, `right`, `show`, `show_main`, `up`
 - **ds1307:** `read_time`, `write_time`
+- **rx8130:** `read_time`, `write_time`
 - **esp32_ble_tracker:** `start_scan`, `stop_scan`
 - **event:** `trigger`
 - **ezo_pmp:** `arbitrary_command`, `change_i2c_address`, `clear_calibration`, `clear_total_volume_dosed`, `dose_continuously`, `dose_volume`, `dose_volume_over_time`, `dose_with_constant_flow_rate`, `find`, `pause_dosing`, `set_calibration_volume`, `stop_dosing`

diff --git a/content/changelog/2025.11.0.md b/content/changelog/2025.11.0.md
diff --git a/content/changelog/_index.md b/content/changelog/_index.md
@@ -3,4 +3,4 @@ description: "Changelog"
 title: "Changelog"
 ---
 
-{{< redirect url="/changelog/2025.10.0.html" >}}
+{{< redirect url="/changelog/2025.11.0.html" >}}
diff --git a/content/changelog/images/changelog-2025.11.0.png b/content/changelog/images/changelog-2025.11.0.png
diff --git a/content/components/_index.md b/content/components/_index.md
@@ -123,6 +123,7 @@ ESPHome-specific components or components supporting ESPHome device provisioning
 "ESP32 BLE Server","components/esp32_ble_server","bluetooth.svg","dark-invert"
 "Bluetooth Proxy","components/bluetooth_proxy","bluetooth.svg","dark-invert"
 "Improv via BLE","components/esp32_improv","improv.svg","dark-invert"
+"Nordic UART Service (NUS)","components/ble_nus","uart.svg",""
 {{< /imgtable >}}
 
 ## Management and Monitoring
@@ -166,6 +167,7 @@ Create update entities simplifying management of OTA updates.
 "I²S Audio","components/i2s_audio","i2s_audio.svg",""
 "OpenTherm","components/opentherm","opentherm.png",""
 "SPI Bus","components/spi","spi.svg",""
+"TinyUSB","components/tinyusb","usb.svg","dark-invert"
 "UART","components/uart","uart.svg",""
 "USB Host","components/usb_host","usb.svg","dark-invert"
 "USB UART","components/usb_uart","usb.svg","dark-invert"
@@ -272,6 +274,7 @@ Sensors are organized into categories; if a given sensor fits into more than one
 "CD74HC4067","components/sensor/cd74hc4067","cd74hc4067.jpg","16-channel analog multiplexer",""
 "MCP3008","components/sensor/mcp3008","mcp3008.jpg","8-channel ADC",""
 "MCP3204 / MCP3208","components/sensor/mcp3204","mcp3204.jpg","4-channel ADC",""
+"MCP3221","components/sensor/mcp3221","mcp3221.png","ADC",""
 "NAU7802","components/sensor/nau7802","nau7802.jpg","ADC",""
 "Resistance","components/sensor/resistance","omega.svg","dark-invert",""
 {{< /imgtable >}}
@@ -361,6 +364,7 @@ Sensors are organized into categories; if a given sensor fits into more than one
 "AM2315C","components/sensor/am2315c","am2315c.jpg","Temperature & Humidity",""
 "AM2320","components/sensor/am2320","am2320.jpg","Temperature & Humidity",""
 "b-parasite","components/sensor/b_parasite","b_parasite.jpg","Moisture & Temperature & Humidity & Light",""
+"BH1900NUX","components/sensor/bh1900nux","bh1900nux-evk-001.png","Temperature",""
 "BME280","components/sensor/bme280","bme280.jpg","Temperature & Humidity & Pressure",""
 "BME68x via BSEC2","components/sensor/bme68x_bsec2","bme680.jpg","Temperature & Humidity & Pressure & Gas",""
 "BME680 via BSEC","components/sensor/bme680_bsec","bme680.jpg","Temperature & Humidity & Pressure & Gas",""
@@ -377,6 +381,7 @@ Sensors are organized into categories; if a given sensor fits into more than one
 "ENS160","components/sensor/ens160","ens160.jpg","eCO₂ & Air Quality",""
 "ENS210","components/sensor/ens210","ens210.jpg","Temperature & Humidity",""
 "HDC1080","components/sensor/hdc1080","hdc1080.jpg","Temperature & Humidity",""
+"HDC2010","components/sensor/hdc2010","hdc2010.png","Temperature & Humidity",""
 "HHCCJCY10 (MiFlora Pink)","components/sensor/xiaomi_hhccjcy10","xiaomi_hhccjcy10.jpg","Soil moisture & Temperature & Light",""
 "Honeywell ABP","components/sensor/honeywellabp","honeywellabp.jpg","Pressure & Temperature",""
 "Honeywell ABP2 I2C","components/sensor/honeywellabp2_i2c","honeywellabp.jpg","Pressure & Temperature",""
@@ -994,6 +999,7 @@ at the {{< docref "light/fastled" "FastLED Light" >}}.
 {{< imgtable >}}
 "Time Core","components/time/index","clock-outline.svg","dark-invert"
 "DS1307 RTC","components/time/ds1307","clock-outline.svg","dark-invert"
+"RX8130 RTC","components/time/rx8130","clock-outline.svg","dark-invert"
 "GPS Time","components/time/gps","crosshairs-gps.svg","dark-invert"
 "Home Assistant Time","components/time/homeassistant","home-assistant.svg","dark-invert"
 "PCF85063 RTC","components/time/pcf85063","clock-outline.svg","dark-invert"
@@ -1047,6 +1053,7 @@ ESPHome to cellular networks. **Does not encompass Wi-Fi.**
 "Exposure Notifications","components/exposure_notifications","exposure_notifications.png",""
 "GPS","components/gps","crosshairs-gps.svg","dark-invert"
 "Grow Fingerprint Reader","components/fingerprint_grow","fingerprint.svg","dark-invert"
+"HLK-FM22x Face Recognition Module","components/hlk_fm22x","face.svg","dark-invert"
 "Modbus Controller","components/modbus_controller","modbus.png",""
 "Sprinkler","components/sprinkler","sprinkler-variant.svg","dark-invert"
 "Status LED","components/status_led","led-on.svg","dark-invert"

diff --git a/content/components/api.md b/content/components/api.md
@@ -75,9 +75,13 @@ api:
     If you need a key, you can use the key below; it is randomly generated by your browser each time this page loads:
 
 {{< api-key-input >}}
+
 > [!NOTE]
 > Support for configuring the encryption key on-the-fly will be implemented in a future release of Home Assistant.
 
+> [!TIP]
+> For comprehensive security guidance including API encryption best practices, see the [Security Best Practices](/guides/security_best_practices) guide.
+
 - **actions** (*Optional*, list): A list of user-defined actions. See [User-defined Actions](#api-device-actions).
 - **batch_delay** (*Optional*, [Time](/guides/configuration-types#time)): The delay time for batching multiple state update messages
   together to reduce network overhead. Lower values send updates sooner but use more network packets,

diff --git a/content/components/ble_nus.md b/content/components/ble_nus.md
@@ -0,0 +1,39 @@
+---
+description: "Nordic UART Service (NUS)"
+title: "Nordic UART Service (NUS)"
+params:
+  seo:
+    description: BLE UART support using Nordic UART Service (NUS) for ESPHome logging and communication.
+    image: uart.svg
+---
+
+The BLE NUS component provides a Bluetooth Low Energy UART interface based on the Nordic UART Service.
+It can be used to stream logs or enable custom bidirectional communication with ESPHome.
+
+```yaml
+# Example configuration entry
+ble_nus:
+  type: logs
+```
+
+## Configuration variables
+
+- **type** (**Required**, string): Mode of operation. Must be set to ``logs`` to stream ESPHome logs over the BLE UART.
+
+## Usage
+
+To connect and view logs from the device over BLE:
+
+```bash
+esphome logs d.yaml --device BLE
+```
+
+Or connect to a specific BLE address:
+
+```bash
+esphome logs d.yaml --device 00:11:22:33:44:55
+```
+
+## See Also
+
+- Nordic UART Service <https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/libraries/bluetooth/services/nus.html>
diff --git a/content/components/climate/climate_ir.md b/content/components/climate/climate_ir.md
@@ -216,11 +216,12 @@ climate:
 
 ### `toshiba`
 
-- **model** (*Optional*, string): There are two valid models
+- **model** (*Optional*, string): There are four valid models:
 
   - `GENERIC`  : Temperature range is from 17 to 30 (default)
   - `RAC-PT1411HWRU-C`  : Temperature range is from 16 to 30; unit displays temperature in degrees Celsius
   - `RAC-PT1411HWRU-F`  : Temperature range is from 16 to 30; unit displays temperature in degrees Fahrenheit
+  - `RAS-2819T`  : Temperature range is from 18 to 30; supports two-packet IR protocol
 
 > [!NOTE]
 >
@@ -237,9 +238,22 @@ climate:
 >   internal temperature sensor; a value of 30 seconds seems to work well. See {{< docref "/components/sensor" >}}
 >   for more information.
 >
+> - The `RAS-2819T` model uses a two-packet IR protocol where most commands send a primary packet (containing
+>   temperature, mode, and fan speed) followed by a secondary packet (containing fan speed confirmation and
+>   mode-specific data). Single-packet commands are used for power-off and swing toggle operations.
+>
 > - This climate IR component is also known to work with Midea model MAP14HS1TBL and may work with other similar
 >   models, as well. (Midea acquired Toshiba's product line and re-branded it.)
 
+```yaml
+# Example configuration entry for RAS-2819T
+climate:
+  - platform: toshiba
+    name: "Toshiba AC"
+    model: RAS-2819T
+    sensor: room_temperature
+```
+
 {{< anchor "whirlpool" >}}
 
 ### `whirlpool`

diff --git a/content/components/climate/thermostat.md b/content/components/climate/thermostat.md
@@ -161,8 +161,8 @@ Got all that? Great. Let's take a closer look at some configuration.
 The thermostat controller uses the sensor to determine whether it should heat or cool.
 
 - **sensor** (**Required**, [ID](/guides/configuration-types#id)): The sensor that is used to measure the current temperature.
-- **humidity_sensor** (*Optional*, [ID](/guides/configuration-types#id)): If specified, this sensor is used to measure the current humidity.
-  This is used for information only and does not influence temperature control.
+- **humidity_sensor** (*Optional*, [ID](/guides/configuration-types#id)): If specified, this sensor is used to measure
+  the current humidity. This may be used for humidity control; see [Humidity Control Actions](#humidity-control-actions).
 
 ### Heating and Cooling Actions
 
@@ -296,6 +296,20 @@ These should be used to control the fan only, if available.
 - **swing_both_action** (*Optional*, [Action](/automations/actions#all-actions)): The action to call when the fan
   should oscillate in horizontal and vertical directions.
 
+### Humidity Control Actions
+
+These are triggered when the humidity control action is changed by the thermostat controller. It can trigger actions
+to activate humidification **or** dehumidification.
+
+- **humidity_control_dehumidify_action** (*Optional*, [Action](#config-action)): The action to call when
+  dehumidification is required.
+
+- **humidity_control_humidify_action** (*Optional*, [Action](#config-action)): The action to call when
+  humidification is required.
+
+- **humidity_control_off_action** (*Optional*, [Action](#config-action)): The action to call when
+  (de)humidification should stop. This action is **required** when either of the above actions are configured.
+
 ## Advanced Configuration/Behavior
 
 ### Set Point Options/Behavior
@@ -467,8 +481,11 @@ climate:
 
 ### Additional Actions/Behavior
 
-- **target_temperature_change_action** (*Optional*, [Action](/automations/actions#all-actions)): The action to call when the
-  thermostat's target temperature(s) is/are changed.
+- **target_humidity_change_action** (*Optional*, [Action](/automations/actions#all-actions)): The action to call when
+  the thermostat's target humidity is changed.
+
+- **target_temperature_change_action** (*Optional*, [Action](/automations/actions#all-actions)): The action to call when
+  the thermostat's target temperature(s) is/are changed.
 
 - **startup_delay** (*Optional*, boolean): If set to `true`, when ESPHome starts, `min_cooling_off_time`,
   `min_fanning_off_time`, and `min_heating_off_time` must elapse before each respective action may be invoked.
@@ -544,6 +561,9 @@ the range of allowed temperature values in the thermostat component. See {{< doc
 - **heat_overrun** (*Optional*, float): The minimum temperature differential (heating beyond the set point)
   before calling the idle [action](/automations/actions#all-actions). Defaults to 0.5 °C.
 
+- **humidity_hysteresis** (*Optional*, float): The maximum humidity differential (above/below the set point)
+  before calling the respective humidity control [action](#config-action). Defaults to 1%.
+
 > [!NOTE]
 >
 > - While this platform uses the term temperature everywhere, it can also be used to regulate other values.

diff --git a/content/components/display/epaper_spi.md b/content/components/display/epaper_spi.md
@@ -15,28 +15,35 @@ better integration with ESPHome's async architecture.
 The communication method uses 4-wire [SPI](/components/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](/guides/configuration-types#pin-schema)): The CS pin.
-- **dc_pin** (**Required**, [Pin Schema](/guides/configuration-types#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>               |
+| 7.3in Spectra-E6       | Eink         | <https://www.eink.com/product/detail/EL073TF1U5>           |
+| 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](/guides/configuration-types#pin-schema)): The BUSY pin. Defaults to not connected.
-- **reset_pin** (*Optional*, [Pin Schema](/guides/configuration-types#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](/guides/configuration-types#pin-schema)): The CS pin. Predefined for integrated boards.
+- **dc_pin** (**Required**, [Pin Schema](/guides/configuration-types#pin-schema)): The DC pin. Predefined for integrated boards.
+- **busy_pin** (*Optional*, [Pin Schema](/guides/configuration-types#pin-schema)): The BUSY pin, if used.
+- **reset_pin** (*Optional*, [Pin Schema](/guides/configuration-types#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

diff --git a/content/components/display/mipi_rgb.md b/content/components/display/mipi_rgb.md
@@ -40,15 +40,16 @@ These boards have completely pre-filled configurations for the display driver, s
 option is `model`.
 
 | Board                        | Driver Chip | Manufacturer | Product link                                                     |
-| ---------------------------- | ----------- | ------------ | ---------------------------------------------------------------- |
+|------------------------------| ----------- | ------------ | ---------------------------------------------------------------- |
 | GUITION-4848S040             | ST7701s     | Guition      | <https://devices.esphome.io/devices/Guition-ESP32-S3-4848S040>   |
 | T-PANEL-S3                   | ST7701s     | Lilygo       | <https://lilygo.cc/products/t-panel-s3>                          |
 | T-RGB-2.1                    | ST7701s     | Lilygo       | <https://lilygo.cc/products/t-rgb>                               |
 | T-RGB-2.8                    | ST7701s     | Lilygo       | <https://lilygo.cc/products/t-rgb>                               |
 | SEEED-INDICATOR-D1           | ST7701s     | Seeed Studio | <https://www.seeedstudio.com/SenseCAP-Indicator-D1L-p-5646.html> |
 | ESP32-S3-TOUCH-LCD-4.3       | RPI         | Waveshare    | <https://www.waveshare.com/esp32-s3-touch-lcd-4.3.htm>           |
 | ESP32-S3-TOUCH-LCD-7-800X480 | RPI         | Waveshare    | <https://www.waveshare.com/esp32-s3-touch-lcd-7.htm>             |
-| WAVESHARE-4-480x480          | RPI         | Waveshare    | <https://www.waveshare.com/esp32-s3-touch-lcd-4.htm>             |
+| WAVESHARE-4-480X480          | RPI         | Waveshare    | <https://www.waveshare.com/esp32-s3-touch-lcd-4.htm>             |
+| WAVESHARE-5-1024X600         | RPI         | Waveshare    | <https://www.waveshare.com/esp32-s3-touch-lcd-5.htm>             |
 
 ## Usage