ESPHome ESP8266 Connexió física al vostre dispositiu

Especificacions

• Requisits del sistema: Control4 OS 3.3+

Acabatview

Integra dispositius basats en ESPHome a Control4. ESPHome és un sistema de codi obert que transforma microcontroladors comuns, com ESP8266 i ESP32, en dispositius domèstics intel·ligents mitjançant una configuració YAML senzilla. Els dispositius ESPHome es poden configurar, monitoritzar i controlar mitjançant un web navegador, Home Assistant o altres plataformes compatibles. Aquest controlador permet la supervisió i el control sense problemes dels dispositius ESPHome directament des del vostre sistema Control4.

Requisits del sistema

• Control4 OS 3.3+

Característiques

• Comunicació de xarxa local que no requereix serveis al núvol
• Actualitzacions en temps real de totes les entitats compatibles exposades pel dispositiu
• Admet connexions xifrades mitjançant la clau de xifratge del dispositiu
• Suport de programació variable

Compatibilitat

Dispositius verificats
Aquest controlador funcionarà genèricament amb qualsevol dispositiu ESPHome, però ho hem provat àmpliament amb els dispositius següents:

• ratgdo – Guia de configuració

Si proveu aquest controlador en un producte de la llista anterior i funciona, feu-nos-ho saber!

Entitats ESPHome compatibles

Configuració de l’instal·lador

Només es requereix una única instància de controlador per dispositiu ESPHome. Diverses instàncies d'aquest controlador connectades al mateix dispositiu tindran un comportament inesperat. Tanmateix, podeu tenir diverses instàncies d'aquest controlador connectades a diferents dispositius ESPHome.

Configuració del núvol de DriverCentral
Si ja teniu el Controlador de núvol DriverCentral instal·lat al vostre projecte, podeu continuar amb la instal·lació del controlador.

Aquest controlador es basa en el controlador DriverCentral Cloud per gestionar les llicències i les actualitzacions automàtiques. Si sou nous en l'ús de DriverCentral, podeu consultar el seu Documentació del controlador de núvol per configurar-ho.

Instal·lació del controlador

La instal·lació i configuració del controlador són similars a la majoria dels altres controladors basats en IP. A continuació, es mostra un esquema dels passos bàsics per a la vostra comoditat.

1. Descarrega l'última control4-esphome.zip des de DriverCentral.
2. Extreu i instal·la el esphome.c4z, esphome_light.c4z, i esphome_lock.c4z conductors.
3. Feu servir la pestanya "Cerca" per trobar el controlador "ESPHome" i afegir-lo al vostre projecte.
4. Seleccioneu el controlador que acabeu d'afegir a la pestanya "Disseny del sistema". Veureu que l'estat del núvol reflecteix l'estat de la llicència. Si heu comprat una llicència, mostrarà "Llicència activada", en cas contrari "Prova en execució" i la durada restant de la prova.
5. Podeu actualitzar l'estat de la llicència seleccionant el controlador "DriverCentral Cloud" a la pestanya "Disseny del sistema" i realitzant l'acció "Comprova els controladors".
6. Configura el Configuració del dispositiu amb la informació de connexió.
7. Després d'uns instants, l'estat del controlador mostrarà "Connectat". Si el controlador no es connecta, definiu la propietat Mode de registre a "Imprimir" i reinicieu el camp Adreça IP per tornar a connectar-se. A continuació, consulteu la finestra de sortida de Lua per obtenir més informació.
8. Un cop connectat, el controlador crearà automàticament variables i connexions per a cada tipus d'entitat compatible.
9. Per controlar llums i/o panys, utilitzeu la pestanya "Cerca" per trobar el controlador "ESPHome Light" i/o "ESPHome Lock". Afegiu una instància de controlador per a cada entitat de llum o pany exposada al vostre projecte. A la pestanya "Connexions", seleccioneu el controlador "ESPHome" i vinculeu les entitats de llum o pany als controladors recentment afegits.

Configuració del controlador

Propietats del controlador

Configuració del núvol

• Estat del núvol
  Mostra l'estat de la llicència al núvol de DriverCentral.
• Actualitzacions automàtiques
  Activa/desactiva les actualitzacions automàtiques al núvol de DriverCentral.

Configuració del controlador

• Estat del conductor (només lectura)
  Mostra l'estat actual del controlador.
• Versió del controlador (només lectura)
  Mostra la versió actual del controlador.
• Nivell de registre [ Fatal | Error | Avís | Informació | Depuració | Traça | Ultra ] Estableix el nivell de registre. El valor per defecte és Informació.
• Mode de registre [ Desactivat | Imprimeix | Registre | Imprimeix i registra ] Estableix el mode de registre. El valor per defecte és Apagat.

Configuració del dispositiu

Adreça IP
Estableix l'adreça IP del dispositiu (per exemple, 192.168.1.30). Els noms de domini estan permesos sempre que el controlador els pugui resoldre a una adreça IP accessible. No s'admet HTTPS.

Nota: Si feu servir una adreça IP, heu d'assegurar-vos que no canviï assignant-hi una IP estàtica o creant una reserva DHCP.

Port
Estableix el port del dispositiu. El port per defecte per als dispositius ESPHome és 6053.

• Mode d'autenticació [ Cap | Contrasenya | Clau de xifratge ]
• Selecciona el mètode d'autenticació per connectar-se al dispositiu ESPHome.

Cap: No cal autenticació.

Contrasenya: Feu servir una contrasenya per a l'autenticació (vegeu més avall).

Clau de xifratge: Feu servir una clau de xifratge per a una comunicació segura (vegeu més avall).

• Contrasenya
  Només es mostra si el Mode d'autenticació està definit com a Contrasenya. Estableix la contrasenya del dispositiu. Ha de coincidir amb la contrasenya configurada al dispositiu ESPHome.
• Clau de xifratge
  Només es mostra si el Mode d'autenticació està definit com a Clau de xifratge. Estableix la clau de xifratge del dispositiu per a una comunicació segura. Aquesta ha de coincidir amb la clau de xifratge configurada al dispositiu ESPHome.

Informació del dispositiu

• Nom (només lectura)
  Mostra el nom del dispositiu ESPHome connectat.
• Model (només lectura)
  Mostra el model del dispositiu ESPHome connectat.
• Fabricant (només lectura)
  Mostra el fabricant del dispositiu ESPHome connectat.
• Adreça MAC (només lectura)
  Mostra l'adreça MAC del dispositiu ESPHome connectat.
• Versió de firmware (només lectura)
  Mostra la versió de firmware del dispositiu ESPHome connectat.

Accions del conductor

Restableix connexions i variables

Avís: Això restablirà tots els enllaços de connexió i eliminarà qualsevol programació associada a les variables.

Restableix les connexions i variables del controlador. Això és útil si canvies el dispositiu ESPHome connectat o si hi ha connexions o variables obsoletes.

Guia de configuració de ratgdo

Aquesta guia proporciona instruccions per configurar el controlador ESPHome perquè funcioni amb dispositius ratgdo per al control de portes de garatge mitjançant relés a Control4 Composer Pro.

Afegeix un controlador de controlador de relés
Afegiu el controlador de relés desitjat al vostre projecte Control4 a Composer Pro.

Propietats del controlador de relés
El dispositiu ratgdo exposa una entitat "Cover" a ESPHome, que es correspon amb la funcionalitat del controlador de relés a Control4.

Nombre de relés
El dispositiu ratgdo utilitza una configuració multirelé per controlar la porta del garatge. A Composer Pro, heu de configurar els paràmetres del relé de la manera següent:

• Configura 2 relés (Obrir/Tancament) o 3 relés (Obrir/Tancament/Aturada)
  • El dispositiu ratgdo utilitza ordres separades per obrir i tancar la porta del garatge.
  • Si el vostre firmware ratgdo admet l'ordre "stop", configureu 3 relés per habilitar la funcionalitat d'aturada. Si no esteu segurs, podeu consultar les connexions ratgdo a Composer Pro per veure si el relé "Stop Door" està disponible.

Configuració del relé

• Estableix a Pols
  • ratgdo utilitza impulsos momentanis per activar l'obridor de la porta del garatge, de manera similar a prémer un botó de paret

Temps de pols

• Estableix tots els temps d'impuls del relé a 500 (per defecte)
  • Aquest és el temps que durarà l'activació del relé

Relé inversor

• Estableix totes les propietats del relé inversor a No (per defecte)

Contacta amb Debounce

• Estableix tots els temps d'antirebot de contacte a 250 (per defecte)
  • Això ajuda a evitar el fals aleteig dels sensors d'estat de la porta del garatge

Inverteix el contacte

• Estableix totes les propietats del contacte invertit a No (per defecte)

Examples Propietats
Com a referència, aquí teniu un ex.ampde les propietats del controlador de relés a Composer Pro:

Connexions del controlador de relés

Relleus

• Obert: Connecteu-vos al relé "Porta oberta" del ratgdo
• Tancar: Connecteu-vos al relé "Tanca la porta" del ratgdo
• Atura: Connecteu-vos al relé "Stop Door" del ratgdo, si n'hi ha.

Sensors de contacte

• Contacte tancat: Connecteu-vos al contacte "Porta tancada" del ratgdo
• Contacte obert: Connecta't al contacte "Porta oberta" del ratgdo

Examples connexions
Com a referència, aquí teniu un ex.ampexemple de com haurien de ser les connexions a Composer Pro:

Programació
Podeu crear programació a Control4 per:

• Obrir/tancar la porta del garatge en funció d'esdeveniments
• Superviseu l'estat de la porta del garatge
• Configura notificacions per a canvis d'estat de la porta del garatge
• Crea botons personalitzats en pantalles tàctils i comandaments a distància

Example: Creació d'una alerta encara oberta

Usant la propietat "Still Open Time" del controlador del controlador de relés:

1. Ajusteu el "Temps d'obertura" a la durada desitjada (per exemple, 10 minuts)
2. Crea una regla de programació que s'activi quan s'activa l'esdeveniment "Encara obert".
3. Afegeix accions per enviar notificacions o realitzar altres tasques

Entitats addicionals
Depenent del dispositiu ratgdo, el firmware i les seves capacitats, el controlador ESPHome pot exposar entitats addicionals. Aquestes poden venir com a connexions addicionals o variables de controlador.

Si voleu més informació sobre entitats específiques, consulteu la documentació de ratgdo: https://ratgdo.github.io/esphome-ratgdo/webui_documentation.html

Informació del desenvolupador
Drets d'autor © 2025 Finite Labs LLC
Tota la informació que s'hi troba és i continua sent propietat de Finite Labs LLC i dels seus proveïdors, si n'hi ha. Els conceptes intel·lectuals i tècnics que s'hi troben són propietat de
Finite Labs LLC i els seus proveïdors poden estar coberts per patents dels EUA i estrangeres, patents en procés i estan protegits per secrets comercials o lleis de drets d'autor. La difusió d'aquesta informació o la reproducció d'aquest material està estrictament prohibida sense permís previ per escrit de Finite Labs LLC. Per obtenir la informació més recent, visiteu https://drivercentral.io/platforms/control4-drivers/utility/esphome

Suport
Si teniu cap pregunta o problema per integrar aquest controlador amb Control4 o ESPHome, podeu contactar amb nosaltres a driver-support@finitelabs.com o truca'ns/envia'ns un missatge de text al +1 949-371-5805.

Registre de canvis

v20250715 – 14-07-2025

• Corregit: S'ha corregit un error que impedia que les entitats es descobrissin en connectar-se.

v20250714 – 14-07-2025

• Afegit: S'ha afegit compatibilitat amb connexions xifrades mitjançant el xifratge del dispositiu.

v20250619 – 19-06-2025

• Afegit : Afegida documentació específica de ratgdo

v20250606 – 06-06-2025

• Afegit Llançament inicial

Preguntes freqüents

Quins dispositius són compatibles amb aquest controlador?

Aquest controlador és compatible amb qualsevol dispositiu ESPHome, amb proves exhaustives realitzades en dispositius ratgdo. Si el proveu en qualsevol altre dispositiu i funciona, informeu-nos-en per verificar-ho.

Documents/Recursos

ESPHome ESP8266 Connexió física al vostre dispositiu [pdfGuia de l'usuari ESP8266, ESP32, ESP8266 Connexió física al vostre dispositiu, ESP8266, Connexió física al vostre dispositiu, Connexió al vostre dispositiu, al vostre dispositiu, el vostre dispositiu

Referències

• Manual d'usuari