File tree Expand file tree Collapse file tree 2 files changed +34
-1
lines changed Expand file tree Collapse file tree 2 files changed +34
-1
lines changed Original file line number Diff line number Diff line change @@ -142,6 +142,39 @@ long-term security and maintainability.
142
142
will not upgrade beyond version 2025.7.x. You must upgrade your Python installation first.
143
143
144
144
145
+ Breaking Changes
146
+ ---------------
147
+
148
+ ESPHome 2025.8.0 includes several breaking changes that may require action on your part:
149
+
150
+ **Python 3.11+ Requirement **
151
+ As detailed above, Python 3.10 support has been dropped. Upgrade your Python installation before updating ESPHome.
152
+
153
+ **Bluetooth Proxy Changes **
154
+ - Parsed advertisement support removed to save memory
155
+ - V1 connection support removed (affects older integrations)
156
+
157
+ **API Optimizations **
158
+ - Deprecated protobuf fields removed (reduces flash usage)
159
+ - Conditional compilation for Home Assistant state/service subscriptions
160
+ - May affect custom API clients using deprecated fields
161
+
162
+ **Component Filter Changes **
163
+ - :doc: `LD2410 </components/sensor/ld2410 >` and :doc: `LD2450 </components/sensor/ld2450 >` components now use native filters instead of ``throttle ``
164
+ - If you were using ``throttle ``, replace with equivalent native filters
165
+
166
+ **ESP32 Touch Sensor **
167
+ - Workaround implemented for ESP-IDF v5.4 regression
168
+ - May affect touch sensor behavior on newer ESP-IDF versions
169
+
170
+ **BLE Optimizations **
171
+ - Conditional compilation for BLE advertising and service classes
172
+ - May reduce available BLE features if not explicitly enabled
173
+
174
+ Most of these changes are automatic optimizations that shouldn't affect typical usage, but custom integrations
175
+ or advanced configurations may need updates.
176
+
177
+
145
178
Full list of changes
146
179
--------------------
147
180
Original file line number Diff line number Diff line change @@ -2207,4 +2207,4 @@ Contributors
2207
2207
- `Christian Zufferey (@zuzu59) <https://github.com/zuzu59 >`__
2208
2208
- `Zynth-dev (@Zynth-dev) <https://github.com/Zynth-dev >`__
2209
2209
2210
- *This page was last updated August 13 , 2025. *
2210
+ *This page was last updated August 14 , 2025. *
You can’t perform that action at this time.
0 commit comments