Ghidul utilizatorului pentru conectarea fizică la dispozitivul ESPHome ESP8266

Este necesară o singură instanță de driver per dispozitiv ESPHome.
Mai multe instanțe ale acestui driver conectate la același dispozitiv vor
au un comportament neașteptat. Cu toate acestea, puteți avea mai multe instanțe
al acestui driver conectat la diferite dispozitive ESPHome.

Configurare DriverCentral în cloud

Dacă aveți deja driverul DriverCentral Cloud instalat în
proiectul dvs., puteți continua cu instalarea driverelor.

Acest driver se bazează pe driverul DriverCentral Cloud pentru a gestiona
licențiere și actualizări automate. Dacă sunteți nou în utilizarea
DriverCentral, puteți consulta documentația lor Cloud Driver
pentru configurarea acestuia.

Instalarea driverului

Descărcați cea mai recentă versiune control4-eshome.zip de pe
DriverCentral.

Extrageți și instalați fișierele esphome.c4z, esphome_light.c4z și
drivere esphome_lock.c4z.
Folosește fila Căutare pentru a găsi driverul ESPHome și a-l adăuga la
proiectul tău.

Selectați driverul nou adăugat în fila System Design. Verificați
Starea Cloudului pentru informații despre licență.
Reîmprospătați starea licenței selectând DriverCentral Cloud
șofer și efectuarea acțiunii Verificare drivere.

Configurați setările dispozitivului cu conexiunea
informaţii.
Așteptați ca statusul driverului să afișeze Conectat.

Configurarea driverului

Proprietăți driver:

FAQ

Î: Ce dispozitive sunt compatibile cu acest driver?

R: Acest driver este compatibil cu orice dispozitiv ESPHome, cu
teste ample efectuate pe dispozitive ratgdo. Dacă încercați pe orice
alt dispozitiv și funcționează, vă rugăm să ne informați pentru verificare.

Î: Cum pot monitoriza și controla dispozitivele ESPHome?

R: Puteți monitoriza și controla dispozitivele ESPHome prin intermediul unui web
browser, Home Assistant sau alte platforme compatibile după
integrarea lor în Control4 folosind acest driver.

„`

View Fullscreen

Pesteview
Integrați dispozitivele bazate pe ESPHome în Control4. ESPHome este un sistem open-source care transformă microcontrolerele comune, precum ESP8266 și ESP32, în dispozitive inteligente pentru casă printr-o simplă configurare YAML. Dispozitivele ESPHome pot fi configurate, monitorizate și controlate folosind un... web browser, Home Assistant sau alte platforme compatibile. Acest driver permite monitorizarea și controlul fără probleme al dispozitivelor ESPHome direct din sistemul Control4.
Index
Cerințe de sistem Caracteristici Compatibilitate
Dispozitive verificate acceptate Entități ESPHome Instalare Configurare DriverCentral Cloud Instalare driver Configurare driver
Proprietăți driver Setări cloud Setări driver Setări dispozitiv Informații dispozitiv
Ghiduri de configurare a acțiunilor driverului
Ghid de configurare ratgdo Informații pentru dezvoltatori Asistență Jurnal de modificări

Cerințe de sistem
Sistem de operare Control4 3.3+
Caracteristici
Comunicare în rețeaua locală care nu necesită servicii cloud Actualizări în timp real de la toate entitățile acceptate expuse de dispozitiv Acceptă conexiuni criptate folosind cheia de criptare a dispozitivului Suport pentru programare variabilă
Compatibilitate
Dispozitive verificate
Acest driver va funcționa generic cu orice dispozitiv ESPHome, dar am testat extensiv cu următoarele dispozitive:
ratgdo – Ghid de configurare Dacă încercați acest driver pe un produs listat mai sus și funcționează, anunțați-ne!

Entități ESPHome acceptate

Tip entitate Panou de control alarmă API Zgomot Senzor binar Bluetooth Proxy Buton Climatizare Capac Dată/Oră Dată/Oră Cameră Eveniment Ventilator Lumină Blocare Player media Număr Selectare senzor Sirenă Comutator Text Senzor text Actualizare Valvă Asistent vocal

Sprijinit

Instalare instalare
Este necesară o singură instanță de driver per dispozitiv ESPHome. Instanțe multiple ale acestui driver
Un driver conectat la același dispozitiv va avea un comportament neașteptat. Cu toate acestea, puteți avea mai multe instanțe ale acestui driver conectate la diferite dispozitive ESPHome.
Configurare DriverCentral în cloud
Dacă aveți deja driverul DriverCentral Cloud instalat în proiectul dvs., puteți continua cu instalarea driverului.
Acest driver se bazează pe driverul DriverCentral Cloud pentru a gestiona licențierea și actualizările automate. Dacă sunteți nou în utilizarea DriverCentral, puteți consulta documentația lor Cloud Driver pentru configurare.
Instalarea driverului
Instalarea și configurarea driverelor sunt similare cu majoritatea celorlalte drivere bazate pe IP. Mai jos este o schiță a pașilor de bază pentru confortul dumneavoastră.
1. Descărcați cea mai recentă versiune a fișierului control4-esphome.zip de la DriverCentral.
2. Extrageți și instalați driverele esphome.c4z, esphome_light.c4z și esphome_lock.c4z.
3. Folosește fila „Căutare” pentru a găsi driverul „ESPHome” și a-l adăuga la proiectul tău.
Ü Este necesară o singură instanță de driver per dispozitiv ESPHome.

4. Selectați driverul nou adăugat în fila „System Design”. Veți observa că Starea Cloudului reflectă starea licenței. Dacă ați achiziționat o licență, aceasta va afișa Licență activată, altfel va afișa Rulare de probă și durata rămasă a versiunii de probă.
5. Puteți actualiza starea licenței selectând driverul „DriverCentral Cloud” din fila „System Design” și efectuând acțiunea „Check Drivers”.
6. Configurați Setările dispozitivului cu informațiile de conectare. 7. După câteva momente, Starea driverului va afișa Conectat. Dacă driverul nu reușește
Pentru a vă conecta, setați proprietatea Mod jurnal la Imprimare și resetați câmpul Adresă IP pentru a vă reconecta. Apoi, verificați fereastra de ieșire lua pentru mai multe informații. 8. După conectare, driverul va crea automat variabile și conexiuni pentru fiecare tip de entitate acceptat. 9. Pentru a controla luminile și/sau încuietorile, utilizați fila „Căutare” pentru a găsi driverul „ESPHome Light” și/sau „ESPHome Lock”. Adăugați o instanță de driver pentru fiecare entitate de lumină sau încuietoare expusă din proiectul dvs. În fila „Conexiuni”, selectați driverul „ESPHome” și legați entitățile de lumină sau încuietoare la driverele nou adăugate.
Configurarea driverului
Proprietăți driver
Setări cloud
Stare cloud Afișează starea licenței DriverCentral în cloud. Actualizări automate Activează/dezactivează actualizările automate ale DriverCentral în cloud.
Setări driver
Starea șoferului (doar citire)

Afișează starea curentă a driverului.
Versiune driver (doar citire) Afișează versiunea curentă a driverului.
Nivel jurnal [ Fatal | Eroare | Avertisment | Info | Debug | Trace | Ultra ] Setează nivelul de jurnalizare. Implicit este Info.
Mod jurnal [ Oprit | Imprimare | Jurnal | Imprimare și jurnal ] Setează modul de înregistrare. Implicit este Oprit.
Setări dispozitiv
Adresă IP Setează adresa IP a dispozitivului (de exemplu, 192.168.1.30). Numele de domeniu sunt permise atâta timp cât pot fi rezolvate la o adresă IP accesibilă de către controler. HTTPS nu este acceptat.
Dacă utilizați o adresă IP, trebuie să vă asigurați că aceasta nu se va modifica prin atribuirea unei adrese statice.
IP sau crearea unei rezervări DHCP. Port Setează portul dispozitivului. Portul implicit pentru dispozitivele ESPHome este 6053. Mod de autentificare [Niciunul | Parolă | Cheie de criptare] Selectează metoda de autentificare pentru conectarea la dispozitivul ESPHome.
Niciuna: Nu este necesară autentificarea. Parolă: Folosiți o parolă pentru autentificare (vezi mai jos). Cheie de criptare: Folosiți o cheie de criptare pentru comunicare securizată (vezi mai jos).
Parolă Se afișează numai dacă Modul de autentificare este setat la Parolă. Setează parola dispozitivului. Aceasta trebuie să corespundă parolei configurate pe dispozitivul ESPHome.
Cheie de criptare Afișată numai dacă Modul de autentificare este setat la Cheie de criptare. Setează cheia de criptare a dispozitivului pentru comunicare securizată. Aceasta trebuie să corespundă cu cheia de criptare configurată pe dispozitivul ESPHome.
Informații despre dispozitiv

Nume (doar citire) Afișează numele dispozitivului ESPHome conectat. Model (doar citire) Afișează modelul dispozitivului ESPHome conectat. Producător (doar citire) Afișează producătorul dispozitivului ESPHome conectat. Adresă MAC (doar citire) Afișează adresa MAC a dispozitivului ESPHome conectat. Versiune firmware (doar citire) Afișează versiunea de firmware a dispozitivului ESPHome conectat.
Acțiuni ale șoferului
Resetare conexiuni și variabile
Aceasta va reseta toate legăturile de conexiune și va șterge orice programare asociată cu
variabile.
Resetați conexiunile și variabilele driverului. Acest lucru este util dacă schimbați dispozitivul ESPHome conectat sau dacă există conexiuni sau variabile învechite.

Ghid de configurare ratgdo
Acest ghid oferă instrucțiuni pentru configurarea driverului ESPHome pentru a funcționa cu dispozitive ratgdo pentru controlul ușilor de garaj prin intermediul releelor în Control4 Composer Pro.
Adăugați driverul controlerului de releu
Adăugați driverul de controler de releu dorit la proiectul Control4 în Composer Pro.
Proprietățile controlerului de releu
Dispozitivul ratgdo expune o entitate „Cover” în ESPHome, care se mapează cu funcționalitatea controlerului de relee din Control4.
Număr de relee
Dispozitivul ratgdo folosește o configurație multi-releu pentru a controla ușa de garaj. În Composer Pro, ar trebui să configurați setările releului după cum urmează:

Setați la 2 relee (Deschidere/Închidere) sau 3 relee (Deschidere/Închidere/Oprire). Dispozitivul ratgdo utilizează comenzi separate pentru deschiderea și închiderea ușii de garaj. Dacă firmware-ul ratgdo acceptă comanda „stop”, configurați pentru 3 relee pentru a activa funcționalitatea de oprire. Dacă nu sunteți sigur, puteți verifica conexiunile ratgdo din Composer Pro pentru a vedea dacă releul „Oprire ușă” este disponibil.
Configurarea releului
Setat la Puls, ratgdo folosește impulsuri momentane pentru a declanșa deschizătorul de ușă de garaj, similar cu apăsarea unui buton de perete.
Timpul pulsului
Setați toate timpii de impuls al releului la 500 (implicit). Aceasta este durata în care releul va fi activat.
Releu inversor
Setați toate proprietățile releului de inversare la Nu (implicit)
Contactați Debounce
Setați toți timpii de debounce a contactului la 250 (implicit). Acest lucru ajută la prevenirea acționării false a senzorilor de stare ai ușii de garaj.
Inversați contactul
Setați toate proprietățile de inversare a contactelor la Nu (implicit)
ExampProprietăți
Pentru referință, iată un ex.ampo listă a proprietăților controlerului de releu din Composer Pro:

Conexiuni controler releu
relee
Deschidere: Conectați-vă la releul „Deschidere ușă” al ratgdo-ului. Închidere: Conectați-vă la releul „Închidere ușă” al ratgdo-ului. Stop: Conectați-vă la releul „Oprire ușă” al ratgdo-ului, dacă este disponibil.
Senzori de contact
Contact închis: Conectați-vă la contactul „Ușă închisă” al ratgdo-ului. Contact deschis: Conectați-vă la contactul „Ușă deschisă” al ratgdo-ului.
Example Conexiuni

Pentru referință, iată un ex.ampUn exemplu de cum ar trebui să arate conexiunile în Composer Pro:
Programare
Puteți crea programe în Control4 pentru a: Deschide/închide ușa garajului în funcție de evenimente Monitoriza starea ușii garajului Configura notificări pentru modificările stării ușii garajului Crea butoane personalizate pe ecrane tactile și telecomenzi
Exampexemplu: Crearea unei alerte „Încă deschisă”
Folosind proprietatea „Still Open Time” din driverul controlerului de releu: 1. Setați „Still Open Time” la durata dorită (de exemplu, 10 minute) 2. Creați o regulă de programare care se declanșează atunci când se declanșează evenimentul „Still Open” 3. Adăugați acțiuni pentru a trimite notificări sau a efectua alte sarcini
Entități suplimentare
În funcție de dispozitivul ratgdo, de firmware și de capacitățile acestuia, pot exista entități suplimentare expuse de driverul ESPHome. Acestea pot apărea ca conexiuni suplimentare sau variabile de driver. Consultați documentația ratgdo pentru mai multe informații despre entități specifice: https://ratgdo.github.io/esphome-ratgdo/webui_documentație.html

Informații pentru dezvoltatori
Drepturi de autor © 2025 Finite Labs LLC Toate informațiile conținute aici sunt și rămân proprietatea Finite Labs LLC și a furnizorilor săi, dacă există. Conceptele intelectuale și tehnice conținute aici sunt proprietatea Finite Labs LLC și a furnizorilor săi și pot fi acoperite de brevete americane și străine, brevete în curs de desfășurare și sunt protejate de legea secretelor comerciale sau a drepturilor de autor. Diseminarea acestor informații sau reproducerea acestui material este strict interzisă fără a se obține în prealabil permisiunea scrisă a Finite Labs LLC. Pentru cele mai recente informații, vă rugăm să vizitați https://drivercentral.io/platforms/control4-drivers/utility/esphome
Sprijin
Dacă aveți întrebări sau probleme la integrarea acestui driver cu Control4 sau ESPHome, ne puteți contacta la driver-support@finitelabs.com sau ne puteți suna/trimite un mesaj la +1 949-371-5805.

Jurnalul modificărilor
v20250715 – 14.07.2025
Fix
Eroare remediată care făcea ca entitățile să nu fie descoperite la conectare
v20250714 – 14.07.2025
Adăugat
Adăugat suport pentru conexiuni criptate folosind cheia de criptare a dispozitivului
v20250619 – 14.07.2025
Adăugat
Adăugată documentație specifică ratgdo
v20250606 – 14.07.2025
Adăugat
Lansare inițială

Documente/Resurse

Conectarea fizică ESPHome ESP8266 la dispozitivul dvs. [pdfGhid de utilizare
Conectarea fizică a ESP8266, ESP32, ESP8266 la dispozitiv, ESP8266, Conectarea fizică a dispozitivului, Conectarea la dispozitivul dvs., la dispozitivul dvs., dispozitivul dvs.

Referințe

Manual de utilizare

Ghidul utilizatorului pentru conectarea fizică la dispozitivul ESPHome ESP8266

Conectarea fizică a ESP8266 la dispozitiv

Specificații

Instrucțiuni de utilizare a produsului

Instalare instalare