Integración externa - Magic Home

Desarrollo
1

Hola a todos,

Como se anunció en el hilo de integraciones a desarrollar, aquí tenéis una integración externa para las bombillas, tiras LED y enchufes Wi-Fi Magic Home, controlados localmente.

Qué hace

Trae a Gladys los dispositivos de las aplicaciones Magic Home Pro, Zengge o Surplife: bombillas, controladores de tiras, tiras direccionables, guirnaldas, enchufes. Todo sigue en la red local (transporte local): sin cuenta, sin cloud. Gladys encuentra los dispositivos sola (búsqueda UDP 48899 a través de su descubrimiento de red), luego la integración les habla en TCP.

Gladys no tiene una integración nativa de Magic Home: ya no necesitas el puente MQTT (hilo) ni Matterbridge (hilo).

Funcionalidades

  • Dispositivos: encendido/apagado, brillo, color y temperatura de color según el modelo; los enchufes como interruptores. Los cambios hechos en el mando suben solos en la mayoría de los modelos.
  • 2 disparadores de escena: un dispositivo no responde (después de 30 s), un dispositivo responde de nuevo.
  • 4 acciones de escena: efecto integrado (23 a elegir), hasta 16 colores en bucle, parpadeo y luego vuelta al estado anterior, parada del efecto.
  • 2 widgets: « Luces Magic Home » (con « Todo apagar ») y « Efectos Magic Home » (tres botones de efecto a elegir).

Ejemplos de escenas:

  • cuando se toca el timbre → hacer parpadear la lámpara del salón en rojo 5 segundos;
  • cuando la luz del jardín no responde → enviarme un mensaje (cortada en el interruptor);
  • al atardecer → tira de la cocina al 40 %, luego un fundido naranja-rosa en la tira del salón.

Widgets Luces Magic Home y Efectos Magic Home (ilustración generada, no una captura de pantalla)

[Captura por venir: la pestaña Descubrimiento con una bombilla, una tira y un enchufe]

Instalación

  • Desde la tienda: buscar « Magic Home ». Disponible en el día, el tiempo de la indexación.
  • O desde la URL del depósito: https://github.com/William-De71/gladys-magic-home.

Versión mínima de Gladys: 5.1.1.

  1. Instalar la integración aceptando el descubrimiento de red (UDP 48899).
  2. Configuración: « Buscar y probar los dispositivos ».
  3. Pestaña Descubrimiento: añadir los dispositivos, luego los widgets y las escenas.

Límites conocidos

  • Protocolo no documentado por el fabricante: lo he escrito según flux_led, que usa Home Assistant. Aún no probado en dispositivos reales, solo contra dispositivos simulados con tramas capturadas en hardware real: vuestros comentarios son valiosos (con el parámetro MAGICHOME_MODEL).
  • No gestionados: animaciones de las tiras direccionables y guirnaldas, modo música, temporizadores, ajustes de las tiras.
  • Los interruptores de 2 o 4 salidas se ven como un solo interruptor; los dispositivos accesibles solo por el cloud no son soportados.
Detalles técnicos
  • Un dispositivo por módulo, identificado por su dirección MAC: se recupera después de un cambio de dirección IP (búsqueda automática cada hora, y tan pronto como un dispositivo no responde). Se recomienda una dirección IP fija.
  • El protocolo se elige según el número de modelo y la versión del firmware: protocolo original sin suma de control, protocolos de 8 y 9 bytes, firmware de 25 bytes en HSV de las bombillas recientes, tramas encapsuladas de las tiras direccionables.
  • Una sola conexión TCP por dispositivo creado (aceptan pocos, la aplicación mantiene una); los dispositivos descubiertos pero no añadidos no se mantienen conectados.
  • La temperatura de color está en mired, como Hue y Tasmota en Gladys.
  • Las acciones de escena nunca disparan un disparador (sin bucle); un corte de menos de 30 s no dispara nada.

Hacer un comentario

Por un issue de GitHub o en respuesta a este hilo, con la versión de Gladys, la versión de la integración y los logs