ESPHome ESP8266 Фізичне підключення до вашого пристрою Посібник користувача

Інтегруйте пристрої на базі ESPHome в Control4. ESPHome — це система з відкритим кодом, яка перетворює поширені мікроконтролери, такі як ESP8266 та ESP32, на пристрої розумного дому за допомогою простого налаштування YAML. Пристрої ESPHome можна налаштовувати, контролювати та керувати за допомогою... web браузер, Home Assistant або інші сумісні платформи. Цей драйвер забезпечує безперебійний моніторинг та керування пристроями ESPHome безпосередньо з вашої системи Control4.

Системні вимоги

ОС Control4 3.3+

особливості

Зв'язок у локальній мережі, що не потребує хмарних сервісів
Оновлення в режимі реального часу від усіх підтримуваних об'єктів, що надаються пристроєм
Підтримує зашифровані з'єднання за допомогою ключа шифрування пристрою
Підтримка програмування змінних

Сумісність

Перевірені пристрої
Цей драйвер загалом працюватиме з будь-яким пристроєм ESPHome, але ми провели ретельне тестування з такими пристроями:

ратгдо – Посібник з налаштування

Якщо ви спробуєте цей драйвер на одному з перелічених вище продуктів, і він запрацює, повідомте нам!

Підтримувані сутності ESPHome

Налаштування інсталятора

Для кожного пристрою ESPHome потрібен лише один екземпляр драйвера. Кілька екземплярів цього драйвера, підключених до одного пристрою, матимуть неочікувану поведінку. Однак, ви можете мати кілька екземплярів цього драйвера, підключених до різних пристроїв ESPHome.

Налаштування хмари DriverCentral
Якщо у вас вже є Драйвер DriverCentral Cloud встановлено у вашому проекті, ви можете продовжити встановлення драйвера.

Цей драйвер використовує драйвер DriverCentral Cloud для керування ліцензуванням та автоматичними оновленнями. Якщо ви вперше користуєтеся DriverCentral, ви можете звернутися до їхньої Документація до хмарного драйвера для його налаштування.

Установка драйвера

Встановлення та налаштування драйвера аналогічні більшості інших драйверів на основі IP. Нижче наведено основні кроки для вашої зручності.

Завантажте останню версію control4-esphome.zip від DriverCentral.
Витягніть та встановіть esphome.c4z, esphome_light.c4z, і esphome_lock.c4z водії.
Скористайтеся вкладкою «Пошук», щоб знайти драйвер «ESPHome» та додати його до свого проєкту.

Виберіть щойно доданий драйвер на вкладці «Проектування системи». Ви побачите, що стан хмари відображає стан ліцензії. Якщо ви придбали ліцензію, відображатиметься «Ліцензія активована», інакше «Пробна версія працює» та залишок пробного періоду.
Ви можете оновити стан ліцензії, вибравши драйвер «DriverCentral Cloud» на вкладці «System Design» та виконавши дію «Check Drivers».

Налаштуйте Налаштування пристрою з інформацією про підключення.
Через кілька хвилин у статусі драйвера з’явиться напис «Підключено». Якщо драйверу не вдається підключитися, встановіть властивість режиму журналу на «Друк» та скиньте значення поля IP-адреса для повторного підключення. Потім перевірте вікно виводу Lua для отримання додаткової інформації.
Після підключення драйвер автоматично створить змінні та з'єднання для кожного підтримуваного типу сутності.

Щоб керувати освітленням та/або замками, скористайтеся вкладкою «Пошук», щоб знайти драйвер «ESPHome Light» та/або «ESPHome Lock». Додайте один екземпляр драйвера для кожної відкритої сутності світильника або замка у вашому проєкті. На вкладці «З’єднання» виберіть драйвер «ESPHome» та прив’яжіть сутності світильника або замка до щойно доданих драйверів.

Налаштування драйвера

Властивості драйвера

Налаштування хмари

Хмарний статус
Відображає стан хмарної ліцензії DriverCentral.
Автоматичне оновлення
Вмикає/вимикає автоматичні оновлення хмари DriverCentral.

Налаштування драйвера

Стан драйвера (лише для читання)
Відображає поточний стан драйвера.

Версія драйвера (лише для читання)
Відображає поточну версію драйвера.
Рівень журналу [ Фатальна | Помилка | Попередження | Інформація | Налагодження | Трасування | Ультра ] Встановлює рівень ведення журналу. За замовчуванням Інформація.

Режим журналу [ Вимк. | Друк | Журнал | Друк і журнал ] Встановлює режим ведення журналу. За замовчуванням Вимкнено.

Налаштування пристрою

IP-адреса
Встановлює IP-адресу пристрою (наприклад 192.168.1.30). Доменні імена дозволені, якщо контролер може визначити їх як доступну IP-адресу. HTTPS не підтримується.

Примітка: Якщо ви використовуєте IP-адресу, вам слід переконатися, що вона не зміниться, призначивши статичну IP-адресу або створивши резервування DHCP.

Порт
Встановлює порт пристрою. Порт за замовчуванням для пристроїв ESPHome – 6053.

Режим автентифікації [ Немає | Пароль | Ключ шифрування ]
Вибирає метод автентифікації для підключення до пристрою ESPHome.

немає: Автентифікація не потрібна.

Пароль: Використовуйте пароль для автентифікації (див. нижче).

Ключ шифрування: Використовуйте ключ шифрування для безпечного зв'язку (див. нижче).

Пароль
Відображається, лише якщо для параметра «Режим автентифікації» встановлено значення «Пароль». Встановлює пароль пристрою. Він має збігатися з паролем, налаштованим на пристрої ESPHome.

Ключ шифрування
Відображається, лише якщо для режиму автентифікації встановлено значення «Ключ шифрування». Встановлює ключ шифрування пристрою для безпечного зв’язку. Він має збігатися з ключем шифрування, налаштованим на пристрої ESPHome.

Інформація про пристрій

Ім'я (лише для читання)
Відображає назву підключеного пристрою ESPHome.

Модель (лише для читання)
Відображає модель підключеного пристрою ESPHome.
Виробник (лише для читання)
Відображає виробника підключеного пристрою ESPHome.

MAC-адреса (лише для читання)
Відображає MAC-адресу підключеного пристрою ESPHome.
Версія прошивки (лише для читання)
Відображає версію прошивки підключеного пристрою ESPHome.

Дії водія

Скинути підключення та змінні

УВАГА: Це скине всі прив'язки з'єднань та видалить будь-яке програмування, пов'язане зі змінними.

Скиньте підключення та змінні драйвера. Це корисно, якщо ви змінили підключений пристрій ESPHome або є застарілі підключення чи змінні.

Посібник з налаштування ratgdo

Цей посібник містить інструкції з налаштування драйвера ESPHome для роботи з пристроями ratgdo для керування гаражними воротами через реле в Control4 Composer Pro.

Додати драйвер контролера реле
Додайте потрібний драйвер контролера реле до вашого проекту Control4 у Composer Pro.

Властивості контролера реле
Пристрій ratgdo надає доступ до об'єкта "Cover" в ESPHome, який відповідає функціональності контролера реле в Control4.

Кількість реле
Пристрій ratgdo використовує конфігурацію з кількома реле для керування гаражними воротами. У Composer Pro слід налаштувати параметри реле наступним чином:

Встановлено на 2 реле (відкрити/закрити) або 3 реле (відкрити/закрити/зупинити)
- Пристрій ratgdo використовує окремі команди для відкриття та закриття гаражних воріт
- Якщо ваша прошивка ratgdo підтримує команду «стоп», налаштуйте 3 реле, щоб увімкнути функцію зупинки. Якщо ви не впевнені, ви можете переглянути з’єднання ratgdo в Composer Pro, щоб дізнатися, чи доступне реле «Стоп дверей».

Конфігурація реле

Установити на Пульс
- ratgdo використовує короткочасні імпульси для запуску механізму відкривання гаражних воріт, подібно до натискання настінної кнопки

Час пульсу

Встановіть час усіх імпульсів реле на 500 (за замовчуванням)
- Це тривалість активації реле

Інвертне реле

Встановіть для всіх властивостей інвертного реле значення немає (за замовчуванням)

Зв'язатися з Debounce

Встановити всі часи усунення відскоку контактів на 250 (за замовчуванням)
- Це допомагає запобігти помилковому спрацьовуванню датчиків стану гаражних воріт.

Інвертувати контакт

Встановіть для всіх властивостей інвертування контакту значення немає (за замовчуванням)

ExampВластивості
Для довідки, ось прикладampсписок властивостей контролера реле в Composer Pro:

Підключення релейного контролера

Реле

ВІДЧИНЕНО: Підключіться до реле «Відчинених дверей» ratgdo
Закрити: Підключіться до реле «Закрити двері» ratgdo
Стій: Підключіться до реле «Стоп-двері» ratgdo, якщо таке є

Контактні датчики

Закритий контакт: Зв’яжіться з контактом ratgdo «Двері зачинені»
Відкритий контакт: Зв'яжіться з контактом ratgdo «Відчинені двері»

Example Підключення
Для довідки, ось прикладampяк мають виглядати з'єднання в Composer Pro:

Програмування
Ви можете створювати програми в Control4 для:

Відкривати/закривати гаражні ворота залежно від подій
Контролюйте стан гаражних воріт
Налаштування сповіщень про зміни стану гаражних воріт
Створення власних кнопок на сенсорних екранах та пультах дистанційного керування

Example: Створення сповіщення про те, що все ще відкрито

Використання властивості «Час роботи все ще відкрито» з драйвера контролера реле:

Встановіть потрібну тривалість для параметра «Час роботи все ще відкритим» (наприклад, 10 хвилин)
Створіть правило програмування, яке спрацьовує, коли спрацьовує подія «Все ще відкрито»
Додавання дій для надсилання сповіщень або виконання інших завдань

Додаткові сутності
Залежно від вашого пристрою ratgdo, прошивки та його можливостей, драйвер ESPHome може надавати додаткові сутності. Вони можуть бути у вигляді додаткових з'єднань або змінних драйвера.

Будь ласка, зверніться до документації ratgdo для отримання додаткової інформації про конкретні сутності: https://ratgdo.github.io/esphome-ratgdo/webui_documentation.html

Інформація для розробника
Авторське право © 2025 ТОВ «Фінайт Лабс»
Вся інформація, що міститься в цьому документі, є і залишається власністю Finite Labs LLC та її постачальників, якщо такі є. Інтелектуальні та технічні концепції, що містяться в цьому документі, є власністю
Компанія Finite Labs LLC та її постачальники можуть бути захищені патентами США та інших країн, патентами, що перебувають у процесі розгляду, а також комерційною таємницею або законом про авторське право. Поширення цієї інформації або відтворення цього матеріалу суворо заборонено без попереднього письмового дозволу від Finite Labs LLC. Щоб отримати найактуальнішу інформацію, відвідайте https://drivercentral.io/platforms/control4-drivers/utility/esphome

Підтримка
Якщо у вас виникнуть будь-які запитання або проблеми з інтеграцією цього драйвера з Control4 або ESPHome, ви можете зв’язатися з нами за адресою driver-support@finitelabs.com або зателефонуйте/напишіть нам на номер +1 949-371-5805.

Журнал змін

v20250715 – 14 липня 2025 р.

Виправлено: Виправлено помилку, через яку сутності не виявлялися під час підключення

v20250714 – 14 липня 2025 р.

Додано: Додано підтримку зашифрованих з'єднань за допомогою шифрування пристрою.

v20250619 – 19 липня 2025 р.

Додано Додано документацію, специфічну для ratgdo.

v20250606 – 06 липня 2025 р.

Додано Початковий випуск

FAQ

Які пристрої сумісні з цим драйвером?

Цей драйвер сумісний з будь-яким пристроєм ESPHome, після ретельного тестування на пристроях ratgdo. Якщо ви спробуєте його на будь-якому іншому пристрої, і він працює, будь ласка, повідомте нас для перевірки.

Документи / Ресурси

ESPHome ESP8266 Фізичне підключення до вашого пристрою [pdfПосібник користувача
ESP8266, ESP32, ESP8266 Фізичне підключення до вашого пристрою, ESP8266, Фізичне підключення до вашого пристрою, Підключення до вашого пристрою, до вашого пристрою, вашого пристрою

Список літератури

Посібник користувача

ESPHome ESP8266 Фізичне підключення до вашого пристрою

Технічні характеристики

закінченоview