@@ -22,6 +22,72 @@ ESPHome 2025.2.0 - 19th February 2025
22
22
Mixer Speaker, components/speaker/mixer, mixer.svg
23
23
Resampler Speaker, components/speaker/resampler, waveform.svg, dark-invert
24
24
25
+ **🎉 Happy New Year! 🎉 **
26
+
27
+ We're kicking off 2025 with a number of updates, several of which are focused on removing old code. Unfortunately,
28
+ this means we have a few breaking changes, but this work helps keep ESPHome more maintainable in the long-run.
29
+
30
+ Removal of "old style" Platform Configuration
31
+ ---------------------------------------------
32
+
33
+ `Three years ago <https://github.com/esphome/esphome/pull/2303 >`__, we added support for using
34
+ `ESP-IDF <https://github.com/espressif/esp-idf/ >`__ directly (as an alternative to Arduino). This brought about a
35
+ number of benefits and a new syntax was introduced to facilitate greater flexibility when specifying and configuring
36
+ your microcontroller/board.
37
+
38
+ In this release, we've removed support for the "old style" of configuring your microcontroller/board. If you're still
39
+ using it, you'll need to update your configurations to use the new style. A brief explanation is
40
+ `here <https://github.com/esphome/esphome/pull/8118 >`__, but for more detail, please see the
41
+ :ref: `documentation for your microcontroller platform <devices >`.
42
+
43
+ Removal of Custom Components
44
+ ----------------------------
45
+
46
+ Custom components were deprecated over a year ago and, as promised, support for them was removed in this release. We
47
+ encourage all developers to migrate their custom components to :doc: `/components/external_components `. Please see
48
+ :ref: `a_note_about_custom_components ` for a detailed explanation and next steps.
49
+
50
+ Removal of ``armv7 `` Docker Support
51
+ -----------------------------------
52
+
53
+ ESPHome no longer supports ``armv7 `` hardware. This is due to both waning support as it relates to tooling and
54
+ performance reasons. We strongly recommend moving to a more modern architecture, especially if you're using the ESPHome
55
+ Device Builder to build/compile firmware for your devices.
56
+
57
+ ``esp32_rmt `` Updates
58
+ ---------------------
59
+
60
+ Components which utilize the RMT hardware found on the ESP32 and its variants have been updated to use the new
61
+ interface available in `ESP-IDF <https://github.com/espressif/esp-idf/ >`__ versions 5 and above. This eliminates
62
+ related warnings seen in the compiler logs while building ESPHome configurations. In most cases, you won't notice any
63
+ difference, but this change could result in some issues, particularly for :doc: `/components/external_components `. You
64
+ may need to make a minor change or two in your device configurations; the configuration validator will tell you if this
65
+ is necessary as you update your devices.
66
+
67
+ Audio Components
68
+ ----------------
69
+
70
+ This release includes support for a number of new audio-related components/hardware. These are primarily aimed at
71
+ supporting hardware found in Espressif's S3-Box series of products, eliminating the need to use the
72
+ `ESP-ADF <https://github.com/espressif/esp-adf/ >`__ and thus offering better integration with ESPHome in general. If
73
+ you're using an S3-Box (or one of the variants), we strongly recommend updating your device either OTA or by using our
74
+ :doc: `/projects/index ` web installer. If you have "taken control" of or "adopted" your S3-Box, we strongly recommend
75
+ updating your device's local configuration based on our updated configuration files found
76
+ `here <https://github.com/esphome/wake-word-voice-assistants >`__.
77
+
78
+ In addition, new ``speaker `` components have been introduced to provide more advanced functionality when using
79
+ :doc: `/components/voice_assistant `. These components extend our work to help you create the ultimate personal voice
80
+ assistant hardware.
81
+
82
+ Image Components
83
+ ----------------
84
+
85
+ This release adds support for alpha-blending images when using LVGL. To facilitate this, the ``use_transparency ``
86
+ configuration variable in :doc: `/components/image ` and related components was renamed to ``transparency `` and changed
87
+ from a boolean to an enum; in addition, the ``type `` configuration variable is now mandatory. See the
88
+ :doc: `/components/image ` documentation for more detail.
89
+
90
+ Finally, the :doc: `/components/online_image ` was updated to add support for both BMP and JPEG image formats.
25
91
26
92
Full list of changes
27
93
--------------------
@@ -60,6 +126,16 @@ Breaking Changes
60
126
- Remove arm/v7 container image support :esphomepr: `8194 ` by :ghuser: `jesserockz ` (breaking-change)
61
127
- [esp32_rmt] Set pull-up and open-drain modes based on pin schema :esphomepr: `8178 ` by :ghuser: `swoboda1337 ` (breaking-change)
62
128
129
+ Beta Changes
130
+ ^^^^^^^^^^^^
131
+
132
+ - [core] Ignore dot-prefixed config entries when looking for target platform :esphomepr: `8240 ` by :ghuser: `jesserockz `
133
+ - Bump zeroconf to 0.144.1 :esphomepr: `8238 ` by :ghuser: `bdraco `
134
+ - [core] Fix ``config_dir `` for dashboard :esphomepr: `8242 ` by :ghuser: `jesserockz `
135
+ - [cse7766] Remove ``stream `` dependency :esphomepr: `7720 ` by :ghuser: `gabest11 `
136
+ - [graph] Remove ``stream `` dependency :esphomepr: `8243 ` by :ghuser: `kbx81 `
137
+ - [modbus_controller] Remove `stream ` dependency :esphomepr: `8244 ` by :ghuser: `kbx81 `
138
+
63
139
All changes
64
140
^^^^^^^^^^^
65
141
@@ -239,6 +315,12 @@ All changes
239
315
- GDEY042T81 e-paper displays support :esphomepr: `8061 ` by :ghuser: `mgruener `
240
316
- Add support for Waveshare 7.3" ACeP 7-Color display :esphomepr: `6380 ` by :ghuser: `NeilSCGH `
241
317
- Bump esphome-dashboard to 20250212.0 :esphomepr: `8235 ` by :ghuser: `jesserockz `
318
+ - [core] Ignore dot-prefixed config entries when looking for target platform :esphomepr: `8240 ` by :ghuser: `jesserockz `
319
+ - Bump zeroconf to 0.144.1 :esphomepr: `8238 ` by :ghuser: `bdraco `
320
+ - [core] Fix ``config_dir `` for dashboard :esphomepr: `8242 ` by :ghuser: `jesserockz `
321
+ - [cse7766] Remove ``stream `` dependency :esphomepr: `7720 ` by :ghuser: `gabest11 `
322
+ - [graph] Remove ``stream `` dependency :esphomepr: `8243 ` by :ghuser: `kbx81 `
323
+ - [modbus_controller] Remove `stream ` dependency :esphomepr: `8244 ` by :ghuser: `kbx81 `
242
324
243
325
Past Changelogs
244
326
---------------
0 commit comments