Установка ESP-IDF с помощью ESP-IDF Installation Manager

Здесь представлена сжатая версия оригинальной статьи: https://kotyara12.ru/iot/esp-idf_install. Только оригинальная статья исправляется и дополняется в случае необходимости.

Доброго здравия, уважаемые читатели!

В данной статье поговорим про установку фреймворка ESP-IDF и среды разработки для работы с ним (VSCode или Espressif IDE) на компьютеры под управлением ОС Windows с помощью нового официального инсталлятора ESP-IDF Installation Manager (EIM).  Впрочем, сейчас инсталлятор кроссплатформенный, поэтому многое будет справедливо и для других операционных систем.

---

Предисловие, которое можно не читать

Если вы наткнулись на эту статью случайно, и пока плохо представляете, как и с помощью каких инструментов можно программировать микроконтроллеры ESP, то я бы посоветовал вначале прочитать другую статью [Как и на чём программировать ESP8266 и ESP32]. Но вкратце изложу основные пункты и здесь.

Если вы решили освоить программирование микроконтроллеров ESP32 – то у вас есть два основных пути:

• программировать с использованием популярного фреймворка Arduino ESP32 или
• программировать с использованием native фреймворка ESP-IDF.

По большому счету – в обоих случаях используется один и тот же язык (С / С++), но разница между ними довольно заметная (конечно, есть еще варианты с Python, LUA, Rust, может быть что-то ещё, но в данном случая их не рассматриваем).

Допустим, вы решили освоить программирование с использованием ESP-IDF, то и тут у вас есть несколько вариантов:

• Использовать оригинальную IDE и систему сборки от Espressif под названием Espressif IDE. По сути это Eclipse IDE c жестко интегрированным плагином от Espressif, но существует возможность установить отдельно Eclipse и потом отдельно расширение ESP-IDF.
• Использовать бесплатный редактор кода Visual Studio Code (VSCode) с дополнительным расширением ESP-IDF.
• Использовать альтернативную систему сборки под названием PlatformIO, которая тоже является расширением для Visual Studio Code.

Первые два варианта предоставлены компанией Espressif и полностью совместимы друг с другом, более того – используют одни и те же версии ESP-IDF. А вот PlatformIO, хотя и включает оригинальный пакет ESP-IDF, использует несколько другие механизмы сборки проекта, поэтому не полностью совместима с предыдущими двумя вариантами.

Конечно же никто не запрещает вам использовать одновременно несколько вариантов. Например, сейчас я в основном использую Visual Studio Code с расширением ESP-IDF. Но тем не менее, предпочитаю иметь под рукой и установленную Espressif IDE.

---

Классический установщик ESP-IDF и в чем его отличие от нового EIM

Прежде чем мы перейдем к обсуждению собственно ESP-IDF Installation Manager (EIM), наверное стоит немного вспомнить про классический вариант установки, (который всё ещё доступен), а также в общих чертах понять, что мы приобретаем и неизбежно теряем при таком переходе. Итак, на момент написания данной статьи (апрель 2026 года) существует два официально поддерживаемых установщика:

• Windows Installer – классический (читай – устаревший) вариант. Про него я уже писал ранее в статье [Установка ESP-IDF и Espressif IDE в ОС Windows].
• ESP-IDF Installation Manager – новый, продвигаемый в настоящее время вариант. Про него и пойдет речь далее в данной статье.

В чем их отличия?

Классический установщик:

• С помощью классического установщика из одного флакона можно сразу же установить:собственно одну выбранную версию ESP-IDF,
  инструменты для сборки (tools),
  драйвера для подключения некоторых плат и JTAG,
  среду разработки Espressif IDE на основе Eclipse.
  
• Для работы в VSCode можно использовать плагин ESP-IDF только версий 1.х, на текущий момент это может быть 1.10 или выше.
• Одновременное использование Espressif IDE и VSCode сопряжено с некоторыми небольшими, но все-таки трудностями. Если вы установили ESP-IDF + Espressif IDE, то для возможности одновременной работы ещё и в VSCode установку следует либо повторить в другой каталог, либо “подхватить” уже существующую. Об этом было написано в прошлой статье.
• Для разных операционных систем были разные типы установщиков.

ESP-IDF Installation Manager:

• Новый установщик eim кроссплатформенный, и имеет один и тот же интерфейс для разных ОС (теоретически, я не проверял ;-))
• Добавлена поддержка “тихой” установки без участия пользователя с помощью опций командной строки и (или) файлов конфигурации.
• Поддерживается установка как в online-режиме, так и в режиме offline (без доступа к сети Интернет), с помощью заранее скачанных пакетов.
• Новый интерфейс позволяет удобно манипулировать перечнем установленных версий ESP-IDF и инструментов – удалять старые, устанавливать новые или восстанавливать поврежденные по какой-либо причине установки. Можно “за один запуск”, пакетно, установить сразу несколько выбранных версий ESP-IDF.
• Список установленных версий ESP-IDF хранится в файле c:\Espressif\tools\eim_idf.json – только тут и никак иначе (изменить расположение этого файла технически можно, но не рекомендуется).
• Плагин ESP-IDF для VSCode теперь автоматически опознает все новые установки, выполненные с помощью eim. Считывает их он из того же самого файла c:\Espressif\tools\eim_idf.json. То есть установили новую версию ESP-IDF – и сразу же, без каких либо дополнительных манипуляций, она доступна и в VSCode, и в Espressif IDE. Но для этого предварительно потребуется обновить плагин до версии 2.0 или выше.
• Новый установщик позволяет устанавливать только фреймворк ESP-IDF и инструменты сборки. Производитель исключил установку Espressif IDE из eim. Установить “оригинальную” Espressif IDE можно, но отдельно.

В настоящее время новый eim продвигается как основной и перспективный способ установки. Тем не менее, багов в нем пока ещё хватает. Но исправления ведутся, поэтому многое может изменится в лучшую сторону и что-то из приведенного ниже в статье уже не будет соответствовать действительности.

---

ESP-IDF Installation Manager

Подготовка к установке

Прежде всего необходимо скачать и установить программу-установщик eim. Теперь это отдельно устанавливаемая программа, а не просто “одноразовый” установщик. Сделать это можно по ссылке: [ESP-IDF Installation Manager].

С непривычки здесь можно слегка запутаться. Но все на самом деле просто. Прежде всего, вы найдете ссылки на две основные версии:

• Online installer – загружает ESP-IDF и инструменты прямо в процессе установки с сайта dl.espressif.com или из репозиториев github-а.
• Offline installer – установка выполняется из предварительно скачанного архива в формате ZST.

Но на самом деле Online installer прекрасно справляется и с offline-установками, если вы предварительно скачаете соответствующий zst-архив. Да и по ссылке Offline installer скачивается тот же самый файл, просто сразу в комплекте с выбранным zst-архивом. На странице загрузки так же есть отдельные ссылки для GUI и CLI-версий (с графическим интерфейсом и для командной строки соответственно), но на текущий момент по факту оказалось, что GUI installers == CLI installers (по крайней мере для винды). То есть по разным ссылкам скачивается абсолютно идентичные файлы.

Так что, если вы ничего не поняли из моих объяснений – просто качайте обычную GUI online версию, соответствующую вашей ОС и разрядности. Она умеет всё и сразу.

Скачали? Запустите установку самого eim.

По умолчанию для windows он предлагает установку в C:\Program Files\eim. Советую вам изменить путь на C:\Espressif\eim – так будет удобнее для запуска eim из командной строки, да и вообще так правильнее – все инструменты Espressif в одной папке.

Но не спешите запускать его и сразу же начинать установку!

Прежде чем запускать установку ESP-IDF, необходимо временно отключить антивирусную программу или добавить eim.exe в исключения. Иначе в процессе установки антивирус Касперского обязательно окрысится и удалит eim как опасный троян (про другие антивирусы сказать ничего не могу).

Связано это на мой взгляд с тем, что “старый” установщик умеет определять наличие антивирусов перед установкой, и при их обнаружении предпринимает какие-то меры:

Если в “старой версии” сознательно пропустить этот этап, то и старый установщик будет также перехвачен антивирусной программой! В новый eim эту проверку и обходной путь почему-то не стали переносить – то ли забыли, то ли сознательно проигнорировали.

Я настроил исключения следующим образом:

После этого можно приступать к установке ESP-IDF.

GUI: Установка в режиме графического интерфейса

Языка интерфейса только два – китайский и английский, их можно выбрать вверху справа. Внизу окна можно найти ссылки на:

• Документацию для eim
• Посмотреть логи предыдущих установок
• Создать issue, если вы обнаружили проблему в eim
• Посмотреть подробную информацию о текущей версии eim.

Если вы запускаете eim в первый раз, то вам сразу будет предложено начать новый процесс установки.

Если же у вас уже были ранее установлены другие версии ESP-IDF, то eim по умолчанию перейдет в режим управления существующими версиями – ESP-IDF Version Managment. Кстати, в старых версиях eim при запуске предлагал выбрать – новая установка или управление старыми, но сейчас стало даже удобнее.

Здесь вы можете удалить, переименовать или переустановить любую из ранее установленных версий, а также установить драйвера. Кроме того, здесь для каждой версии имеется очень удобная кнопочка “Open IDF terminal“, которая запускает так называемый скрипт активации, с помощью которого можно выполнять команды idf.py и другие для любой из установленных версий.

Теперь давайте перейдем к главной теме статьи – процессу установки новой версии. Для этого нажмите кнопку Install New Version (напомню, если вы запускаете eim впервые, система сама начнет этот процесс, ничего нажимать не потребуется). Вы увидите следующий экран:

Вам предлагаются следующие варианты установки:

• Easy installation – простая установка, все настройки и каталоги будут выбраны так, как это представляют себе разработчики eim. Может оно и просто, но это не наш метод.
• Custom installation – выборочная установка, где вы всё (или почти всё) сможете выбрать и настроить самостоятельно.
• Offline installation – выборочная установка, но из предварительно скачанного архива в формате ZST. Например это может быть файл archive_vv6.0_windows-x64.zst, который вы найдете на вкладке Offline installers. Данный режим предназначен для установки на компьютеры, где по тем или иным причинам доступ к сети интернет закрыт или отсутствует. Не сильно отличается от режима Custom installation.
• Load configuration – позволяет загрузить файл с набором параметров установки, созданных в процессе предыдущей установки. Это позволит ускорить и автоматизировать процесс установки, а также “подкрутить” некоторые параметры, не доступные в GUI. Более подробно об этом будет рассказано ниже.

Нажимаем Custom installation и приступаем.

Вначале eim выполняет некие подготовительные операции, о содержании которых нельзя ничего успеть понять – все происходит слишком быстро. Первые два шага у меня пролетают мгновенно, и мы переходим сразу на третий шаг.

3. Select Target Chips

В начале необходимо выбрать семейства SoC – “цели“, с которыми вы предполагаете работать. По умолчанию выделены все targets.

Выбираем нужное или устанавливаем крыжик All и нажимаем красную кнопку Continuie with Selected Targets.

4. Select ESP-IDF Versions

Теперь выбираем версию ESP-IDF. Выберите одну или несколько версий, которые вы хотели бы установить. Да, это очень удобно – установить сразу несколько версий! Разные проекты могут быть рассчитаны на разные версии ESP-IDF.

Отмечаем нужные версии, прокручиваем страницу вниз, и жмякаем Continue Installation…

4. Select Download Mirrors

Теперь выбираем “зеркало” – сайт-источник, откуда установщик будет скачивать дистрибутивы (для offline-установок этот этап пропускается).

Установщик по умолчанию сам выбирает доступные репозитории на основе ping-а, но вы можете изменить выбор по своему усмотрению. Как и прежде, жмем “большую красную кнопку” внизу.

6. Select ESP-IDF Features

Выбираем компоненты, которые вам необходимы. Выбрать нужно отдельно для каждой устанавливаемой версии, и их состав может изменяться в зависимости от версии:

• core – это базовая и обязательная часть ESP-IDF, которая устанавливается всегда, сюда входят все основные библиотеки и API для работы с периферией чипов ESP32.
• gdbgui – графический интерфейс для отладчика GDB, который работает прямо в браузере. Он позволяет визуально отлаживать прошивку – смотреть переменные, ставить брейкпоинты, ходить по шагам. Это удобно для тех, кто не любит работать с отладчиком через командную строку.Важное примечание: Начиная с ESP-IDF v6.0, установка gdbgui через стандартные скрипты была удалена. Теперь, если он вам нужен, его следует ставить отдельно через pipx. Однако в EIM эта опция, скорее всего, еще какое-то время будет присутствовать для старых версий (v5.x)
  
• pytest – фреймворк для автоматического тестирования кода на Python. В контексте ESP-IDF он используется не для тестирования самого фреймворка, а для написания пользовательских тестов вашего приложения (в связке с pytest-embedded). Позволяет автоматизировать процесс сборки, прошивки устройства и проверки корректности его работы.
• test-specific – набор инструментов и зависимостей, необходимых для запуска тестов. Сюда могут входить:Библиотеки для юнит-тестирования (Unity, CppUnit).
  Утилиты для интеграционного тестирования.
  Скрипты и тулзы для симуляции или запуска тестов на реальном железе.
  Включение этой опции нужно разработчикам, которые следят за качеством кода и используют CI/CD.
  
• ci (Continuous Integration) – эта опция устанавливает все необходимое для работы в автоматизированных средах сборки, таких как GitHub Actions, GitLab CI или Jenkins:Headless-режим: позволяет ESP-IDF работать без графического интерфейса.
  Утилиты для логирования и создания артефактов сборки.
  Оптимизации для уменьшения финального размера Docker-образа (например, автоматическая очистка кэша)
  
• docs – установка локальной копии документации по ESP-IDF. Обычно документация доступна онлайн, но эта опция полезна для работы без интернета. Устанавливаются HTML-файлы, примеры кода и руководства, которые можно открыть локально в браузере.
• ide (Integration with IDE) – установка файлов и инструментов для интеграции со средами разработки, такими как VS Code, Eclipse или CLion.Генерация CMakePresets.json (стандарт для CMake, который понимают все современные IDE).
  Настройка путей для IntelliSense (автодополнение кода).
  Создание ярлыков или профилей для запуска сборки и прошивки из IDE.
  Здесь внимание: это не установка собственной IDE на базе Eclipse, как это было ранее, а только интеграция для неё! Однако эта опция полезна всем.
  
• mcp – это самая современная и интересная опция, появившаяся в ESP-IDF v6.0. MCP — это протокол от компании Anthropic (создатели модели Claude), который позволяет подключать внешние источники данных к AI-ассистентам. В контексте EIM это означает установку компонентов, необходимых для запуска MCP-сервера [MCP Server], который в свою очередь дает возможность подключать AI (например, тому же Claude или Github Copilot):Читать документацию по ESP-IDF.
  Анализировать структуру вашего проекта.
  Предлагать корректные фрагменты кода с учетом API конкретной установленной версии ESP-IDF.
  

По умолчанию выбрано только core. Выбирайте нужные компоненты и переходим к следующему этапу.

7. Select Tools

Выбираем tools или инструменты сборки. Как и в предыдущем случае – их состав может быть разным для разных версий:

Базовые инструменты устанавливаются всегда.

Дополнительно вы можете установить QEMU – это эмулятор ESP32 с открытым исходным кодом. Простыми словами, это программа, которая может притвориться платой ESP32, и запускать “на себе” ваши прошивки. Вместо того чтобы каждый раз прошивать код на физическое устройство, вы можете запустить тот же самый код в эмуляторе QEMU прямо на своем компьютере.

8. Select Installation Location

Наконец мы добрались до выбора каталога установки. По умолчанию eim предлагает установку в c:\esp, но я предпочитаю изменить путь на c:\Espressif\frameworks. Дабы все яйца были в одной корзине, так сказать…

Путь к инструментам в интерфейсе изменить нельзя – по умолчанию tools всегда устанавливаются в папку c:\Espressif\tools. Связано это с тем, что в этом же каталоге создается специальный файл eim_idf.json, в котором содержится вся служебная информация об установленных версиях ESP-IDF. Из этого файла черпает информацию и плагин VSCode и сам eim – поэтому перемещать его на другие диски или в другие папки настоятельно не рекомендуется.

Отсюда вывод: для ОС Windows как бы вы не старались поставить продукты Espressif на другой диск (отличный от диска C:\), все равно часть файлов будет установлена на C:\. Да, с помощью файла конфигурации можно перенести tools в другой каталог или даже на другой диск, но файл eim_idf.json должен всегда оставаться “на своем месте”. Поэтому не стоит мучаться и устанавливаем инструменты туда, куда нам их по умолчанию и предлагают.

И опять нажимаем “большую красную кнопку” внизу.

9. Installation Progress

Вы переходите на следующий экран, где нет никакого выбора, но есть ещё одна большая красная кнопка: Start Installation. Что бы это значило? Нажимаем!

Теперь подождите, пока инсталлятор сделает все то, о чем его попросили. Это может занять довольно продолжительное время. Откиньтесь на спинку кресла и отдохните, вы проделали нелегкий путь и сделали тяжелый выбор. Примите ванну, выпейте какавы с чаем...

Если Вас интересуют подробности, можно посмотреть протокол установки, нажав на строчку Installation log внизу…

10. Installation complete

После нажатия последней красной кнопки, мы попадаем на финальную страницу, где можно сохранить файл конфигурации. Рекомендую сделать это – “я тебе ещё пригожусь, Иван Царевич”…

Как видите, всё очень просто.

---

Установка или обновление плагина для VSCode

Если вы предпочитаете работать в Visual Studio Code, то теперь вам необходимо установить соответствующий плагин или обновить его до последней версии (так как плагин версий 1.x “не видит” установок, сделанных с помощью eim).

Последовательность действий следующая:

1. Откройте VSCode
2. Перейдите на вкладку Extentions
3. В поисковой строке вбейте ESP-IDF
4. Если плагин не был ещё установлен – нажмите Install, или
5. Если установленная ранее версия плагина ниже 2.0, то кликните на шестеренку, нажмите Install specific version и выберите новую версию.

Наглядно процесс показан на скриншоте ниже (у меня он уже установлен):

Кстати, разработчики и документация утверждают, что при обновлении новый плагин должен “подхватить” все ранее установленные версии ESP-IDF, но я эту информацию подтвердить или опровергнуть не могу, так как в процессе экспериментов “снес” все ранее установленные версии. Но переустановить всё заново не так уж и долго – поэтому может и не стоит “держаться за старые установки”.

После этого вы сможете выбрать target и версию esp-idf для вашего проекта через меню плагина:

Или через панель команд плагина в строке состояния VSCode:

Выглядит это так:

И зверей убивать не надо ничего не нужно донастраивать или устанавливать – все работает само! Невероятно, но китайцы наконец-то допилили плагин “как надо”.

---

Использование файла конфигурации

Как я уже упоминал выше, eim позволяет загружать настройки из файлов конфигурации с расширением .toml. Давайте посмотрим на файл конфигурации установки eim_config.toml, который мы получили на фингальном этапе. Содержимое в моем случае следующее:

path = 'C:\Espressif\frameworks'
esp_idf_json_path = 'C:\Espressif\tools'
tool_download_folder_name = 'C:\Espressif\dist'
tool_install_folder_name = 'C:\Espressif\tools'
target = ["all"]
idf_versions = ["v6.0", "v5.5.4"]
tools_json_file = "tools/tools.json"
config_file_save_path = 'C:\Espressif\eim\eim_config.toml'
non_interactive = true
wizard_all_questions = false
mirror = "https://dl.espressif.com/github_assets"
idf_mirror = "https://github.com"
pypi_mirror = "https://pypi.org/simple"
recurse_submodules = true
install_all_prerequisites = false
skip_prerequisites_check = false
cleanup = false
python_env_folder_name = "python"
activation_script_path_override = 'C:\Espressif\tools'
python_version_override = "python313"
create_bat_activation_script = false

[idf_features_per_version]
"v5.5.4" = ["core", "ide", "docs", "ci", "test-specific"]
"v6.0" = ["core", "mcp", "ide", "docs", "ci", "test-specific"]

[idf_tools_per_version]
"v6.0" = ["xtensa-esp-elf-gdb", "riscv32-esp-elf-gdb", "xtensa-esp-elf", "esp-clang", "esp-clang-libs", "riscv32-esp-elf", "esp32ulp-elf", "cmake", "openocd-esp32", "ninja", "idf-exe", "ccache", "dfu-util", "esp-rom-elfs", "qemu-xtensa", "qemu-riscv32"]
"v5.5.4" = ["xtensa-esp-elf-gdb", "riscv32-esp-elf-gdb", "xtensa-esp-elf", "esp-clang", "esp-clang-libs", "riscv32-esp-elf", "esp32ulp-elf", "cmake", "openocd-esp32", "ninja", "idf-exe", "ccache", "dfu-util", "esp-rom-elfs", "qemu-xtensa", "qemu-riscv32"]

Рассмотрим эти опции поподробнее.

• path = ‘C:\Espressif\frameworks’
  Базовый каталог для установки версий ESP-IDF. Внутри этого каталога будут созданы подкаталоги с версиями, например c:\Espressif\frameworks\v5.5.4\esp-idf\ (именно так, а не c:\Espressif\frameworks\esp-idf\v5.5.4\, что было бы более логично). Вы можете изменить этот путь, но внутри все равно будет vX.X.X\esp-idf – и никак иначе.
• esp_idf_json_path = ‘C:\Espressif\tools’
  Путь к JSON-файлу, в котором содержится информация об установленных версиях ESP-IDF. Категорически не советую изменять этот параметр! Именно по этому пути ищет версии плагин для VSCode – изменить-то вы сможете, но это нарушит работу плагина для VSCode. А посему я посчитал правильным удалить эту опцию из файла, чтобы ничего не перепуталось.
• tool_download_folder_name = ‘C:\Espressif\dist’
  Путь к временной папке, куда eim складирует скачанные дистрибутивы. Нет особого смысла что-то изменять в данном случае.
• tool_install_folder_name = ‘C:\Espressif\tools’
  Каталог, куда будут установлены инструменты сборки. Это общий каталог для всех устанавливаемых версий. В GUI этой опции нет, но здесь вы можете изменить путь при необходимости. Но и по умолчанию всё довольно логично.
• target = [“all”]
  Массив целевых семейств или all для всего и сразу.
• idf_versions = [“v6.0”, “v5.5.4”]
  Массив устанавливаемых версий ESP-IDF.
• tools_json_file = “tools/tools.json”
  Относительный путь к файлу, в котором содержится информация об установленных версиях инструментов сборки. Что характерно, у меня этого файла так и не появилось, но есть eim_idf.json – в котором содержится ровно то же самое. А посему я посчитал правильным удалить эту опцию из файла, чтобы ничего не перепуталось.
• config_file_save_path = ‘C:\Espressif\eim\eim_config.toml’
  Путь, куда был сохранен данный файл конфигурации.
• non_interactive = true
  Эта опция отключает интерактивный режим установки (то есть взаимодействие с пользователем) при установке из файла конфигурации.
• wizard_all_questions = false
  В документации я не нашел описания этой опции, но видимо она влияет на количество вопросов к пользователю в интерактивном режиме.
• mirror = “https://dl.espressif.com/github_assets”
  idf_mirror = “https://github.com”
  pypi_mirror = “https://pypi.org/simple”
  “Зеркала” – источники для скачивания дистрибутивов. Для offline-установки не действуют
• use_local_archive = ‘C:\Espressif\dist\archive_vv6.0_windows-x64.zst’
  Установщик будет использовать предоставленный архив вместо загрузки из интернета. Архив должен быть файлом .zst. Не распаковывайте архив .zst. Этот вариант несовместим с вариантами онлайн-установки, такими как idf_versions, mirror, и т. д. В настоящее время автономная установка поддерживает только Python 3.11–3.14 на Linux, macOS и Windows.
• recurse_submodules = true
  Должен ли установщик рекурсивно просматривать подмодули репозитория ESP-IDF (по умолчанию true)
• install_all_prerequisites = false
  Должен ли установщик попытаться установить все недостающие необходимые компоненты (только для Windows)
• skip_prerequisites_check = false
  Пропустить проверку необходимых компонентов. Это полезно, если вы уверены, что все необходимые компоненты уже установлены, и хотите пропустить проверку. Не рекомендуется использовать этот способ, если вы не знаете, что делаете, так как это может привести к неработоспособной установке. Используйте на свой страх и риск.
• cleanup = false
  Если установлено значение true, установщик удалит временные архивные файлы инструментов после установки. По умолчанию — false. Это полезно для автоматических установок, CI и Docker, где файлы установки не требуются после установки и могут значительно уменьшить размер конечного образа.
• python_env_folder_name = “python”
  Имя папки, используемой для окружений Python. Если не указано, будет использоваться значение по умолчанию python.
• activation_script_path_override = ‘C:\Espressif\tools’
  Необязательная опция для указания пути к скрипту PowerShell для активации ESP-IDF. Это позволяет указать собственный путь для сохранения скрипта активации вместо пути по умолчанию.
• create_bat_activation_script = false
  Необязательный флаг для создания скрипта активации пакетной команды CMD в дополнение к скрипту PowerShell. Это сделано только для обратной совместимости — рекомендуется всегда использовать PowerShell, а поддержка пакетной обработки будет прекращена в будущих версиях.
• python_version_override = “python313”
  Версия python, которая будет использована при установке.
• idf_features
  Разделенный запятыми список дополнительных функций IDF (ci, docs, pytests и т. д.), которые будут установлены вместе с ESP-IDF. При установке нескольких версий этот список применяется ко всем версиям. Для настройки функций для каждой версии отдельно используйте раздел idf_features_per_version.
• idf_tools
  Разделенный запятыми список инструментов сборки, которые будут установлены вместе с ESP-IDF. При установке нескольких версий этот список применяется ко всем версиям. Для настройки инструментов для каждой версии отдельно используйте раздел idf_tools_per_version.

Таким образом, вы можете подкорректировать файл конфигурации “под себя” и затем не тратить драгоценное время на выбор необходимых опций при установке.

---

CLI: Установка в режиме командного интерфейса

ESP-IDF Installation Manager предоставляет интерфейс командной строки с различными командами для управления установками ESP-IDF [CLI Commands].

Формат запуска:

eim [OPTIONS] [COMMAND]

Команды пишутся без дефиса, опции – с одним (windows-стиль) или двумя (unix-стиль) дефисами.

Общие опции

Некоторые команды имеют свои собственные опции. Но есть и общие для всех команд опции – эти опции перечислены ниже:

• -l, --locale <LOCALE>: выбор языка для мастера установки (английский, китайский)
• -v, --verbose: увеличить уровень детализации логов (можно использовать несколько раз)
• --log-file <LOG_FILE>: файл, в котором будут храниться журналы (по умолчанию: eim.log)
• --do-not-track <true|false>: не отслеживать – если установлено значение true, установщик не будет отправлять данные об использовании eim.
• -h, --help: печать справочной информации
• -V, --version: печать сведений о версии eim

Команды

• install – Неинтерактивная (без взаимодействия с пользователем) установка версий ESP-IDF.
• wizard – Запустить мастер установки ESP-IDF в интерактивном режиме
• list – Вывести список установленных версий ESP-IDF
• select – Выбрать версию ESP-IDF как активную
• rename – Переименовать выбранную ESP-IDF версию
• remove – Удалить выбранную ESP-IDF версию
• purge – Удалить все установленные ESP-IDF версии
• import – Импорт существующих установок ESP-IDF из файла tools_set_config.json
• run – Выполнить команду в контексте конкретной выбранной версии ESP-IDF
• fix – Исправить установку одной из версий ESP-IDF
• discover – Список доступных для установки версий ESP-IDF (пока не реализовано)
• completions – Сгенерировать скрипт автодополнения оболочки для вывода в стандартный поток вывода

---

Установка дополнительных драйверов

Для установки драйверов необходимо запустить eim от имени администратора. Затем просто нажмите Install Drivers…

Через несколько секунд eim отрапортует еле заметным уведомлением, что драйвера успешно установлены. Но вот сами файлы вы не найдете. Драйвера сразу же устанавливаются в систему, а достать их “на будущее” невозможно, так как временные файлы сразу же удаляются.

---

Установка Espressif IDE на базе Eclipse

В старом установщике Espressif IDE на базе Eclipse была встроена в установку версии ESP-IDF. Из eim её убрали, так как основной IDE теперь считается расширение для Visual Studio Code. Теперь Espressif IDE, если она вам необходима, нужно ставить отдельно. Скачать архив можно здесь.

Установщика как такового сейчас нет, вы просто распаковываете скачанный архив в нужную папку и запускаете.

На момент написания статьи доступна версия 4.2.0 от 02 апреля 2026 г.

---

Замеченные проблемы

Проблемы, которые я заметил на текущий момент. Вполне возможно, я что-то забыл и дополню список или наоборот – все описанное будет исправлено в ближайшем будущем.

1. Антивирус Касперского воспринимает eim как злобный троян. Причем не при запуске – а уже во время установки. При этом удаляет eim без возможности восстановления (в карантин почему-то не помещает). Решение – добавить eim в исключение антивируса.

2. Нельзя изменять путь к файлу конфигурации eim_idf.json. По умолчанию он лежит в папке c:\Espressif\tools\. Параметр, отвечающий за этот путь есть и в файле конфигурации, и в параметрах установки через командную строку. НО! При изменении местоположения этого файла перестает работать плагин VSCode. В Espressif ответили, что “этот параметр предназначен для слишком специальных случаев и его не следует использовать обычному пользователю”.

3. Невозможно изменить путь к tools во время установки из GUI. Точнее можно, если очень нужно, но только через файл конфигурации или параметры командной строки.

4. Версии устанавливаются в папку \<VERSION>\esp-idf\ а не \esp-idf\<VERSION>\, что было бы более логично.

---

Ссылки

1. Новая версия установщика ISP-IDF (eim): ESP-IDF Installation Manager
2. Прежняя версия установщика ISP-IDF: Windows Installer Download
3. Espressif IDE отдельно и в виде плагина для Eclipse
4. Драйвер USB-Serial-JTAG для Windows [подробнее]