Выбор и сборка прошивки¶
Конструктор на сайте помогает выбрать плату, готовый профиль или собственный набор возможностей. Вариант собирается из конкретного коммита исходников; готовность подтверждается полным комплектом файлов и их SHA256.
1. Плата¶
| Выбор | Для чего | Задачи в своей сборке |
|---|---|---|
| ESP8266 | NodeMCU / D1 mini, ограниченная RAM | 1–5, по умолчанию 4 |
| ESP-01S | 1 МБ Flash, внешний программатор, API без Web UI | 1–5, по умолчанию 4 |
| ESP32 | Совместимая ESP32 DevKit / WROOM | 1–16, по умолчанию 16 |
| ESP32-C3 | Совместимая C3-плата | 1–16, по умолчанию 16 |
Наличие свободного Flash не означает достаточный runtime heap. Каждый слот задачи резервирует RAM, даже если задача ещё не создана. Для ESP8266 выбирайте необходимое число слотов и возможности, затем проверяйте свободную память под реальной нагрузкой. Проценты RAM в результате сборки — статическое размещение, а не минимальный свободный heap во время работы.
2. Возможности¶
Готовый профиль можно скачать сразу, если опубликованы оба образа. Если готового варианта для платы нет, перейдите к своему набору. Конструктор получает список плагинов из манифестов прошивки: реле и датчики, триггеры, условия и действия. Необходимые зависимости добавляются автоматически; например, удалённый датчик требует mesh. IR определяется выбранными IR-плагинами, отдельной пустой галки IR нет.
Выбор сохраняется отдельно для каждой платы, в том числе после смены языка и перезагрузки страницы, если браузер разрешает локальное хранилище.
3. Сборка и результат¶
Своя сборка доступна без входа с меньшим лимитом новых заданий. Вход через облако даёт лимит учётной записи. Повтор уже готового варианта и присоединение к той же активной сборке не создают ещё один workflow. Исходники и число задач входят в ключ кэша: новая версия исходников требует нового результата.
Интерфейс различает очередь, сборку, готовность, ошибку и паузу из-за сети. Состояние можно вручную проверить прямо в конструкторе. История позволяет вернуться к варианту после закрытия страницы. Ожидание ограничено 25 минутами; ошибочный запуск можно повторить. Неизвестный или старый непроверяемый комплект нужно пересобрать. При смене каталога обновите страницу перед новой сборкой.
Первая установка по USB¶
Если доступен installer ZIP, скачайте и распакуйте весь архив. Он содержит
firmware, LittleFS, а для ESP32/C3 — загрузчик, таблицу разделов и boot_app0;
также flash.json, config.json, README.txt и flash.py.
python -m pip install esptool==4.11.0
python flash.py
python flash.py --port COM3 --confirm-first-install
Первый запуск только проверяет SHA256 и показывает адреса. Последняя команда пишет образы и заменяет настройки; укажите фактический COM/tty-порт. Не используйте этот комплект поверх настроенной платы без резервной копии.
У старого готового профиля ZIP может отсутствовать. Два отдельных .bin не
являются полным комплектом первой записи пустого ESP32/C3: выберите свою сборку
и скачайте её полный установочный комплект.
Обновление действующей платы¶
Используйте соответствующие друг другу firmware и LittleFS одного варианта на странице OTA. Форма принимает по одному файлу за раз. Загрузчик и таблица разделов через OTA не обновляются. При смене разметки нужна USB-установка с сохранением нужной конфигурации заранее. ESP-01S обновляется через программатор; образ NodeMCU для него не подходит.
Перед уменьшением лимита задач убедитесь, что существующая конфигурация в него
помещается. Проверяйте сообщения загрузки задач и лимиты в /api/v1/system/info.
Нужна другая возможность?¶
Репозитории исходников закрыты. Доступные функции выбираются в публичном конструкторе. Если нужного устройства или действия нет, напишите нам его модель и ожидаемое поведение.