@@ -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
--------------------
0 commit comments