Merge pull request #4808 from esphome/bump-2025.4.0b1

2025.4.0b1

Author: jesserockz

CODE_OF_CONDUCT.md

@@ -34,7 +34,7 @@ This Code of Conduct applies both within project spaces and in public spaces whe
 
 ## Enforcement
 
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at esphome@nabucasa.com. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at esphome@openhomefoundation.org. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
 
 Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
 

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.0b1
 
 # 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.0b1
 PAGEFIND_VERSION=1.1.1
 PAGEFIND=pagefind
 NET_PAGEFIND=../pagefindbin/pagefind

_static/version

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

_templates/contact.html

@@ -3,7 +3,7 @@
     <li><a href="https://discord.gg/KhAMKrd" target="_blank">Join the community</a></li>
     <li><a href="https://twitter.com/esphome_" target="_blank">Follow us on Twitter</a></li>
     <li><a href="https://github.com/esphome/esphome" target="_blank">Source Code</a></li>
-    <li><a href="mailto:esphome@nabucasa.com">Contact</a> (no support!)</li>
+    <li><a href="mailto:esphome@openhomefoundation.org">Contact</a> (no support!)</li>
 </ul>
 ESPHome is part of the <a href="https://www.openhomefoundation.org/" target="_blank">Open Home Foundation</a>
 <ul>

_templates/layout.html

@@ -61,7 +61,7 @@
     <div class="side">
       <div class="links">
         <a href="https://github.com/esphome/esphome" target="_blank">Source Code</a>
-        <a href="mailto:esphome@nabucasa.com">Contact</a><small>(no support)</small>
+        <a href="mailto:esphome@openhomefoundation.org">Contact</a><small>(no support)</small>
       </div>
       <a href="https://www.netlify.com" class="link-netlify" target="_blank">This site is powered by Netlify</a>
     </div>

changelog/2025.4.0.rst

@@ -0,0 +1,150 @@
+ESPHome 2025.4.0 - 16th April 2025
+==================================
+
+.. seo::
+    :description: Changelog for ESPHome 2025.4.0.
+    :image: /_static/changelog-2025.3.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)
+
+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`
+
+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/index.rst

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

components/bluetooth_proxy.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/canbus/esp32_can.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/esp32.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_ble_tracker.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/esphome.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/index.rst

@@ -107,6 +107,7 @@ Bluetooth/BLE
     ESP32 BLE Beacon, components/esp32_ble_beacon, bluetooth.svg, dark-invert
     ESP32 BLE Client, components/ble_client, bluetooth.svg, dark-invert
     ESP32 BLE Tracker, components/esp32_ble_tracker, bluetooth.svg, dark-invert
+    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
 
@@ -909,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/logger.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/lvgl/index.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
 --------
 

components/lvgl/widgets.rst

@@ -1026,6 +1026,14 @@ The line widget is capable of drawing straight lines between a set of points.
 
 By default, the Line widget width and height dimensions are set to ``SIZE_CONTENT``. This means it will automatically set its size to fit all the points. If the size is set explicitly, parts of the line may not be visible.
 
+The points list may be defined with constants in the form ``x, y`` or as a list of dictionaries with ``x`` and ``y`` keys. The latter allows for more complex point definitions, such as using a lambda function to calculate the coordinates.
+
+**Actions:**
+
+- ``lvgl.line.update`` :ref:`action <actions-action>` updates the points and any style properties.
+    - **id** (**Required**): The ID or a list of IDs of lines to update.
+    - **points** (**Required**): A point list as described above.
+
 **Example:**
 
 .. code-block:: yaml
@@ -1036,7 +1044,8 @@ By default, the Line widget width and height dimensions are set to ``SIZE_CONTEN
           - 5, 5
           - 70, 70
           - 120, 10
-          - 180, 60
+          - x: !lambda return random_uint32() % 100;
+            y: !lambda return random_uint32() % 100;
           - 230, 15
         line_width: 8
         line_color: 0x0000FF
@@ -1962,6 +1971,14 @@ when the page becomes active or inactive respectively.
                 transition_length: 0ms
                 brightness: !lambda return x / 100;
 
+
+``on_boot``
+*************
+
+This :ref:`trigger <lvgl-automation-triggers>` is triggered after LVGL has been setup. It is available on the ``lvgl`` component and any widget and can be used to perform any LVGL related setup that is not possible with static configuration.
+When used on a widget, it does not act specifically on that widget but can be used to keep actions related to that widget together with its configuration.
+
+
 See Also
 --------