Додавання в ESPHome
ESPHome: Інструкція з налаштування (Adopt)
Цей посібник допоможе вам додати новий пристрій до панелі ESPHome, вирішити проблеми зі зв'язком та гнучко налаштувати конфігурацію за допомогою пакетів.
Процедура «Усиновлення» (Adopt)
Після першої прошивки пристрій має з'явитися в інтерфейсі ESPHome для керування через Wi-Fi.
- Підключення: Переконайтеся, що пристрій увімкнено і він перебуває в одній Wi-Fi мережі з сервером Home Assistant / ESPHome.
- Виявлення: Відкрийте веб-інтерфейс ESPHome. Новий пристрій має автоматично з'явитися у верхній частині списку під заголовком «Discovered».
- Натисніть «Adopt»: Клікніть на кнопку Adopt на картці виявленого пристрою.
- Встановлення: ESPHome скомпілює та встановить оновлену конфігурацію «по повітрю» (OTA), щоб пристрій став частиною вашої системи для подальших оновлень.
Пошук несправностей (Troubleshooting)
Якщо пристрій не з'являється у списку для «усиновлення»:
- Мережеві налаштування: Перевірте, чи не увімкнено на роутері функцію AP Isolation (ізоляція клієнтів). Пристрої повинні мати можливість «бачити» один одного.
- Протокол mDNS: ESPHome використовує mDNS для пошуку пристроїв. Якщо сервер працює в Docker, використовуйте режим
--net=host. Переконайтеся, що порт 5353 (UDP) не заблокований брандмауером. - VLAN: mDNS зазвичай не проходить через різні підмережі без налаштування mDNS reflection / Avahi.
- Перевірка логів: Підключіть пристрій через USB до комп'ютера, натисніть Logs в ESPHome і оберіть порт. У логах буде видно, чи зміг пристрій підключитися до Wi-Fi та чи отримав він IP-адресу.
- Ручне додавання: Якщо автопошук не працює, натисніть «+ New Device», створіть картку вручну та вкажіть IP-адресу пристрою в налаштуваннях.
Зміна конфігурації та робота з пакетами (Packages)
Використання пакетів дозволяє не перевантажувати основний файл конфігурації. Це зручний спосіб підключення готових модулів для конкретних пристроїв одним посиланням. Пакети дозволяють підтримувати код чистим та легко оновлювати спільні частини конфігурації для багатьох пристроїв одночасно.
Пакети SvitloBot?
Детальний опис, готові списки пакетів, приклади їх підключення та параметри налаштування доступні на сторінці опису пакетів SvitloBot.
Перехід з віддалених пакетів на локальні (Migration to Local Packages)
Після прошивки пристрою (Adopt) ви можете захотіти змінити логіку роботи або додати власні налаштування, не залежачи від оновлень у репозиторії. Ви можете перейти на локальні файли як повністю, так і частково.
Завантаження файлів
Скопіюйте необхідні YAML-файли з вихідного репозиторію у вашу папку з конфігураціями ESPHome (наприклад, у підпапку packages/).
Варіант 1: Повний перехід
Цей метод повністю розриває зв'язок із GitHub. Усі налаштування тепер беруться з ваших локальних копій. Це дозволяє редагувати код «на льоту» без очікування оновлення кешу GitHub.
Було (Remote):
Стало (Local):
Варіант 2: Частковий (гібридний) перехід
Ви можете залишити базові системні налаштування у репозиторії, щоб отримувати критичні оновлення від розробника, але перенести логіку (наприклад, svitlobot.yaml) у локальні файли для кастомізації.
Приклад гібридної конфігурації:
packages:
# Залишаємо базову частину в репозиторії
remote_package:
url: https://github.com/andrewjswan/svitlobot
files:
- packages/common.yaml
- packages/esp32.yaml
refresh: 1s
# Специфічну логіку робимо локальною для власних змін
svitlobot: !include packages/svitlobot.yaml
custom_url: !include packages/custom_url.yaml
# Ваші нові локальні пакети
some_package: !include packages/some_package.yaml
Структура локальних файлів (Рекомендована)
Для стабільної роботи та зручного редагування рекомендується зберігати всі спільні налаштування в підпапці packages поруч із файлами конфігурацій ваших пристроїв: