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

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.

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, ¡infórmenos!

Entidades ESPHome compatibles

Configuración del instalador

Solo se requiere una instancia de controlador por dispositivo ESPHome. Si se conectan varias instancias de este controlador al mismo dispositivo, se producirá un comportamiento inesperado. Sin embargo, es posible tener varias instancias de este controlador conectadas a diferentes dispositivos ESPHome.

Configuración de la nube de DriverCentral
Si ya tienes el Controlador de nube de DriverCentral Una vez instalado en su proyecto, puede continuar con la instalación del controlador.

Este controlador se basa en el controlador DriverCentral Cloud para gestionar las licencias y las actualizaciones automáticas. Si no está familiarizado con DriverCentral, puede consultar su... Documentación del controlador de 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.

Descargue la última versión control4-esphome.zip de Centro de conductores.
Extraer e instalar el esphome.c4z, esphome_light.c4z, y esphome_lock.c4z Conductores.
Utilice la pestaña “Buscar” para encontrar el controlador “ESPHome” y agregarlo a su proyecto.

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, mostrará "Licencia activada"; de lo contrario, "Prueba en ejecución" y el tiempo restante de la prueba.
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”.

Configurar el Configuración del dispositivo con la información de conexión.
Tras unos instantes, el estado del controlador mostrará "Conectado". Si el controlador no se conecta, configure la propiedad "Modo de registro" en "Imprimir" y restablezca el campo "Dirección IP" para reconectarse. A continuación, consulte la ventana de salida de Lua para obtener más información.
Una vez conectado, el controlador creará automáticamente variables y conexiones para cada tipo de entidad compatible.

Para controlar luces o cerraduras, use 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/desactiva las actualizaciones automáticas de 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 Apagado.

Configuración del dispositivo

Dirección IP
Establece la dirección IP del dispositivo (por ejemplo 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.

Nota: Si está utilizando una dirección IP, debe asegurarse de que no cambie asignando una IP estática o creando 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: Utilice una contraseña para la autenticación (ver a continuación).

Clave de cifrado: Utilice una clave de cifrado para una comunicación segura (ver a continuación).

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

Advertencia: Esto restablecerá todos los enlaces de conexión y eliminará cualquier programación asociada con las 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 en 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 "stop", configure 3 relés para habilitar la función de parada. Si no está seguro, puede revisar las conexiones de ratgdo en Composer Pro para comprobar si el relé "Stop Door" está disponible.

Configuración de relé

Empezar a Legumbres
- ratgdo utiliza 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 (por defecto)
- Esta es la duración que estará activado el relé.

Relé de inversión

Establecer todas las propiedades del relé invertido en No (por defecto)

Contacto Debounce

Establecer todos los tiempos de rebote de contacto en 250 (por defecto)
- Esto ayuda a evitar el aleteo falso de los sensores de estado de la puerta del garaje.

Invertir contacto

Establecer todas las propiedades de contacto invertido en No (por defecto)

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

Abierto: Conectarse al relé “Puerta Abierta” del ratgdo
Cerca: Conectarse al relé “Cerrar puerta” del ratgdo
Stop: Conéctese 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 en función de eventos
Supervisar el estado de la puerta del garaje
Configurar notificaciones para cambios de estado de la puerta del garaje
Crea botones personalizados en pantallas táctiles y controles remotos

Example: Creando una alerta aún abierta

Uso de la propiedad “Tiempo de permanencia abierta” del controlador del relé:

Establezca el “Tiempo de permanencia abierta” en la duración deseada (por ejemplo, 10 minutos)
Cree una regla de programación que se active cuando se active el evento "Aún abierto"
Agregar acciones para enviar notificaciones o realizar otras tareas

Entidades adicionales
Dependiendo de su dispositivo ratgdo, su firmware y sus capacidades, el controlador ESPHome podría exponer entidades adicionales. Estas pueden presentarse como conexiones adicionales o variables del controlador.

Consulte la documentación de ratgdo para obtener más información sobre entidades específicas: https://ratgdo.github.io/esphome-ratgdo/webui_documentation.html

Información del desarrollador
Derechos de autor © 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 pueden estar cubiertos por patentes estadounidenses y extranjeras, patentes en trámite y protegidos por secretos comerciales o derechos de autor. La difusión de esta información o la reproducción de este material está estrictamente prohibida 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 en driver-support@finitelabs.com o llámanos/envíanos 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 mediante el cifrado del dispositivo.

v20250619 – 2025-06-19

Agregado :Se agregó documentación específica de ratgdo

v20250606 – 2025-06-06

Agregado :Lanzamiento inicial

Preguntas frecuentes

¿Qué dispositivos son compatibles con este controlador?

Este controlador es compatible con cualquier dispositivo ESPHome, tras exhaustivas pruebas en dispositivos ratgdo. Si lo prueba en otro dispositivo y funciona, por favor, infórmenos para su verificación.

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

ESPHome ESP8266 Conexión física a su dispositivo

Presupuesto

Encimaview