Перейти к содержанию

Какую версию ESP-IDF выбрать для нового проекта?

Обновлено Редакция GAW

У ESP-IDF выходят основные и дополнительные версии (v5.5, v6.0, v6.1), а внутри каждой — выпуски с исправлениями (v6.0.1, v6.0.2…). Политика поддержки Espressif определяет, сколько времени ветка получает исправления, и на неё стоит смотреть при выборе версии, а не только на дату выхода.

Сроки по политике Espressif

ВерсияПервый выпускКонец Service (наш расчёт)Конец поддержки, EOL (наш расчёт)
v6.127 августа 2026август 2027февраль 2029
v6.020 марта 2026март 2027сентябрь 2028
v5.521 июля 2025июль 2026январь 2028
v5.44 января 2025январь 2026июль 2027
v5.325 июля 2024июль 2025январь 2027

Сроки получены прибавлением 12 и 30 месяцев к дате первого стабильного выпуска, как сказано в политике; точные даты Espressif указывает для каждого выпуска отдельно. В периоде Service выходят частые исправления, а иногда и функции, нужные для сертификации. В Maintenance исправляют только серьёзные ошибки и уязвимости.

Как выбрать

  1. Для нового проекта — последняя стабильная версия в периоде Service, на ноябрь 2026 года это v6.1.
  2. Проверить совместимость с ревизией чипа по COMPATIBILITY.md.
  3. Убедиться, что сторонние компоненты поддерживают эту версию: при смене основной версии меняется API — в примечаниях к v6.0, например, перечислены удалённые функции, в том числе двоичный формат core dump и пользовательская функция vPortCleanUpTCB().
  4. Обновляться внутри ветки на каждый бакфикс-выпуск.

Сборку и прошивку удобно вести через PlatformIO или утилиту esptool, адреса и режимы прошивки описаны на странице «Прошивка ESP32». О новых выпусках ESP-IDF, FreeRTOS и Zephyr сообщает раздел «Новости», обзор модулей — раздел ESP32.

Похожие вопросы

Стоит ли начинать проект на master?

Только если нужна функция, которой ещё нет в стабильных выпусках. По руководству ESP-IDF для производства берут стабильную версию, а предварительные выпуски — beta, rc и dev — под политику поддержки не попадают вовсе.

Что делать со старым проектом на v5.x?

Обновлять до бакфикс-выпуска своей ветки, например до последнего v5.5.x, и планировать переход на новую основную версию до конца поддержки. Политика Espressif просит переводить проекты на новый выпуск до того, как старый станет End of Life: исправлений для таких версий больше не выпускают.

Влияет ли версия ESP-IDF на ревизию чипа?

Да: новые ревизии кристаллов поддерживаются не всеми версиями. Руководство ESP-IDF советует перед выбором сверить версию с таблицей совместимости COMPATIBILITY.md для той ревизии, которую вы будете ставить в производство.

Источники

  1. Espressif Systems. ESP-IDF Support Period Policy (SUPPORT_POLICY.md, тег v6.1) — каждый основной и дополнительный выпуск (V4.1, V4.2 и т. д.) поддерживается 30 месяцев с первого стабильного выпуска; период Service — 12 месяцев, рекомендуется для новых проектов; Maintenance — 18 месяцев, не рекомендуется, только исправления серьёзных ошибок и уязвимостей; после срока — End of Life, исправлений нет; бета-, rc- и dev-версии и функции с пометкой Preview не поддерживаются; пример — V3.3 вышла в сентябре 2019 и поддерживалась до февраля 2022
  2. Espressif Systems. ESP-IDF Programming Guide, Versions (docs/en/versions.rst) — для промышленного использования — текущая стабильная версия, обновляемая выпусками с исправлениями; совместимость версий ESP-IDF и ревизий чипов — в COMPATIBILITY.md; для нового проекта — последний стабильный выпуск; у каждого выпуска на странице Releases указан срок поддержки
  3. Espressif Systems. esp-idf, Releases на GitHub (данные API GitHub на 1 ноября 2026) — v6.1 — 27 августа 2026; v6.0 — 20 марта 2026, в примечаниях к выпуску — несовместимые изменения: core dump только в формате ELF, удалена поддержка пользовательской vPortCleanUpTCB(); v6.0.3 — 2 сентября 2026; v5.5 — 21 июля 2025; v5.5.6 — 16 октября 2026; v5.4 — 4 января 2025; v5.4.4 — 17 апреля 2026; v5.3 — 25 июля 2024; v5.3.6 — 15 сентября 2026 (даты published_at в API GitHub, проверены 2 ноября 2026)

Нашли ошибку?