ESPHome ESP8266 Conexión física ao teu dispositivo

Especificacións

• Requisitos do sistema: Control4 OS 3.3+

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.

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 usando a clave de cifrado do dispositivo
• Soporte de 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

Configuración do instalador

Só se require unha única instancia de controlador por dispositivo ESPHome. Se conecta varias instancias deste controlador ao mesmo dispositivo, o comportamento será 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 de nube DriverCentral 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 o seu Documentación do controlador de nube 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óstrase un esquema dos pasos básicos para a súa comodidade.

1. Descarga a última control4-esphome.zip dende Central de condutores.
2. Extraer e instalar o esphome.c4z, esphome_light.c4z, e esphome_lock.c4z controladores.
3. Usa a lapela "Buscar" para atopar o controlador "ESPHome" e engadilo ao teu proxecto.
4. Selecciona o controlador engadido recentemente na lapela "Deseño do sistema". Notarás que o Estado da nube reflicte o estado da licenza. Se compraches unha licenza, mostrarase "Licenza activada"; se non, "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 o Configuración do dispositivo coa información de conexión.
7. Despois duns intres, o estado do controlador mostrará "Conectado". Se o controlador non se conecta, define a propiedade Modo de rexistro en "Imprimir" e restablece o campo Enderezo IP para volver conectar. Despois, consulta a xanela de saída de 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 luces e/ou fechaduras, usa a lapela "Buscar" para atopar o controlador "ESPHome Light" e/ou "ESPHome Lock". Engade unha instancia de controlador para cada entidade de luz ou fechadura exposta no teu proxecto. Na lapela "Conexións", selecciona o controlador "ESPHome" e vincula as entidades de luz ou fechadura 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 predeterminado é Información.
• Modo de rexistro [ Desactivado | Imprimir | Rexistro | Imprimir e rexistrar ] Define o modo de rexistro. O 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.

Nota: Se estás a usar un enderezo IP, debes asegurarte de que non cambia asignando un IP estático 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: Usa un contrasinal para a autenticación (ver máis abaixo).

Clave de cifrado: Usa unha clave de cifrado para unha comunicación segura (consulta a continuación).

• 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
  Só se mostra 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 do firmware do dispositivo ESPHome conectado.

Accións do condutor

Restablecer conexións e variables

Aviso: Isto restablecerá todas as ligazóns de conexión e eliminará calquera programación asociada ás 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:

• Axustar a 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 teu firmware ratgdo admite o comando "stop", configura 3 relés para activar a funcionalidade de parada. Se non estás seguro, podes consultar as conexións de ratgdo en Composer Pro para ver se o relé "Stop Door" está dispoñible.

Configuración de relés

• Establecer en Pulso
  • ratgdo usa pulsos momentáneos para activar o abridor da porta da garaxe, de xeito semellante a premer un botón na parede

Tempo de pulso

• Axustar todos os tempos de pulso do relé a 500 (predeterminado)
  • Esta é a duración da activación do relé

Relé inversor

• Definir todas as propiedades do relé inversor como Non (predeterminado)

Contactar con Debounce

• Definir todos os tempos de eliminación de rebote de contacto en 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 a 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

• Aberto: Conectar ao relé de "Porta aberta" do ratgdo
• Pechar: Conectar ao relé de "Pechar porta" do ratgdo
• Parar: Conectar ao relé "Parar porta" do ratgdo, se está dispoñible

Sensores de contacto

• Contacto pechado: Conectar co contacto "Porta pechada" do ratgdo
• Contacto aberto: Conectar co contacto de "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
• Monitorear o estado da porta da garaxe
• Configurar notificacións para cambios de estado na porta da garaxe
• Crea botóns personalizados en pantallas táctiles e mandos a distancia

Example: Creando unha alerta aínda aberta

Usando a propiedade "Tempo de apertura inmóbil" do controlador do controlador de relé:

1. Axusta o "Tempo de apertura" á duración desexada (por exemplo, 10 minutos)
2. Crear unha regra de programación que se active cando se active o evento "Aínda aberto"
3. Engadir 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/webui_documentation.html

Información para desenvolvedores
Dereitos reservados © 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 os seus provedores poden estar amparados 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 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 dúbida ou problema para integrar este controlador con Control4 ou ESPHome, podes contactar connosco en soporte-para-condutores@finitelabs.com ou chámanos/envíanos unha mensaxe de texto ao +1 949-371-5805.

Rexistro de cambios

v20250715 – 14-07-2025

• Fixado: 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 o cifrado do dispositivo

v20250619 – 19-06-2025

• Engadido Engadida documentación específica de ratgdo

v20250606 – 06-06-2025

• Engadido Versión inicial

FAQ

Que dispositivos son compatibles con este controlador?

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

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