Integración externa - Busch & Jäger free@home

Hola a todos,

Quiero presentarles mi nueva integración externa free@home para Gladys Assistant.

Con esto, se pueden integrar dispositivos del sistema free@home de Busch-Jaeger / ABB en Gladys: encender y apagar luces, controlar persianas y usar los pulsadores de pared existentes como desencadenantes para escenas de Gladys.

La primera versión estable 1.0.0 ha sido publicada. La comunicación con el System Access Point se realiza exclusivamente de forma local, sin conexión a la nube y sin XMPP.

GitHub e instalación:

¿Qué puede hacer la integración?

Luz y salidas de conmutación

  • Encender y apagar luces.
  • Ajustar luces regulables a un nivel de brillo específico.
  • Encender y apagar otros consumidores en actuadores de conmutación compatibles — no tiene que estar necesariamente conectada una lámpara.
  • Mostrar retroalimentación de estado de free@home en Gladys.

Persianas y celosías

  • Mover hacia arriba y hacia abajo.
  • Detener un movimiento en curso.
  • Ajustar una posición de apertura porcentual.
  • Controlar la apertura de lamas por separado con actuadores adecuados.

La representación de la posición utiliza 0 % cerrado y 100 % abierto. Las lamas también se ofrecen como valor porcentual, no como ángulo calibrado en grados. Las funciones disponibles dependen de los puntos de datos que el actuador respectivo proporcione a través de la API local.

Pulsadores de pared y panel

Los pulsadores de free@home existentes pueden desencadenar escenas de Gladys. Esto permite controlar dispositivos y funciones fuera de free@home.

Dependiendo de la configuración del pulsador, se informan acciones de encendido/apagado, atenuación o persiana. Incluso dos acciones idénticas y consecutivas se procesan como eventos separados.

Importante: Estas son las acciones de pulsador proporcionadas por free@home, no una interfaz de datos brutos universales para presionar, soltar o doble clic.

¿Para qué se puede usar esto?

Algunas aplicaciones posibles:

  • Apagar luces y consumidores seleccionados al salir de la casa.
  • Posicionar persianas a través de escenas de Gladys en ciertos momentos.
  • Iniciar una escena de noche o ausencia con un pulsador de pared de free@home existente.
  • Operar dispositivos de otros sistemas ya integrados en Gladys con un pulsador.
  • Controlar luz y sombreado juntos a través del panel de Gladys.

La automatización deseada se establece en sus escenas de Gladys. La integración proporciona los dispositivos y eventos de pulsador compatibles para esto.

¿Cómo funciona la conexión?

La integración se conecta con la API REST y WebSocket local oficial del System Access Point:

  • REST se utiliza para leer la configuración y enviar comandos de control.
  • WebSocket proporciona cambios de estado en curso y eventos de pulsador.

Para la comunicación local, no se requiere Gladys Plus. La interfaz y la documentación están disponibles en alemán, inglés y francés.

Probado y notas importantes

Con hardware real y firmware SysAP 3.5.3, se han probado, entre otras cosas, el encendido de luces, la atenuación con retroalimentación, el posicionamiento de persianas, el movimiento hacia arriba y la parada, así como eventos de pulsador repetidos como desencadenantes de escenas.

No todas las variantes de dispositivos o firmware están cubiertas. El control de lamas, el comando de bajada separado y el otro lado del pulsador probado están actualmente solo simulados. Las funciones de calefacción, otras clases de sensores y las escenas de free@home existentes aún no están incluidas en el alcance soportado.

Además, se aplica lo siguiente:

  • Algunos actuadores informan su posición de persiana solo después de finalizar un viaje.
  • Durante una interrupción de conexión, los eventos de pulsador perdidos no se recuperan.
  • Los comandos de control no se repiten automáticamente después de errores. En caso de tiempo de espera, primero verifique el estado real del dispositivo.
  • No exponga la API del controlador a Internet. Se prefiere HTTPS con un certificado confiable; HTTP transmite los datos de acceso a la API sin cifrar.

Me encantaría recibir comentarios y experiencias, especialmente sobre otros actuadores, pulsadores y versiones de firmware de free@home. Así podemos seguir expandiendo la integración juntos.