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

Быстрый старт

Начните с выбора платы и подходящей прошивки. Установка с нуля записывает код и файловую систему; обновление настроенной платы выполняется через OTA.

Что понадобится

  • ESP8266 (NodeMCU / D1 mini), ESP32, ESP32-C3 или ESP-01S с подходящим питанием.
  • USB-кабель с передачей данных. ESP-01S требует внешнего программатора 3,3 В.
  • Компьютер для записи образов. Расположение USB и способ входа в загрузчик зависят от конкретной платы; см. Поддерживаемые платы.

1. Выбрать прошивку

Откройте конструктор: выберите плату, готовый профиль или свой набор реле, датчиков, триггеров и действий. Для своей сборки задайте число задач. Модули, необходимые выбранным плагинам, включаются вместе с ними. Подробности: Выбор и сборка прошивки.

2. Записать установочный комплект

Для первой установки выберите «Своя сборка» в конструкторе и скачайте installer ZIP. Распакуйте весь архив: в нём есть firmware, LittleFS и необходимые загрузочные образы именно для вашей платы. Исходники и PlatformIO не требуются.

python -m pip install esptool==4.11.0
python flash.py
python flash.py --port /dev/ttyUSB0 --confirm-first-install

Первая команда flash.py только проверяет SHA256, последняя записывает образы. В Windows укажите фактический порт, например COM3. Адреса записи берутся из flash.json; не переносите адреса ESP32 на ESP32-C3.

У готового профиля может быть только пара firmware и LittleFS. Для пустой ESP32/C3 этого недостаточно: выберите свою сборку и полный ZIP-комплект. ESP-01S требует программатора 3,3 В; см. подключение.

Первая запись заменяет настройки

Установочный ZIP предназначен для первой записи. Для действующей платы сделайте резервную копию и используйте OTA, сохраняющее настройки.

3. Подключить к Wi-Fi

После первой прошивки откройте сеть настройки платы: обычно CtrlBoard-Setup; точное имя видно в Serial-логе. Откройте http://192.168.4.1, задайте домашнюю сеть и перезагрузите плату. Её новый адрес найдите в DHCP-списке роутера или Serial-мониторе (pio device monitor --baud 115200).

ESP-01S не имеет страниц настройки. В режиме точки доступа настройте Wi-Fi через API:

curl -X POST http://192.168.4.1/api/v1/settings/wifi \
  -H 'Content-Type: application/json' \
  -d '{"wifi_networks":[{"ssid":"YourSSID","password":"YourPass"}]}'

4. Войти и настроить плату

Откройте http://<ip-платы>/. Начальный пользователь — admin, пароль — 1234. Смените пароль на странице пользователей. Для API-only платы используйте API-рецепты.

На странице компонентов проверьте доступные плагины; на странице задач — лимит сборки. Число слотов и буферы под задачи определяются при компиляции.

5. Подключить облако при необходимости

Войдите в облачный кабинет, создайте проект и добавьте плату по её UUID. В настройках облачного подключения платы задайте выданный при регистрации ключ этой платы и адрес API для плат http://cloud.kavlev.ru:8081. Адрес кабинета https://cloud.kavlev.ru/ предназначен для браузера.

Heartbeat использует HMAC; новые версии проверяют также подпись ответа. Это подтверждает подлинность и целостность, но не шифрует HTTP-трафик. Подробнее: Облачное подключение.

Дальше: Устройства, Задачи, Группы и доступ.