Guía do usuario de ESPHome ESP8266 Conexión física ao dispositivo

Só se require unha instancia de controlador por dispositivo ESPHome.
Varias instancias deste controlador conectadas ao mesmo dispositivo
ter un comportamento inesperado. Non obstante, podes ter varias instancias
deste controlador conectado a diferentes dispositivos ESPHome.

Configuración da nube de DriverCentral

Se xa tes instalado o controlador DriverCentral Cloud en
o teu proxecto, podes proceder á instalación do controlador.

Este controlador depende do controlador DriverCentral Cloud para xestionar
licenzas e actualizacións automáticas. Se es novo no uso
DriverCentral, podes consultar a súa documentación de Cloud Driver
para configuralo.

Instalación de controladores

Descarga o último ficheiro control4-esphome.zip desde
Central de condutores.

Extrae e instala os ficheiros esphome.c4z, esphome_light.c4z e
Controladores de esphome_lock.c4z.
Use a lapela Buscar para atopar o controlador ESPHome e engadilo a
o teu proxecto.

Seleccione o controlador recentemente engadido na lapela Deseño do sistema. Comprobe
o Estado da nube para obter información sobre a licenza.
Actualiza o estado da licenza seleccionando DriverCentral Cloud
condutor e realizando a acción Comprobar controladores.

Configurar os axustes do dispositivo coa conexión
información.
Agarde a que o Estado do controlador mostre Conectado.

Configuración do controlador

Propiedades do controlador:

FAQ

P: Que dispositivos son compatibles con este controlador?

R: Este controlador é compatible con calquera dispositivo ESPHome, con
probas exhaustivas realizadas en dispositivos ratgdo. Se o probas en calquera
outro dispositivo e funciona, infórmenos para a súa verificación.

P: Como podo monitorizar e controlar os dispositivos ESPHome?

R: Podes monitorizar e controlar os dispositivos ESPHome a través dun web
navegador, Home Assistant ou outras plataformas compatibles despois
integrándoos en Control4 usando este controlador.

View Fullscreen

Acabadoview
Integra dispositivos baseados en ESPHome en Control4. ESPHome é un sistema de código aberto que transforma microcontroladores comúns, como ESP8266 e ESP32, en dispositivos domésticos intelixentes mediante unha sinxela configuración YAML. Os dispositivos ESPHome pódense configurar, monitorizar e controlar mediante un web navegador, Home Assistant ou outras plataformas compatibles. Este controlador permite a monitorización e o control sen problemas dos dispositivos ESPHome directamente desde o seu sistema Control4.
Índice
Requisitos do sistema Características Compatibilidade
Dispositivos verificados compatibles Entidades ESPHome Configuración do instalador Configuración da nube de DriverCentral Instalación do controlador Configuración do controlador
Propiedades do controlador Configuración da nube Configuración do controlador Configuración do dispositivo Información do dispositivo
Guías de configuración de accións de controladores
Guía de configuración de ratgdo Información para desenvolvedores Asistencia Rexistro de cambios

Requisitos do sistema
Control4 OS 3.3+
Características
Comunicación de rede local que non require servizos na nube Actualizacións en tempo real de todas as entidades compatibles expostas polo dispositivo Admite conexións cifradas mediante a clave de cifrado do dispositivo Compatibilidade con programación variable
Compatibilidade
Dispositivos verificados
Este controlador funcionará xenericamente con calquera dispositivo ESPHome, pero realizámolo amplamente cos seguintes dispositivos:
ratgdo – Guía de configuración Se probas este controlador nun produto da lista anterior e funciona, avísanos!

Entidades ESPHome compatibles

Tipo de entidade Panel de control de alarma API Ruído Sensor binario Bluetooth Proxy Botón Clima Cuberta Data e hora Data e hora Cámara Evento Ventilador Luz Bloqueo Reprodutor multimedia Número Selección de sensor Sirena Interruptor Texto Sensor de texto Actualización Válvula Asistente de voz

Soportado

Configuración do instalador
Só se require unha única instancia de controlador por dispositivo ESPHome. Instancias múltiples deste
Un controlador conectado ao mesmo dispositivo terá un comportamento inesperado. Non obstante, pode ter varias instancias deste controlador conectadas a diferentes dispositivos ESPHome.
Configuración da nube de DriverCentral
Se xa tes o controlador DriverCentral Cloud instalado no teu proxecto, podes continuar coa instalación do controlador.
Este controlador baséase no controlador DriverCentral Cloud para xestionar as licenzas e as actualizacións automáticas. Se es novo no uso de DriverCentral, podes consultar a documentación de Driver Cloud para configuralo.
Instalación de controladores
A instalación e configuración do controlador son semellantes á maioría dos outros controladores baseados en IP. A continuación, móstranse os pasos básicos para a súa comodidade.
1. Descarga a última versión do ficheiro control4-esphome.zip de DriverCentral.
2. Extraia e instale os controladores esphome.c4z, esphome_light.c4z e esphome_lock.c4z.
3. Usa a lapela “Buscar” para atopar o controlador “ESPHome” e engadilo ao teu proxecto.
Ü Requírese unha única instancia de controlador por dispositivo ESPHome.

4. Selecciona o controlador engadido recentemente na lapela "Deseño do sistema". Observarás que o Estado da nube reflicte o estado da licenza. Se compraches unha licenza, mostrarase Licenza activada; en caso contrario, Proba en execución e a duración restante da proba.
5. Podes actualizar o estado da licenza seleccionando o controlador “DriverCentral Cloud” na lapela “Deseño do sistema” e realizando a acción “Comprobar controladores”.
6. Configura a Configuración do Dispositivo coa información de conexión. 7. Despois duns intres, o Estado do Controlador mostrará Conectado. Se o controlador falla
conectar, defina a propiedade Modo de rexistro en Imprimir e restableza o campo Enderezo IP para volver conectar. Despois, consulte a xanela de saída lua para obter máis información. 8. Unha vez conectado, o controlador creará automaticamente variables e conexións para cada tipo de entidade compatible. 9. Para controlar as luces e/ou os peches, use a lapela "Buscar" para atopar o controlador "ESPHome Light" e/ou "ESPHome Lock". Engada unha instancia de controlador para cada entidade de luz ou peche exposta no seu proxecto. Na lapela "Conexións", seleccione o controlador "ESPHome" e vincule as entidades de luz ou peche aos controladores recentemente engadidos.
Configuración do controlador
Propiedades do controlador
Configuración da nube
Estado da nube Mostra o estado da licenza na nube de DriverCentral. Actualizacións automáticas Activa/desactiva as actualizacións automáticas na nube de DriverCentral.
Configuración do controlador
Estado do condutor (só lectura)

Mostra o estado actual do controlador.
Versión do controlador (só lectura) Mostra a versión actual do controlador.
Nivel de rexistro [ Fatal | Erro | Aviso | Información | Depuración | Rastrexo | Ultra ] Define o nivel de rexistro. O valor predeterminado é Información.
Modo de rexistro [ Desactivado | Imprimir | Rexistro | Imprimir e rexistrar ] Define o modo de rexistro. O valor predeterminado é Desactivado.
Configuración do dispositivo
Enderezo IP Define o enderezo IP do dispositivo (por exemplo, 192.168.1.30). Os nomes de dominio están permitidos sempre que o controlador os poida resolver nun enderezo IP accesible. Non se admite HTTPS.
Se estás a usar un enderezo IP, debes asegurarte de que non cambiará asignándolle un enderezo estático.
IP ou creando unha reserva DHCP. Porto Define o porto do dispositivo. O porto predeterminado para os dispositivos ESPHome é 6053. Modo de autenticación [ Ningún | Contrasinal | Clave de cifrado ] Selecciona o método de autenticación para conectarse ao dispositivo ESPHome.
Ningún: Non se require autenticación. Contrasinal: Use un contrasinal para a autenticación (consulte máis abaixo). Clave de cifrado: Use unha clave de cifrado para unha comunicación segura (consulte máis abaixo).
Contrasinal Só se mostra se o Modo de autenticación está definido como Contrasinal. Define o contrasinal do dispositivo. Debe coincidir co contrasinal configurado no dispositivo ESPHome.
Clave de cifrado Móstrase só se o Modo de autenticación está definido como Clave de cifrado. Define a clave de cifrado do dispositivo para unha comunicación segura. Debe coincidir coa clave de cifrado configurada no dispositivo ESPHome.
Información do dispositivo

Nome (só lectura) Mostra o nome do dispositivo ESPHome conectado. Modelo (só lectura) Mostra o modelo do dispositivo ESPHome conectado. Fabricante (só lectura) Mostra o fabricante do dispositivo ESPHome conectado. Enderezo MAC (só lectura) Mostra o enderezo MAC do dispositivo ESPHome conectado. Versión de firmware (só lectura) Mostra a versión de firmware do dispositivo ESPHome conectado.
Accións do condutor
Restablecer conexións e variables
Isto restablecerá todas as conexións e eliminará calquera programación asociada co
variables.
Reinicie as conexións e variables do controlador. Isto é útil se cambia o dispositivo ESPHome conectado ou se hai conexións ou variables obsoletas.

Guía de configuración de ratgdo
Esta guía ofrece instrucións para configurar o controlador ESPHome para que funcione con dispositivos ratgdo para o control de portas de garaxe mediante relés en Control4 Composer Pro.
Engadir controlador de relé
Engade o controlador de relé desexado ao teu proxecto Control4 en Composer Pro.
Propiedades do controlador de relés
O dispositivo ratgdo expón unha entidade "Cuberta" en ESPHome, que se mapea á funcionalidade do controlador de relés en Control4.
Número de relés
O dispositivo ratgdo usa unha configuración de varios relés para controlar a porta da garaxe. En Composer Pro, debes configurar os axustes do relé do seguinte xeito:

Definir en 2 relés (Abrir/Pechar) ou 3 relés (Abrir/Pechar/Parar). O dispositivo ratgdo usa comandos separados para abrir e pechar a porta da garaxe. Se o firmware ratgdo admite o comando "parar", configúreo para 3 relés para activar a funcionalidade de parada. Se non está seguro, pode consultar as conexións ratgdo en Composer Pro para ver se o relé "Parar porta" está dispoñible.
Configuración de relés
Definido como Pulso, ratgdo usa pulsos momentáneos para activar o abridor da porta da garaxe, de xeito similar a premer un botón na parede.
Tempo de pulso
Axusta todos os tempos de pulso do relé a 500 (predeterminado). Esta é a duración que o relé estará activado.
Relé inversor
Definir todas as propiedades do relé inversor en Non (predeterminado)
Contactar con Debounce
Axusta todos os tempos de eliminación de rebotes de contacto a 250 (predeterminado). Isto axuda a evitar o falso aleteo dos sensores de estado da porta da garaxe.
Inverter contacto
Definir todas as propiedades de contacto inverso en Non (predeterminado)
ExampPropiedades
Como referencia, aquí tes un ex.ampunha das propiedades do controlador de relés en Composer Pro:

Conexións do controlador de relés
Relés
Abrir: Conectar ao relé "Abrir porta" do ratgdo Pechar: Conectar ao relé "Pechar porta" do ratgdo Parar: Conectar ao relé "Parar porta" do ratgdo, se está dispoñible
Sensores de contacto
Contacto pechado: Conéctese ao contacto "Porta pechada" do ratgdo. Contacto aberto: Conéctese ao contacto "Porta aberta" do ratgdo.
Example Conexións

Como referencia, aquí tes un ex.ampexemplo de como deberían ser as conexións en Composer Pro:
Programación
Podes crear programación en Control4 para: Abrir/pechar a porta da garaxe en función de eventos Monitorizar o estado da porta da garaxe Configurar notificacións para cambios de estado da porta da garaxe Crear botóns personalizados en pantallas táctiles e mandos a distancia
Example: Creando unha alerta de "Aínda aberta"
Usando a propiedade "Tempo de apertura inmóbil" do controlador do relé: 1. Define o "Tempo de apertura inmóbil" na duración desexada (por exemplo, 10 minutos) 2. Crea unha regra de programación que se active cando se active o evento "Aberto inmóbil" 3. Engade accións para enviar notificacións ou realizar outras tarefas
Entidades adicionais
Dependendo do teu dispositivo ratgdo, firmware e as súas capacidades, pode haber entidades adicionais expostas polo controlador ESPHome. Estas poden vir como conexións adicionais ou variables de controlador. Consulta a documentación de ratgdo para obter máis información sobre entidades específicas: https://ratgdo.github.io/esphome-ratgdo/webdocumentación_da_usuario.html

Información para desenvolvedores
Copyright © 2025 Finite Labs LLC Toda a información contida neste documento é e segue sendo propiedade de Finite Labs LLC e dos seus provedores, se os houber. Os conceptos intelectuais e técnicos contidos neste documento son propiedade de Finite Labs LLC e dos seus provedores e poden estar cubertos por patentes estadounidenses e estranxeiras, patentes en proceso e están protexidos por segredos comerciais ou leis de dereitos de autor. A difusión desta información ou a reprodución deste material está estritamente prohibida a menos que se obteña a autorización previa por escrito de Finite Labs LLC. Para obter a información máis recente, visite https://drivercentral.io/platforms/control4-drivers/utility/esphome
Apoio
Se tes algunha pregunta ou problema para integrar este controlador con Control4 ou ESPHome, podes contactar connosco en driver-support@finitelabs.com ou chamarnos/mensaxernos ao +1 949-371-5805.

Rexistro de cambios
v20250715 – 14-07-2025
Fixo
Corrixiuse un erro que provocaba que as entidades non se descubrisen ao conectarse
v20250714 – 14-07-2025
Engadido
Engadiuse compatibilidade con conexións cifradas mediante a clave de cifrado do dispositivo
v20250619 – 19-06-2025
Engadido
Engadida documentación específica de ratgdo
v20250606 – 06-06-2025
Engadido
Lanzamento inicial

Documentos/Recursos

ESPHome ESP8266 Conexión física ao teu dispositivo [pdfGuía do usuario
ESP8266, ESP32, ESP8266 Conexión fisica ao teu dispositivo, ESP8266, Conexión fisica ao teu dispositivo, Conexión ao teu dispositivo, ao teu dispositivo, o teu dispositivo

Referencias

Manual de usuario

Guía do usuario de ESPHome ESP8266 Conexión física ao dispositivo

Conexión física do ESP8266 ao teu dispositivo

Especificacións

Instrucións de uso do produto

Configuración do instalador