ESPHome ESP8266 Cunnessione fisica à u vostru dispositivu Guida di l'utente

Integrate i dispusitivi basati annantu à ESPHome in Control4. ESPHome hè un sistema open-source chì trasforma i microcontrollori cumuni, cum'è ESP8266 è ESP32, in dispusitivi di casa intelligente per mezu di una simplice cunfigurazione YAML. I dispusitivi ESPHome ponu esse cunfigurati, monitorati è cuntrullati cù un web navigatore, Home Assistant, o altre piattaforme cumpatibili. Stu driver permette un monitoraghju è un cuntrollu senza interruzioni di i dispositivi ESPHome direttamente da u vostru sistema Control4.

Requisiti di u sistema

Sistema operativu Control4 3.3+

Features

Cumunicazione di rete lucale chì ùn richiede micca servizii cloud
Aghjurnamenti in tempu reale da tutte l'entità supportate esposte da u dispusitivu
Supporta cunnessione criptate cù a chjave di criptazione di u dispusitivu
Supportu di Programmazione Variabile

Cumpatibilità

Dispositivi Verificati
Stu driver funziona genericamente cù qualsiasi dispositivu ESPHome, ma avemu fattu testi estensivi cù i seguenti dispositivi:

ratgdo – Guida di cunfigurazione

Sè pruvate stu driver nant'à un pruduttu elencatu sopra, è funziona, fateci sapè!

Entità ESPHome supportate

Installazione di l'installatore

Solu una sola istanza di driver hè necessaria per ogni dispusitivu ESPHome. Parechje istanze di stu driver cunnesse à u listessu dispusitivu averanu un cumpurtamentu inaspettatu. Tuttavia, pudete avè parechje istanze di stu driver cunnesse à diversi dispusitivi ESPHome.

Cunfigurazione di DriverCentral Cloud
Sè vo avete digià u DriverCentral Driver di nuvola installatu in u vostru prugettu pudete cuntinuà à l'installazione di u driver.

Stu driver si basa nantu à u driver DriverCentral Cloud per gestisce e licenze è l'aghjurnamenti automatichi. Sè vo site novu à aduprà DriverCentral, pudete riferisce à u so Documentazione di u Driver Cloud per avè lu messu in opera.

Installazione di driver

L'installazione è a cunfigurazione di i driver sò simili à a maiò parte di l'altri driver basati nantu à IP. Quì sottu hè un schema di i passi basi per a vostra comodità.

Scaricate l'ultime control4-esphome.zip da DriverCentral.
Estrae è stallà u esphome.c4z, esphome_light.c4z, è esphome_lock.c4z cunduttori.
Aduprate a tabulazione "Ricerca" per truvà u driver "ESPHome" è aghjunghje lu à u vostru prughjettu.

Selezziunate u driver appena aghjuntu in a tabulazione "System Design". Nuterete chì u Cloud Status riflette u statu di a licenza. Sè avete acquistatu una licenza, mostrerà "Licenza attivata", altrimenti "Trial Running" è a durata di prova restante.
Pudete aghjurnà u statutu di a licenza selezziunendu u driver "DriverCentral Cloud" in a tabulazione "System Design" è eseguisce l'azione "Verificà i driver".

Configurate u Settings di u dispusitivu cù l'infurmazioni di cunnessione.
Dopu à qualchi mumentu, u Statu di u Driver mostrerà "Cunnessu". Sè u driver ùn riesce micca à cunnette si, impostate a pruprietà Modu di Log à "Stampa" è resettate u campu Indirizzu IP per ricunnette si. Dopu verificate a finestra di output Lua per più infurmazioni.
Una volta cunnessu, u driver creerà automaticamente variabili è cunnessione per ogni tipu d'entità supportatu.

Per cuntrullà luci è/o serrature, aduprate a tabulazione "Ricerca" per truvà u driver "ESPHome Light" è/o "ESPHome Lock". Aghjunghjite una istanza di driver per ogni entità di luce o serratura esposta in u vostru prughjettu. In a tabulazione "Cunnessione", selezziunate u driver "ESPHome" è ligate l'entità di luce o serratura à i driver appena aghjunti.

Configurazione di u driver

Pruprietà di u driver

Settings Cloud

Status Cloud
Mostra u statu di a licenza cloud di DriverCentral.
Actualizazioni automatiche
Attiva/disattiva l'aghjurnamenti automatichi in u cloud di DriverCentral.

Paràmetri di u driver

Statu di u cunduttore (sola lettura)
Mostra u statu attuale di u driver.

Versione di u Driver (sola lettura)
Mostra a versione attuale di u driver.
Livellu di Log [ Fatale | Errore | Avvertimentu | Infurmazioni | Debug | Traccia | Ultra ] Definisce u livellu di registrazione. U predefinitu hè Info.

Modu di Registru [ Off | Stampa | Registru | Stampa è Registru ] Imposta a modalità di registrazione. U predefinitu hè Off.

Settings di u dispusitivu

Indirizzu IP
Imposta l'indirizzu IP di u dispusitivu (per esempiu 192.168.1.30). I nomi di duminiu sò permessi fintantu ch'elli ponu esse risolti à un indirizzu IP accessibile da u controller. HTTPS ùn hè micca supportatu.

Nota: Sè vo aduprate un indirizzu IP, duvete assicurà chì ùn cambierà micca assignendu un IP staticu o creendu una riservazione DHCP.

Portu
Definisce u portu di u dispusitivu. U portu predefinitu per i dispusitivi ESPHome hè 6053.

Modu d'autentificazione [ Nisunu | Password | Chjave di crittografia ]
Selezziunà u metudu d'autentificazione per a cunnessione à u dispusitivu ESPHome.

Nimu: Nisuna autentificazione hè necessaria.

Codice: Aduprate una password per l'autentificazione (vede quì sottu).

Chjave di crittografia: Aduprate una chjave di crittografia per una cumunicazione sicura (vede quì sottu).

Codice
Mostratu solu s'è a Modalità d'Autentificazione hè impostata nantu à Password. Imposta a password di u dispusitivu. Questa deve currisponde à a password cunfigurata nantu à u dispusitivu ESPHome.

Chjave di criptografia
Mostratu solu s'è a Modalità d'Autentificazione hè impostata nantu à Chjave di Crittografia. Imposta a chjave di crittografia di u dispusitivu per una cumunicazione sicura. Questa deve currisponde à a chjave di crittografia cunfigurata nantu à u dispusitivu ESPHome.

Info di u dispusitivu

Nome (sola lettura)
Mostra u nome di u dispusitivu ESPHome cunnessu.

Modellu (sola lettura)
Mostra u mudellu di u dispusitivu ESPHome cunnessu.
Fabbricante (sola lettura)
Mostra u fabricatore di u dispusitivu ESPHome cunnessu.

Indirizzu MAC (sola lettura)
Mostra l'indirizzu MAC di u dispusitivu ESPHome cunnessu.
Versione di u firmware (sola lettura)
Mostra a versione di u firmware di u dispusitivu ESPHome cunnessu.

Azzioni di u cunduttore

Resettà e cunnessione è e variabili

Attenzione: Questu resetterà tutti i ligami di cunnessione è cancellerà qualsiasi prugrammazione assuciata à e variabili.

Resettate e cunnessione è e variabili di u driver. Questu hè utile sè cambiate u dispusitivu ESPHome cunnessu o s'ellu ci sò cunnessione o variabili obsolete.

Guida di cunfigurazione di ratgdo

Questa guida furnisce struzzioni per cunfigurà u driver ESPHome per travaglià cù i dispositivi ratgdo per u cuntrollu di a porta di garage via relè in Control4 Composer Pro.

Aghjunghje un driver di controller di relè
Aghjunghjite u driver di u controller di relè desideratu à u vostru prughjettu Control4 in Composer Pro.

Proprietà di u Controller di Relè
U dispusitivu ratgdo espone una entità "Cover" in ESPHome, chì si mappa à a funziunalità di u controller di relè in Control4.

Numero di relè
U dispusitivu ratgdo usa una cunfigurazione multi-relè per cuntrullà a porta di u garage. In Composer Pro, duvete cunfigurà i paràmetri di u relè cusì:

Impostate à 2 Relè (Apertura/Chiusura) o 3 Relè (Apertura/Chiusura/Stop)
- U dispusitivu ratgdo usa cumandamenti separati per apre è chjude a porta di u garage
- Sè u vostru firmware ratgdo supporta u cumandamentu "stop", cunfigurate 3 relè per attivà a funzionalità di stop. Sè ùn site micca sicuru, pudete guardà e cunnessione ratgdo in Composer Pro per vede s'ellu u relè "Stop Door" hè dispunibule.

Cunfigurazione Relay

Set à Pulse
- ratgdo usa impulsi momentanei per attivà l'apriporta di u garage, simile à una pressione di buttone murale

Pulse Time

Impostate tutti i tempi di impulsi di relè à 500 (default)
- Questa hè a durata di attivazione di u relè

Relè d'inversione

Imposta tutte e proprietà di u relè d'inversione à Innò (default)

Cuntattate Debounce

Imposta tutti i tempi di debounce di cuntattu à 250 (default)
- Questu aiuta à impedisce u falsu sbattimentu di i sensori di statu di a porta di u garage.

Invertisce u cuntattu

Imposta tutte e proprietà di cuntattu invertite à Innò (default)

Exampe Proprietà
Per riferimentu, eccu un esempiuample di e pruprietà di u controller di relè in Composer Pro:

Cunnessione di u Controller di Relè

Relè

Apertura: Cunnette vi à u relè "Porta Aperta" di u ratgdo
Chiudi: Cunnette vi à u relè "Chiudi a porta" di u ratgdo
Stop : Cunnette vi à u relè "Stop Door" di u ratgdo, s'ellu hè dispunibule.

Sensori di Cuntattatu

Cuntattu chjusu: Cunnette vi à u cuntattu "Porta chjusa" di u ratgdo
Cuntattu apertu: Cunnette vi à u cuntattu "Porta Aperta" di u ratgdo

Example Cunnessioni
Per riferimentu, eccu un esempiuampEccu un esempiu di cumu devenu esse e cunnessione in Composer Pro:

Prugrammazione
Pudete creà prugrammazione in Control4 per:

Apertura/chjusura di a porta di u garage secondu l'eventi
Survegliate u statu di a porta di u garage
Configurate notifiche per i cambiamenti di statu di a porta di u garage
Crea buttoni persunalizati nantu à i schermi tattili è i telecomandi

Example: Creazione di un avvisu sempre apertu

Aduprendu a pruprietà "Still Open Time" da u driver di u controller di relè:

Impostate u "Tempu di apertura" à a durata desiderata (per esempiu, 10 minuti)
Crea una regula di prugrammazione chì si attiva quandu l'eventu "Sempre Apertu" si attiva
Aghjunghje azzioni per mandà notificazioni o fà altre attività

Entità supplementari
Sicondu u vostru dispusitivu ratgdo, u firmware è e so capacità, ci ponu esse entità supplementari esposte da u driver ESPHome. Queste ponu vene cum'è cunnessione supplementari o variabili di driver.

Per piacè riferitevi à a ducumentazione di ratgdo per più infurmazioni nantu à entità specifiche: https://ratgdo.github.io/esphome-ratgdo/webui_documentation.html

L'infurmazione di u sviluppatore
Dritti d'autore © 2025 Finite Labs LLC
Tutte l'infurmazioni cuntenute in questu documentu sò, è restanu pruprietà di Finite Labs LLC è di i so fornitori, s'ellu ci n'hè. I cuncetti intellettuali è tecnichi cuntenuti in questu documentu sò pruprietà di
Finite Labs LLC è i so fornitori ponu esse cuparti da brevetti americani è stranieri, brevetti in corsu, è sò prutetti da secreti cummerciali o da lege di copyright. A diffusione di queste informazioni o a ripruduzzione di stu materiale hè strettamente pruibita, salvu chì ùn sia ottenuta prima l'autorizazione scritta da Finite Labs LLC. Per l'ultime informazioni, visitate https://drivercentral.io/platforms/control4-drivers/utility/esphome

Supportu
Sè avete qualchì quistione o prublemi à integrà stu driver cù Control4 o ESPHome, pudete cuntattà ci à supportu-di-driver@finitelabs.com o chjamateci / mandate un SMS à +1 949-371-5805.

Changelog

v20250715 – 14/07/2025

Fixed: Risoltu un bug chì impedia a scuperta di l'entità à a cunnessione

v20250714 – 14/07/2025

Aggiuntu: Aggiuntu u supportu per e cunnessione criptate utilizendu a crittografia di u dispusitivu

v20250619 – 19/06/2025

Aggiuntu : Aghjunta a ducumentazione specifica di ratgdo

v20250606 – 06/06/2025

Aggiuntu Versione iniziale

FAQ

Quali dispusitivi sò cumpatibili cù stu driver?

Stu driver hè cumpatibile cù qualsiasi dispusitivu ESPHome, cù testi approfonditi fatti nantu à i dispusitivi ratgdo. Sè vo u pruvate nantu à qualsiasi altru dispusitivu è funziona, per piacè informateci per a verificazione.

Documenti / Risorse

ESPHome ESP8266 Cunnessione fisica à u vostru dispositivu [pdfGuida di l'utente
ESP8266, ESP32, ESP8266 Cunnessione fisica à u vostru dispositivu, ESP8266, Cunnessione fisica à u vostru dispositivu, Cunnessione à u vostru dispositivu, à u vostru dispositivu, u vostru dispositivu

Referenze

Manuale d'usu

ESPHome ESP8266 Cunnessione fisica à u vostru dispositivu

Specificazioni

Overview