Руководство пользователя ESPHome ESP8266: физическое подключение к устройству

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

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

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

Проверенные устройства:

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

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

Инструкции по применению продукта

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

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

Настройка облака DriverCentral

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

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

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

Загрузите последнюю версию control4-esphome.zip с сайта
DriverCentral.

Извлеките и установите esphome.c4z, esphome_light.c4z и
драйверы esphome_lock.c4z.
Используйте вкладку «Поиск», чтобы найти драйвер ESPHome и добавить его в
ваш проект.

Выберите недавно добавленный драйвер на вкладке «Проект системы». Проверьте.
Статус облака для получения информации о лицензии.
Обновите статус лицензии, выбрав DriverCentral Cloud
водителя и выполнение действия «Проверка водителей».

Настройте параметры устройства с помощью подключения
информация.
Дождитесь, пока статус драйвера не отобразится как Подключен.

Настройка драйвера

Свойства драйвера:

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

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

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

В: Как я могу отслеживать и контролировать устройства ESPHome?

A: Вы можете контролировать и управлять устройствами ESPHome через web
браузер, Home Assistant или другие совместимые платформы после
интегрировав их в Control4 с помощью этого драйвера.

«`

View Fullscreen

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

Системные требования
Control4 OS 3.3+
Функции
Локальная сетевая связь, не требующая облачных сервисов. Обновления в режиме реального времени от всех поддерживаемых объектов, предоставляемых устройством. Поддержка зашифрованных соединений с использованием ключа шифрования устройства. Поддержка программирования переменных.
Совместимость
Проверенные устройства
Этот драйвер в целом будет работать с любым устройством ESPHome, но мы провели тщательное тестирование со следующими устройствами:
ratgdo – Руководство по настройке Если вы попробуете этот драйвер на продукте, указанном выше, и он заработает, сообщите нам об этом!

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

Тип объекта Сигнализация Панель управления API Шум Двоичный датчик Bluetooth Прокси Кнопка Климатическая крышка Дата и время Дата Время Камера Событие Вентилятор Свет Блокировка Медиаплеер Номер Выбор датчика Сирена Переключатель Текст Текст Датчик Обновление Клапан Голосовой помощник

Поддерживается

Установка установщика
Для каждого устройства ESPHome требуется только один экземпляр драйвера. Несколько экземпляров этого драйвера
Драйвер, подключенный к одному устройству, может вести себя непредсказуемо. Однако вы можете подключить несколько экземпляров этого драйвера к разным устройствам ESPHome.
Настройка облака DriverCentral
Если в вашем проекте уже установлен драйвер DriverCentral Cloud, вы можете перейти к установке драйвера.
Этот драйвер использует облачный драйвер DriverCentral для управления лицензированием и автоматическими обновлениями. Если вы новичок в использовании DriverCentral, ознакомьтесь с его документацией по облачному драйверу, чтобы узнать, как его настроить.
Установка драйвера
Установка и настройка драйвера аналогичны установке и настройке большинства других IP-драйверов. Ниже для вашего удобства приведено краткое описание основных шагов.
1. Загрузите последнюю версию control4-esphome.zip с DriverCentral.
2. Извлеките и установите драйверы esphome.c4z, esphome_light.c4z и esphome_lock.c4z.
3. Используйте вкладку «Поиск», чтобы найти драйвер «ESPHome» и добавить его в свой проект.
Ü Для каждого устройства ESPHome требуется один экземпляр драйвера.

4. Выберите недавно добавленный драйвер на вкладке «Проект системы». Вы увидите, что состояние облака отражает состояние лицензии. Если вы приобрели лицензию, будет указано «Лицензия активирована», в противном случае — «Триал запущен» и оставшийся срок действия пробной версии.
5. Вы можете обновить статус лицензии, выбрав драйвер «DriverCentral Cloud» на вкладке «Проект системы» и выполнив действие «Проверка драйверов».
6. Настройте параметры устройства, используя информацию о подключении. 7. Через несколько секунд в статусе драйвера отобразится значение «Подключено». Если драйвер не подключен,
Подключитесь, установите свойство Log Mode на Print и переустановите поле IP Adress для повторного подключения. Затем проверьте окно вывода lua для получения дополнительной информации. 8. После подключения драйвер автоматически создаст переменные и соединения для каждого поддерживаемого типа объекта. 9. Для управления источниками света и/или замками используйте вкладку «Поиск», чтобы найти драйвер «ESPHome Light» и/или «ESPHome Lock». Добавьте один экземпляр драйвера для каждого открытого источника света или замка в вашем проекте. На вкладке «Подключения» выберите драйвер «ESPHome» и привяжите источники света или замка к добавленным драйверам.
Настройка драйвера
Свойства драйвера
Настройки облака
Состояние облака. Отображает состояние лицензии облачного сервиса DriverCentral. Автоматические обновления. Включает/выключает автоматические обновления облачного сервиса DriverCentral.
Настройки драйвера
Статус водителя (только чтение)

Отображает текущий статус водителя.
Версия драйвера (только для чтения) Отображает текущую версию драйвера.
Уровень журнала [ Fatal | Error | Warning | Info | Debug | Trace | Ultra ] Задаёт уровень журнала. Значение по умолчанию — Info .
Режим журнала [ Выкл | Печать | Журнал | Печать и журнал ] Устанавливает режим ведения журнала. По умолчанию — Выкл.
Настройки устройства
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, чтобы узнать, доступно ли реле «Стоп двери».
Конфигурация реле
В режиме импульсного сигнала ратгдо использует кратковременные импульсы для активации открывателя гаражных ворот, аналогично нажатию настенной кнопки.
Время импульса
Установите все значения времени импульса реле на 500 (по умолчанию). Это продолжительность времени, в течение которого реле будет активировано.
Инвертное реле
Установите все свойства инвертного реле на «Нет» (по умолчанию)
Связаться с Debounce
Установите все значения времени дребезга контактов на 250 (по умолчанию). Это поможет предотвратить ложное срабатывание датчиков состояния гаражных ворот.
Инвертировать контакт
Установите все свойства инвертированного контакта на «Нет» (по умолчанию)
Example Properties
Для справки, вот примерample свойств контроллера реле в Composer Pro:

Подключения релейного контроллера
Реле
Открыть: подключить к реле «Открыть дверь» Ratgdo. Закрыть: подключить к реле «Закрыть дверь» Ratgdo. Стоп: подключить к реле «Остановить дверь» Ratgdo, если доступно.
Контактные датчики
Закрытый контакт: подключите к контакту «Дверь закрыта» устройства Ratgdo. Открытый контакт: подключите к контакту «Дверь открыта» устройства Ratgdo.
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 ESP8266 Физическое подключение к вашему устройству [pdf] Руководство пользователя
ESP8266, ESP32, ESP8266 Физическое подключение к вашему устройству, ESP8266, Физическое подключение к вашему устройству, Подключение к вашему устройству, к вашему устройству, ваше устройство

Ссылки

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