Начните работать без лишних настроек
Пошаговая инструкция по первой настройке, открытию проекта ESP32 Coder и импорту из Arduino IDE и PlatformIO.
Установка — в отдельную папку
ESP32 Coder внутри. На странице последнего релиза GitHub выбирайте именно ZIP. Отдельный файл .exe в списке релиза предназначен для автоматического обновления. Не запускайте программу прямо из архива или временной папки: компоненты, кэш, настройки и проекты требуют постоянной папки с правом записи.- Откройте последний релиз ESP32 Coder и скачайте ZIP-архив.
- Создайте постоянный каталог для программ, например
C:\Dev\(желательно без кириллицы и OneDrive). - Распакуйте из ZIP папку
ESP32 Coderцеликом. В результате получитсяC:\Dev\ESP32 Coder\. - Запускайте
esp32coder.exeиз этой папки. Сохраняйте каталог целиком при дальнейшей работе; отдельный EXE из GitHub Releases используйте только по назначению механизма автообновления.
C:\Dev\ESP32 Coder\
├── esp32coder.exe
├── runtime\ (компоненты)
├── Projects\
│ └── MyProject1\
│ ├── libs\
│ ├── MyProject1.cpp
│ └── esp32coder.ini
└── build_temp\ (возможна после сборки)В обычном случае build_temp создаётся рядом с программой при сборке. Если путь содержит кириллицу или находится в OneDrive, Coder может перенести временную сборку в локальный каталог Windows.
Не рекомендуем Program Files без прав записи. Папка Projects создаётся программой автоматически.
Выберите плату и установите компоненты
- Запустите ESP32 Coder и в меню «Плата, порт» выберите вашу модель. Для примеров ниже — ESP32 Dev Module.
- Откройте «Компоненты» и установите предлагаемые для выбранной платы SDK/Arduino Core и toolchain. Набор зависит от семейства ESP32.
- При необходимости откройте «Библиотеки» и установите внешние библиотеки проекта.
- Подключите плату USB-кабелем с передачей данных и выберите её COM-порт.
ESP32 Coder работает без VPN: для локального редактирования, сборки и прошивки он не нужен. Первоначальная загрузка SDK, инструментов и библиотек требует интернета; после установки можно работать оффлайн.
Готовый проект ESP32 Coder
Демонстрационный ESP32_Smart_Monitor — проект с восемью исходными файлами: Wi-Fi точка доступа, HTTP-страница с JSON, чтение ADC и настройки через Preferences. Архив теперь содержит конфигурацию esp32coder.ini и каталог libs/ — это формат проекта Coder.
ESP32_Smart_Monitor/
├── libs/ ← библиотеки проекта
├── ESP32_Smart_Monitor.cpp
├── AppConfig.h
├── SensorHub.h
├── SensorHub.cpp
├── WebDashboard.h
├── WebDashboard.cpp
├── SettingsStore.h
├── SettingsStore.cpp
└── esp32coder.ini ← настройки проектаCoder создаёт папку проекта и каталог libs/, но не создаёт src/ и include/. Исходники и заголовки в этом примере лежат в корне проекта.
Вы можете использовать автоматическую очистку библиотек и в новом проекте: после успешной сборки Coder оставит в libs/ используемые библиотеки и их зависимости.
- Скачайте проект в формате ESP32 Coder ↓.
- Распакуйте папку
ESP32_Smart_MonitorвC:\Dev\ESP32 Coder\Projects\или другую постоянную папку проекта. - В Coder выберите «Открыть» → «Открыть проект» и откройте
ESP32_Smart_Monitor. - Выберите ESP32 Dev Module и нажмите «Проверить» или «Собрать».
GPIO34, подходящий для классической ESP32 Dev Module. Для ESP32-S3/C3 и других плат измените номер вывода и проверьте аппаратную совместимость. Пример не проверен на реальной плате.Что выводит монитор порта (115200 бод)
После запуска прошивка печатает сообщение о готовности. Далее при включённом журналировании примерно каждые 250 мс выводит измерение ADC на GPIO34 и сглаженное значение:
[SmartMonitor] System ready
ADC: 1.50 V | Avg: 1.50 V
ADC: 1.55 V | Avg: 1.51 V
ADC: 1.60 V | Avg: 1.52 V
ADC: 1.68 V | Avg: 1.54 V
Числа здесь рассчитаны по алгоритму SensorHub из примерных значений ADC. При подключении настоящей ESP32 они будут зависеть от напряжения на GPIO34. Программа не выводит Wi-Fi SSID, IP-адрес или HTTP-статус в Serial.
Как импортировать Arduino-скетч
ESP32 Coder импортирует папку проекта с главным файлом .ino, а не только содержимое открытого редактора.
Arduino_Blink_Serial/
├── Arduino_Blink_Serial.ino
└── BlinkConfig.h
#include <Arduino.h>
#include "BlinkConfig.h"
void setup() { Serial.begin(115200); pinMode(LED_PIN, OUTPUT); }
void loop() { digitalWrite(LED_PIN, HIGH); delay(500); digitalWrite(LED_PIN, LOW); delay(500); }
- Скачайте пример Arduino IDE ↓ и распакуйте его вне папки Coder Projects.
- В программе нажмите «Открыть» → «Импорт проекта Arduino IDE».
- Выберите папку
Arduino_Blink_Serial(в ней лежит.ino). - Укажите имя нового проекта и подтвердите импорт — он появится в
Projects/. - Проверьте плату, библиотеки, затем нажмите «Проверить» или «Собрать».
esp32coder.ini. Оригинал из Arduino IDE остаётся на месте.После импорта большого скетча удобно скопировать общие библиотеки Arduino IDE в libs/ и после успешной сборки автоматически удалить лишние. Аналогичная возможность есть и у новых проектов.
Как импортировать проект PlatformIO
Для импорта выберите корневую папку проекта, где находится platformio.ini. Не выбирайте отдельно src/.
Структура ниже относится к исходному проекту PlatformIO, а не к проекту Coder:
PlatformIO_Blink_Serial/
├── platformio.ini
├── src/
│ └── main.cpp
└── include/
└── BlinkConfig.hПосле импорта в Coder исходники main.cpp и BlinkConfig.h располагаются в корне новой папки проекта; также создаются esp32coder.ini и libs/.
[env:esp32dev]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
- Скачайте пример PlatformIO ↓ и распакуйте в отдельное место.
- Выберите «Открыть» → «Импорт проекта PlatformIO».
- Укажите папку
PlatformIO_Blink_Serialсplatformio.ini. - Подтвердите имя проекта. Кодер перенесёт исходники, настройки платы и сведения о зависимостях в собственный проект.
- Проверьте выбранную плату и установленные библиотеки. Нажмите «Собрать».
platformio.ini используется для чтения параметров, но в проект Coder не копируется. Вместо него создаётся esp32coder.ini. Локальные библиотеки из lib/ и доступного кэша .pio/libdeps/ могут импортироваться в libs/; отсутствующие зависимости устанавливаются отдельно.Импорт библиотек Arduino IDE в папку libs и автоматическая очистка
В ESP32 Coder библиотеки привязываются к конкретному проекту. Каждая внешняя библиотека хранится в своей подпапке libs/, рядом с исходниками и esp32coder.ini. Благодаря этому проект можно перенести на другой компьютер вместе с нужными библиотеками — их не придётся искать в общей папке Arduino IDE.
libs/ библиотеки из общей папки Arduino IDE, а после первой успешной компиляции ESP32 Coder сам удалит из проекта библиотеки, которые не используются в текущем коде и не требуются зависимостями. Такой же подход работает и с новыми проектами Coder.1. Как импортировать библиотеки
- Откройте или создайте проект в ESP32 Coder. Для импортированного Arduino-скетча сначала завершите импорт папки с главным
.ino. - Откройте менеджер «Библиотеки» и выберите импорт из папки библиотек Arduino IDE. В диалоге укажите общую папку, содержащую подпапки библиотек, например
C:\Users\<пользователь>\Documents\Arduino\libraries. Если ваша Arduino IDE использует другое расположение, выберите его. - Подтвердите импорт и дождитесь копирования. Coder переносит библиотеки в папку текущего проекта
libs/, отображает ход копирования и не отсеивает их заранее по архитектуре ESP32. - Откройте дерево проекта и проверьте содержимое
libs/. При обычном копировании исходные папки библиотек Arduino IDE сохраняются без изменений.
Projects/
└── MyProject1/
├── MyProject1.cpp
├── esp32coder.ini
└── libs/
├── ArduinoJson/
├── ESP_Async_WebServer/
├── Async_TCP/
└── Some_Unused_Library/ ← пока тоже скопирована
Можно также добавлять отдельные библиотеки через менеджер, устанавливать их из GitHub (в русской версии доступен и поиск через Trema) или копировать папки непосредственно в libs/. Библиотеки, уже входящие в ESP32 Arduino Core, обычно отдельно копировать не нужно.
2. Что происходит после первой успешной сборки
- Выберите целевую плату и нажмите «Собрать» (или выполните полную «Проверить» с успешной компиляцией). Coder анализирует
#includeв исходниках, заголовки внешних библиотек и зависимости между библиотеками. - Программа компилирует и компонует проект. Удаление запускается только после успешного завершения компиляции и компоновки, а для сборки — после создания BIN. При ошибке или отмене библиотеки не удаляются.
- Coder оставляет библиотеки, которые использует проект, а также библиотеки, необходимые им как зависимости. Излишние распознанные папки библиотек удаляются из локального каталога проекта (
libs/; очистка также поддерживает проектныеlib/и.pio/libdeps/). - В консоли появляется отчёт
LIBRARY CLEANUP REPORT AFTER SUCCESSFUL VERIFY/BUILDс количеством проверенных, удалённых и сохранённых библиотек. При необходимости недостающую библиотеку можно снова импортировать или установить.
MyProject1/
├── MyProject1.cpp
├── esp32coder.ini
└── libs/
├── ArduinoJson/
├── ESP_Async_WebServer/
└── Async_TCP/ ← нужная зависимость сохранена
#include, автоматический анализ может не распознать её. Храните резервную копию таких библиотек вне libs/ перед первой успешной сборкой. Из общей папки Arduino IDE при обычном импорте ничего не удаляется.3. Тот же механизм для нового проекта
- Создайте новый проект, например
MyProject2: Coder создаст его папку иlibs/. - Добавьте необходимые или потенциально нужные библиотеки через «Библиотеки» либо скопируйте их из своего каталога.
- Напишите код с нужными
#includeи выполните первую успешную сборку. - Просмотрите отчёт об очистке: останутся используемые библиотеки и их зависимости, лишние папки будут удалены.
Если после этого добавите в проект новый модуль или #include, просто установите недостающую библиотеку в libs/ и соберите снова. Это позволяет содержать проект компактным и не засорять его общим набором Arduino-библиотек.
Проверка, сборка, прошивка
Проверка проекта и зависимостей без прошивки.
Компиляция и создание файла прошивки BIN.
Сборка и прошивка через выбранный COM-порт.
Для диагностики используйте «Монитор и плоттер»; скорость порта должна совпадать с Serial.begin(...), в примерах — 115200.
Если что-то не получается
Нет SDK или toolchain
Выберите нужную плату и откройте «Компоненты». Дождитесь установки для соответствующего семейства ESP32 и повторите сборку.
Импорт не видит .ino или platformio.ini
Выбирайте корневую папку: для Arduino — каталог с главным .ino, для PlatformIO — каталог с platformio.ini.
Нет COM-порта
Проверьте USB-кабель, драйвер USB-UART и не занят ли порт другим монитором. После подключения обновите список портов.
Не сохраняются проекты или кэш
Убедитесь, что программа распакована и запущена из отдельной папки, доступной для записи, а не из ZIP или временной папки.
