Skip to content

Commit ff99033

Browse files
kbx81jesserockz
authored andcommitted
Add changelog text (#4662)
1 parent 24c0638 commit ff99033

File tree

1 file changed

+66
-0
lines changed

1 file changed

+66
-0
lines changed

changelog/2025.2.0.rst

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,72 @@ ESPHome 2025.2.0 - 19th February 2025
2222
Mixer Speaker, components/speaker/mixer, mixer.svg
2323
Resampler Speaker, components/speaker/resampler, waveform.svg, dark-invert
2424

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.
2591

2692
Full list of changes
2793
--------------------

0 commit comments

Comments
 (0)