ESPHome ESP8266 Fizičko povezivanje s vašim uređajem Korisnički vodič

Integrirajte uređaje bazirane na ESPHome-u u Control4. ESPHome je sistem otvorenog koda koji transformiše uobičajene mikrokontrolere, poput ESP8266 i ESP32, u pametne kućne uređaje putem jednostavne YAML konfiguracije. ESPHome uređaji se mogu podešavati, pratiti i kontrolisati pomoću... web preglednik, Home Assistant ili druge kompatibilne platforme. Ovaj drajver omogućava besprijekorno praćenje i kontrolu ESPHome uređaja direktno iz vašeg Control4 sistema.

Sistemski zahtjevi

Control4 OS 3.3+

Karakteristike

Komunikacija u lokalnoj mreži koja ne zahtijeva usluge u oblaku
Ažuriranja u stvarnom vremenu od svih podržanih entiteta koje uređaj pruža
Podržava šifrirane veze pomoću ključa za šifriranje uređaja
Podrška za varijabilno programiranje

Kompatibilnost

Provjereni uređaji
Ovaj drajver će generalno raditi sa bilo kojim ESPHome uređajem, ali smo ga opsežno testirali sa sljedećim uređajima:

ratgdo – Vodič za konfiguraciju

Ako isprobate ovaj drajver na proizvodu navedenom iznad i on radi, javite nam!

Podržani ESPHome entiteti

Instalacijsko postavljanje

Samo jedna instanca drajvera je potrebna po ESPHome uređaju. Više instanci ovog drajvera povezanih na isti uređaj će imati neočekivano ponašanje. Međutim, možete imati više instanci ovog drajvera povezanih na različite ESPHome uređaje.

Postavke DriverCentral oblaka
Ako već imate Drajver za DriverCentral Cloud instaliran u vašem projektu, možete nastaviti s instalacijom upravljačkog programa.

Ovaj drajver se oslanja na drajver DriverCentral Cloud za upravljanje licenciranjem i automatskim ažuriranjima. Ako ste novi u korištenju DriverCentral-a, možete pogledati njihov Dokumentacija za Cloud Driver za njegovo postavljanje.

Instalacija drajvera

Instalacija i podešavanje drajvera su slični većini drugih drajvera zasnovanih na IP-u. U nastavku je pregled osnovnih koraka radi vaše udobnosti.

Preuzmite najnovije control4-esphome.zip od DriverCentral.
Izvucite i instalirajte esphome.c4z, esphome_light.c4z, i esphome_lock.c4z vozači.
Koristite karticu "Pretraži" da biste pronašli drajver "ESPHome" i dodali ga u svoj projekat.

Odaberite novododani upravljački program na kartici „Dizajn sistema“. Primijetit ćete da status oblaka odražava stanje licence. Ako ste kupili licencu, prikazat će se „Licenca aktivirana“, u suprotnom „Probno razdoblje u tijeku“ i preostalo trajanje probnog razdoblja.
Status licence možete osvježiti odabirom upravljačkog programa „DriverCentral Cloud“ na kartici „Dizajn sistema“ i izvršavanjem akcije „Provjeri upravljačke programe“.

Konfigurišite Postavke uređaja sa informacijama o vezi.
Nakon nekoliko trenutaka, status drajvera će prikazati „Povezano“. Ako se drajver ne uspije povezati, postavite svojstvo Log Mode na „Print“ i resetirajte polje IP Address da biste se ponovo povezali. Zatim provjerite Lua izlazni prozor za više informacija.
Nakon povezivanja, drajver će automatski kreirati varijable i veze za svaki podržani tip entiteta.

Za kontrolu svjetala i/ili brava, koristite karticu „Pretraživanje“ da biste pronašli drajver „ESPHome Light“ i/ili „ESPHome Lock“. Dodajte jednu instancu drajvera za svaki izloženi entitet svjetla ili brave u vašem projektu. Na kartici „Veze“ odaberite drajver „ESPHome“ i povežite entitete svjetla ili brave s novododanim drajverima.

Podešavanje drajvera

Svojstva upravljačkog programa

Postavke oblaka

Status oblaka
Prikazuje status licence za DriverCentral u oblaku.
Automatska ažuriranja
Uključuje/isključuje automatska ažuriranja DriverCentral clouda.

Postavke drajvera

Status drajvera (samo za čitanje)
Prikazuje trenutni status upravljačkog programa.

Verzija drajvera (samo za čitanje)
Prikazuje trenutnu verziju upravljačkog programa.
Nivo zapisa [ Fatalna greška | Greška | Upozorenje | Informacije | Debug | Trag | Ultra ] Postavlja nivo zapisivanja. Zadano je Info.

Način evidentiranja [ Isključeno | Ispis | Zapis | Ispis i evidentiranje ] Postavlja način zapisivanja. Zadano je Isključeno.

Postavke uređaja

IP adresa
Postavlja IP adresu uređaja (npr. 192.168.1.30). Imena domena su dozvoljena sve dok ih kontroler može razdvojiti u dostupnu IP adresu. HTTPS nije podržan.

Napomena: Ako koristite IP adresu, trebali biste osigurati da se ona neće mijenjati dodjeljivanjem statičke IP adrese ili kreiranjem DHCP rezervacije.

Luka
Postavlja port uređaja. Zadani port za ESPHome uređaje je 6053.

Način autentifikacije [Nijedan | Lozinka | Ključ za šifriranje]
Odabire metodu autentifikacije za povezivanje s ESPHome uređajem.

ništa: Nije potrebna autentifikacija.

Lozinka: Koristite lozinku za autentifikaciju (pogledajte dolje).

Ključ za šifriranje: Koristite ključ za šifriranje za sigurnu komunikaciju (pogledajte dolje).

Lozinka
Prikazuje se samo ako je Način autentifikacije postavljen na Lozinka. Postavlja lozinku uređaja. Ova lozinka mora odgovarati lozinki konfiguriranoj na ESPHome uređaju.

Ključ za šifriranje
Prikazuje se samo ako je Način autentifikacije postavljen na Ključ za šifriranje. Postavlja ključ za šifriranje uređaja za sigurnu komunikaciju. Ovo se mora podudarati s ključem za šifriranje konfiguriranim na ESPHome uređaju.

Informacije o uređaju

Ime (samo za čitanje)
Prikazuje naziv povezanog ESPHome uređaja.

Model (samo za čitanje)
Prikazuje model povezanog ESPHome uređaja.
Proizvođač (samo za čitanje)
Prikazuje proizvođača povezanog ESPHome uređaja.

MAC adresa (samo za čitanje)
Prikazuje MAC adresu povezanog ESPHome uređaja.
Verzija firmvera (samo za čitanje)
Prikazuje verziju firmvera povezanog ESPHome uređaja.

Radnje vozača

Resetiraj veze i varijable

Upozorenje: Ovo će resetovati sva povezivanja i izbrisati sve programe povezane s varijablama.

Resetujte veze i varijable drajvera. Ovo je korisno ako promijenite povezani ESPHome uređaj ili ako postoje zastarjele veze ili varijable.

Vodič za konfiguraciju ratgdo-a

Ovaj vodič pruža upute za konfiguriranje ESPHome drajvera za rad s ratgdo uređajima za upravljanje garažnim vratima putem releja u Control4 Composer Pro.

Dodajte drajver kontrolera releja
Dodajte željeni drajver za kontroler releja u svoj Control4 projekat u Composer Pro-u.

Svojstva kontrolera releja
Uređaj ratgdo izlaže entitet "Cover" u ESPHome-u, koji se mapira na funkcionalnost kontrolera releja u Control4.

Broj releja
Uređaj ratgdo koristi konfiguraciju s više releja za upravljanje garažnim vratima. U Composer Pro programu, trebali biste konfigurirati postavke releja na sljedeći način:

Postavite na 2 releja (Otvaranje/Zatvaranje) ili 3 releja (Otvaranje/Zatvaranje/Zaustavljanje)
- Uređaj Ratgdo koristi odvojene komande za otvaranje i zatvaranje garažnih vrata.
- Ako vaš ratgdo firmver podržava naredbu "stop", konfigurirajte 3 releja kako biste omogućili funkcionalnost zaustavljanja. Ako niste sigurni, možete pogledati ratgdo veze u Composer Pro programu da vidite je li relej "Stop Door" dostupan.

Konfiguracija releja

Postavite na Puls
- Ratgdo koristi trenutne impulse za pokretanje otvarača garažnih vrata, slično pritisku na dugme na zidu.

Pulse Time

Postavite sva vremena impulsa releja na 500 (zadano)
- Ovo je trajanje tokom kojeg će relej biti aktiviran

Invertni relej

Postavite sva svojstva invertnog releja na br (zadano)

Kontakt Debounce

Postavite sva vremena odbijanja kontakta na 250 (zadano)
- Ovo pomaže u sprečavanju lažnog mahanja senzora stanja garažnih vrata.

Invertiraj kontakt

Postavi sva svojstva invertiranog kontakta na br (zadano)

Example Nekretnine
Za referencu, evo primjeraample svojstava kontrolera releja u Composer Pro-u:

Priključci kontrolera releja

Releji

Otvoreno: Povežite se s relejem "Otvorena vrata" uređaja Ratgdo
Zatvori: Povežite se s relejem "Zatvori vrata" uređaja Ratgdo
zaustaviti: Povežite se s relejem "Stop Door" uređaja Ratgdo, ako je dostupan

Kontakt senzori

Zatvoreni kontakt: Povežite se s kontaktom ratgdo-a za "zatvorena vrata"
Otvoren kontakt: Povežite se s kontaktom za "otvaranje vrata" ratgdo-a

Example Connections
Za referencu, evo primjeraampLe kako bi veze trebale izgledati u Composer Pro programu:

Programiranje
U Control4 možete kreirati programe za:

Otvaranje/zatvaranje garažnih vrata na osnovu događaja
Pratite stanje garažnih vrata
Postavite obavještenja o promjenama statusa garažnih vrata
Kreirajte prilagođene dugmad na ekranima osjetljivim na dodir i daljinskim upravljačima

Example: Kreiranje upozorenja da je još uvijek otvoreno

Korištenje svojstva „Vrijeme još uvijek otvoreno“ iz drajvera kontrolera releja:

Podesite "Vrijeme otvorenosti" na željeno trajanje (npr. 10 minuta)
Kreirajte programsko pravilo koje se aktivira kada se aktivira događaj „Još uvijek otvoreno“
Dodajte radnje za slanje obavještenja ili obavljanje drugih zadataka

Dodatni entiteti
U zavisnosti od vašeg ratgdo uređaja, firmvera i njegovih mogućnosti, ESPHome drajver može prikazati dodatne entitete. Oni mogu biti dodatne veze ili varijable drajvera.

Za više informacija o određenim entitetima, molimo pogledajte dokumentaciju ratgdo-a: https://ratgdo.github.io/esphome-ratgdo/webui_documentation.html

Informacije za programere
Autorska prava © 2025 Finite Labs LLC
Sve informacije sadržane u ovom dokumentu su i ostaju vlasništvo kompanije Finite Labs LLC i njenih dobavljača, ako ih ima. Intelektualni i tehnički koncepti sadržani u ovom dokumentu su vlasništvo
Finite Labs LLC i njegovi dobavljači mogu biti zaštićeni američkim i stranim patentima, patentima u postupku, te su zaštićeni poslovnom tajnom ili zakonom o autorskim pravima. Širenje ovih informacija ili reprodukcija ovog materijala strogo je zabranjena bez prethodne pismene dozvole od Finite Labs LLC. Za najnovije informacije posjetite https://drivercentral.io/platforms/control4-drivers/utility/esphome

Podrška
Ako imate bilo kakvih pitanja ili problema s integracijom ovog drajvera sa Control4 ili ESPHome, možete nas kontaktirati na driver-support@finitelabs.com ili nas pozovite/pošaljite poruku na +1 949-371-5805.

Dnevnik promjena

v20250715 – 14.07.2025.

Popravljeno: Ispravljena greška koja je uzrokovala da entiteti nisu otkriveni prilikom povezivanja

v20250714 – 14.07.2025.

Dodato: Dodana je podrška za šifrirane veze korištenjem šifriranja uređaja

v20250619 – 14.07.2025.

Dodano Dodata je dokumentacija specifična za ratgdo

v20250606 – 14.07.2025.

Dodano Početno izdanje

FAQ

Koji su uređaji kompatibilni s ovim drajverom?

Ovaj drajver je kompatibilan sa bilo kojim ESPHome uređajem, uz opsežno testiranje provedeno na ratgdo uređajima. Ako ga isprobate na bilo kojem drugom uređaju i radi, molimo vas da nas obavijestite radi provjere.

Dokumenti / Resursi

ESPHome ESP8266 Fizičko povezivanje s vašim uređajem [pdf] Korisnički priručnik
ESP8266, ESP32, ESP8266 Fizičko povezivanje s vašim uređajem, ESP8266, Fizičko povezivanje s vašim uređajem, Povezivanje s vašim uređajem, s vašim uređajem, vaš uređaj

Reference

Uputstvo za upotrebu

ESPHome ESP8266 Fizičko povezivanje s vašim uređajem

Specifikacije

Gotovoview