# ESPHome lista wydań zawierających Breaking Changes (zmiany wstecznie niekompatybilne)

**URL:** <https://forum.arturhome.pl/t/esphome-lista-wydan-zawierajacych-breaking-changes-zmiany-wstecznie-niekompatybilne/12986>\
**Category:** Aplikacje\
**Tags:** aktualizacja, esphome, breaking-changes\
**Created:** [19 Wrzesień 2024 11:14 UTC](https://forum.arturhome.pl/t/esphome-lista-wydan-zawierajacych-breaking-changes-zmiany-wstecznie-niekompatybilne/12986 "2024-09-19T11:14:11Z")\
**Posts on this page:** 8\
**Page:** 1

<div class="post-metadata">

**Autor:** ![szopen](https://forum.arturhome.pl/user_avatar/forum.arturhome.pl/szopen/32/1093_2.png) [@szopen](https://forum.arturhome.pl/u/szopen)\
**Data wpisu:** [19 Wrzesień 2024 11:14 UTC](https://forum.arturhome.pl/t/esphome-lista-wydan-zawierajacych-breaking-changes-zmiany-wstecznie-niekompatybilne/12986/1 "2024-09-19T11:14:11Z")

</div>

**Od 2018 roku do września 2024 tylko 2 czy 3 wydania nie zawierały breaking changes…** (a wydania comiesięczne zaczęły się pojawiać mniej więcej na początku 2021 roku! czasem z pojedynczymi przerwami wakacyjnymi, ponadto dokumentacja od tego czasu jest wydawana ściśle równolegle ze zmianami).

Nie ma więc chyba sensu bym podawał linki do jakichś archaicznych wydań, skoro dokumentacja zawsze zawiera rekurencyjne linki do starszych wydań

> **[Changelog](https://esphome.io/changelog/)**
>
> ESPHome Changelog

Póki co tylko te wydania które spowodowały spore poruszenie (wstępnie oznaczyłem je pogrubieniem) oraz kilka ostatnich z pomniejszymi zmianami (później na miarę wolnego czasu przebuduję wątek, więc pozostaje zamknięty i podwieszony).

* * *

[lata do 2020 włącznie](https://forum.arturhome.pl/t/esphome-lista-wydan-zawierajacych-breaking-changes-zmiany-wstecznie-niekompatybilne/12986/4)

[rok 2021](https://forum.arturhome.pl/t/esphome-lista-wydan-zawierajacych-breaking-changes-zmiany-wstecznie-niekompatybilne/12986/5)

[rok 2022](https://forum.arturhome.pl/t/esphome-lista-wydan-zawierajacych-breaking-changes-zmiany-wstecznie-niekompatybilne/12986/6)

[rok 2023](https://forum.arturhome.pl/t/esphome-lista-wydan-zawierajacych-breaking-changes-zmiany-wstecznie-niekompatybilne/12986/7)

[rok 2024](https://forum.arturhome.pl/t/esphome-lista-wydan-zawierajacych-breaking-changes-zmiany-wstecznie-niekompatybilne/12986/8)

[rok 2025](https://forum.arturhome.pl/t/esphome-lista-wydan-zawierajacych-breaking-changes-zmiany-wstecznie-niekompatybilne/12986/9)

[rok 2026](https://forum.arturhome.pl/t/esphome-lista-wydan-zawierajacych-breaking-changes-zmiany-wstecznie-niekompatybilne/12986/10)

---

<div class="post-metadata">

**Autor:** ![szopen](https://forum.arturhome.pl/user_avatar/forum.arturhome.pl/szopen/32/1093_2.png) [@szopen](https://forum.arturhome.pl/u/szopen)\
**Data wpisu:** [19 Wrzesień 2024 11:35 UTC](https://forum.arturhome.pl/t/esphome-lista-wydan-zawierajacych-breaking-changes-zmiany-wstecznie-niekompatybilne/12986/4 "2024-09-19T11:35:19Z")

</div>

* * *

# lata do 2020 roku

* * *

Wersje wcześniejsze od 1.7.0 nie mają dedykowanych rozdziałów w aktualnej dokumentacji, więc wcześniejszą historię można szukać w notatkach do wydań na [starym repozytorium](https://github.com/esphome/esphome-core/releases), ale moim zdaniem nie było tam jawnie listowanych breaking changes

* * *

1.7.0 (czerwiec 2018) - Fixed the [SHT3x-D] component and removed the `accuracy` parameter. The accuracy now defaults to `HIGH`; The `inverted` option of binary sensors has been moved into the `filters:` section; The `esp32_ble` component and platform have been renamed to [esp32\_ble\_tracker] in order to make the naming clearer with the new [esp32\_ble\_beacon] component; The `receive_timeout` option has been removed from the [**i2c component]** as it turns out it didn’t actually do anything; The `ir_transmitter` component has been renamed to [**remote\_transmitter**] as it now works with all kinds of protocols, not just infrared-based ones; The `pull_mode` option of the [**Pulse Counter**](https://esphome.io/components/sensor/pulse_counter) has been removed, please use the [Pin Schema] now instead. Additionally, the `internal_filter` option now only accepts [time] units.

> **[Version 1.7.0](https://esphome.io/changelog/v1.7.0/)**
>
> Changelog for esphomelib version 1.7.0.

* * *

1.8.0 (listopad 2018) - The [core configuration] has been reworked a bit to a) make using different arduino framework version easier and b) make editing your local esphomelib copy easier; **Light Effects** now need to be manually declared in the config and will no longer show up automatically; **MAX6675** has been migrated to use the new SPI bus (and fixed!). Please see the docs for how to use it now

> **[Version 1.8.0](https://esphome.io/changelog/v1.8.0/)**
>
> Changelog for esphomelib version 1.8.0.

* * *

1.9.0 (listopad 2018) - As part of the rewrite of Over-The-Air updates, the old **OTA** protocol is incompatible with the new one - But fear not, esphomeyaml still supports the legacy OTA update process. On your first OTA upload with 1.9.0, you will see esphomeyaml try with the new OTA method and fail. After that, esphomeyaml will fall back to the old OTA process and upload correctly; esphomelib’s naming convention has been made more consistent. If you’re not using any [lambdas](https://esphome.io/automations/templates#config-lambda), everything will still work. However, if you’re using the C++ API, there are a couple of breaking changes:  
For sensors and binary sensors, `id(my_sensor).value` has been deprecated and `id(my_sensor).state` should be used instead. Additionally, the syntax for toggling lights and switches through C++ has been changed.

> **[Changelog - Version 1.9.0](https://esphome.io/changelog/v1.9.0/)**
>
> Changelog for esphomelib version 1.9.0.

* * *

1.10.0 (styczeń 2019) - Previously, esphomelib would by default only publish every 15th sensor value in order to provide averaged values. However, that often confused users and I now decided to remove it **and** set the default update interval of all components to `60s` instead of the previous `15s`.; The **fastled** effects have been renamed to `addressable_` for the new [**Neopixelbus**] integration.

> **[Changelog - Version 1.10.0](https://esphome.io/changelog/v1.10.0/)**
>
> Changelog for esphomelib version 1.10.0.

* * *

1.11.0 (luty 2019) - **Template Switches** no longer restore their state by default; Removed heartbeat filter from **binary sensors** ; `optimistic` mode for **template platforms** has been split off into `optimistic` and `assumed_state` options; `run_cycles` has been removed from **deep\_sleep**

> **[Changelog - Version 1.11.0](https://esphome.io/changelog/v1.11.0/)**
>
> Changelog for esphomelib version 1.11.0.

* * *

1.12.0 (marzec 2019) - The `timeout_meter` and `timeout_time` options of the **ultrasonic** sensor have been merged into `timeout`, Ultrasonic Sensor no longer works with GPIO16 as echo pin on ESP8266s because the implementation switched to an asynchronous interrupt mode.

> **[Changelog - Version 1.12.0](https://esphome.io/changelog/v1.12.0/)**
>
> Changelog for ESPHome version 1.12.0.

* * *

1.13.0 (maj 2019) - `esphome_core_version` has been removed - ESPHome is no longer split up in the core and python repository; The `esp32_ble_tracker` binary sensor platform (not the global hub) has been renamed to `ble_presence`; The remote transmitter switch has been removed and a template switch with the new actions should be used. See validation output; `esphome_core_version` has been removed - ESPHome is no longer split up in the core and python repository; because of some internal changes, some **ID names** are used internally and can no longer be used. See validation errors.

> **[Changelog - Version 1.13.0 - May 30th 2019](https://esphome.io/changelog/v1.13.0/)**
>
> Changelog for ESPHome version 1.13.0.

* * *

1.14.0 (listopad 2019) - **deprecated support for Python 2 installs** ; The `xiaomi_` BLE platforms have been renamed to match their model numbers; As part of the addition of the captive portal component, the default `reboot_timeout` for `wifi` has been increased to 15 minutes from the previous 5 minutes; The ESP32 **LEDC** `bit_depth` option has been removed. The best bit depth is now dynamically calculated; For [**pcf8574**], the `INPUT_PULLUP` option has been removed and replaced with `INPUT`

> **[Changelog - Version 1.14.0 - November 1](https://esphome.io/changelog/v1.14.0/)**
>
> Changelog for ESPHome version 1.14.0.

* * *

1.15.0 (wrzesień 2020) - **Drop Python 2 Support** ; Fix **SGP30** incorrect baseline reading/writing; fix **servo** bug restoring state and starting servo detached; fix shunt voltage / current / power reading in **INA3221** ; **Component script** not stopped in certain situations, New script modes POC

> **[Changelog - Version 1.15.0 - September 13, 2020](https://esphome.io/changelog/v1.15.0/)**
>
> Changelog for ESPHome version 1.15.0.

---

<div class="post-metadata">

**Autor:** ![szopen](https://forum.arturhome.pl/user_avatar/forum.arturhome.pl/szopen/32/1093_2.png) [@szopen](https://forum.arturhome.pl/u/szopen)\
**Data wpisu:** [19 Wrzesień 2024 11:35 UTC](https://forum.arturhome.pl/t/esphome-lista-wydan-zawierajacych-breaking-changes-zmiany-wstecznie-niekompatybilne/12986/5 "2024-09-19T11:35:34Z")

</div>

* * *

# rok 2021

* * *

1.16.0 (luty 2021) - Enable reverse display of the **Max7219 digit** ; **Pulse\_counter** measure total pulses; Support **I2C** transactions with combined reads and writes

> **[Changelog - Version 1.16.0 - February 3, 2021](https://esphome.io/changelog/v1.16.0/)**
>
> Changelog for ESPHome version 1.16.0.

* * *

1.17.0 (4 maj 2021) - **MCP23XXX** Refactor

> **[Changelog - Version 1.17.0 - 4th May 2021](https://esphome.io/changelog/v1.17.0/)**
>
> Changelog for ESPHome version 1.17.0.

* * *

1.18.0 (19 maj 2021) - Raise **minimum python version to 3.7** ; esphome: Change **wifi signal strength** unit to dBm; esphome: Use core constants for sample duration on **bh1750**

> **[Changelog - Version 1.18.0 - 19th May 2021](https://esphome.io/changelog/v1.18.0/)**
>
> Changelog for ESPHome version 1.18.0.

* * *

1.19.0 (czerwiec 2021) - Drop 128x160 **ESP-32 camera** resolution; teleinfo: use text\_sensor and sensor; CLI user experience improvements

> **[Changelog - Version 1.19.0 - 16th June 2021](https://esphome.io/changelog/v1.19.0/)**
>
> Changelog for ESPHome version 1.19.0.

* * *

1.20.0 (lipiec 2021) - Change color model to fix white channel issues - **addressable RGBW lights** + **RGBW lights** ; remote\_receiver use config parent receiver for registering dumpers; **Remove a whole bunch of deprecated/removed stuff** ; catch 0.0 in float set\_level pre-adjustment; **Climate mode meaning was changed**

> **[Changelog - Version 1.20.0 - 21st July 2021](https://esphome.io/changelog/v1.20.0/)**
>
> Changelog for ESPHome version 1.20.0.

* * *

2021.8.0 - Merge build flags from **platformio\_options** ; Color mode implementation; Fix parity bit calculation for **ESP8266SoftwareSerial** ; Dont force 0 state instead of **min\_power** unless explicit config set; **Anova** fahrenheit support; Tidy **HA addon** ; **Thermostat** enhancements 2

> **[ESPHome 2021.8.0 - 18th August 2021](https://esphome.io/changelog/2021.8.0/)**
>
> Changelog for ESPHome 2021.8.0.

* * *

2021.9.0 - Fix **SDM energy** units to be KILO; Reject **template select/number/switches** that don’t handle user input; Remove **last\_reset\_type** and convert all those sensors to **TOTAL\_INCREASING** ; **Midea** support v2

> **[ESPHome 2021.9.0 - 15th September 2021](https://esphome.io/changelog/2021.9.0/)**
>
> Changelog for ESPHome 2021.9.0.

* * *

2021.10.0 - Combine code of **xiaomi\_miscale** and **xiaomi\_miscale2** ; Correctly invert the float output state; Add **SSD1305** support to **SSD1306** integration along with few new options; Disable dependency finder on ESP32

> **[ESPHome 2021.10.0 - 20th October 2021](https://esphome.io/changelog/2021.10.0/)**
>
> Changelog for ESPHome 2021.10.0.

* * *

2021.11.0 - **TCS34725** BugFix and GA factor; Limit **hostnames** to 31 characters; Move default build path to .esphome directory; ESP8266 disable PIO LDF; Remove autoload of **xiaomi\_ble** and **ruuvi\_ble** ; **BH1750** : Fix a too high default H-res2 mode value; Add option to use **MQTT** abbreviations; Add restore\_mode to **rotary\_encoder** ; **Neopixelbus** redo method definitions; Update **device classes** for binary sensors; **BLE\_Sensor** : Use as\_reversed\_hex\_array to properly parse UUIDs after

> **[ESPHome 2021.11.0 - 17th November 2021](https://esphome.io/changelog/2021.11.0/)**
>
> Changelog for ESPHome 2021.11.0.

* * *

2021.12.0 - Fix **NEC protocol** implementation; **Tuya Cover** improvements  
[https://esphome.io/changexiaomi\_blelog/2021.12.0](https://esphome.io/changexiaomi_blelog/2021.12.0)

---

<div class="post-metadata">

**Autor:** ![szopen](https://forum.arturhome.pl/user_avatar/forum.arturhome.pl/szopen/32/1093_2.png) [@szopen](https://forum.arturhome.pl/u/szopen)\
**Data wpisu:** [19 Wrzesień 2024 11:35 UTC](https://forum.arturhome.pl/t/esphome-lista-wydan-zawierajacych-breaking-changes-zmiany-wstecznie-niekompatybilne/12986/6 "2024-09-19T11:35:44Z")

</div>

* * *

# rok 2022

wydania lipcowego nie było - okres wakacyjny

* * *

2022.1.0 - **Modbus** : use multiply for publishing number; Upgrade ArduinoJson to 6.18.5 and migrate code; Fix backwards string case helpers

> **[ESPHome 2022.1.0 - 19th January 2022](https://esphome.io/changelog/2022.1.0/)**
>
> Changelog for ESPHome 2022.1.0.

* * *

2022.2.0 - [**TCS34725**] remove duplicated endian conversion; **TSL2591** automatic gain control; [**debug**] Refactor debug sensors to use the normal sensor model; Allow framework version validator to be maximum version

> **[ESPHome 2022.2.0 - 16th February 2022](https://esphome.io/changelog/2022.2.0/)**
>
> Changelog for ESPHome 2022.2.0.

* * *

2022.3.0 - **BH1750** dynamically calculate options; Add class as first positional arg to sensor\_schema; Raise **minimum python version to 3.8**

> **[ESPHome 2022.3.0 - 16th March 2022](https://esphome.io/changelog/2022.3.0/)**
>
> Changelog for ESPHome 2022.3.0.

* * *

2022.4.0 - Make **home\_assistant** imported sensors internal by default

> **[ESPHome 2022.4.0 - 20th April 2022](https://esphome.io/changelog/2022.4.0/)**
>
> Changelog for ESPHome 2022.4.0.

* * *

2022.5.0 - **select** component; **number** component

> **[ESPHome 2022.5.0 - 18th May 2022](https://esphome.io/changelog/2022.5.0/)**
>
> Changelog for ESPHome 2022.5.0.

* * *

2022.6.0 - **TCS34725** automatic sampling settings; support for **SGP41** ; Remove deprecated **fan speeds** ; Output a true RMS voltage %, Add display\_type property to DisplayBuffer

> **[ESPHome 2022.6.0 - 15th June 2022](https://esphome.io/changelog/2022.6.0/)**
>
> Changelog for ESPHome 2022.6.0.

* * *

wydania lipcowego (które by miało numer wersji 2022.7.0) nie było - okres wakacyjny

* * *

2022.8.0 - Extend **ST7789V** component to support additional displays; Refactor **BedJet** climate into Hub component; Remove min\_save\_interval from intergration and total\_daily\_energy; Rework NaN handling in sensor filters

> **[ESPHome 2022.8.0 - 17th August 2022](https://esphome.io/changelog/2022.8.0/)**
>
> Changelog for ESPHome 2022.8.0.

* * *

2022.9.0 - **jedna z niewielu wersji nie mających oficjalnie breaking changes**

> **[ESPHome 2022.9.0 - 21st September 2022](https://esphome.io/changelog/2022.9.0/)**
>
> Changelog for ESPHome 2022.9.0.

* * *

2022.10.0 - **Thermostat** remove deprecated config; Bump **python min to 3.9** ; Refactor **xpt2046** to be a **touchscreen** platform; Add **ble RSSI** sensor for connected devices

> **[ESPHome 2022.10.0 - 19th October 2022](https://esphome.io/changelog/2022.10.0/)**
>
> Changelog for ESPHome 2022.10.0.

* * *

2022.11.0 - Don’t Use Base Network Manual IP for **WiFi AP**

> **[ESPHome 2022.11.0 - 16th November 2022](https://esphome.io/changelog/2022.11.0/)**
>
> Changelog for ESPHome 2022.11.0.

* * *

2022.12.0 - Update esp32 arduino and platform versions; Docker Container images

> **[ESPHome 2022.12.0 - 14th December 2022](https://esphome.io/changelog/2022.12.0/)**
>
> Changelog for ESPHome 2022.12.0.

---

<div class="post-metadata">

**Autor:** ![szopen](https://forum.arturhome.pl/user_avatar/forum.arturhome.pl/szopen/32/1093_2.png) [@szopen](https://forum.arturhome.pl/u/szopen)\
**Data wpisu:** [19 Wrzesień 2024 11:36 UTC](https://forum.arturhome.pl/t/esphome-lista-wydan-zawierajacych-breaking-changes-zmiany-wstecznie-niekompatybilne/12986/7 "2024-09-19T11:36:02Z")

</div>

* * *

# rok 2023

wydania styczniowego nie było - okres wakacyjny

* * *

2023.2.0 - Use NAN values for **TSL2591** saturation; set\_retry: add retries remaining parameter to the provided function

> **[ESPHome 2023.2.0 - 15th February 2023](https://esphome.io/changelog/2023.2.0/)**
>
> Changelog for ESPHome 2023.2.0.

* * *

**2023.3.0** - Renaming and extending the **ili9341** to the **ili9xxx** component, **sn74hc165** fixes, **Sprinkler** “v2” updates, Add configurable color datapoint

> **[ESPHome 2023.3.0 - 15th March 2023](https://esphome.io/changelog/2023.3.0/)**
>
> Changelog for ESPHome 2023.3.0.

* * *

**2023.4.0** - **UART** ids - Disallow **uart0/1/2** as ids in config, Number `step` - Require step to be set when calling register\_number, Default **restore mode** for Switches, Fans and Lights

> **[ESPHome 2023.4.0 - 19th April 2023](https://esphome.io/changelog/2023.4.0/)**
>
> Changelog for ESPHome 2023.4.0.

* * *

2023.5.0 - Remove climate legacy away flags, Revert “Template sensors always publish on update interval”

> **[ESPHome 2023.5.0 - 17th May 2023](https://esphome.io/changelog/2023.5.0/)**
>
> Changelog for ESPHome 2023.5.0.

* * *

2023.6.0 - Migrate **VOC sensors** that use ppb to use volatile\_organic\_compounds\_parts device class, **display** : add BaseImage and provide only Image::get\_pixel method, Add transparency support to all image types, Allow **i2s microphone** bits per sample to be configured, Move ESPTime into core esphome namespace

> **[ESPHome 2023.6.0 - 21st June 2023](https://esphome.io/changelog/2023.6.0/)**
>
> Changelog for ESPHome 2023.6.0.

* * *

2023.7.0 - Remove template switch `restore_state`, display: add BaseFont and introduce Font::draw methods Rename display.DisplayBufferRef to display.DisplayRef used by lambda

> **[ESPHome 2023.7.0 - 19th July 2023](https://esphome.io/changelog/2023.7.0/)**
>
> Changelog for ESPHome 2023.7.0.

* * *

**2023.8.0** - Coolix IR protocol, Speaker return bytes written and do not wait for queue, Change device name in **MQTT discovery** messages to friendly names, Add configuration flow abilites to the **ld2410** component

> **[ESPHome 2023.8.0 - 16th August 2023](https://esphome.io/changelog/2023.8.0/)**
>
> Changelog for ESPHome 2023.8.0.

* * *

**2023.9.0** - **Home Assistant Add-on** - Use /data directory for .esphome folder when running as HA add-on, Enum device class - Synchronise Device Classes from Home Assistant

> **[ESPHome 2023.9.0 - 27th September 2023](https://esphome.io/changelog/2023.9.0/)**
>
> Changelog for ESPHome 2023.9.0.

* * *

**2023.10.0** - **SPS30** ; **SHT3x** had a `heater_enabled` config option added in the 2023.9.0 release with a default value of `true`. This has been flipped this release to be `false` as it started causing issues with various sensors.

> **[ESPHome 2023.10.0 - 18th October 2023](https://esphome.io/changelog/2023.10.0/)**
>
> Changelog for ESPHome 2023.10.0.

* * *

2023.11.0 - Hydreon, Fix esp32\_rmt\_led\_strip custom timing units

> **[ESPHome 2023.11.0 - 15th November 2023](https://esphome.io/changelog/2023.11.0/)**
>
> Changelog for ESPHome 2023.11.0.

* * *

**2023.12.0** - **MCP3008** , Pin Reuse validation, **SH1107 → SSD1306** , sen5x, Ensure names containing characters other than a-z A-Z 0-9 or \_ are unique, **Nextion** colors parameters, Updating the touchscreen interface structure

> **[ESPHome 2023.12.0 - 20th December 2023](https://esphome.io/changelog/2023.12.0/)**
>
> Changelog for ESPHome 2023.12.0.

* * *

---

<div class="post-metadata">

**Autor:** ![szopen](https://forum.arturhome.pl/user_avatar/forum.arturhome.pl/szopen/32/1093_2.png) [@szopen](https://forum.arturhome.pl/u/szopen)\
**Data wpisu:** [19 Wrzesień 2024 11:36 UTC](https://forum.arturhome.pl/t/esphome-lista-wydan-zawierajacych-breaking-changes-zmiany-wstecznie-niekompatybilne/12986/8 "2024-09-19T11:36:38Z")

</div>

* * *

# rok 2024

wydania styczniowego nie było - okres wakacyjny

* * *

**2024.2.0** - **BME280** , PMSx003, cse7766, combination sensor and remove absorbed kalman\_combinator component

> **[ESPHome 2024.2.0 - 21st February 2024](https://esphome.io/changelog/2024.2.0/)**
>
> Changelog for ESPHome 2024.2.0.

* * *

**2024.3.0** - Haier Climate, template fan, Touchscreen component, LTR390

> **[ESPHome 2024.3.0 - 20th March 2024](https://esphome.io/changelog/2024.3.0/)**
>
> Changelog for ESPHome 2024.3.0.

* * *

2024.4.0 - new modes in Tuya Climate, IPv6 string RFC5952

> **[ESPHome 2024.4.0 - 17th April 2024](https://esphome.io/changelog/2024.4.0/)**
>
> Changelog for ESPHome 2024.4.0.

* * *

2024.5.0 [sn74hc595], SM2135, DNS sensor, datetime entities, BMP390, BMP380

> **[ESPHome 2024.5.0 - 15th May 2024](https://esphome.io/changelog/2024.5.0/)**
>
> Changelog for ESPHome 2024.5.0.

* * *

**2024.6.0** - **OTA Platforms** , **DS18B20** , **[dallas]** → **1-Wire** , **safe\_mode** , ENS160, [http\_request], parse\_json

> **[ESPHome 2024.6.0 - 19th June 2024](https://esphome.io/changelog/2024.6.0/)**
>
> Changelog for ESPHome 2024.6.0.

> [@ESPHome Problem po aktualizacji 2024.6.0](https://forum.arturhome.pl/t/esphome-problem-po-aktualizacji-2024-6-0/12526):
>
> U mnie Po aktualizacji do wersji 2024.6.0 jest problem z uruchomieniem usługi aktualizacji ESPHome.

> [@Integracja z Midea AC](https://forum.arturhome.pl/t/integracja-z-midea-ac/1850/306):
>
> Witajcie! Pomóżcie bo już mi ręce opadają. Płytka ESP-01S Wgrany ESPHome W dodatku ESPHome w HA mam dodaną płytkę Próbuje wgrać kod do obsługi klimy i niestety cały czas zgłasza jakieś błędy (nawet wrzucając kod innych użytkowników, którym on działa. Przyznaję się to pierwsze szlify z ESPHome, natomiast nie wiem gdzie szukać problemu. Komunikat błędu brzmi następująco, natomiast w kodzie mam taki fragment ota: password: "" INFO ESPHome 2024.8.3 INFO Reading configuration /config/espho…

* * *

2024.7.0 - [dooya], [modbus\_text\_sensor], [micro\_wake\_word]

> **[ESPHome 2024.7.0 - 17th July 2024](https://esphome.io/changelog/2024.7.0/)**
>
> Changelog for ESPHome 2024.7.0.

> [@Breaking changes w ESPHome 2024.7.x](https://forum.arturhome.pl/t/breaking-changes-w-esphome-2024-7-x/12650):
>
> Nie są to wprawdzie zmiany dotyczące większości instalacji i urządzeń ESPHome jak [przed miesiącem](https://forum.arturhome.pl/t/esphome-problem-po-aktualizacji-2024-6-0/12526) ale i tak warto zajrzeć do changeloga (dotyczą m.in. modnego ostatnio voiceassistanta i wybranych integracji z modbus)

* * *

2024.8.0 - argument parser

> **[ESPHome 2024.8.0 - 21st August 2024](https://esphome.io/changelog/2024.8.0/)**
>
> Changelog for ESPHome 2024.8.0.

* * *

**2024.9.0** - **[ili9xxx]**, **BMP280** , I2S config settings, **[i2s\_audio]**

> **[ESPHome 2024.9.0 - 18th September 2024](https://esphome.io/changelog/2024.9.0/)**
>
> Changelog for ESPHome 2024.9.0.

**2024.9.0** - zmiany w definicji platformy rp2040  
[https://esphome.io/components/rp2040](https://esphome.io/components/rp2040)

* * *

**2024.10.0** - **Haier** , [ch422g], **CSE7766** , [web\_server] v3

> **[ESPHome 2024.10.0 - 16th October 2024](https://esphome.io/changelog/2024.10.0/)**
>
> Changelog for ESPHome 2024.10.0.

* * *

2024.11.0 - [spi\_device], [qspi\_amoled] → [qspi\_dbi], [lvgl], [http\_request], [touchscreen], UNIT\_VOLT\_AMPS\_REACTIVE ‘VAR’ → “var”

> **[ESPHome 2024.11.0 - 20th November 2024](https://esphome.io/changelog/2024.11.0/)**
>
> Changelog for ESPHome 2024.11.0.

* * *

**2024.12.0** - **dużo zmian w architekturze** - przede wszystkim odejście od oficjalnych wydań [platform.io](https://esphome.io/changelog/2024.12.0#esp-idf), użytkownicy nie gotowi na zgłaszanie issue powinni być przygotowani na cofnięcie wersji!, zmiany definicji płytek rodziny ESP32 na obecne w [pioarduino](https://github.com/pioarduino), Fix entity name validation, MQTT sensors handling of publishing NaN, [sgp30] Set default update interval to 60s,  
na frameworku **esp-idf** w domyślnej zalecanej wersji (a jest to teraz 5.1.5) sensor Hall’a nie jest obsługiwany i już nie będzie (bo nowsze wersje MCU już go nie zawierają, a był niedokładny i podobno zawodny), wrześniowe zmiany w platformie rp2040 skumulowały się z obecnymi zmianami

> **[ESPHome 2024.12.0 - 18th December 2024](https://esphome.io/changelog/2024.12.0/)**
>
> Changelog for ESPHome 2024.12.0.

---

<div class="post-metadata">

**Autor:** ![szopen](https://forum.arturhome.pl/user_avatar/forum.arturhome.pl/szopen/32/1093_2.png) [@szopen](https://forum.arturhome.pl/u/szopen)\
**Data wpisu:** [19 Luty 2025 12:39 UTC](https://forum.arturhome.pl/t/esphome-lista-wydan-zawierajacych-breaking-changes-zmiany-wstecznie-niekompatybilne/12986/9 "2025-02-19T12:39:22Z")

</div>

* * *

# rok 2025

wydania styczniowego nie było - okres wakacyjny

* * *

Rok 2025 zaczął się z dużym przytupem w HA przez wprowadzenie w kontrowersyjny sposób masy poważnych zmian w działaniu kluczowych funkcji i elementów systemu, teraz coś podobnego wydarzy się w ESPHome (przedsmakiem było wydanie grudniowe “odcinające” ESPHome od [platform.io](http://platform.io)).

Spis zmian i potencjalne ostrzeżenia ~~w terminie późniejszym~~ , a na teraz sugeruję przeczytanie standardowych notatek do wydania

* * *

**2025.2.0** - **dużo zmian w architekturze** , breaking changes:  
**likwidacja wsparcia starej definicji [platformy sprzętowej](https://github.com/esphome/esphome/pull/8118)**; **likwidacja wsparcia starych komponentów niestandardowych** (custom components → [external components](https://esphome.io/components/external_components); **[esp32\_rmt]** Updates for IDF 5+, Set pull-up and open-drain modes based on pin schema; **[lvgl] `use_transparency` → `transparency`**, remove default state; **[image] Transparency changes** code refactor; [nextion] Brightness control tweaks; **[ili9xxx] psram and 8 bit changes**; [scd30] Increase minimal CONF\_UPDATE\_INTERVAL from 1 to 2 seconds; Remove arm/v7 container image support - kompilacja na sprzęcie klasy ziemniak (32-bitowy arm) i tak już zasadniczo nie była możliwa, więc dalsze utrzymywanie tej platformy nie miało sensu

> **[ESPHome 2025.2.0 - 19th February 2025](https://esphome.io/changelog/2025.2.0/)**
>
> Changelog for ESPHome 2025.2.0.

* * *

2025.3.0 - [mlx90393] Fix inverted gain and resolution; [touchscreen] Axis swap bugfix; [cst816] Remove binary sensor

> **[ESPHome 2025.3.0 - 19th March 2025](https://esphome.io/changelog/2025.3.0/)**
>
> Changelog for ESPHome 2025.3.0.

* * *

2025.4.0 - Rework max connections for BLE to avoid exceeding the hard limit, ilość breaking changes może ulec zmianie jeśli dobrze rozumiem deklarację opiekuna projektu

> **[ESPHome 2025.4.0 - 16th April 2025](https://esphome.io/changelog/2025.4.0/)**
>
> Changelog for ESPHome 2025.4.0.

* * *

**2025.5.0** - **[i2s\_audio, microphone, micro\_wake\_word, voice\_assistant] Use microphone source to process incoming audio**; http\_request] Ability to get response headers; [packet\_transport] Extract packet encoding functionality; ATM90E32 Semi-automatic calibration & Status fields

> **[ESPHome 2025.5.0 - 21st May 2025](https://esphome.io/changelog/2025.5.0/)**
>
> Changelog for ESPHome 2025.5.0.

**jedna z ważnych i kluczowych zmian to nowy sterownik dla ogromnej grupy wyświetlaczy - _MIPI SPI_** , jego wprowadzenie i rozwój prowadzi do faktu, że niektóre inne dotychczasowe sterowniki takie jak _ILI9xxx_ (obsługuje całą grupę modeli nie tylko na chipsetach Ilitek, ale też GalaxyCore czy Sitronix), _ST7701S_, _ST7735_, ST7789V i in. stają się przestarzałe i być może zostaną wycofane z użytku, więc najlepszym posunięciem jest migracja konfiguracji na nowy sterownik.

* * *

**2025.6.0** - wymagany Python \>=3.10; Add LWIP optimization options to reduce flash usage; Replace API deferred queue with efficient message batching system; Optimize Component and Application state storage from uint32\_t to uint8\_t; Reduce entity memory usage by eliminating field shadowing and bit-packing; Optimize Application `area_` from `std::string` to `const char*`; (nie opisane jako breakin-change -\>) podniesiona wersja ESP-IDF 5.3.2

> **[ESPHome 2025.6.0 - 18th June 2025](https://esphome.io/changelog/2025.6.0/)**
>
> Changelog for ESPHome 2025.6.0.

* * *

**2025.7.0** - wyjątkowo przedpremierowo link do wersji beta, bo zmiany jakie weszły na początku roku nie były jedynymi “z grubej rury” w tym roku (później przekształcę ten wpis w taki w bardziej standardowym stylu)

~~[ESPHome 2025.7.0 - 16th July 2025 - ESPHome - Smart Home Made Simple](https://beta.esphome.io/changelog/2025.7.0)~~  
lista **breaking changes**  
**Web Server OTA Platform**  
**ESP-IDF 4.x End of Life**  
**ESP32 Arduino Framework 3.x**  
**ArduinoJson Library 7.x**  
oraz reszta “skopiowana żywcem”

- [binary\_sensor] Add action to invalidate state and pass to HA [esphome#8961](https://github.com/esphome/esphome/pull/8961) by [@clydebarrow](https://github.com/clydebarrow) (breaking-change)
- [esp32\_hall] Remove esp32\_hall [esphome#9117](https://github.com/esphome/esphome/pull/9117) by [@swoboda1337](https://github.com/swoboda1337) (breaking-change)
- [web\_server] Upgrade ESPAsync libraries [esphome#8867](https://github.com/esphome/esphome/pull/8867) by [@kuba2k2](https://github.com/kuba2k2) (breaking-change)
- Bump ESP32 Arduino version to 3.1.3 [esphome#8604](https://github.com/esphome/esphome/pull/8604) by [@swoboda1337](https://github.com/swoboda1337) (breaking-change)
- [mqtt] Don’t wait for connection unless configured to [esphome#8933](https://github.com/esphome/esphome/pull/8933) by [@jesserockz](https://github.com/jesserockz) (breaking-change)
- [API] Sub devices and areas [esphome#8544](https://github.com/esphome/esphome/pull/8544) by [@dala318](https://github.com/dala318) (breaking-change)
- Reduce memory required for sensor entities [esphome#9201](https://github.com/esphome/esphome/pull/9201) by [@bdraco](https://github.com/bdraco) (breaking-change)
- Optimize TemplatableValue memory [esphome#9202](https://github.com/esphome/esphome/pull/9202) by [@bdraco](https://github.com/bdraco) (breaking-change)
- Optimize Application class memory layout and reduce loop\_interval size [esphome#9208](https://github.com/esphome/esphome/pull/9208) by [@bdraco](https://github.com/bdraco) (breaking-change)
- [pins] Update `internal_gpio_pin_number` to work directly like `internal_gpio_output_pin_number` [esphome#9270](https://github.com/esphome/esphome/pull/9270) by [@jesserockz](https://github.com/jesserockz) (breaking-change)
- [smt100] Rename `dielectric_constant` to `permittivity` [esphome#9175](https://github.com/esphome/esphome/pull/9175) by [@piechade](https://github.com/piechade) (breaking-change)
- Fix entity hash collisions by enforcing unique names across devices per platform [esphome#9276](https://github.com/esphome/esphome/pull/9276) by [@bdraco](https://github.com/bdraco) (breaking-change)
- [esp32] Remove IDF 4 support and clean up code [esphome#9145](https://github.com/esphome/esphome/pull/9145) by [@swoboda1337](https://github.com/swoboda1337) (breaking-change)
- Replace custom OTA implementation in web\_server\_base [esphome#9274](https://github.com/esphome/esphome/pull/9274) by [@bdraco](https://github.com/bdraco) (new-integration) (breaking-change)
- Reduce RAM usage by optimizing Color constant storage [esphome#9339](https://github.com/esphome/esphome/pull/9339) by [@bdraco](https://github.com/bdraco) (breaking-change)
- Optimize logger callback API by including message length parameter [esphome#9368](https://github.com/esphome/esphome/pull/9368) by [@bdraco](https://github.com/bdraco) (breaking-change)
- Conditionally compile API user services to save 4.3KB flash (follow-up to #9262) [esphome#9451](https://github.com/esphome/esphome/pull/9451) by [@bdraco](https://github.com/bdraco) (breaking-change)
- [json] Bump ArduinoJson library to 7.4.2 [esphome#8857](https://github.com/esphome/esphome/pull/8857) by [@kahrendt](https://github.com/kahrendt) (breaking-change)

> **[ESPHome 2025.7.0 - 16th July 2025](https://esphome.io/changelog/2025.7.0/)**
>
> Changelog for ESPHome 2025.7.0.

w związku z tym, że aktualizacja do 2025.7.0 okazała się dla wielu problematyczna, a w dodatku nawet doświadczeni userzy nie robią backupów Dodatków przy instalacji nowej wersji… to tu jest repozytorium ze starymi wersjami (można zainstalować dowolną ilość różnych wersji ale należy zatrzymać naszą główną jesli ma być uruchomiona jakakolwiek inna)

> **[GitHub - khenderick/esphome-legacy-addons: ESPHome addons from previous versions. Just in...](https://github.com/khenderick/esphome-legacy-addons)**
>
> ESPHome addons from previous versions. Just in case something isn't working with the new version

Ogrom problemów użytkowników z nowymi wersjami buildera/kompilera/IDE (czy jakkkolwiek sobie to nazwiemy) jest taki, że polecam też okolice tamtego posta w wątku na dość specyficzny temat.

> [@Komponent wM-Bus do ESPHome (SzczepanLeon) wersja 4.x - wątek ogólny](https://forum.arturhome.pl/t/komponent-wm-bus-do-esphome-szczepanleon-wersja-4-x-watek-ogolny/12995/289):
>
> Oczywiście, jeśli przy aktualizacji Dodatku wykonałeś sobie backup cząstkowy tu akurat na przykładzie przejścia z 2025.7.0 do 2025.7.1 swoją drogą z pełnego backupu HA można selektywnie przywrócić tylko 1 Dodatek A tu macie taki prezencik - repozytorium ze starymi wersjami ESPHome tylko jedna UWAGA - jeśli nie chcecie mieć innych problemów to można sobie zainstalować dowolną ilość wersji ESPHome, ale w danym momenc…

szczególnie mam na myśli repo z archiwalnymi wersjami

> **[GitHub - khenderick/esphome-legacy-addons: ESPHome addons from previous versions. Just in...](https://github.com/khenderick/esphome-legacy-addons)**
>
> ESPHome addons from previous versions. Just in case something isn't working with the new version

* * *

**2025.8.0** mnóstwo przełomowych zmian, [Bluetooth and BLE](https://esphome.io/changelog/2025.8.0/#bluetooth-and-ble-changes), [API Optimizations](https://esphome.io/changelog/2025.8.0/#api-optimizations), [Component Filter Changes [LD2410, LD2450]](https://esphome.io/changelog/2025.8.0/#component-filter-changes), [ESP32 Touch Sensor](https://esphome.io/changelog/2025.8.0/#esp32-touch-sensor)

> **[ESPHome 2025.8.0 - 20th August 2025](https://esphome.io/changelog/2025.8.0/)**
>
> Changelog for ESPHome 2025.8.0.

z nowości dość kluczowy jest nowy komponent dla wyświetlaczy _MIPI DSI_  
pełna lista

> **[Breaking Changes - ESPHome 2025.8.0 - 20th August 2025](https://esphome.io/changelog/2025.8.0/#breaking-changes)**
>
> ESPHome 2025.8.0 includes several breaking changes that may require action on your part: | Changelog for ESPHome 2025.8.0.

* * *

**2025.9.0**

> **[Breaking Changes - ESPHome 2025.9.0 - 17th September 2025](https://esphome.io/changelog/2025.9.0/#breaking-changes)**
>
> ESPHome 2025.9.0 includes several breaking changes that may require configuration updates: | Changelog for ESPHome 2025.9.0.

Dość konsekwentnie są wprowadzane nowe sterowniki całych grup modeli wyświetlaczy, tym razem to _MIPI RGB_

* * *

**2025.10.0** To jest naprawdę REWOLUCJA - przeczytanie notatek do wydania jest wręcz koniecznością…

> **[ESPHome 2025.10.0 - 15th October 2025](https://esphome.io/changelog/2025.10.0/)**
>
> Changelog for ESPHome 2025.10.0.

tym razem jedna z kluczowych nowości to nowy sterownik dla wyświetlaczy e-ink _ePaper SPI_

* * *

**2025.11.0** wprowadza wiele optymalizacji, ale również sporo breaking changes (w tym dotyczących sieci, PSRAM, skryptów czy lambd) - znowu koniecznie należy w nie zajrzeć

> **[Breaking Changes - ESPHome 2025.11.0 - November 2025](https://esphome.io/changelog/2025.11.0/#breaking-changes)**
>
> WiFi: WiFi and Ethernet components no longer block other components’ setup until connected. Components with setup priority \> WIFI (802.3) now initialize immediately, even if network is disconnected. esphome#9823 | Changelog for ESPHome 2025.11.0.

* * *

**2025.12.0** - kilka nowych komponentów, w tym wstępna obsługa układu RF - TI CC1101, sporo breaking changes

> **[Breaking Changes - ESPHome 2025.12.0 - December 2025](https://esphome.io/changelog/2025.12.0/#breaking-changes)**
>
> Micronova: Multiple configuration changes (esphome#12226, esphome#12318, esphome#12371): | Changelog for ESPHome 2025.12.0.

---

<div class="post-metadata">

**Autor:** ![szopen](https://forum.arturhome.pl/user_avatar/forum.arturhome.pl/szopen/32/1093_2.png) [@szopen](https://forum.arturhome.pl/u/szopen)\
**Data wpisu:** [19 Luty 2026 21:45 UTC](https://forum.arturhome.pl/t/esphome-lista-wydan-zawierajacych-breaking-changes-zmiany-wstecznie-niekompatybilne/12986/10 "2026-02-19T21:45:56Z")

</div>

* * *

# rok 2026

* * *

**2026.1.0** warto czytać - istotne zmiany, m.in. framework Arduino przestał być domyślny dla wielu platform sprzętowych, zmiany w API i OTA

> **[Breaking Changes - ESPHome 2026.1.0 - January 2026](https://esphome.io/changelog/2026.1.0/#breaking-changes)**
>
> This website uses privacy-first analytics to help us improve the site. You can view all data in our public dashboard. | Changelog for ESPHome 2026.1.0.

* * *

**2026.2.0** warto czytać - istotne zmiany

> **[Breaking Changes - ESPHome 2026.2.0 - February 2026](https://esphome.io/changelog/2026.2.0/#breaking-changes)**
>
> This website uses privacy-first analytics to help us improve the site. You can view all data in our public dashboard. | Changelog for ESPHome 2026.2.0.

* * *

**2026.3.0** - istotne zmiany w popularnych komponentach **Time** , **OpenTherm** , **Speaker Media Player** i w mniej popularnych **SGP30** , **ESP32-P4**

> **[Breaking Changes - ESPHome 2026.3.0 - March 2026](https://esphome.io/changelog/2026.3.0/#breaking-changes)**
>
> This website uses privacy-first analytics to help us improve the site. You can view all data in our public dashboard. | Changelog for ESPHome 2026.3.0.

* * *

**2026.4.0** - **ESP32 CPU frequency** , … i wiele innych

> **[Breaking Changes - ESPHome 2026.4.0 - April 2026](https://esphome.io/changelog/2026.4.0/#breaking-changes)**
>
> This website uses privacy-first analytics to help us improve the site. You can view all data in our public dashboard. | Changelog for ESPHome 2026.4.0.

i taki mój mały prywatny komentarz, radzę poczekać na jakieś nowsze wersje od 2026.4.0, gdzie zostaną naprawione błędy, bo mimo tego, że przeczytałem (a nie jedynie przejrzałem) całość, to ta aktualizacja

1. uwaliła mi bardzo rozbudowaną konstrukcję na bazie RP2040 i już drugi dzień szukam co jest przyczyną (bo nie ma słowa o żadnym komponencie, który używam, a tymczasem nowe firmware uwala malinę pico W “na głucho” więc z konfiguracji wywalam po kawałku komponent za komponentem zupełnie w ciemno), tu sytuacja na razie bez zmian (chwilowo brak czasu na dalszą walkę)
2. ~~kolejna ciekawostka - mam 2 identyczne wyświetlacze, różnią się tym, że w jednym jest ESP32 rev 1.0, a drugim rev. 3.1 (taka kwestia której normalny człowiek nawet nie zauważy, bo nie ma fizycznych różnic), starszy modela zaczął niepoprawnie wyświetlać kolory… nad tym się jeszcze nie zastanawiam czy i co robić…~~ tu poprawka wyszła w 2026.4.1
3. jest za to inna nowość - ostrzeżenie dla niektórych urządzeń gdzie ESHome działa od bardzo dawna `Bootloader too old for OTA rollback and SRAM1 as IRAM (+40KB). Flash via USB once to update the bootloader` oczywiście ostrzeżenie jako-takie nie jest niczym groźnym, ale bez fizycznego połączenia serialem wykorzystanie [nowej dostępnej opcji optymalizującej wykorzystanie RAM nie jest możliwe](https://esphome.io/changelog/2026.4.0/#esp32-performance-and-security-improvements)

* * *

**2026.5.0**

> **[Breaking Changes - ESPHome 2026.5.0 - May 2026](https://esphome.io/changelog/2026.5.0/#breaking-changes)**
>
> This website uses privacy-first analytics to help us improve the site. You can view all data in our public dashboard. | Changelog for ESPHome 2026.5.0.

* * *

**2026.6.0** Nowe GUI już dla wszystkich, UWAGA ważna zmiana dla posiadaczy starych routerów WiFi/AP i ESP8266/ESP8285 - zmiana domyślnego minimalnego poziomu szyfrowania z WPA na WPA2 (archaiczne konfiguracje wymagają jawnego obniżenia tego poziomu) i wiele innych zmian (również non-breaking)

> **[Breaking Changes - ESPHome 2026.6.0 - June 2026](https://esphome.io/changelog/2026.6.0/#breaking-changes)**
>
> This website uses privacy-first analytics to help us improve the site. You can view all data in our public dashboard. | Changelog for ESPHome 2026.6.0.

* * *

**2026.7.0** ogromna liczba dużych zmian dla wielu platform sprzętowych, ale generalnie tym razem polecam poświęcić czas na przeczytanie [całych](https://esphome.io/changelog/2026.7.0/) notatek do wydania, bo zmiany dotyczą praktycznie wszystkiego co istotne (i nawet streszczenie byłoby zbyt obszerna na posta tutaj)

> **[Breaking Changes - ESPHome 2026.7.0 - July 2026](https://esphome.io/changelog/2026.7.0/#breaking-changes)**
>
> This website uses privacy-first analytics to help us improve the site. You can view all data in our public dashboard. | Changelog for ESPHome 2026.7.0.

* * *

**2026.8.0**

> **[Breaking Changes - ESPHome 2026.8.0 - August 2026](https://esphome.io/changelog/2026.8.0/#breaking-changes)**
>
> This website uses privacy-first analytics to help us improve the site. You can view all data in our public dashboard. | Changelog for ESPHome 2026.8.0.

* * *

**2026.9.0**

> **[Breaking Changes - ESPHome 2026.9.0 - September 2026](https://esphome.io/changelog/2026.9.0/#breaking-changes)**
>
> This website uses privacy-first analytics to help us improve the site. You can view all data in our public dashboard. | Changelog for ESPHome 2026.9.0.

blog

> **[Breaking changes - ESPHome 2026.9.0: Faster builds and encrypted updates](https://esphome.io/blog/2026/09/16/esphome-2026-9/#breaking-changes)**
>
> Advanced users with lambdas that touch component internals should note the following C++ changes. These APIs are not covered by the formal breaking-change policy (they are undocumented public methods), but lambdas often depend on them: | ESPHome...

* * *

**2026.10.0**  
blog

> **[ESPHome 2026.10.0: Native ESP8266 builds and compressed updates](https://esphome.io/blog/2026/10/21/esphome-2026-10/)**
>
> ESPHome 2026.10.0 makes the native ESP8266 toolchain the default, compresses OTA uploads on every platform, trims RAM across every build, and adds 20 new components.

breaking changes w technicznych notatkach do wydania

> **[Breaking Changes - ESPHome 2026.10.0 - October 2026](https://esphome.io/changelog/2026.10.0/#breaking-changes)**
>
> This website uses privacy-first analytics to help us improve the site. You can view all data in our public dashboard. | Changelog for ESPHome 2026.10.0.