ESPHome ESP8266 si connette fisicamente al tuo dispositivo

Specifiche

• Requisiti di sistema: Control4 OS 3.3+

Sopraview

Integra i dispositivi basati su ESPHome in Control4. ESPHome è un sistema open source che trasforma i comuni microcontrollori, come ESP8266 ed ESP32, in dispositivi per la casa intelligente tramite una semplice configurazione YAML. I dispositivi ESPHome possono essere configurati, monitorati e controllati tramite un web browser, Home Assistant o altre piattaforme compatibili. Questo driver consente il monitoraggio e il controllo senza interruzioni dei dispositivi ESPHome direttamente dal sistema Control4.

Requisiti di sistema

• Control4 OS 3.3+

Caratteristiche

• Comunicazione di rete locale che non richiede servizi cloud
• Aggiornamenti in tempo reale da tutte le entità supportate esposte dal dispositivo
• Supporta connessioni crittografate utilizzando la chiave di crittografia del dispositivo
• Supporto alla programmazione delle variabili

Compatibilità

Dispositivi verificati
Questo driver funziona in genere con qualsiasi dispositivo ESPHome, ma lo abbiamo testato ampiamente con i seguenti dispositivi:

• ratgdo – Guida alla configurazione

Se provi questo driver su uno dei prodotti elencati sopra e funziona, faccelo sapere!

Entità ESPHome supportate

Installazione del programma di installazione

È richiesta una sola istanza del driver per dispositivo ESPHome. Più istanze di questo driver connesse allo stesso dispositivo avranno un comportamento imprevisto. Tuttavia, è possibile avere più istanze di questo driver connesse a dispositivi ESPHome diversi.

Configurazione del cloud DriverCentral
Se hai già il DriverCentral Cloud driver installato nel tuo progetto puoi continuare con l'installazione del driver.

Questo driver si basa sul driver DriverCentral Cloud per gestire le licenze e gli aggiornamenti automatici. Se non hai mai utilizzato DriverCentral, puoi fare riferimento al loro Documentazione del driver cloud per averlo impostato.

Installazione del driver

L'installazione e la configurazione del driver sono simili a quelle della maggior parte degli altri driver basati su IP. Di seguito è riportato uno schema dei passaggi di base per la vostra comodità.

1. Scarica l'ultima versione control4-esphome.zip da DriverCentral.
2. Estrarre e installare il esphome.c4z, esphome_light.c4z, E esphome_lock.c4z conducenti.
3. Utilizza la scheda "Cerca" per trovare il driver "ESPHome" e aggiungerlo al tuo progetto.
4. Seleziona il driver appena aggiunto nella scheda "Progettazione del sistema". Noterai che lo stato del cloud riflette lo stato della licenza. Se hai acquistato una licenza, verrà visualizzato "Licenza attivata", altrimenti "Prova in corso" e la durata residua della prova.
5. È possibile aggiornare lo stato della licenza selezionando il driver "DriverCentral Cloud" nella scheda "Progettazione del sistema" ed eseguendo l'azione "Controlla driver".
6. Configurare il Impostazioni del dispositivo con le informazioni di connessione.
7. Dopo qualche istante, lo stato del driver visualizzerà "Connesso". Se il driver non riesce a connettersi, impostare la proprietà Modalità registro su "Stampa" e reimpostare il campo Indirizzo IP per riconnettersi. Quindi, controllare la finestra di output Lua per ulteriori informazioni.
8. Una volta connesso, il driver creerà automaticamente variabili e connessioni per ogni tipo di entità supportato.
9. Per controllare luci e/o serrature, utilizza la scheda "Cerca" per trovare il driver "ESPHome Light" e/o "ESPHome Lock". Aggiungi un'istanza del driver per ogni entità luce o serratura esposta nel tuo progetto. Nella scheda "Connessioni", seleziona il driver "ESPHome" e associa le entità luce o serratura ai driver appena aggiunti.

Impostazione del driver

Proprietà del driver

Impostazioni cloud

• Stato del cloud
  Visualizza lo stato della licenza cloud di DriverCentral.
• Aggiornamenti automatici
  Attiva/disattiva gli aggiornamenti automatici del cloud DriverCentral.

Impostazioni del driver

• Stato del driver (sola lettura)
  Visualizza lo stato attuale del driver.
• Versione del driver (sola lettura)
  Visualizza la versione corrente del driver.
• Livello di registro [Fatale | Errore | Avviso | Informazioni | Debug | Traccia | Ultra] Imposta il livello di registrazione. Il valore predefinito è Informazioni.
• Modalità registro [ Disattivato | Stampa | Registro | Stampa e registro ] Imposta la modalità di registrazione. L'impostazione predefinita è Spento.

Impostazioni del dispositivo

Indirizzo IP
Imposta l'indirizzo IP del dispositivo (ad esempio 192.168.1.30). I nomi di dominio sono consentiti a condizione che il controller possa risolverli in un indirizzo IP accessibile. HTTPS non è supportato.

Nota: Se si utilizza un indirizzo IP, è necessario assicurarsi che non venga modificato assegnando un IP statico o creando una prenotazione DHCP.

Porta
Imposta la porta del dispositivo. La porta predefinita per i dispositivi ESPHome è 6053.

• Modalità di autenticazione [Nessuna | Password | Chiave di crittografia]
• Seleziona il metodo di autenticazione per la connessione al dispositivo ESPHome.

Nessuno: Non è richiesta alcuna autenticazione.

Password: Utilizzare una password per l'autenticazione (vedere sotto).

Chiave di crittografia: Utilizzare una chiave di crittografia per comunicazioni sicure (vedere sotto).

• Password
  Visualizzato solo se la modalità di autenticazione è impostata su Password. Imposta la password del dispositivo. Questa deve corrispondere alla password configurata sul dispositivo ESPHome.
• Chiave di crittografia
  Visualizzato solo se la modalità di autenticazione è impostata su Chiave di crittografia. Imposta la chiave di crittografia del dispositivo per comunicazioni sicure. Deve corrispondere alla chiave di crittografia configurata sul dispositivo ESPHome.

Informazioni sul dispositivo

• Nome (sola lettura)
  Visualizza il nome del dispositivo ESPHome connesso.
• Modello (sola lettura)
  Visualizza il modello del dispositivo ESPHome connesso.
• Produttore (sola lettura)
  Visualizza il produttore del dispositivo ESPHome connesso.
• Indirizzo MAC (sola lettura)
  Visualizza l'indirizzo MAC del dispositivo ESPHome connesso.
• Versione firmware (sola lettura)
  Visualizza la versione del firmware del dispositivo ESPHome connesso.

Azioni del conducente

Reimposta connessioni e variabili

Avvertimento: Ciò reimposterà tutti i binding delle connessioni ed eliminerà qualsiasi programmazione associata alle variabili.

Reimposta le connessioni e le variabili del driver. Questa operazione è utile se si cambia il dispositivo ESPHome connesso o se ci sono connessioni o variabili obsolete.

Guida alla configurazione di ratgdo

Questa guida fornisce istruzioni per configurare il driver ESPHome affinché funzioni con i dispositivi ratgdo per il controllo delle porte del garage tramite relè in Control4 Composer Pro.

Aggiungi driver del controller relè
Aggiungi il driver del controller relè desiderato al tuo progetto Control4 in Composer Pro.

Proprietà del controller relè
Il dispositivo ratgdo espone un'entità "Cover" in ESPHome, che mappa la funzionalità del controller del relè in Control4.

Numero di relè
Il dispositivo ratgdo utilizza una configurazione multi-relè per controllare la porta del garage. In Composer Pro, è necessario configurare le impostazioni dei relè come segue:

• Impostato su 2 relè (Apri/Chiudi) o 3 relè (Apri/Chiudi/Stop)
  • Il dispositivo ratgdo utilizza comandi separati per l'apertura e la chiusura della porta del garage
  • Se il firmware ratgdo supporta il comando "stop", configurarlo per 3 relè per abilitare la funzionalità di arresto. In caso di dubbi, è possibile controllare le connessioni ratgdo in Composer Pro per verificare se il relè "Stop Door" è disponibile.

Configurazione relè

• Impostato su Impulso
  • ratgdo utilizza impulsi momentanei per attivare l'apriporta del garage, in modo simile alla pressione di un pulsante a muro

Tempo di impulso

• Imposta tutti i tempi di impulso del relè su 500 (predefinito)
  • Questa è la durata per cui il relè sarà attivato

Inverti relè

• Imposta tutte le proprietà del relè invertito su NO (predefinito)

Contatta Debounce

• Imposta tutti i tempi di debounce dei contatti su 250 (predefinito)
  • Ciò aiuta a prevenire falsi sbattimenti dei sensori di stato della porta del garage

Inverti contatto

• Imposta tutte le proprietà di contatto invertito su NO (predefinito)

Example Proprietà
Per riferimento, ecco un esempioample delle proprietà del controller del relè in Composer Pro:

Collegamenti del controller del relè

Relè

• Aprire: Connettiti al relè "Open Door" del ratgdo
• Vicino: Connettiti al relè "Chiudi porta" del ratgdo
• Stop: Collegare al relè "Stop Door" del ratgdo, se disponibile

Sensori di contatto

• Contatto chiuso: Connettiti al contatto "Porta chiusa" del ratgdo
• Contatto aperto: Connettiti al contatto "Porta aperta" del ratgdo

Example Connessioni
Per riferimento, ecco un esempioampesempio di come dovrebbero apparire le connessioni in Composer Pro:

Programmazione
È possibile creare programmi in Control4 per:

• Aprire/chiudere la porta del garage in base agli eventi
• Monitorare lo stato della porta del garage
• Imposta notifiche per le modifiche dello stato della porta del garage
• Crea pulsanti personalizzati su touchscreen e telecomandi

Example: Creazione di un avviso "ancora aperto"

Utilizzando la proprietà "Tempo di apertura" dal driver del controller del relè:

1. Imposta il "Tempo di apertura" sulla durata desiderata (ad esempio, 10 minuti)
2. Crea una regola di programmazione che si attiva quando si verifica l'evento "Ancora aperto"
3. Aggiungi azioni per inviare notifiche o eseguire altre attività

Entità aggiuntive
A seconda del dispositivo ratgdo, del firmware e delle sue capacità, potrebbero esserci entità aggiuntive esposte dal driver ESPHome. Queste possono essere presenti come connessioni aggiuntive o variabili del driver.

Per maggiori informazioni su entità specifiche, fare riferimento alla documentazione di ratgdo: https://ratgdo.github.io/esphome-ratgdo/webui_documentation.html

Informazioni per gli sviluppatori
Copyright © 2025 Finite Labs LLC
Tutte le informazioni contenute nel presente documento sono e rimangono di proprietà di Finite Labs LLC e dei suoi eventuali fornitori. I concetti intellettuali e tecnici qui contenuti sono di proprietà di
Finite Labs LLC e i suoi fornitori possono essere coperti da brevetti statunitensi ed esteri, brevetti in corso di elaborazione e sono protetti da segreto commerciale o copyright. La diffusione di queste informazioni o la riproduzione di questo materiale è severamente vietata senza previa autorizzazione scritta da parte di Finite Labs LLC. Per informazioni aggiornate, visitare il sito https://drivercentral.io/platforms/control4-drivers/utility/esphome

Supporto
Se hai domande o problemi nell'integrazione di questo driver con Control4 o ESPHome, puoi contattarci all'indirizzo driver-support@finitelabs.com oppure chiamaci/mandaci un messaggio al numero +1 Numero di telefono: 949-371-5805.

Registro delle modifiche

versione 20250715 – 2025-07-14

• Fisso: Risolto il bug che impediva la scoperta delle entità durante la connessione

versione 20250714 – 2025-07-14

• Aggiunto: Aggiunto supporto per connessioni crittografate utilizzando la crittografia del dispositivo

versione 20250619 – 2025-06-19

• Aggiunto : Aggiunta documentazione specifica di ratgdo

versione 20250606 – 2025-06-06

• Aggiunto :Versione iniziale

Domande frequenti

Quali dispositivi sono compatibili con questo driver?

Questo driver è compatibile con qualsiasi dispositivo ESPHome, con test approfonditi effettuati su dispositivi ratgdo. Se lo provate su un altro dispositivo e funziona, vi preghiamo di comunicarcelo per una verifica.

Documenti / Risorse

ESPHome ESP8266 si connette fisicamente al tuo dispositivo [pdf] Guida utente ESP8266, ESP32, ESP8266 Connessione fisica al tuo dispositivo, ESP8266, Connessione fisica al tuo dispositivo, Connessione al tuo dispositivo, al tuo dispositivo, al tuo dispositivo

Riferimenti

• Manuale d'uso