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

✅ Что нужно

Python 3.10+ и установленный ESPHome (pip install esphome)
ESP-плата + USB-кабель с данными (не «charge-only»)
Подготовленный firmwares/secrets.yaml
Home Assistant с ESPHome integration

📦 Шаги

Подготовьте secrets.yaml:
Окно терминала
```
cp firmwares/secrets.yaml.example firmwares/secrets.yaml
```
Минимум для старта:
```
wifi_ssid: "имя_сети"
wifi_password: "пароль"
ap_password: "пароль_точки_доступа"
api_encryption_key: "…ключ из esphome wizard…"
ota_password: "надёжный_пароль_ota"
```
Сгенерируйте api_encryption_key командой esphome wizard или онлайн. Он должен совпадать с тем, что вы внесёте в HA при добавлении устройства.
Подключите плату по USB. Если устройство не определилось:
- Проверьте кабель (с линиями данных).
- Закройте программы, держащие COM-порт (esphome dashboard, Serial Monitor).
Запустите прошивку — выберите подход:
Окно терминала
python scripts/gui_flasher_flet.py
Wizard в 4 шага: источник → плата → secrets → запуск. Подходит для новичков.
Окно терминала
# Пример на минимальном шаблоне: py -3.13 scripts/flasher.py -a run \ -f firmwares/example/example.yaml.j2 \ --board-profile esp8266-nodemcu \ --port COM5 -y
Список профилей платы — в гайде.
Windows:
Окно терминала
bin\windows\run.bat
Linux/macOS:
Окно терминала
./bin/linux/run.sh
Добавьте устройство в Home Assistant через ESPHome integration. Введите api_encryption_key, который указали выше.

📚 Дальше

📦 Каталог прошивок 5 готовых прошивок: radar, humidifier, curtains, station, relay.

🛠️ Шаблоны Jinja2 Как параметризовать .yaml.j2 + переменные FLASHER_*.

🚀 OTA quickstart Как настроить обновления по GitHub Actions + MinIO S3.

🐝 Zigbee каркасы Параллельная ESP-IDF ветка для C6/H2 устройств.