[Integración externa] - KNX

Desarrollo
1

Hola a todos,

Para responder a la solicitud Integración del protocolo KNX, aquí hay una integración externa que conecta Gladys con una instalación KNX.

Qué hace

Se comunica con el bus a través de una interfaz IP KNX de su red, localmente solo: nada se envía a Internet. Gladys no tiene una integración nativa de KNX.

KNX no permite descubrir los dispositivos: debe declararlos una vez con sus direcciones de grupo ETS (botones « Declarar una luz », « Declarar una persiana »… de la configuración), luego agrégalos desde la pestaña Descubrimiento.

Funcionalidades

  • Dispositivos: luces (variación, color), interruptores, persianas y cortinas, sensores (temperatura, humedad, CO2, potencia, energía…), sensores binarios (movimiento, contacto de ventana, humo…), termostatos.
  • Conexión: túnel UDP o TCP, KNX IP Secure, enrutamiento; búsqueda automática de la interfaz.
  • Widget « Bus KNX »: conexión, tráfico, últimos telegramas.
  • Disparadores de escena: telegrama recibido en direcciones seleccionadas, conexión perdida, conexión restablecida.
  • Acciones de escena: enviar un valor, leer un valor, recordar una escena KNX.

Ejemplos de escenas:

  • cuando el botón « Todo apagar » de la entrada envía off → apagar también las luces no KNX;
  • cuando la alarma está activada → recordar la escena KNX « Ausencia » y cerrar las persianas;
  • cuando la conexión KNX se pierde → notificar al hogar.

Instalación

Disponible en la tienda durante el día, el tiempo de indexación (busque « KNX »), o ahora mismo desde la URL del repositorio: Integraciones → Instalar una integración → https://github.com/William-De71/gladys-knx. Gladys 5.1.1 mínimo.

  1. Ingrese la dirección IP de la interfaz (o déjela vacía), luego Probar la conexión.
  2. Declara tus dispositivos con sus direcciones de grupo ETS (1/2/3).
  3. Agrégalos desde la pestaña Descubrimiento.
  4. Agrega el widget « Bus KNX » a un tablero.

Capturas

Ilustración generada a partir del código de la integración (no una captura de pantalla de un Gladys real):

Widget Bus KNX (ilustración generada)

Límites conocidos

  • No probado en una instalación KNX real, solo contra el servidor de túnel de KNXUltimate y pruebas automatizadas: sus comentarios sobre hardware real son bienvenidos.
  • No hay importación del proyecto ETS: las direcciones se ingresan manualmente.
  • Ni KNX Data Secure, ni ventilación, ni modos de termostato (confort, eco…) por el momento.
  • El enrutamiento multicast generalmente no alcanza el contenedor: prefiera el túnel.
Cómo funciona, para los curiosos

La integración es un contenedor Node.js que utiliza la biblioteca KNXUltimate (la de node-red-contrib-knx-ultimate). Las declaraciones se registran en la configuración de Gladys, por lo tanto, en sus copias de seguridad. Cada telegrama se decodifica con el tipo de punto de datos (DPT) de su dirección, y solo los cambios se envían a Gladys (240 estados por minuto como máximo). La búsqueda de interfaz pasa por el núcleo de Gladys, el único que puede difundir en la red local.

Sus comentarios

En respuesta a este hilo o en un issue de GitHub, con las versiones de Gladys y de la integración, el modelo de la interfaz y los registros (idealmente con DEBUG=gladys-integration-sdk).

Licencia Apache 2.0. Gracias al equipo Gladys por la documentación y el SDK de las integraciones externas, y al autor de KNXUltimate.

KNX es una marca de KNX Association; este proyecto no está afiliado a ella.