ESPHome 2026.7: что проверить перед обновлением ESP32, Zigbee и Modbus

Что изменилось в ветке ESPHome 2026.7

Основной релиз ESPHome 2026.7.0 принёс крупные изменения в сборке прошивок, безопасности, Zigbee, Modbus, Device Builder и веб-интерфейсе устройств. После него вышли исправления 2026.7.1, 2026.7.2 и 2026.7.3.

Версия 2026.7.3 исправляет проблемы нативной сборки ESP-IDF, captive portal, Wi-Fi, BLE и работу с некоторыми сетевыми компонентами. Поэтому при плановом обновлении следует использовать последнее исправление ветки, а не первоначальную 2026.7.0.

Нативный ESP-IDF теперь используется по умолчанию

Раньше многие проекты ESP32 собирались через PlatformIO. В ESPHome 2026.7 конфигурация без явно заданного параметра toolchain переключается на нативную сборку ESP-IDF.

Почему это важно

• первая сборка может занять больше времени из-за загрузки нового toolchain;
• изменятся каталоги кеша и размер временных файлов;
• нестандартные библиотеки и внешние компоненты могут собираться иначе;
• собственные build flags требуют повторной проверки;
• старый проект может успешно компилироваться в PlatformIO, но выдавать ошибку в нативном ESP-IDF;
• поведение framework Arduino и toolchain нельзя считать одним и тем же параметром.

Как временно сохранить старое поведение

Для проекта, который пока нельзя переводить на новую цепочку сборки, можно явно оставить PlatformIO:

esp32:
  board: esp32dev
  toolchain: platformio

Python 3.11 больше не поддерживается

Минимальной версией Python для прямой установки ESPHome стала Python 3.12. Это изменение касается пользователей, которые устанавливали ESPHome командой pip в Linux, Windows, macOS, виртуальном окружении или собственном контейнере.

Старый встроенный dashboard удалён

Пользователи прямой установки через pip больше не должны рассчитывать на старый Tornado dashboard. Для веб-интерфейса используется отдельный ESPHome Device Builder. Официальное дополнение Home Assistant и Docker уже работают с новой системой.

Проверить Python можно командой:

python3 --version

ESP32 Zigbee-устройства потребуется подключить заново

ESPHome 2026.7 обновляет esp-zigbee-sdk до версии 2.0.2, меняет хранение Zigbee-данных и добавляет объединение endpoint. Для существующих ESP32 Zigbee-устройств официально требуется повторное присоединение к сети, повторный interview и настройка.

До обновления ESP32 Zigbee-устройства сохраните

• его YAML-конфигурацию;
• список endpoint и кластеров;
• названия сущностей в Home Assistant;
• привязанные автоматизации;
• скриншоты параметров устройства в ZHA или Zigbee2MQTT;
• место установки и физический доступ к кнопке сопряжения;
• порядок перевода устройства в режим подключения.

После повторного добавления идентификаторы сущностей или устройства могут отличаться. Перед удалением старой записи проверьте, какие автоматизации используют её напрямую.

Modbus получил новый парсер и изменённые параметры времени

В ESPHome 2026.7 переработана внутренняя реализация Modbus. Изменения направлены на уменьшение выделений памяти, корректную обработку диапазонов регистров и разделение клиентской и серверной логики.

Что может потребовать правки YAML

Новые значения по умолчанию для клиента: send_wait_time: 2000ms и turnaround_time: 600ms. Это может изменить скорость опроса нескольких устройств на одной шине.

NVS encryption и защита от отката OTA

В ESPHome появилась первая согласованная группа функций, направленная на будущую совместимость с требованиями EN 18031 для сетевых потребительских устройств. Это инфраструктурная работа, а не автоматическая сертификация любого самодельного ESP32-модуля.

Шифрование NVS нельзя включать экспериментально

Для NVS encryption ключ записывается в выбранный блок eFuse. Запись eFuse является постоянной и необратимой. Ошибка в выборе блока, ключа или процедуре восстановления может сделать дальнейшее обслуживание устройства значительно сложнее.

Защита от отката работает только с подписанной OTA

ESPHome сравнивает версию новой прошивки с уже установленной и блокирует переход на более старую. Однако механизм эффективен только при использовании подписанных OTA-образов. Обычное указание номера версии без подписи не создаёт полноценную защиту.

Что изменилось во встроенном веб-интерфейсе устройства

• web_server: version: 1 объявлен устаревающим, переход на v2 или v3 нужно завершить до ESPHome 2027.1;
• URL, построенные по старому object ID, следует заменить на адреса по имени сущности;
• для запросов с другой веб-страницы нужно явно задать allowed_origins;
• Private Network Access больше не следует считать включённым автоматически;
• появилась возможность выбрать Digest authentication;
• в 2027.1 Digest должен стать вариантом по умолчанию вместо Basic.

Если устройство используется только через Home Assistant API и его web_server не открыт, эти изменения могут не влиять на работу. В зоне риска пользовательские панели, собственные REST-запросы и веб-страницы, которые обращаются к ESPHome напрямую.

Пошаговая подготовка ESPHome

1. Создайте резервную копию Home Assistant. Для дополнения ESPHome сохраните полную резервную копию и выгрузите её с сервера.
2. Скопируйте все YAML. Включая packages, secrets, внешние компоненты и локальные файлы.
3. Зафиксируйте текущую версию. Запишите версию ESPHome, framework, toolchain и плату каждого критичного устройства.
4. Проверьте Python. Это обязательно для pip и собственных контейнеров.
5. Найдите ESP32 Zigbee. Подготовьте доступ для повторного сопряжения.
6. Проверьте Modbus YAML. Найдите удалённые параметры и запишите текущие интервалы опроса.
7. Скомпилируйте без прошивки. Device Builder позволяет проверить несколько устройств действием Compile only.
8. Начните с некритичного модуля. Не с котла, насоса, ворот, защиты от протечки или вводного контроля.
9. Сохраните предыдущий binary. Он нужен для восстановления по USB, если OTA перестанет работать.
10. Проверьте физический доступ. Устройство за потолком или в уличном шкафу должно быть доступно для кабельной прошивки.

Что проверить на каждом устройстве

Что ещё полезного появилось

Что изучить перед обновлением

Полезно прочитать: Home Assistant в частном доме, как построить стабильную Zigbee-сеть, как работает умный дом без интернета, монтаж и настройка умного дома в Туле.

Нужно ли обновлять ESPHome 2026.7

Для обычного Home Assistant Add-on без собственных компонентов обновление обычно проходит проще, чем для ручной pip-установки. Но даже в этом случае не стоит массово прошивать все устройства одним нажатием.

Самые важные проверки нужны владельцам ESP32 Zigbee, Modbus-автоматики, внешних компонентов, старого web_server и проектов, которые зависят от PlatformIO.

Новые функции безопасности полезны, но NVS encryption и OTA anti-rollback нельзя включать только ради галочки. Они требуют подписанных прошивок, управления ключами и понимания необратимых eFuse.