Hola a todos,
Tras la discusión https://community.gladysassistant.com/t/rebond-sur-le-sujet-transfert-zigbee2mqtt-ha-vers-gladys, me lanzo a crear una herramienta de migración de Home Assistant a Gladys. Este hilo sirve para presentar el proyecto, explicar y discutir los pocos cambios en el núcleo que requiere, y recoger sus opiniones antes de escribir la primera línea de código.
¿Por qué?
Abandonar Home Assistant para Gladys significa hoy tener que volver a hacer todo manualmente: dispositivos, habitaciones, usuarios, escenas… y perder el historial. Este coste de salida frena a muchos curiosos. El objetivo es que un usuario de HA « estándar » pueda migrar en menos de un cuarto de hora, y sepa precisamente qué no puede migrarse y por qué.
Qué hará la herramienta
Un servicio integrado en Gladys, accesible:
- desde el primer lanzamiento, junto a « Restaurar una copia de seguridad Gladys Plus »;
- luego en Configuración → Migración.
Versión 1
- Análisis de la instalación de HA, con un informe de compatibilidad dispositivo por dispositivo: migrable, parcial, mediante una alternativa, no migrable, ignorado.
- Instalación de las integraciones necesarias desde la tienda, marcando casillas.
- Dispositivos (con su nombre y su habitación), habitaciones, usuarios e integraciones de servicio (meteorología, calendarios, notificaciones…).
- Entradas de HA (modo vacaciones, ajustes de consigna, contadores) recreadas en dispositivos virtuales.
- Presencia: rastreadores de red y Bluetooth vinculados a los usuarios, zonas, llegadas y salidas.
- Módulos complementarios de HA (Mosquitto, Zigbee2MQTT, Node-RED, Frigate…) asociados a su equivalente en Gladys: servicio nativo o integración de la tienda.
- Historiales completos: estadísticas a largo plazo y estados recientes, incluidos los contadores de energía, con una estimación del espacio en disco necesario.
- Escenas de HA (las « ambientes »: lámpara al 20 %, persianas cerradas…) y scripts simples, convertidos en escenas de Gladys para ejecutar manualmente.
- Automatizaciones simples: horarios, salida y puesta de sol, movimiento o apertura detectados, umbrales de temperatura… Las demás se presentan en un formato legible, con un borrador de escena prellenado, para que el usuario las recree él mismo. También es una buena manera de descubrir el editor de escenas de Gladys.
- Lo que no tiene equivalente en el núcleo (el sol, los días laborables…) puede basarse en un dispositivo que ya tienes, en un dispositivo virtual o en una integración: la herramienta simplemente te pide cuál usar.
- Paneles de control: se genera un panel de control « Inicio » a partir de lo que se ha migrado (habitaciones, ambientes, meteorología, cámaras, energía), para no llegar nunca a una página vacía. Tus paneles de control de HA se retoman a continuación, de forma aproximada.
Versión 2
- Un asistente de migración de automatizaciones más elaboradas y de scripts con parámetros, que evolucionará con el motor de escenas de Gladys.
Algunos principios
- Solo lectura en HA: la herramienta no modifica nada allí.
- Dos modos: coexistencia (se prueba Gladys sin detener HA) o cambio. Se pasa de uno a otro relanzando la herramienta.
- Cancelación garantizada: la herramienta solo deshace lo que ha hecho, y devuelve Gladys exactamente a su estado anterior.
- Nada sale de la instancia. El token y las contraseñas de HA se mantienen en memoria, el tiempo necesario.
- Relanzable: se relanza la herramienta para recuperar lo que ha cambiado en HA, sin crear duplicados.
Para los dispositivos sin integración en Gladys, la herramienta anima primero al usuario a crearla él mismo, gracias al modelo de integración oficial. Si no, le propone publicar una solicitud en « Solicitudes de funciones », con un mensaje ya redactado.
Cómo funciona, en breve
La herramienta no « fabrica » dispositivos. Instala la integración de Gladys adecuada, la deja descubrir los dispositivos, y luego asocia cada dispositivo de HA con el dispositivo descubierto mediante una clave material: dirección MAC, dirección Zigbee (IEEE), número de serie… A continuación, aplica el nombre y la habitación procedentes de HA. Este modo de funcionamiento funciona tanto con las integraciones nativas como con las de la tienda.
El estudio del código de las 12 integraciones de HA más utilizadas muestra que, para 8 de ellas, esta asociación es segura: Zigbee (Zigbee2MQTT y ZHA), Shelly, Tuya, Google Cast, UPnP, DLNA… Ninguna es completamente manual.
Lo que pido al núcleo (para discusión)
He intentado afectar el núcleo lo menos posible. Las bibliotecas necesarias (lectura de archivos, YAML, descifrado de backups recientes de HA) siguen siendo propias del servicio, como yaml para zigbee2mqtt.
| # | Modificación | ¿Por qué? |
|---|---|---|
| 1 | Tres nuevas tablas t_migration_run, t_migration_item y t_migration_history_cursor |
Mantener un registro de lo que se ha importado: reinicio sin duplicados, reanudación después de una interrupción, cancelación exacta. Ningún modelo existente se modifica. Las tablas tienen una columna source para poder servir algún día a otros sistemas (Jeedom, Domoticz…). |
| 2 | Una página Configuración → Migración y una línea en la pantalla de inicio | Puntos de entrada de la herramienta |
| 3 | Parámetros reservados GLADYS_HW_* (GLADYS_HW_MAC, GLADYS_HW_IEEE, GLADYS_HW_SERIAL, GLADYS_HW_UDN…), siguiendo el modelo de GLADYS_TRANSPORT |
Que cada integración publique la identidad física de sus dispositivos en un formato estándar. La reconciliación se vuelve entonces genérica, sin reglas que escribir por integración. Beneficio más allá de la migración: identificar un mismo dispositivo visto por dos integraciones, y proponer device.migrate. GLADYS_* desconocidos: es el SDK el que no los enviará a las versiones que los acepten. |
| 4 | (Opcional) Una ruta de carga en flujo de los backups de HA | Útil solo si HA está inutilizable. En el caso habitual, Gladys descarga él mismo el backup de HA (como para Gladys Plus), ya descifrado por HA. El cuerpo de las solicitudes JSON está actualmente limitado a 100 ko. |
Un punto de atención también: la purga diaria de los estados (90 días por defecto) borraría el historial importado. La herramienta propondrá, por lo tanto, cambiar la conservación a “ilimitada”, un ajuste que el usuario podrá modificar después. Esto no requiere ninguna modificación del núcleo, pero prefiero que se diga.
Pistas de evolución del núcleo (para la V2 y más allá)
Al estudiar el motor de escenas para la conversión de automatizaciones de HA, he identificado algunas carencias. Cubrirlas aumentaría directamente lo que la herramienta podrá convertir. No son necesarias para la V1: son propuestas para discutir.
| # | Pista | Interés |
|---|---|---|
| P1 | Modos de ejecución de las escenas (“ignorar si ya está en curso”, “reiniciar”, “poner en cola”) | Hoy, todas las ejecuciones de una escena se ejecutan en paralelo. Una escena con una espera puede lanzarse varias veces al mismo tiempo. Es la ganancia más importante. |
| P2 | Acción “detener una escena” | Motivos de temporizador |
| P3 | Condición solar (es de día o de noche, antes o después de la puesta de sol) | Iluminación, persianas. En la práctica, un dispositivo “día/noche” ya cubre la necesidad. Una pequeña integración “Sol” (estado día/noche, elevación, azimut) sería bienvenida en la tienda. |
| P4 | Condición de duración (“en este estado desde hace N minutos”) | Alertas |
| P5 | Disparador original de la escena utilizable en las condiciones | Escenas con varios disparadores y varios comportamientos |
| P6 | Condición o disparador “dispositivo accesible / valor reciente” (Gladys ya calcula “sin valor reciente”, pero solo para la visualización) | Alertas “este sensor no responde más”, comportamiento similar al de HA en caso de dispositivo no disponible |
De paso, he encontrado un error: un disparador “mensaje MQTT recibido” cuyo tema contiene un comodín (+ o #) nunca se dispara. Ticket: Scene trigger "MQTT message received" never fires when the topic contains a wildcard (+ or #) · Issue #3400 · GladysAssistant/Gladys · GitHub. Una corrección está propuesta y espera la revisión de un mantenedor: fix: fire "MQTT message received" scene trigger on wildcard topics (#3400) by Pierre-Gilles · Pull Request #3401 · GladysAssistant/Gladys · GitHub.
Lo que pediré a los desarrolladores de integraciones
No mucho, y solo en la próxima actualización del SDK:
- publicar la identidad física de sus dispositivos con la ayuda del SDK (punto 3 arriba);
- si es necesario, añadir a la raíz de su repositorio un pequeño archivo
gladys-migration.json. Describe las excepciones (funciones cuyo nombre difiere de HA, conversiones de unidades) y los ajustes a recuperar de HA (dirección de un broker, clave de cifrado ESPHome…). El modelointegration-template-jscontendrá un ejemplo.
Con @Will_71 y su rastreador
Él propuso una arquitectura llamada „limpia“ para el nuevo servicio. Pero „limpio“ no siempre significa simple.
Él propuso un llamado catálogo de correspondencias HA → Gladys que se basará en el tracker de integraciones de @Will_71. Ya hace la conexión entre las integraciones de HA y Gladys, completamente automáticamente. Sería suficiente agregar la recolección de los archivos gladys-migration.json y una columna « Migración HA ». Una vez creadas todas las integraciones, el tracker seguiría siendo la herramienta que mide la cobertura de la migración. William, ¿qué opinas?
¿En qué punto estamos?
Las especificaciones de la V1 están redactadas, en francés, esperando su versión en inglés para la solicitud de extracción hacia Gladys: GitHub - gboulvin/HA2Gladys-Migration-Tool · GitHub
| Sección | Contenido |
|---|---|
| 00 — Visión | Objetivos, alcance, decisiones |
| 01 — Arquitectura | Servicio central, tablas, seguridad, cancelación |
| 02 — Lectura de HA | API, copias de seguridad (incluyendo cifradas), historial |
| 03 — Correspondencias | Catálogo, conciliación, piezas, personas, entradas HA, módulos complementarios |
| 04 — Escenas | Escenas y scripts de HA, automatizaciones simples, presencia, sustitutos |
| 05 — Recorridos | Las pantallas del asistente |
| 06 — Pruebas | Cobertura del 100 %, CI de vigilancia de las versiones de HA |
| 07 — Historiales | Importación, energía, purga |
| 08 — Tableros de control | Inicio generado, recuperación de los tableros de control de HA |
Todo el trabajo está destinado a ser entregado a la organización GladysAssistant una vez fusionado.
Cómo pueden ayudar
- Sus opiniones sobre las modificaciones del núcleo, en particular los parámetros
GLADYS_HW_*. - Copias de seguridad reales de HA, que sé que puedo anonimizar con un script proporcionado (nombres, direcciones, números de serie reemplazados, secretos eliminados). Sirven para probar en instalaciones reales y medir el rendimiento. Nunca serán publicadas.
- Probadores para la imagen Docker de prueba, que se anunciará aquí antes de la solicitud de extracción final.
Ningún desarrollo se emprenderá sin una validación del principio. Por lo tanto, hago un llamado a los usuarios y desarrolladores de Gladys y/o HA para comentar (aquí o en GitHub), proponer…
¡Gracias de antemano por sus comentarios!