ESPHome ESP8266 Физичко поврзување со вашиот уред Упатство за корисникот

Интегрирајте уреди базирани на ESPHome во Control4. ESPHome е систем со отворен код кој ги трансформира вообичаените микроконтролери, како ESP8266 и ESP32, во паметни домашни уреди преку едноставна YAML конфигурација. ESPHome уредите може да се постават, следат и контролираат со помош на web прелистувач, Home Assistant или други компатибилни платформи. Овој драјвер овозможува непречено следење и контрола на ESPHome уредите директно од вашиот систем Control4.

Системски барања

Control4 OS 3.3+

Карактеристики

Локална мрежна комуникација која не бара услуги во облак
Ажурирања во реално време од сите поддржани ентитети изложени од уредот
Поддржува шифрирани врски користејќи го клучот за шифрирање на уредот
Поддршка за променливо програмирање

Компатибилност

Потврдени уреди
Овој драјвер генерално ќе работи со кој било ESPHome уред, но ние го тестиравме опширно со следниве уреди:

ратгдо – Водич за конфигурација

Доколку го пробате овој драјвер на производ наведен погоре и работи, известете нè!

Поддржани ентитети на ESPHome

Поставување на инсталерот

Потребна е само една инстанца на драјвер за секој ESPHome уред. Повеќе инстанци на овој драјвер поврзани со истиот уред ќе имаат неочекувано однесување. Сепак, можете да имате повеќе инстанци на овој драјвер поврзани со различни ESPHome уреди.

Поставување на DriverCentral Cloud
Доколку веќе го имате Драјвер за 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“.

Конфигурирајте го Поставки на уредот со информациите за поврзување.
По неколку моменти, статусот на драјверот ќе прикаже „Поврзан“. Ако драјверот не успее да се поврзе, поставете го својството Log Mode на „Pearn“ и ресетирајте го полето IP Address за повторно поврзување. Потоа проверете го излезниот прозорец на 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 (стандардно)
- Ова помага да се спречи лажно трепкање на сензорите за состојбата на гаражната врата

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

Поставете ги сите својства на инвертен контакт на бр (стандардно)

Example Properties
За референца, еве еден примерampлиста од својствата на релејниот контролер во Composer Pro:

Врски на релејниот контролер

Релеи

Отвори: Поврзете се со релето „Отворена врата“ на ratgdo
Затвори: Поврзете се со релето „Затвори врата“ на ratgdo
Стоп: Поврзете се со релето „Стоп врата“ на ratgdo, доколку е достапно

Сензори за контакт

Затворен контакт: Поврзете се со контактот „Вратата е затворена“ на ratgdo
Отворен контакт: Поврзете се со контактот „Отворена врата“ на ratgdo

Exampле Врски
За референца, еве еден примерampза тоа како треба да изгледаат врските во Composer Pro:

Програмирање
Можете да креирате програмирање во Control4 за да:

Отворете/затворете ја гаражната врата врз основа на настани
Следете ја состојбата на гаражната врата
Поставете известувања за промени во статусот на гаражната врата
Креирајте прилагодени копчиња на екраните на допир и далечинските управувачи

Example: Креирање на сè уште отворено известување

Користење на својството „Still Open Time“ од драјверот на релејниот контролер:

Поставете го „Време на отворено“ на посакуваното времетраење (на пр., 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