Skip to content

📦 Пакети конфігурації ESPHome для SvitloBot

Цей розділ містить готові модульні пакети (packages), які дозволяють швидко зібрати прошивку для вашого пристрою. Замість копіювання величезних блоків коду, ви просто підключаєте потрібні функції однією директивою.

🚀 Переваги використання пакетів

  • Модульність: підключайте лише те, що потрібно (тільки дисплей, тільки сенсори тощо).
  • Завжди актуально: пристрої автоматично підтягують оновлення логіки з цього репозиторію при перезбірці.
  • Чистий код: ваш основний YAML-файл залишається коротким і зрозумілим.

🛠 Доступні пакети

Нижче наведено перелік пакетів, які дозволяють гнучко збирати прошивку SvitloBot як конструктор.

🛠 Основні пакети

Виберіть базові пакети залежно від вашої платформи та потреб:

  • common.yaml — Загальні налаштування системи (Wi-Fi, API, Logger).
  • esp32.yaml / esp8266.yaml — Конфігурація для відповідного типу мікроконтролера.
  • web_server_auth.yaml — Веб-інтерфейс із авторизацією.

🕵️ Моніторинг та сервіси

  • svitlobot.yaml — Сповіщення в телеграм-канал від системи СвітлоБот при зміні стану живлення. Детальніше.
  • healthcheck.yaml — "Сигнали життя" (pings) на Healthсhecks.io. Сповістить, якщо пристрій офлайн. Детальніше.
  • custom_url.yaml — "Сигнали життя" (pings) на будь-який сервіс, URL вказується в налаштуваннях.
  • ping.yaml — Пакет дозволяє СвітлоБот визначати наявність світла опосередковано — через доступність будь-якого пристрою в локальній мережі, який не підключений до UPS. Детальніше.

⚙️ Настройка частоты опроса (Ping Interval)

  • interval_esp32.yaml — Пакет підтримує налаштування частоти опитування сервісів у діапазоні від 30 секунд до 5 хвилин.
  • interval_esp8266.yaml — Пакет підтримує налаштування частоти опитування сервісів у діапазоні від 30 секунд до 5 хвилин.

Важливо: Оберіть правильний пакет!

Конфігурація містить два окремих пакети залежно від вашого заліза. Використовуйте лише той, що відповідає вашому контролеру:

  • interval_esp32.yaml — якщо у вас плата на базі ESP32.
  • interval_esp8266.yaml — якщо у вас плата на базі ESP8266 (наприклад, NodeMCU або Wemos D1 Mini).

Не підключайте обидва пакети одночасно! Це призведе до помилок при компіляції.

Особливість для ESP8266

У пакеті для ESP8266 функція restore_from_flash увімкнена за замовчуванням. Це дозволяє пристрою «пам'ятати» встановлений інтервал після вимкнення живлення. Запис у Flash-пам'ять відбувається виключно в момент зміни параметра користувачем. Оскільки це трапляється рідко, ресурс чипа не вичерпується, а стабільність роботи підвищується.

🧩 Комбіновані під-пристрої (Sub Devices)

Готові збірки для специфічних сценаріїв:

Коли використовувати?

При додаванні декількох пакетів моніторингу, для успішної збірки прошивки необхідно додати відповідний пакет під-пристроїв (Sub Devices).

📥 Як підключити

Додайте блок packages у свій конфігураційний файл .yaml:

Приклад

packages:
  remote_package:
    url: https://github.com/andrewjswan/svitlobot
    files:
      ...
      - packages/package_name.yaml
      ...
    refresh: 1s

ESPHome Packages

Документація та приклади використання

Прошивки

Опис прошивок

🛠 Варіанти прошивки