ESPHome ESP8266 Conexión física a su dispositivo Guía del usuario

Comunicación de red local que no requiere servicios en la nube
Actualizaciones en tiempo real de todas las entidades compatibles expuestas por el
dispositivo

Admite conexiones cifradas mediante el cifrado del dispositivo.
llave
Soporte de programación de variables

Compatibilidad:

Dispositivos verificados:

Este controlador funcionará genéricamente con cualquier dispositivo ESPHome, pero
Hemos realizado pruebas exhaustivas con los siguientes dispositivos:

ratgdo – Guía de configuración

Instrucciones de uso del producto

Configuración del instalador

Solo se requiere una única instancia de controlador por dispositivo ESPHome.
Varias instancias de este controlador conectadas al mismo dispositivo
tener un comportamiento inesperado. Sin embargo, puede tener varias instancias
de este controlador conectado a diferentes dispositivos ESPHome.

Configuración de la nube de DriverCentral

Si ya tiene instalado el controlador DriverCentral Cloud en
su proyecto, puede continuar con la instalación del controlador.

Este controlador se basa en el controlador DriverCentral Cloud para administrar
Licencias y actualizaciones automáticas. Si eres nuevo en el uso
DriverCentral, puede consultar su documentación de Cloud Driver
para configurarlo.

Instalación del controlador

Descargue la última versión de control4-esphome.zip desde
Centro de conductores.

Extraiga e instale esphome.c4z, esphome_light.c4z y
Controladores esphome_lock.c4z.
Utilice la pestaña Buscar para encontrar el controlador ESPHome y agregarlo a
tu proyecto.

Seleccione el controlador recién agregado en la pestaña Diseño del sistema. Marque
Estado de la nube para obtener información de la licencia.
Actualice el estado de la licencia seleccionando DriverCentral Cloud
controlador y realizar la acción Comprobar controladores.

Configurar los ajustes del dispositivo con la conexión
información.
Espere hasta que el estado del controlador muestre Conectado.

Configuración del controlador

Propiedades del controlador:

Preguntas frecuentes

P: ¿Qué dispositivos son compatibles con este controlador?

A: Este controlador es compatible con cualquier dispositivo ESPHome, con
Se han realizado pruebas exhaustivas en dispositivos ratgdo. Si lo prueba en cualquier...
otro dispositivo y funciona, por favor infórmenos para verificarlo.

P: ¿Cómo puedo monitorear y controlar los dispositivos ESPHome?

A: Puede monitorear y controlar los dispositivos ESPHome a través de un web
navegador, Home Assistant u otras plataformas compatibles después
integrándolos en Control4 usando este controlador.

View Fullscreen

Encimaview
Integre dispositivos basados en ESPHome en Control4. ESPHome es un sistema de código abierto que transforma microcontroladores comunes, como ESP8266 y ESP32, en dispositivos domésticos inteligentes mediante una sencilla configuración YAML. Los dispositivos ESPHome se pueden configurar, supervisar y controlar mediante un web Navegador, Home Assistant u otras plataformas compatibles. Este controlador permite la monitorización y el control continuos de los dispositivos ESPHome directamente desde el sistema Control4.
Índice
Requisitos del sistema Características Compatibilidad
Dispositivos verificados compatibles Entidades ESPHome Instalador Configuración DriverCentral Configuración de la nube Instalación del controlador Configuración del controlador
Propiedades del controlador Configuración de la nube Configuración del controlador Configuración del dispositivo Información del dispositivo
Guías de configuración de acciones del controlador
Guía de configuración de ratgdo Información para desarrolladores Soporte Registro de cambios

Requisitos del sistema
Control4 OS 3.3+
Características
Comunicación de red local que no requiere servicios en la nube Actualizaciones en tiempo real de todas las entidades compatibles expuestas por el dispositivo Admite conexiones cifradas mediante la clave de cifrado del dispositivo Soporte de programación de variables
Compatibilidad
Dispositivos verificados
Este controlador funcionará genéricamente con cualquier dispositivo ESPHome, pero hemos realizado pruebas exhaustivas con los siguientes dispositivos:
ratgdo – Guía de configuración Si prueba este controlador en uno de los productos mencionados anteriormente y funciona, ¡avísenos!

Entidades ESPHome compatibles

Entidad Tipo Alarma Panel de control API Ruido Binario Sensor Bluetooth Proxy Botón Clima Cubierta Fecha y hora Fecha y hora Cámara Evento Ventilador Luz Bloqueo Reproductor multimedia Número Seleccionar Sensor Sirena Interruptor Texto Texto Sensor Actualizar Válvula Asistente de voz

Apoyado

Configuración del instalador
Solo se requiere una instancia de controlador por dispositivo ESPHome. Múltiples instancias de este
El controlador conectado al mismo dispositivo tendrá un comportamiento inesperado. Sin embargo, puede tener varias instancias de este controlador conectadas a diferentes dispositivos ESPHome.
Configuración de la nube de DriverCentral
Si ya tiene el controlador DriverCentral Cloud instalado en su proyecto, puede continuar con la instalación del controlador.
Este controlador se basa en el controlador en la nube de DriverCentral para gestionar las licencias y las actualizaciones automáticas. Si no está familiarizado con DriverCentral, puede consultar la documentación del controlador en la nube para configurarlo.
Instalación del controlador
La instalación y configuración del controlador son similares a las de la mayoría de los controladores basados en IP. A continuación, se detallan los pasos básicos para su comodidad.
1. Descargue la última versión de control4-esphome.zip desde DriverCentral.
2. Extraiga e instale los controladores esphome.c4z, esphome_light.c4z y esphome_lock.c4z.
3. Utilice la pestaña “Buscar” para encontrar el controlador “ESPHome” y agréguelo a su proyecto.
Ü Se requiere una única instancia de controlador por cada dispositivo ESPHome.

4. Seleccione el controlador recién añadido en la pestaña "Diseño del sistema". Verá que el estado de la nube refleja el estado de la licencia. Si ha adquirido una licencia, se mostrará "Licencia activada"; de lo contrario, "Prueba en ejecución" y el tiempo restante de la prueba.
5. Puede actualizar el estado de la licencia seleccionando el controlador “DriverCentral Cloud” en la pestaña “Diseño del sistema” y realizando la acción “Verificar controladores”.
6. Configure los ajustes del dispositivo con la información de conexión. 7. Después de unos instantes, el estado del controlador mostrará "Conectado". Si el controlador no...
Conéctese, configure la propiedad "Modo de registro" en "Imprimir" y restablezca el campo "Dirección IP" para reconectarse. Luego, consulte la ventana de salida de Lua para obtener más información. 8. Una vez conectado, el controlador creará automáticamente variables y conexiones para cada tipo de entidad compatible. 9. Para controlar luces o cerraduras, utilice la pestaña "Buscar" para encontrar el controlador "ESPHome Light" o "ESPHome Lock". Agregue una instancia de controlador para cada luz o cerradura expuesta en su proyecto. En la pestaña "Conexiones", seleccione el controlador "ESPHome" y vincule las luces o cerraduras a los controladores recién agregados.
Configuración del controlador
Propiedades del controlador
Configuración de la nube
Estado de la nube: Muestra el estado de la licencia en la nube de DriverCentral. Actualizaciones automáticas: Activa o desactiva las actualizaciones automáticas en la nube de DriverCentral.
Configuración del controlador
Estado del conductor (solo lectura)

Muestra el estado actual del controlador.
Versión del controlador (solo lectura) Muestra la versión actual del controlador.
Nivel de registro [Fatal | Error | Advertencia | Información | Depuración | Rastreo | Ultra] Establece el nivel de registro. El valor predeterminado es Información.
Modo de registro [Desactivado | Imprimir | Registro | Imprimir y registrar] Establece el modo de registro. El valor predeterminado es Desactivado.
Configuración del dispositivo
Dirección IP: Establece la dirección IP del dispositivo (p. ej., 192.168.1.30). Se permiten nombres de dominio siempre que el controlador pueda resolverlos a una dirección IP accesible. No se admite HTTPS.
Si está utilizando una dirección IP, debe asegurarse de que no cambie asignándole una dirección IP estática.
IP o creación de una reserva DHCP. Puerto: Establece el puerto del dispositivo. El puerto predeterminado para los dispositivos ESPHome es 6053. Modo de autenticación [Ninguno | Contraseña | Clave de cifrado]: Selecciona el método de autenticación para conectarse al dispositivo ESPHome.
Ninguno: No se requiere autenticación. Contraseña: Use una contraseña para la autenticación (ver más abajo). Clave de cifrado: Use una clave de cifrado para una comunicación segura (ver más abajo).
Contraseña: Solo se muestra si el modo de autenticación está configurado como Contraseña. Establece la contraseña del dispositivo. Debe coincidir con la contraseña configurada en el dispositivo ESPHome.
Clave de cifrado. Solo se muestra si el modo de autenticación está configurado como Clave de cifrado. Establece la clave de cifrado del dispositivo para una comunicación segura. Debe coincidir con la clave de cifrado configurada en el dispositivo ESPHome.
Información del dispositivo

Nombre (solo lectura) Muestra el nombre del dispositivo ESPHome conectado. Modelo (solo lectura) Muestra el modelo del dispositivo ESPHome conectado. Fabricante (solo lectura) Muestra el fabricante del dispositivo ESPHome conectado. Dirección MAC (solo lectura) Muestra la dirección MAC del dispositivo ESPHome conectado. Versión de firmware (solo lectura) Muestra la versión de firmware del dispositivo ESPHome conectado.
Acciones del conductor
Restablecer conexiones y variables
Esto restablecerá todos los enlaces de conexión y eliminará cualquier programación asociada con el
variables.
Restablezca las conexiones y variables del controlador. Esto es útil si cambia el dispositivo ESPHome conectado o si hay conexiones o variables obsoletas.

Guía de configuración de ratgdo
Esta guía proporciona instrucciones para configurar el controlador ESPHome para que funcione con dispositivos ratgdo para el control de puertas de garaje a través de relés en Control4 Composer Pro.
Agregar controlador de relé
Agregue el controlador de relé deseado a su proyecto Control4 en Composer Pro.
Propiedades del controlador de relé
El dispositivo ratgdo expone una entidad “Cover” en ESPHome, que se asigna a la funcionalidad del controlador de relé en Control4.
Número de relés
El dispositivo ratgdo utiliza una configuración multirelé para controlar la puerta del garaje. En Composer Pro, configure los relés de la siguiente manera:

Configurar con 2 relés (Abrir/Cerrar) o 3 relés (Abrir/Cerrar/Detener). El dispositivo ratgdo utiliza comandos separados para abrir y cerrar la puerta del garaje. Si el firmware de su ratgdo admite el comando "detener", configure 3 relés para habilitar la función de detención. Si no está seguro, puede revisar las conexiones de ratgdo en Composer Pro para ver si el relé "Detener puerta" está disponible.
Configuración de relé
Configurado en Pulso ratgdo usa pulsos momentáneos para activar el abridor de la puerta del garaje, similar a presionar un botón de pared.
Tiempo de pulso
Establezca todos los tiempos de pulso del relé en 500 (predeterminado). Esta es la duración durante la cual se activará el relé.
Relé de inversión
Establecer todas las propiedades del relé invertido en No (predeterminado)
Contacto Debounce
Establezca todos los tiempos de rebote de contacto en 250 (predeterminado). Esto ayuda a evitar el aleteo falso de los sensores de estado de la puerta del garaje.
Invertir contacto
Establezca todas las propiedades de contacto invertido en No (predeterminado)
Examplas Propiedades
Como referencia, aquí hay un ejemploampAlgunas de las propiedades del controlador de relé en Composer Pro:

Conexiones del controlador de relé
Relés
Abrir: Conectar al relé “Abrir puerta” del ratgdo Cerrar: Conectar al relé “Cerrar puerta” del ratgdo Detener: Conectar al relé “Detener puerta” del ratgdo, si está disponible
Sensores de contacto
Contacto cerrado: Conéctese al contacto “Puerta cerrada” del ratgdo Contacto abierto: Conéctese al contacto “Puerta abierta” del ratgdo
ExampConexiones

Como referencia, aquí hay un ejemploampEjemplo de cómo deberían verse las conexiones en Composer Pro:
Programación
Puede crear programación en Control4 para: Abrir/cerrar la puerta del garaje según eventos Monitorear el estado de la puerta del garaje Configurar notificaciones para cambios de estado de la puerta del garaje Crear botones personalizados en pantallas táctiles y controles remotos
Example: Crear una alerta de “Aún abierto”
Uso de la propiedad “Tiempo aún abierto” del controlador del relé: 1. Establezca el “Tiempo aún abierto” en la duración deseada (por ejemplo, 10 minutos) 2. Cree una regla de programación que se active cuando se dispare el evento “Aún abierto” 3. Agregue acciones para enviar notificaciones o realizar otras tareas
Entidades adicionales
Dependiendo de su dispositivo ratgdo, su firmware y sus capacidades, el controlador ESPHome puede exponer entidades adicionales. Estas pueden presentarse como conexiones adicionales o variables de controlador. Consulte la documentación de ratgdo para obtener más información sobre entidades específicas: https://ratgdo.github.io/esphome-ratgdo/webdocumentación_ui.html

Información del desarrollador
Copyright © 2025 Finite Labs LLC. Toda la información aquí contenida es y seguirá siendo propiedad de Finite Labs LLC y sus proveedores, si los hubiera. Los conceptos intelectuales y técnicos aquí contenidos son propiedad de Finite Labs LLC y sus proveedores, y pueden estar protegidos por patentes estadounidenses y extranjeras, patentes en trámite, y por secretos comerciales o derechos de autor. Queda estrictamente prohibida la difusión de esta información o la reproducción de este material sin la autorización previa por escrito de Finite Labs LLC. Para obtener la información más reciente, visite https://drivercentral.io/platforms/control4-drivers/utility/esphome
Apoyo
Si tiene alguna pregunta o problema al integrar este controlador con Control4 o ESPHome, puede contactarnos a driver-support@finitelabs.com o llamarnos/enviarnos un mensaje de texto al +1 949-371-5805.

Registro de cambios
v20250715 – 2025-07-14
Fijado
Se corrigió un error que causaba que las entidades no se descubrieran al conectarse
v20250714 – 2025-07-14
Agregado
Se agregó soporte para conexiones cifradas usando la clave de cifrado del dispositivo
v20250619 – 2025-06-19
Agregado
Se agregó documentación específica de ratgdo
v20250606 – 2025-06-06
Agregado
Lanzamiento inicial

Documentos / Recursos

ESPHome ESP8266 Conexión física a su dispositivo [pdf] Guía del usuario
ESP8266, ESP32, ESP8266 Conexión física a su dispositivo, ESP8266, Conexión física a su dispositivo, Conexión a su dispositivo, a su dispositivo, su dispositivo

Referencias

Manual de usuario