Merge pull request #4829 from esphome/bump-2025.4.0

2025.4.0

Author: jesserockz

Doxygen

@@ -38,7 +38,7 @@ PROJECT_NAME           = "ESPHome"
 # could be handy for archiving the generated documentation or if some version
 # control system is used.
 
-PROJECT_NUMBER         = 2025.3.3
+PROJECT_NUMBER         = 2025.4.0
 
 # 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

Makefile

@@ -1,5 +1,5 @@
 ESPHOME_PATH = ../esphome
-ESPHOME_REF = 2025.3.3
+ESPHOME_REF = 2025.4.0
 PAGEFIND_VERSION=1.1.1
 PAGEFIND=pagefind
 NET_PAGEFIND=../pagefindbin/pagefind

_static/changelog-2025.4.0.png

@@ -1 +1 @@
-2025.3.3
+2025.4.0

_static/version

@@ -0,0 +1,184 @@
+ESPHome 2025.4.0 - 16th April 2025
+==================================
+
+.. seo::
+    :description: Changelog for ESPHome 2025.4.0.
+    :image: /_static/changelog-2025.4.0.png
+    :author: Jesse Hills
+    :author_twitter: @jesserockz
+
+.. imgtable::
+    :columns: 3
+
+    MCP4661, components/output/mcp4461, mcp4461.jpg
+
+
+Another small release out this month. I (Jesse) will be back full-time next week and so hopefully we can
+get the project picking up soe steam again.
+
+
+Full list of changes
+--------------------
+
+New Components
+^^^^^^^^^^^^^^
+
+- Add support for MCP4461 quad i2c digipot/rheostat :esphomepr:`8180` by :ghuser:`p1ngb4ck` (new-integration)
+
+Breaking Changes
+^^^^^^^^^^^^^^^^
+
+- Rework max connections for BLE to avoid exceeding the hard limit :esphomepr:`8303` by :ghuser:`bdraco` (breaking-change)
+
+Beta Changes
+^^^^^^^^^^^^
+
+- [lvgl] Fix use of image without canvas (Bugfix) :esphomepr:`8540` by :ghuser:`clydebarrow`
+- Include MAC address in noise hello :esphomepr:`8551` by :ghuser:`bdraco`
+- [axs15231] Don't overwrite manual dimensions :esphomepr:`8553` by :ghuser:`clydebarrow`
+- [lvgl] Fix initial focus on roller :esphomepr:`8547` by :ghuser:`clydebarrow`
+- [lvgl] Add restore_value to select and number :esphomepr:`8494` by :ghuser:`clydebarrow`
+- Speaker-Media-Player: Fix potential deadlock in audio pipeline :esphomepr:`8548` by :ghuser:`gnumpi`
+- [lvgl] Ensure captured lambdas are in correct order :esphomepr:`8560` by :ghuser:`clydebarrow`
+- Bump aioesphomeapi from 29.9.0 to 29.10.0 :esphomepr:`8562` by :ghuser:`dependabot[bot]`
+- Bump zeroconf from 0.146.3 to 0.146.4 :esphomepr:`8563` by :ghuser:`dependabot[bot]`
+- Bump esphome-dashboard to 20250415.0 :esphomepr:`8565` by :ghuser:`swoboda1337`
+- Fix '--device MQTT' for devices with static IP :esphomepr:`8535` by :ghuser:`dwmw2`
+- [am2315c] Use warning not fail during update :esphomepr:`8499` by :ghuser:`swoboda1337`
+- Bump zeroconf from 0.146.4 to 0.146.5 :esphomepr:`8569` by :ghuser:`dependabot[bot]`
+- Fix vscode validation not showing error squiggles :esphomepr:`8500` by :ghuser:`glmnet`
+- SML runtime optimizations :esphomepr:`8571` by :ghuser:`mariusgreuel`
+
+All changes
+^^^^^^^^^^^
+
+- Bump setuptools from 69.2.0 to 76.0.0 :esphomepr:`8405` by :ghuser:`dependabot[bot]`
+- Bump puremagic from 1.27 to 1.28 :esphomepr:`8406` by :ghuser:`dependabot[bot]`
+- Bump esphome-glyphsets from 0.1.0 to 0.2.0 :esphomepr:`8403` by :ghuser:`dependabot[bot]`
+- Bump actions/cache from 4.2.2 to 4.2.3 in /.github/actions/restore-python :esphomepr:`8437` by :ghuser:`dependabot[bot]`
+- Bump actions/cache from 4.2.2 to 4.2.3 :esphomepr:`8433` by :ghuser:`dependabot[bot]`
+- Bump ruff from 0.9.2 to 0.11.0 :esphomepr:`8409` by :ghuser:`dependabot[bot]`
+- Bump pylint from 3.2.7 to 3.3.6 :esphomepr:`8441` by :ghuser:`dependabot[bot]`
+- Update wheel requirement from ~=0.43.0 to >=0.43,<0.46 :esphomepr:`8421` by :ghuser:`dependabot[bot]`
+- Bump tzlocal from 5.2 to 5.3.1 :esphomepr:`8423` by :ghuser:`dependabot[bot]`
+- [esp32] Allow pioarduino versions 5.3.2 and 5.4.0 :esphomepr:`8440` by :ghuser:`swoboda1337`
+- [cli] Add `--reset` and `--upload_speed` options :esphomepr:`8380` by :ghuser:`clydebarrow`
+- Bump aioesphomeapi from 29.6.0 to 29.7.0 :esphomepr:`8448` by :ghuser:`dependabot[bot]`
+- Bump pytest-asyncio from 0.23.6 to 0.25.3 :esphomepr:`8447` by :ghuser:`dependabot[bot]`
+- [core] Fix 5.4.0 build issue :esphomepr:`8455` by :ghuser:`swoboda1337`
+- [core] Fix s2 build after crc header fix :esphomepr:`8459` by :ghuser:`swoboda1337`
+- [esp32_can] Configurable enqueue timeout :esphomepr:`8453` by :ghuser:`patagonaa`
+- [scheduler] Properly handle millis() overflow :esphomepr:`8197` by :ghuser:`clydebarrow`
+- [esp32] Allow pioarduino version 5.4.1 :esphomepr:`8480` by :ghuser:`swoboda1337`
+- Bump ruff from 0.11.0 to 0.11.2 :esphomepr:`8461` by :ghuser:`dependabot[bot]`
+- [psram] 120MHz does not work in octal mode :esphomepr:`8477` by :ghuser:`clydebarrow`
+- Bump actions/setup-python from 5.4.0 to 5.5.0 :esphomepr:`8468` by :ghuser:`dependabot[bot]`
+- Bump actions/setup-python from 5.4.0 to 5.5.0 in /.github/actions/restore-python :esphomepr:`8467` by :ghuser:`dependabot[bot]`
+- Bump pytest-cov from 5.0.0 to 6.0.0 :esphomepr:`8462` by :ghuser:`dependabot[bot]`
+- Bump pytest-asyncio from 0.25.3 to 0.26.0 :esphomepr:`8490` by :ghuser:`dependabot[bot]`
+- Bump async-timeout from 4.0.3 to 5.0.1 :esphomepr:`8491` by :ghuser:`dependabot[bot]`
+- Bump platformio from 6.1.16 to 6.1.18 :esphomepr:`8449` by :ghuser:`dependabot[bot]`
+- Move CONF_DEFAULT to const.py :esphomepr:`8497` by :ghuser:`nielsnl68`
+- [lvgl] Add some defines :esphomepr:`8501` by :ghuser:`clydebarrow`
+- Add support for MCP4461 quad i2c digipot/rheostat :esphomepr:`8180` by :ghuser:`p1ngb4ck` (new-integration)
+- Bump peter-evans/create-pull-request from 7.0.7 to 7.0.8 :esphomepr:`8362` by :ghuser:`dependabot[bot]`
+- Bump docker/login-action from 3.3.0 to 3.4.0 in the docker-actions group :esphomepr:`8408` by :ghuser:`dependabot[bot]`
+- Bump actions/download-artifact from 4.1.9 to 4.2.1 :esphomepr:`8434` by :ghuser:`dependabot[bot]`
+- Bump actions/upload-artifact from 4.6.1 to 4.6.2 :esphomepr:`8435` by :ghuser:`dependabot[bot]`
+- Bump ruamel-yaml from 0.18.6 to 0.18.10 :esphomepr:`8446` by :ghuser:`dependabot[bot]`
+- Bump yamllint from 1.35.1 to 1.37.0 :esphomepr:`8495` by :ghuser:`dependabot[bot]`
+- Bump pyupgrade from 3.15.2 to 3.19.1 :esphomepr:`8496` by :ghuser:`dependabot[bot]`
+- Bump voluptuous from 0.14.2 to 0.15.2 :esphomepr:`8506` by :ghuser:`dependabot[bot]`
+- Bump zeroconf from 0.146.1 to 0.146.3 :esphomepr:`8507` by :ghuser:`dependabot[bot]`
+- Bump platformio to 6.1.18 :esphomepr:`8430` by :ghuser:`shvmm`
+- Update emails from nabucasa to OHF :esphomepr:`8508` by :ghuser:`jesserockz`
+- [nau7802] fix bad blocking code (#6395) :esphomepr:`8070` by :ghuser:`cujomalainey`
+- [core, qspi_dbi] Clang tidy fixes for 5.3.2 :esphomepr:`8509` by :ghuser:`swoboda1337`
+- [CI] Clang tidy fixes for 5.3.2 :esphomepr:`8510` by :ghuser:`swoboda1337`
+- [ethernet_info] return actual ethernet MAC address :esphomepr:`8492` by :ghuser:`victorclaessen`
+- Bump setuptools from 76.0.0 to 78.1.0 :esphomepr:`8512` by :ghuser:`dependabot[bot]`
+- Bump flake8 from 7.0.0 to 7.2.0 :esphomepr:`8493` by :ghuser:`dependabot[bot]`
+- Rework max connections for BLE to avoid exceeding the hard limit :esphomepr:`8303` by :ghuser:`bdraco` (breaking-change)
+- [component] Show error message for failed component :esphomepr:`8478` by :ghuser:`clydebarrow`
+- [psram] Allow use of experimental 120MHz octal mode :esphomepr:`8519` by :ghuser:`clydebarrow`
+- Ensure plaintext responds with bad indicator byte before dropping the connection :esphomepr:`8521` by :ghuser:`bdraco`
+- Bump aioesphomeapi to 29.9.0 :esphomepr:`8522` by :ghuser:`bdraco`
+- [lvgl] add on_boot trigger :esphomepr:`8498` by :ghuser:`clydebarrow`
+- [lvgl] Make line points templatable :esphomepr:`8502` by :ghuser:`clydebarrow`
+- [spi] Implement octal mode :esphomepr:`8386` by :ghuser:`clydebarrow`
+- Bump pytest from 8.2.0 to 8.3.5 :esphomepr:`8528` by :ghuser:`dependabot[bot]`
+- real_time_clock: Apply timezone immediately in set_timezone() :esphomepr:`8531` by :ghuser:`dwmw2`
+- [lvgl] Implement canvas widget :esphomepr:`8504` by :ghuser:`clydebarrow`
+- [lvgl] Fix use of image without canvas (Bugfix) :esphomepr:`8540` by :ghuser:`clydebarrow`
+- Include MAC address in noise hello :esphomepr:`8551` by :ghuser:`bdraco`
+- [axs15231] Don't overwrite manual dimensions :esphomepr:`8553` by :ghuser:`clydebarrow`
+- [lvgl] Fix initial focus on roller :esphomepr:`8547` by :ghuser:`clydebarrow`
+- [lvgl] Add restore_value to select and number :esphomepr:`8494` by :ghuser:`clydebarrow`
+- Speaker-Media-Player: Fix potential deadlock in audio pipeline :esphomepr:`8548` by :ghuser:`gnumpi`
+- [lvgl] Ensure captured lambdas are in correct order :esphomepr:`8560` by :ghuser:`clydebarrow`
+- Bump aioesphomeapi from 29.9.0 to 29.10.0 :esphomepr:`8562` by :ghuser:`dependabot[bot]`
+- Bump zeroconf from 0.146.3 to 0.146.4 :esphomepr:`8563` by :ghuser:`dependabot[bot]`
+- Bump esphome-dashboard to 20250415.0 :esphomepr:`8565` by :ghuser:`swoboda1337`
+- Fix '--device MQTT' for devices with static IP :esphomepr:`8535` by :ghuser:`dwmw2`
+- [am2315c] Use warning not fail during update :esphomepr:`8499` by :ghuser:`swoboda1337`
+- Bump zeroconf from 0.146.4 to 0.146.5 :esphomepr:`8569` by :ghuser:`dependabot[bot]`
+- Fix vscode validation not showing error squiggles :esphomepr:`8500` by :ghuser:`glmnet`
+- SML runtime optimizations :esphomepr:`8571` by :ghuser:`mariusgreuel`
+
+Past Changelogs
+---------------
+
+- :doc:`2025.3.0`
+- :doc:`2025.2.0`
+- :doc:`2024.12.0`
+- :doc:`2024.11.0`
+- :doc:`2024.10.0`
+- :doc:`2024.9.0`
+- :doc:`2024.8.0`
+- :doc:`2024.7.0`
+- :doc:`2024.6.0`
+- :doc:`2024.5.0`
+- :doc:`2024.4.0`
+- :doc:`2024.3.0`
+- :doc:`2024.2.0`
+- :doc:`2023.12.0`
+- :doc:`2023.11.0`
+- :doc:`2023.10.0`
+- :doc:`2023.9.0`
+- :doc:`2023.8.0`
+- :doc:`2023.7.0`
+- :doc:`2023.6.0`
+- :doc:`2023.5.0`
+- :doc:`2023.4.0`
+- :doc:`2023.3.0`
+- :doc:`2023.2.0`
+- :doc:`2022.12.0`
+- :doc:`2022.11.0`
+- :doc:`2022.10.0`
+- :doc:`2022.9.0`
+- :doc:`2022.8.0`
+- :doc:`2022.6.0`
+- :doc:`2022.5.0`
+- :doc:`2022.4.0`
+- :doc:`2022.3.0`
+- :doc:`2022.2.0`
+- :doc:`2022.1.0`
+- :doc:`2021.12.0`
+- :doc:`2021.11.0`
+- :doc:`2021.10.0`
+- :doc:`2021.9.0`
+- :doc:`2021.8.0`
+- :doc:`v1.20.0`
+- :doc:`v1.19.0`
+- :doc:`v1.18.0`
+- :doc:`v1.17.0`
+- :doc:`v1.16.0`
+- :doc:`v1.15.0`
+- :doc:`v1.14.0`
+- :doc:`v1.13.0`
+- :doc:`v1.12.0`
+- :doc:`v1.11.0`
+- :doc:`v1.10.0`
+- :doc:`v1.9.0`
+- :doc:`v1.8.0`
+- :doc:`v1.7.0`

changelog/2025.4.0.rst

@@ -2,7 +2,7 @@ Changelog
 =========
 
 .. redirect::
-    :url: /changelog/2025.3.0.html
+    :url: /changelog/2025.4.0.html
 
 .. toctree::
     :glob:

changelog/index.rst

@@ -45,6 +45,12 @@ Configuration:
 
 - **active** (*Optional*, boolean): Enables proxying active connections. Defaults to ``false``.
 - **cache_services** (*Optional*, boolean): Enables caching GATT services in NVS flash storage which significantly speeds up active connections. Defaults to ``true`` when using the ESP-IDF framework.
+- **connection_slots** (*Optional*, int): The maximum number of BLE connection slots to use.
+  Each configured slot consumes ~1KB of RAM. This can only be adjusted when using
+  the ``esp-idf`` framework up to a maximum of ``9``. It is recommended not to exceed ``5``
+  connection slots to avoid memory issues. Defaults to ``3``.
+  The value must not exceed the total configured ``max_connections``
+  for :doc:`esp32_ble_tracker`.
 
 The Bluetooth proxy depends on :doc:`esp32_ble_tracker` so make sure to add that to your configuration.
 
@@ -113,6 +119,7 @@ This configuration is for an Olimex ESP32-PoE-ISO board with an Ethernet connect
 
     bluetooth_proxy:
       active: true
+      connection_slots: 3
 
 
 See Also

components/bluetooth_proxy.rst

@@ -28,6 +28,8 @@ Configuration variables:
 - **tx_pin** (**Required**, :ref:`Pin <config-pin>`): Transmit pin.
 - **rx_queue_len** (**Optional**, int): Length of RX queue.
 - **tx_queue_len** (**Optional**, int): Length of TX queue, 0 to disable.
+- **tx_enqueue_timeout** (**Optional**, :ref:`config-time`): Maximum time to wait when the TX queue is full before
+  dropping the message (by default, this is set to the time it takes to send 10 CAN messages at the given bit rate).
 - All other options from :ref:`Canbus <config-canbus>`.
 
 .. _esp32-can-bit-rate:

components/canbus/esp32_can.rst

@@ -112,6 +112,9 @@ Advanced Configuration
 - **ignore_efuse_mac_crc** (*Optional*, boolean): Can be set to ``true`` for devices on which the burned-in MAC
   address is not consistent with the burned-in CRC for that MAC address, resulting in an error like
   ``Base MAC address from BLK0 of EFUSE CRC error``. **Valid only on original ESP32 with** ``esp-idf`` **framework.**
+- **enable_idf_experimental_features** (*Optional*, boolean): Can be set to ``true`` to enable
+  experimental features in the ESP-IDF framework. Not valid for the Arduino framework. Use of experimental features
+  may cause instability or other issues.
 
 GPIO Pin Numbering
 ------------------

components/esp32.rst

@@ -23,6 +23,7 @@ the MAC address of a device and track it using ESPHome.
 
     # Example configuration entry
     esp32_ble_tracker:
+      max_connections: 3
 
     binary_sensor:
       - platform: ble_presence
@@ -86,6 +87,13 @@ Configuration variables:
     asked to start a scan (with start_scan action). Defaults to ``true``.
 
 - **id** (*Optional*, :ref:`config-id`): Manually specify the ID for this ESP32 BLE Hub.
+- **max_connections** (*Optional*, int): The maximum number of BLE connection slots to use.
+  Each configured slot consumes ~1KB of RAM. It is recommended not to exceed ``5``
+  connection slots to avoid memory issues. Defaults to ``3``.
+  This can only be adjusted when using the ``esp-idf`` framework up to a maximum of ``9``.
+  This value cannot exceed the total number of ``connection_slots`` for the
+  :doc:`bluetooth_proxy` component combined with the total
+  configured :doc:`ble_client` instances.
 
 Automations:
 

components/esp32_ble_tracker.rst

@@ -66,6 +66,7 @@ Advanced options:
   See :ref:`esphome-min_version`.
 - **compile_process_limit** (*Optional*, int): The maximum number of simultaneous compile processes to run.
   Defaults to the number of cores of the CPU which is also the maximum you can set.
+- **debug_scheduler** (*Optional*, boolean): If set, the scheduler will print debug information about scheduled tasks at log level DEBUG.
 
 Automations:
 

components/esphome.rst

@@ -910,6 +910,7 @@ Output Components
     GP8403, components/output/gp8403, gp8403.svg
     GPIO Output, components/output/gpio, gpio.svg
     LibreTiny PWM, components/output/libretiny_pwm, pwm.png
+    MCP4661, components/output/mcp4461, mcp4461.jpg
     MCP4725, components/output/mcp4725, mcp4725.jpg
     MCP4728, components/output/mcp4728, mcp4728.jpg
     MCP47A1, components/output/mcp47a1, mcp47a1.svg

components/index.rst

@@ -47,10 +47,14 @@ Advanced settings:
 -  **on_message** (*Optional*, :ref:`Automation <automation>`): An action to be
    performed when a message is to be logged. The variables ``int level``, ``const char* tag`` and
    ``const char* message`` are available for lambda processing.
--  **deassert_rts_dtr** (*Optional*, boolean): Deasserts RTS/DTR when opening
-   log over UART. This is useful if RTS/DTR signals are directly connected to
-   the reset pin or strapping pins. Note: Deassert typically means high on TTL
-   level since RTS/DTR are usually low active signals. Defaults to ``false``.
+-  **deassert_rts_dtr** (*Optional*, boolean): Causes ESPHome to sequentially drive DTR and RTS false after opening
+   a serial logging connection. Defaults to ``false``.
+   Many ESP boards use these signals to reset the chip or enter
+   bootloader mode, and the effect of setting this option will be
+   to reset the chip in application mode after opening the serial port, thus ensuring that all log messages
+   from the boot process are captured.
+   Note: Deassert typically means a TTL high level
+   level since RTS/DTR are usually low active signals.
 
 .. _logger-hardware_uarts:
 

components/logger.rst

@@ -452,6 +452,32 @@ Feel free to experiment to discover inheritance and precedence of the styles bas
 
 :ref:`lvgl-cookbook-theme` The Cookbook contains an example which demonstrates how to implement a gradient style for your widgets.
 
+``lvgl.style.update``
+*********************
+
+This :ref:`action <actions-action>` allows changing/updating the properties of a style at run time. This can be used to
+implement dynamic themes, e.g. light/dark mode, or to change the appearance of widgets based on user interaction.
+
+The action takes a style ID and a dictionary of properties to update. The properties can be any of the style properties listed above, and the values are templatable.components
+
+.. code-block:: yaml
+
+    # Example configuration entry
+    lvgl:
+      style_definitions:
+        - id: my_style
+          bg_color: 0xFFFFFF
+          border_color: 0x000000
+          border_width: 2
+
+    # Action to update the style
+    on_...:
+      - lvgl.style.update:
+          id: my_style
+          properties:
+            bg_color: 0xFF0000
+            border_color: 0x00FF00
+
 .. _lvgl-layouts:
 
 Layouts
@@ -921,6 +947,12 @@ This :ref:`trigger <lvgl-automation-triggers>` is triggered when LVGL is paused.
 This :ref:`trigger <lvgl-automation-triggers>` is triggered when LVGL is resumed. This can be used to perform any desired actions when the screen is unlocked, such as turning on the display backlight.
 
 
+``on_boot``
+*************
+
+This :ref:`trigger <lvgl-automation-triggers>` is triggered after LVGL has been setup. It is also available on any widget, but the timing is the same.
+
+
 See Also
 --------