ESPHome ESP8266 Fyzické pripojenie k vášmu zariadeniu Používateľská príručka

Integrujte zariadenia založené na platforme ESPHome do systému Control4. ESPHome je systém s otvoreným zdrojovým kódom, ktorý transformuje bežné mikrokontroléry, ako sú ESP8266 a ESP32, na zariadenia inteligentnej domácnosti prostredníctvom jednoduchej konfigurácie YAML. Zariadenia ESPHome je možné nastavovať, monitorovať a ovládať pomocou... web prehliadač, Home Assistant alebo iné kompatibilné platformy. Tento ovládač umožňuje bezproblémové monitorovanie a ovládanie zariadení ESPHome priamo z vášho systému Control4.

Systémové požiadavky

Operačný systém Control4 3.3+

Vlastnosti

Komunikácia v lokálnej sieti nevyžadujúca cloudové služby
Aktualizácie v reálnom čase zo všetkých podporovaných entít sprístupnených zariadením
Podporuje šifrované pripojenia pomocou šifrovacieho kľúča zariadenia
Podpora programovania premenných

Kompatibilita

Overené zariadenia
Tento ovládač bude vo všeobecnosti fungovať s akýmkoľvek zariadením ESPHome, ale dôkladne sme ho testovali s nasledujúcimi zariadeniami:

ratgdo – Konfiguračná príručka

Ak vyskúšate tento ovládač na produkte uvedenom vyššie a bude fungovať, dajte nám vedieť!

Podporované entity ESPHome

Inštalátor

Na jedno zariadenie ESPHome je potrebná iba jedna inštancia ovládača. Viaceré inštancie tohto ovládača pripojené k rovnakému zariadeniu budú mať neočakávané správanie. Môžete však mať viacero inštancií tohto ovládača pripojených k rôznym zariadeniam ESPHome.

Nastavenie cloudu DriverCentral
Ak už máte Ovládač DriverCentral Cloud nainštalovaný vo vašom projekte, môžete pokračovať v inštalácii ovládača.

Tento ovládač sa spolieha na cloudový ovládač DriverCentral na správu licencií a automatických aktualizácií. Ak s používaním DriverCentral ešte len začínate, môžete si pozrieť ich Dokumentácia k cloudovému ovládaču za jeho nastavenie.

Inštalácia ovládača

Inštalácia a nastavenie ovládača sú podobné ako pri väčšine ostatných ovládačov založených na IP. Nižšie je uvedený prehľad základných krokov pre vaše pohodlie.

Stiahnite si najnovšie control4-esphome.zip od DriverCentral.
Extrahujte a nainštalujte esphome.c4z, esphome_light.c4za esphome_lock.c4z vodičov.
Pomocou karty „Hľadať“ vyhľadajte ovládač „ESPHome“ a pridajte ho do svojho projektu.

Na karte „Návrh systému“ vyberte novo pridaný ovládač. Všimnete si, že stav cloudu odráža stav licencie. Ak ste si licenciu zakúpili, zobrazí sa „Licencia aktivovaná“, v opačnom prípade „Skúšobná prevádzka“ a zostávajúce trvanie skúšobnej verzie.
Stav licencie môžete obnoviť výberom ovládača „DriverCentral Cloud“ na karte „Návrh systému“ a vykonaním akcie „Skontrolovať ovládače“.

Nakonfigurujte Nastavenia zariadenia s informáciami o pripojení.
Po chvíli sa v stave ovládača zobrazí „Pripojené“. Ak sa ovládač nepripojí, nastavte vlastnosť Režim protokolovania na „Tlačiť“ a resetujte pole IP adresa na opätovné pripojenie. Potom skontrolujte výstupné okno Lua, kde nájdete ďalšie informácie.
Po pripojení ovládač automaticky vytvorí premenné a pripojenia pre každý podporovaný typ entity.

Na ovládanie svetiel a/alebo zámkov použite kartu „Hľadať“ a vyhľadajte ovládač „ESPHome Light“ a/alebo „ESPHome Lock“. Pridajte jednu inštanciu ovládača pre každú exponovanú entitu svetla alebo zámku vo vašom projekte. Na karte „Pripojenia“ vyberte ovládač „ESPHome“ a prepojte entity svetla alebo zámku s novo pridanými ovládačmi.

Nastavenie ovládača

Vlastnosti ovládača

Nastavenia cloudu

Stav cloudu
Zobrazuje stav cloudovej licencie DriverCentral.
Automatické aktualizácie
Zapne/vypne automatické aktualizácie cloudu DriverCentral.

Nastavenia ovládača

Stav ovládača (iba na čítanie)
Zobrazuje aktuálny stav ovládača.

Verzia ovládača (iba na čítanie)
Zobrazuje aktuálnu verziu ovládača.
Úroveň protokolu [ Fatálna | Chyba | Upozornenie | Informácie | Ladenie | Sledovanie | Ultra ] Nastavuje úroveň protokolovania. Predvolená hodnota je Info.

Režim protokolovania [Vypnuté | Tlačiť | Protokolovať | Tlačiť a protokolovať] Nastavuje režim logovania. Predvolená hodnota je Vypnuté.

Nastavenia zariadenia

IP adresa
Nastaví IP adresu zariadenia (napr. 192.168.1.30). Názvy domén sú povolené, pokiaľ ich ovládač dokáže rozlíšiť na dostupnú IP adresu. HTTPS nie je podporovaný.

Poznámka: Ak používate IP adresu, mali by ste zabezpečiť, aby sa nezmenila, a to priradením statickej IP adresy alebo vytvorením rezervácie DHCP.

Port
Nastavuje port zariadenia. Predvolený port pre zariadenia ESPHome je 6053.

Režim overovania [ Žiadne | Heslo | Šifrovací kľúč ]
Vyberá metódu overovania pre pripojenie k zariadeniu ESPHome.

Žiadne: Nevyžaduje sa žiadne overenie.

heslo: Na overenie použite heslo (pozri nižšie).

Šifrovací kľúč: Pre bezpečnú komunikáciu použite šifrovací kľúč (pozri nižšie).

heslo
Zobrazuje sa iba v prípade, že je Režim overovania nastavený na Heslo. Nastavuje heslo zariadenia. Toto heslo sa musí zhodovať s heslom nakonfigurovaným na zariadení ESPHome.

Šifrovací kľúč
Zobrazuje sa iba v prípade, že Režim overovania je nastavený na Šifrovací kľúč. Nastavuje šifrovací kľúč zariadenia pre bezpečnú komunikáciu. Musí sa zhodovať so šifrovacím kľúčom nakonfigurovaným na zariadení ESPHome.

Informácie o zariadení

Názov (iba na čítanie)
Zobrazuje názov pripojeného zariadenia ESPHome.

Model (iba na čítanie)
Zobrazuje model pripojeného zariadenia ESPHome.
Výrobca (iba na čítanie)
Zobrazuje výrobcu pripojeného zariadenia ESPHome.

MAC adresa (iba na čítanie)
Zobrazuje MAC adresu pripojeného zariadenia ESPHome.
Verzia firmvéru (iba na čítanie)
Zobrazuje verziu firmvéru pripojeného zariadenia ESPHome.

Akcie vodiča

Obnoviť pripojenia a premenné

POZOR: Týmto sa resetujú všetky väzby pripojenia a vymaže sa akékoľvek programovanie spojené s premennými.

Obnovte pripojenia a premenné ovládača. Toto je užitočné, ak zmeníte pripojené zariadenie ESPHome alebo ak máte zastarané pripojenia alebo premenné.

Konfiguračná príručka ratgdo

Táto príručka obsahuje pokyny na konfiguráciu ovládača ESPHome pre prácu so zariadeniami ratgdo na ovládanie garážových brán pomocou relé v softvéri Control4 Composer Pro.

Pridať ovládač ovládača relé
Pridajte požadovaný ovládač reléového ovládača do vášho projektu Control4 v Composer Pro.

Vlastnosti ovládača relé
Zariadenie ratgdo sprístupňuje entitu „Cover“ v ESPHome, ktorá sa mapuje na funkcionalitu ovládača relé v Control4.

Počet relé
Zariadenie ratgdo používa na ovládanie garážovej brány konfiguráciu s viacerými relé. V aplikácii Composer Pro by ste mali nakonfigurovať nastavenia relé nasledovne:

Nastavte na 2 relé (otvorenie/zatvorenie) alebo 3 relé (otvorenie/zatvorenie/zastavenie)
- Zariadenie ratgdo používa samostatné príkazy na otváranie a zatváranie garážových brán.
- Ak váš firmvér ratgdo podporuje príkaz „stop“, nakonfigurujte 3 relé, aby ste povolili funkciu zastavenia. Ak si nie ste istí, môžete sa pozrieť na pripojenia ratgdo v Composer Pro a zistiť, či je relé „Stop Door“ k dispozícii.

Konfigurácia relé

Nastaviť na Pulz
- Ratgdo používa momentálne impulzy na spustenie otvárača garážových brán, podobne ako stlačenie tlačidla na stene

Čas impulzu

Nastavte všetky časy impulzov relé na 500 (predvolené)
- Toto je doba, počas ktorej bude relé aktivované

Invertovať relé

Nastavte všetky vlastnosti invertovaného relé na Nie (predvolené)

Kontakt Debounce

Nastaviť všetky časy odskoku kontaktov na 250 (predvolené)
- Toto pomáha predchádzať falošnému mávaniu senzorov stavu garážových brán.

Invertovať kontakt

Nastavte všetky vlastnosti invertovaného kontaktu na Nie (predvolené)

Example Properties
Pre referenciu, tu je príkladampz vlastností ovládača relé v Composer Pro:

Pripojenia ovládača relé

relé

OTVORENÉ: Pripojte k relé „Otvorené dvere“ zariadenia ratgdo
Zavrieť: Pripojte k relé „Zatvoriť dvere“ zariadenia Ratgdo
zastavenie: Pripojte k relé „Stop Door“ zariadenia ratgdo, ak je k dispozícii.

Kontaktné senzory

Uzavretý kontakt: Spojte sa s kontaktom „Zatvorené dvere“ organizácie ratgdo
Otvorený kontakt: Spojte sa s kontaktom „Otvorenie dverí“ ratgdo

Example Connections
Pre referenciu, tu je príkladampako by mali vyzerať pripojenia v programe Composer Pro:

Programovanie
V Control4 môžete vytvoriť programy na:

Otváranie/zatváranie garážových brán na základe udalostí
Sledujte stav garážových brán
Nastavenie upozornení na zmeny stavu garážových brán
Vytvorte si vlastné tlačidlá na dotykových obrazovkách a diaľkových ovládačoch

Example: Vytvorenie upozornenia „Stále otvorené“

Použitie vlastnosti „Čas stáleho otvorenia“ z ovládača ovládača relé:

Nastavte „Čas stále otvoreného otvorenia“ na požadovanú dobu (napr. 10 minút)
Vytvorte programovacie pravidlo, ktoré sa spustí pri udalosti „Stále otvorené“
Pridajte akcie na odosielanie upozornení alebo vykonávanie iných úloh

Ďalšie entity
V závislosti od vášho zariadenia ratgdo, firmvéru a jeho možností môže ovládač ESPHome sprístupniť ďalšie entity. Tieto môžu byť ako ďalšie pripojenia alebo premenné ovládača.

Viac informácií o konkrétnych entitách nájdete v dokumentácii ratgdo: https://ratgdo.github.io/esphome-ratgdo/webui_documentation.html

Informácie pre vývojárov
Autorské práva © 2025 Finite Labs LLC
Všetky informácie uvedené v tomto dokumente sú a zostávajú majetkom spoločnosti Finite Labs LLC a jej dodávateľov, ak existujú. Intelektuálne a technické koncepty uvedené v tomto dokumente sú majetkom spoločnosti
Spoločnosť Finite Labs LLC a jej dodávatelia môžu byť chránení americkými a zahraničnými patentmi, patentmi v procese schvaľovania a sú chránení obchodným tajomstvom alebo autorským právom. Šírenie týchto informácií alebo reprodukcia tohto materiálu je prísne zakázaná bez predchádzajúceho písomného súhlasu spoločnosti Finite Labs LLC. Najnovšie informácie nájdete na https://drivercentral.io/platforms/control4-drivers/utility/esphome

Podpora
Ak máte akékoľvek otázky alebo problémy s integráciou tohto ovládača s Control4 alebo ESPHome, môžete nás kontaktovať na adrese driver-support@finitelabs.com alebo nám zavolajte/napíšte SMS na číslo +1 949-371-5805.

Denník zmien

v20250715 – 14. júla 2025

Opravené: Opravená chyba, ktorá spôsobovala, že entity neboli objavené pri pripojení

v20250714 – 14. júla 2025

Pridané: Pridaná podpora pre šifrované pripojenia pomocou šifrovania zariadenia

v20250619 – 19. júla 2025

Pridané Pridaná dokumentácia špecifická pre ratgdo

v20250606 – 06. júla 2025

Pridané Počiatočné vydanie

FAQ

Ktoré zariadenia sú kompatibilné s týmto ovládačom?

Tento ovládač je kompatibilný s akýmkoľvek zariadením ESPHome a bol rozsiahlo testovaný na zariadeniach ratgdo. Ak ho vyskúšate na inom zariadení a funguje, dajte nám prosím vedieť, aby sme to overili.

Dokumenty / zdroje

ESPHome ESP8266 Fyzické pripojenie k vášmu zariadeniu [pdf] Používateľská príručka
ESP8266, ESP32, ESP8266 Fyzické pripojenie k vášmu zariadeniu, ESP8266, Fyzické pripojenie k vášmu zariadeniu, Pripojenie k vášmu zariadeniu, k vášmu zariadeniu, vášmu zariadeniu

Referencie

Používateľská príručka

ESPHome ESP8266 Fyzické pripojenie k vášmu zariadeniu

Špecifikácie

Koniecview