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

Интегрирайте устройства, базирани на ESPHome, в Control4. ESPHome е система с отворен код, която трансформира обикновени микроконтролери, като ESP8266 и ESP32, в устройства за интелигентен дом чрез проста YAML конфигурация. Устройствата ESPHome могат да бъдат настройвани, наблюдавани и управлявани с помощта на... web браузър, Home Assistant или други съвместими платформи. Този драйвер позволява безпроблемно наблюдение и управление на ESPHome устройства директно от вашата Control4 система.

Системни изисквания

Control4 OS 3.3+

Характеристики

Локална мрежова комуникация, която не изисква облачни услуги
Актуализации в реално време от всички поддържани обекти, достъпни от устройството
Поддържа криптирани връзки, използващи ключа за криптиране на устройството
Поддръжка на променливо програмиране

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

Проверени устройства
Този драйвер по принцип ще работи с всяко ESPHome устройство, но ние го тествахме обстойно със следните устройства:

ратгдо – Ръководство за конфигуриране

Ако изпробвате този драйвер на продукт, посочен по-горе, и той работи, уведомете ни!

Поддържани ESPHome обекти

Настройка на инсталатора

За всяко ESPHome устройство е необходим само един екземпляр на драйвера. Няколко екземпляра на този драйвер, свързани към едно и също устройство, ще имат неочаквано поведение. Можете обаче да имате няколко екземпляра на този драйвер, свързани към различни ESPHome устройства.

Настройка на DriverCentral в облака
Ако вече имате DriverCentral облачен драйвер инсталиран във вашия проект, можете да продължите с инсталирането на драйвера.

Този драйвер разчита на драйвера на DriverCentral Cloud за управление на лицензирането и автоматичните актуализации. Ако сте начинаещи в използването на DriverCentral, можете да се обърнете към техния Документация за облачен драйвер за настройването му.

Инсталиране на драйвери

Инсталирането и настройката на драйвера са подобни на повечето други IP-базирани драйвери. По-долу е дадено описание на основните стъпки за ваше удобство.

Изтеглете най-новото control4-esphome.zip от DriverCentral.
Извадете и инсталирайте esphome.c4z, esphome_light.c4z, и esphome_lock.c4z драйвери.
Използвайте раздела „Търсене“, за да намерите драйвера „ESPHome“ и да го добавите към проекта си.

Изберете новодобавения драйвер в раздела „System Design“. Ще забележите, че „Cloud Status“ (Състояние на облака) отразява състоянието на лиценза. Ако сте закупили лиценз, ще се показва „License Activated“ (Лицензът е активиран), в противен случай „Trial Running“ (Пробен период) и оставаща продължителност на пробния период.
Можете да обновите състоянието на лиценза, като изберете драйвера „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 (по подразбиране)
- Това е продължителността, през която релето ще бъде активирано

Инвертиращо реле

Задайте всички свойства на инвертиращо реле на не (по подразбиране)

Контакти за премахване на отскоци

Задайте всички времена за отскачане на контактите на 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 и нейните доставчици могат да бъдат защитени от американски и чуждестранни патенти, патенти в процес на издаване и са защитени от търговска тайна или закон за авторското право. Разпространението на тази информация или възпроизвеждането на този материал е строго забранено, освен ако не е получено предварително писмено разрешение от Finite Labs LLC. За най-актуална информация, моля, посетете https://drivercentral.io/platforms/control4-drivers/utility/esphome

поддръжка
Ако имате въпроси или проблеми с интегрирането на този драйвер с Control4 или ESPHome, можете да се свържете с нас на driver-support@finitelabs.com или ни се обадете/изпратете ни съобщение на +1 949-371-5805.

Дневник на промените

v20250715 – 14.07.2025 г.

Фиксиран: Отстранена грешка, която е причинявала неоткриване на обекти при свързване

v20250714 – 14.07.2025 г.

Добавено: Добавена е поддръжка за криптирани връзки, използващи криптиране на устройството

v20250619 – 14.07.2025 г.

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

v20250606 – 14.07.2025 г.

Добавено Първоначално издание

ЧЗВ

Кои устройства са съвместими с този драйвер?

Този драйвер е съвместим с всяко ESPHome устройство, като са проведени обширни тестове на ratgdo устройства. Ако го изпробвате на друго устройство и работи, моля, уведомете ни за потвърждение.

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

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

Референции

Ръководство за потребителя

ESPHome ESP8266 Физическо свързване с вашето устройство

Спецификации

крайview