Обзор OTA

OTA в проекте

Рекомендуемый путь - через GitHub: просто, надежно и без поддержки своего сервера.

Поток

1. Сборка прошивки.
2. Публикация артефакта.
3. Устройство видит новую версию.
4. Обновление из Home Assistant.

Где начать

Перейдите в /ota/github-quickstart/.

sidebar_position: 1 title: Обзор OTA системы

📚 Документация ESPHome Flasher

Общая документация проекта. Документация для конкретных устройств находится в папках firmwares/*/.

✅ Canonical flow: /ota/github-quickstart
⚠️ Legacy: /ota/ota-quickstart, /ota/ota-ready, /ota-server (только для сопровождения уже существующих self-hosted инсталляций).

📁 Структура

docs/
├── 📂 github-ota/          # GitHub OTA система (общая)
│   ├── GITHUB-OTA.md       # Полное описание
│   ├── GITHUB-QUICKSTART.md # Быстрый старт (10 мин)
│   ├── OTA-QUICKSTART.md   # Краткое руководство
│   └── OTA-READY.md        # Описание готовности
│
├── 📂 ota-server/          # Альтернатива: свой сервер
│   └── README.md           # Настройка Nginx/Apache/Python
│
├── POWER-MONITORING.md     # 🔋 Мониторинг батареи и БП
│
└── README.md               # Этот файл

📦 Документация устройств

Документация для конкретных устройств находится в соответствующих папках:

firmwares/
├── esp32c3-radar-light/
│   ├── README.md           # Описание, функции, примеры
│   ├── HARDWARE-GUIDE.md   # Подключение радара и фоторезистора
│   └── esp32c3-radar-light.yaml.j2
│
├── esp32c3-relay/
│   ├── README.md           # Описание реле
│   └── esp32c3-relay.yaml.j2
│
└── example/
    ├── README.md           # Шаблон для новых устройств
    └── example.yaml.j2

🎯 Актуальная документация

Общая для всех устройств

GitHub OTA система (рекомендуется)

• GITHUB-QUICKSTART.md - начните отсюда! Настройка за 10 минут
• GITHUB-OTA.md - полное описание системы, архитектура, примеры

Альтернатива: свой сервер

• ota-server/ - если хотите использовать свой веб-сервер вместо GitHub

Специфичная для устройств

Документация по подключению, настройке и использованию конкретных устройств находится в папках устройств:

• firmwares/esp32c3-radar-light/ - ESP32-C3 с радаром HLK-LD2402 и фоторезистором

  • README.md - описание функций, примеры автоматизаций
  • HARDWARE-GUIDE.md - детальное руководство по подключению

• firmwares/esp32c3-relay/ - ESP32-C3 с реле

  • README.md - описание и примеры использования

• firmwares/example/ - базовый шаблон

  • README.md - как создать свое устройство

🚀 С чего начать?

1. Настройка проекта → см. главный README.md в корне проекта
2. Первая прошивка → используйте ./bin/linux/run.sh
3. Настройка OTA → читайте GITHUB-QUICKSTART.md
4. Подключение устройства → см. документацию в папке конкретного устройства:
   • Радар + свет: firmwares/esp32c3-radar-light/HARDWARE-GUIDE.md
   • Реле: firmwares/esp32c3-relay/README.md

📝 Прошивки

Документация по конкретным прошивкам находится в папке firmwares/:

• firmwares/README.md - обзор всех прошивок
• firmwares/esp32c3-radar-light/ - радар + фоторезистор
• firmwares/esp32c3-relay/ - простое реле
• firmwares/example/ - базовый шаблон

📦 Архив

Папка archive/ содержит устаревшие файлы из предыдущих версий проекта. Они сохранены для справки, но актуальную информацию ищите в других разделах.

---

Последнее обновление: 28 января 2026 г.