ESPHome ESP8266 Fyzické připojení k vašemu zařízení Uživatelská příručka

Integrujte zařízení založená na platformě ESPHome do systému Control4. ESPHome je open-source systém, který transformuje běžné mikrokontroléry, jako jsou ESP8266 a ESP32, na zařízení pro chytrou domácnost pomocí jednoduché konfigurace v jazyce YAML. Zařízení ESPHome lze nastavit, monitorovat a ovládat pomocí... web prohlížeč, Home Assistant nebo jiné kompatibilní platformy. Tento ovladač umožňuje bezproblémové monitorování a ovládání zařízení ESPHome přímo z vašeho systému Control4.

Systémové požadavky

Control4 OS 3.3+

Vlastnosti

Lokální síťová komunikace nevyžadující cloudové služby
Aktualizace v reálném čase ze všech podporovaných entit zpřístupněných zařízením
Podporuje šifrovaná připojení pomocí šifrovacího klíče zařízení
Podpora programování proměnných

Kompatibilita

Ověřená zařízení
Tento ovladač bude obecně fungovat s jakýmkoli zařízením ESPHome, ale provedli jsme rozsáhlé testy s následujícími zařízeními:

ratgdo – Průvodce konfigurací

Pokud tento ovladač vyzkoušíte na výše uvedeném produktu a bude fungovat, dejte nám vědět!

Podporované entity ESPHome

Instalační nastavení

Pro každé zařízení ESPHome je vyžadována pouze jedna instance ovladače. Více instancí tohoto ovladače připojených ke stejnému zařízení bude mít neočekávané chování. Můžete však mít více instancí tohoto ovladače připojených k různým zařízením ESPHome.

Nastavení cloudu DriverCentral
Pokud již máte Ovladač DriverCentral Cloud nainstalován ve vašem projektu, můžete pokračovat k instalaci ovladače.

Tento ovladač se při správě licencí a automatických aktualizací spoléhá na cloudový ovladač DriverCentral. Pokud s používáním DriverCentral začínáte, můžete se podívat na jejich Dokumentace k cloudovému ovladači pro jeho nastavení.

Instalace ovladače

Instalace a nastavení ovladače je podobné jako u většiny ostatních ovladačů založených na IP. Níže je uveden přehled základních kroků pro vaše pohodlí.

Stáhněte si nejnovější control4-esphome.zip z DriverCentral.
Extrahujte a nainstalujte esphome.c4z, esphome_light.c4za esphome_lock.c4z řidiči.
Pomocí záložky „Hledat“ vyhledejte ovladač „ESPHome“ a přidejte ho do svého projektu.

Vyberte nově přidaný ovladač na kartě „Návrh systému“. Všimněte si, že stav cloudu odráží stav licence. Pokud jste si licenci zakoupili, zobrazí se „Licence aktivována“, v opačném případě „Zkušební verze spuštěna“ a zbývající doba trvání zkušební verze.
Stav licence můžete obnovit výběrem ovladače „DriverCentral Cloud“ na kartě „Návrh systému“ a provedením akce „Zkontrolovat ovladače“.

Nakonfigurujte Nastavení zařízení s informacemi o připojení.
Po chvíli se v okně Stav ovladače zobrazí „Připojeno“. Pokud se ovladači nepodaří připojit, nastavte vlastnost Režim protokolování na „Tisk“ a resetujte pole IP adresa pro opětovné připojení. Poté zkontrolujte výstupní okno Lua pro další informace.
Po připojení ovladač automaticky vytvoří proměnné a připojení pro každý podporovaný typ entity.

Pro ovládání světel a/nebo zámků použijte záložku „Hledat“ k nalezení ovladače „ESPHome Light“ a/nebo „ESPHome Lock“. Přidejte jednu instanci ovladače pro každou exponovanou entitu světla nebo zámku ve vašem projektu. Na záložce „Připojení“ vyberte ovladač „ESPHome“ a spárujte entity světla nebo zámku s nově přidanými ovladači.

Nastavení ovladače

Vlastnosti ovladače

Nastavení cloudu

Stav cloudu
Zobrazuje stav cloudové licence DriverCentral.
Automatické aktualizace
Zapíná/vypíná automatické aktualizace cloudu DriverCentral.

Nastavení ovladače

Stav ovladače (pouze pro čtení)
Zobrazuje aktuální stav ovladače.

Verze ovladače (pouze pro čtení)
Zobrazuje aktuální verzi ovladače.
Úroveň protokolu [ Fatální | Chyba | Varování | Informace | Ladění | Trasování | Ultra ] Nastavuje úroveň protokolování. Výchozí nastavení je Info.

Režim protokolování [Vypnuto | Tisk | Protokolování | Tisk a protokolování] Nastavuje režim protokolování. Výchozí nastavení je Vypnuto.

Nastavení zařízení

IP adresa
Nastaví IP adresu zařízení (např. 192.168.1.30). Doménová jména jsou povolena, pokud je kontrolér dokáže rozpoznat na přístupnou IP adresu. HTTPS není podporováno.

Poznámka: Pokud používáte IP adresu, měli byste se ujistit, že se nezmění, a to přiřazením statické IP adresy nebo vytvořením rezervace DHCP.

Přístav
Nastavuje port zařízení. Výchozí port pro zařízení ESPHome je 6053.

Režim ověřování [ Žádný | Heslo | Šifrovací klíč ]
Vybere metodu ověřování pro připojení k zařízení ESPHome.

Žádný: Není vyžadováno žádné ověřování.

Heslo: Pro ověření použijte heslo (viz níže).

Šifrovací klíč: Pro bezpečnou komunikaci použijte šifrovací klíč (viz níže).

Heslo
Zobrazuje se pouze v případě, že je Režim ověřování nastaven na Heslo. Nastavuje heslo zařízení. Toto heslo se musí shodovat s heslem nakonfigurovaným v zařízení ESPHome.

Šifrovací klíč
Zobrazuje se pouze v případě, že je Režim ověřování nastaven na Šifrovací klíč. Nastavuje šifrovací klíč zařízení pro zabezpečenou komunikaci. Ten se musí shodovat s šifrovacím klíčem nakonfigurovaným v zařízení ESPHome.

Informace o zařízení

Jméno (pouze pro čtení)
Zobrazuje název připojeného zařízení ESPHome.

Model (pouze pro čtení)
Zobrazuje model připojeného zařízení ESPHome.
Výrobce (pouze pro čtení)
Zobrazuje výrobce připojeného zařízení ESPHome.

MAC adresa (pouze pro čtení)
Zobrazuje MAC adresu připojeného zařízení ESPHome.
Verze firmwaru (pouze pro čtení)
Zobrazuje verzi firmwaru připojeného zařízení ESPHome.

Akce řidiče

Obnovit připojení a proměnné

Varování: Tím se resetují všechna propojení a odstraní se veškeré programování spojené s proměnnými.

Resetujte připojení a proměnné ovladače. To je užitečné, pokud změníte připojené zařízení ESPHome nebo pokud existují zastaralá připojení či proměnné.

Konfigurační průvodce ratgdo

Tato příručka obsahuje pokyny pro konfiguraci ovladače ESPHome pro práci se zařízeními ratgdo pro ovládání garážových vrat pomocí relé v Control4 Composer Pro.

Přidat ovladač řadiče relé
Přidejte požadovaný ovladač reléového regulátoru do projektu Control4 v Composer Pro.

Vlastnosti řadiče relé
Zařízení ratgdo zpřístupňuje entitu „Cover“ v ESPHome, která se mapuje na funkcionalitu reléového ovladače v Control4.

Počet relé
Zařízení ratgdo používá k ovládání garážových vrat konfiguraci s více relé. V Composer Pro byste měli nakonfigurovat nastavení relé takto:

Nastavení na 2 relé (Otevření/Zavření) nebo 3 relé (Otevření/Zavření/Stop)
- Zařízení ratgdo používá samostatné příkazy pro otevírání a zavírání garážových vrat.
- Pokud váš firmware ratgdo podporuje příkaz „stop“, nakonfigurujte 3 relé, abyste povolili funkci zastavení. Pokud si nejste jisti, můžete se podívat na připojení ratgdo v Composer Pro, zda je relé „Stop Door“ k dispozici.

Konfigurace relé

Nastavit na Puls
- Ratgdo používá momentální impulsy k aktivaci otvírače garážových vrat, podobně jako stisknutí tlačítka na zdi

Doba pulsu

Nastavte všechny časy impulzů relé na 500 (výchozí)
- Toto je doba, po kterou bude relé aktivováno

Invertní relé

Nastavte všechny vlastnosti invertního relé na Žádný (výchozí)

Kontakt Debounce

Nastavit všechny doby odskoku kontaktů na 250 (výchozí)
- To pomáhá zabránit falešnému mávání senzorů stavu garážových vrat.

Invertovat kontakt

Nastavte všechny vlastnosti invertovaného kontaktu na Žádný (výchozí)

ExampVlastnosti le
Pro referenci, zde je příkladampz vlastností reléového regulátoru v Composer Pro:

Připojení reléového regulátoru

Relé

OTEVŘENO: Připojte k relé „Otevřené dveře“ ratgdo
Blízko: Připojte k relé „Zavřít dveře“ jednotky Ratgdo
Stop: Připojte k relé „Stop Door“ zařízení ratgdo, je-li k dispozici.

Kontaktní senzory

Uzavřený kontakt: Spojte se s kontaktem „Zavřené dveře“ organizace ratgdo
Otevřený kontakt: Spojte se s kontaktem „Otevřené dveře“ ratgdo

Example připojení
Pro referenci, zde je příkladampjak by měla vypadat propojení v Composer Pro:

Programování
V Control4 můžete programovat pro:

Otevírání/zavírání garážových vrat na základě událostí
Sledujte stav garážových vrat
Nastavení oznámení o změnách stavu garážových vrat
Vytvořte si vlastní tlačítka na dotykových obrazovkách a dálkových ovladačích

Example: Vytvoření upozornění „Stále otevřeno“

Použití vlastnosti „Doba stále otevřeného stavu“ z ovladače reléového regulátoru:

Nastavte „Dobu otevření“ na požadovanou dobu (např. 10 minut)
Vytvořte programovací pravidlo, které se spustí při události „Stále otevřeno“.
Přidání akcí pro odesílání oznámení nebo provádění jiných úkolů

Další entity
V závislosti na vašem zařízení ratgdo, firmwaru a jeho možnostech může ovladač ESPHome zpřístupnit další entity. Ty mohou být v podobě dodatečných připojení nebo proměnných ovladače.

Více informací o konkrétních entitách naleznete v dokumentaci k ratgdo: https://ratgdo.github.io/esphome-ratgdo/webui_documentation.html

Informace pro vývojáře
Autorská práva © 2025 Finite Labs LLC
Veškeré zde uvedené informace jsou a zůstávají majetkem společnosti Finite Labs LLC a jejích případných dodavatelů. Intelektuální a technické koncepty zde uvedené jsou majetkem společnosti Finite Labs LLC.
Společnost Finite Labs LLC a její dodavatelé mohou být chráněni americkými i zahraničními patenty, patenty v řízení a jsou chráněni obchodním tajemstvím nebo autorským právem. Šíření těchto informací nebo reprodukce tohoto materiálu je přísně zakázáno bez předchozího písemného souhlasu společnosti Finite Labs LLC. Nejnovější informace naleznete na adrese https://drivercentral.io/platforms/control4-drivers/utility/esphome

Podpora
Pokud máte jakékoli dotazy nebo problémy s integrací tohoto ovladače s Control4 nebo ESPHome, můžete nás kontaktovat na adrese driver-support@finitelabs.com nebo nám zavolejte/napište SMS na číslo +1 949-371-5805.

Seznam změn

v20250715 – 14. 07. 2025

Opraveno: Opravena chyba, která způsobovala, že entity nebyly při připojení objeveny.

v20250714 – 14. 07. 2025

Přidáno: Přidána podpora pro šifrovaná připojení pomocí šifrování zařízení

v20250619 – 19. 06. 2025

Přidáno Přidána dokumentace specifická pro ratgdo

v20250606 – 06. 06. 2025

Přidáno První vydání

FAQ

Jaká zařízení jsou s tímto ovladačem kompatibilní?

Tento ovladač je kompatibilní s jakýmkoli zařízením ESPHome a byl rozsáhle testován na zařízeních ratgdo. Pokud jej vyzkoušíte na jiném zařízení a bude fungovat, dejte nám prosím vědět, abychom si to ověřili.

Dokumenty / zdroje

ESPHome ESP8266 Fyzické připojení k vašemu zařízení [pdfUživatelská příručka
ESP8266, ESP32, ESP8266 Fyzické připojení k vašemu zařízení, ESP8266, Fyzické připojení k vašemu zařízení, Připojení k vašemu zařízení, k vašemu zařízení, vašemu zařízení

Reference

Uživatelská příručka

ESPHome ESP8266 Fyzické připojení k vašemu zařízení

Specifikace

Nadview