PlatformIO: первые шаги с ESP32
PlatformIO собирает проект по platformio.ini, где явно задаётся плата, framework и порт — большинство ошибок сборки на старте связаны именно с неверным board id или незакрытым портом.
Возможные причины сложностей
- Неверный или устаревший board id в platformio.ini
- Не указан или неверно определяется upload_port/monitor_port
- Framework не совпадает с реальным чипом (arduino vs espidf)
- Кэш .pio с предыдущей сборкой конфликтует после смены платы
Что сделать
- Создайте новый проект в PlatformIO и выберите вашу плату из каталога (например esp32dev, esp32-s3-devkitc-1, esp32-c3-devkitm-1).
- Проверьте секцию [env:...] в platformio.ini: platform = espressif32, board = ваш board id, framework = arduino.
- При необходимости явно укажите upload_port и monitor_port, если автоопределение выбирает не тот COM.
- Задайте monitor_speed = 115200 в platformio.ini, чтобы монитор порта сразу открывался на правильной скорости.
- Если сборка падает после смены платы, удалите папку .pio в проекте и пересоберите с нуля.
- Используйте pio device list, чтобы увидеть все доступные порты и их идентификаторы перед выбором.
Когда нужна замена железа
Не аппаратная проблема — все типичные сбои на этом шаге лечатся правкой platformio.ini и очисткой кэша сборки.
Не официальная поддержка Espressif Systems. Названия и версии инструментов сверяйте с официальной документацией на момент установки.