ESPHome ESP8266 Физическое подключение к вашему устройству

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

• Системные требования: Control4 OS 3.3+

Надview

Интегрируйте устройства на базе ESPHome в Control4. ESPHome — это система с открытым исходным кодом, которая преобразует обычные микроконтроллеры, такие как ESP8266 и ESP32, в устройства для умного дома с помощью простой конфигурации YAML. Устройства ESPHome можно настраивать, контролировать и управлять ими с помощью web Браузер, Home Assistant или другие совместимые платформы. Этот драйвер обеспечивает бесперебойный мониторинг и управление устройствами ESPHome непосредственно из системы Control4.

Системные требования

• Control4 OS 3.3+

Функции

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

Совместимость

Проверенные устройства
Этот драйвер в целом будет работать с любым устройством ESPHome, но мы провели тщательное тестирование со следующими устройствами:

• ратгдо – Руководство по настройке

Если вы попробуете этот драйвер на продукте из списка выше, и он сработает, дайте нам знать!

Поддерживаемые сущности ESPHome

Установка установщика

Для каждого устройства ESPHome требуется только один экземпляр драйвера. Подключение нескольких экземпляров этого драйвера к одному устройству может привести к непредсказуемому поведению. Однако вы можете подключить несколько экземпляров этого драйвера к разным устройствам ESPHome.

Настройка облака DriverCentral
Если у вас уже есть Драйвер DriverCentral Cloud установлен в вашем проекте, вы можете перейти к установке драйвера.

Этот драйвер использует облачный драйвер DriverCentral для управления лицензированием и автоматическими обновлениями. Если вы новичок в использовании DriverCentral, вы можете обратиться к их Документация по облачному драйверу за его настройку.

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

Установка и настройка драйвера аналогичны установке и настройке большинства других IP-драйверов. Ниже для вашего удобства приведено краткое описание основных шагов.

1. Загрузите последнюю версию control4-esphome.zip от DriverCentral.
2. Извлеките и установите esphome.c4z, esphome_light.c4z, и esphome_lock.c4z водители.
3. Используйте вкладку «Поиск», чтобы найти драйвер «ESPHome» и добавить его в свой проект.
4. Выберите недавно добавленный драйвер на вкладке «Проект системы». Вы увидите, что состояние облака отражает состояние лицензии. Если вы приобрели лицензию, будет указано «Лицензия активирована», в противном случае — «Пробный период» и оставшийся срок действия пробного периода.
5. Вы можете обновить статус лицензии, выбрав драйвер «DriverCentral Cloud» на вкладке «Проект системы» и выполнив действие «Проверка драйверов».
6. Настройте Настройки устройства с информацией о подключении.
7. Через несколько секунд в поле «Состояние драйвера» появится значение «Подключено». Если драйверу не удаётся подключиться, установите для свойства «Режим журнала» значение «Печать» и перенастройте поле «IP-адрес» для повторного подключения. Затем проверьте окно вывода Lua для получения дополнительной информации.
8. После подключения драйвер автоматически создаст переменные и соединения для каждого поддерживаемого типа сущности.
9. Для управления освещением и/или замками используйте вкладку «Поиск», чтобы найти драйвер «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 поддерживает команду «стоп», настройте три реле для включения функции остановки. Если вы не уверены, проверьте подключения ratgdo в Composer Pro, чтобы узнать, доступно ли реле «Стоп-дверь».

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

• Установить на Пульс
  • ратгдо использует кратковременные импульсы для активации открывателя гаражных ворот, подобно нажатию настенной кнопки

Время импульса

• Установите все времена импульсов реле на 500 (по умолчанию)
  • Это продолжительность времени, в течение которого реле будет активировано.

Инвертное реле

• Установите все свойства инвертного реле на Нет (по умолчанию)

Связаться с Debounce

• Установите все значения времени дребезга контактов на 250 (по умолчанию)
  • Это помогает предотвратить ложное срабатывание датчиков состояния гаражных ворот.

Инвертировать контакт

• Установите все свойства инвертированного контакта на Нет (по умолчанию)

Example Properties
Для справки, вот примерample свойств контроллера реле в Composer Pro:

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

Реле

• Открыть: Подключитесь к реле «Открытая дверь» ратгдо
• Закрывать: Подключитесь к реле «Закрыть дверь» ратгдо
• Стоп: Подключитесь к реле «Стоп-дверь» ратгдо, если оно есть.

Контактные датчики

• Закрытый контакт: Подключитесь к контакту «Дверь закрыта» на ратгдо.
• Открытый контакт: Подключитесь к контакту «Открыть дверь» ратгдо

Exampле Соединения
Для справки, вот примерample того, как должны выглядеть соединения в Composer Pro:

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

• Открытие/закрытие гаражных ворот в зависимости от событий
• Контролировать состояние гаражных ворот
• Настройте уведомления об изменении статуса гаражных ворот
• Создавайте пользовательские кнопки на сенсорных экранах и пультах дистанционного управления

Example: Создание все еще открытого оповещения

Использование свойства «Время еще открытого состояния» из драйвера контроллера реле:

1. Установите «Время выдержки» на желаемую вами продолжительность (например, 10 минут).
2. Создайте правило программирования, которое срабатывает при возникновении события «Все еще открыто».
3. Добавьте действия для отправки уведомлений или выполнения других задач.

Дополнительные сущности
В зависимости от вашего устройства RATGDO, прошивки и его возможностей драйвер ESPHome может предоставлять доступ к дополнительным объектам. Это могут быть дополнительные соединения или переменные драйвера.

Более подробную информацию о конкретных сущностях можно найти в документации ratgdo: https://ratgdo.github.io/esphome-ratgdo/webui_documentation.html

Информация для разработчиков
Авторские права © 2025 Finite Labs LLC
Вся информация, содержащаяся в настоящем документе, является и остаётся собственностью компании 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 – 2025-07-14

• Зафиксированный: Исправлена ​​ошибка, из-за которой сущности не обнаруживались при подключении.

v20250714 – 2025-07-14

• Добавлен: Добавлена ​​поддержка зашифрованных соединений с использованием шифрования устройства.

v20250619 – 2025-06-19

• Добавлен : Добавлена ​​специфическая документация по ratgdo

v20250606 – 2025-06-06

• Добавлен :Первоначальный выпуск

Часто задаваемые вопросы

Какие устройства совместимы с этим драйвером?

Этот драйвер совместим с любым устройством ESPHome и был тщательно протестирован на устройствах RATGDO. Если вы попробуете его на другом устройстве и он заработает, пожалуйста, сообщите нам об этом для проверки.

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

ESPHome ESP8266 Физическое подключение к вашему устройству [pdf] Руководство пользователя ESP8266, ESP32, ESP8266 Физическое подключение к вашему устройству, ESP8266, Физическое подключение к вашему устройству, Подключение к вашему устройству, к вашему устройству, ваше устройство

Ссылки

• Руководство пользователя