Historial de versiones - MiWiFi XiaoHack Edition

Esta actualización mejora el comportamiento de las entidades de actualización y añade compatibilidad con notas de la versión dinámicas para la interfaz del panel.

🆕 Novedades de la versión 3.2.1

📦 Soporte para las notas de la versión de GitHub

• ✨ Se agregó async_release_notes() a la entidad de actualización. (Desde Update.panel_frontend)
• 📄 Obtiene automáticamente las descripciones de las versiones de GitHub usando:

https://api.github.com/repos/JuanManuelRomeroGarcia/miwifi-panel-frontend/releases/tags/vX.Y.Z

• 🧠 Si las notas de la versión están disponibles, ahora se mostrarán directamente en la interfaz de usuario de Home Assistant bajo la entidad update.miwifi_panel_frontend.
• 🛑 Se implementará un mecanismo de reserva elegante que utilizará None si no se encuentran los datos de la versión o si se producen errores.

📶 Cálculo de calidad de señal fijo

• 🛠 Se corrigió la asignación incorrecta de signal_quality en los atributos del rastreador de dispositivos.
• 🧠 Anteriormente, el sistema de backend trataba los valores de señal (escala de 0 a 100) como si estuvieran en dBm (por ejemplo, -65), lo que resultaba en niveles de calidad inexactos.
• ✅ Se ha actualizado map_signal_quality() para que funcione correctamente con valores de señal basados en porcentajes:

🛠 Mejoras

• Se ha mejorado el registro de errores y soluciones alternativas de la API de GitHub.
• Mejor gestión de los datos de versión faltantes o no válidos.
• Compatibilidad total con los campos release_summary y release_notes cuando estén disponibles.

✅ Compatibilidad

Requisitos: Home Assistant 2023.10 o posterior.

Compatible con: MiWiFi Panel Frontend v1.3.0 o posterior

Sin cambios importantes

© 2025 – Proyecto XiaoHack 🔗 GitHub: JuanManuelRomeroGarcia/hass-miwifi

✅ Mejoras del backend

• Se agregó lógica de detección para establecer is_main_auto: true|false en el atributo graph del sensor de topología (sensor.topologia_miwifi_*), lo que permite que la interfaz distinga si el enrutador principal fue detectado automáticamente o seleccionado manualmente.
• Mayor robustez de la función _async_prepare_topo:
• Mantiene la prioridad correcta entre la detección automática y la selección manual a través de select_main_router.
• Garantiza que graph.is_main solo esté presente si el dispositivo es realmente el enrutador principal.
• Ahora se utiliza manual_main_mac para restaurar el estado del enrutador principal si falla la detección automática.

🚀 Versión estable: servicio de bloqueo WAN, compatibilidad con registros, persistencia first_seen y optimización completa del backend.

🔄 Novedades de la versión 3.1.9

🛠 Correcciones

• Se ha añadido un sistema de monitorización periódica para comprobar la versión del panel de control cada 30 segundos.
• El sistema ahora detecta nuevas versiones del panel sin necesidad de reiniciar la integración.
• La comprobación es pasiva: no se actualiza automáticamente, pero registra cuándo hay una nueva versión disponible.

🆕 Servicio de bloqueo de acceso WAN

• Nuevo servicio: miwifi.block_device para bloquear o desbloquear el acceso WAN por dispositivo.
• Totalmente integrado en las automatizaciones y planos de Home Assistant.
• Servicio basado en dispositivos que utiliza directamente el device_id del registro de Home Assistant.
• Totalmente compatible con las llamadas al servicio de la interfaz de usuario de Home Assistant.
• Las notificaciones persistentes ahora se gestionan directamente desde el servidor después de cada operación de bloqueo/desbloqueo.

🐞 Persistencia completa del atributo first_seen

• El atributo first_seen ahora se genera solo cuando se detecta un dispositivo por primera vez.
• Ya no se reinicia en cada ciclo de actualización.
• Proporciona un seguimiento histórico preciso de cuándo se detectó por primera vez cada dispositivo mediante la integración.

🧹 Se filtran los errores de conexión falsos positivos.

• En ocasiones, la API Luci de Xiaomi cierra las conexiones después de aplicar filtros MAC.
• Estos errores de conexión inofensivos ahora se gestionan correctamente:
• Los errores se registran únicamente con fines informativos.
• Ya no se interrumpirán las automatizaciones ni las llamadas de servicio.
• El servicio siempre se completa con éxito, incluso si Luci pierde la conexión.

🔧 Refactorización de la ruta de registro para una compatibilidad total con Docker y Synology.

• Todos los registros ahora se almacenan en:

/config/miwifi/Logs/

• Totalmente compatible con volúmenes Docker, el sistema operativo Home Assistant, Synology DSM y configuraciones Proxmox LXC.
• No hay problemas de permisos en los volúmenes de montaje de enlace de Docker.

➕ Se han añadido nuevos modelos compatibles.

• El router Xiaomi Mi CR8806 (cr8806) ahora es totalmente compatible. #16

🪵 Registro de eventos en el backend mejorado

• Registros internos completos de las llamadas de servicio.
• Informes de errores amigables para la depuración y el soporte.

✅ Notas de compatibilidad

• Versión mínima de integración de MiWiFi: v3.1.8
• Totalmente compatible con:
• Interfaz de usuario de MiWiFi XiaoHack v1.2.4
• Home Assistant 2025.x y Supervisor 2025.x
• Docker, Synology, HAOS, Proxmox, LXC

Integración de MiWiFi (XiaoHack Edition) con una importante reestructuración interna y nuevas funciones avanzadas de bloqueo de dispositivos.

🆕 Qué hay de nuevo

Fase 1: Compatibilidad + Sistema de bloqueo de Internet

• Sistema de compatibilidad implementado:
• La nueva lógica del archivo compatibility.py detecta dinámicamente las capacidades del enrutador.
• Los modelos y las características no compatibles ahora se gestionan completamente a través del archivo centralizado unsupported.py.
• Se ha mejorado la lógica de inicio para detectar modelos y evitar fallos innecesarios en firmwares desconocidos.
• Base para futuros modelos Xiaomi AX/RA y nodos de malla.

• Bloqueo de Internet (Filtro MAC):
• Se ha añadido compatibilidad para el bloqueo de Internet por dispositivo mediante el filtro MAC nativo del router.
• Nuevos servicios: miwifi.block_internet y miwifi.unblock_internet disponibles directamente desde la interfaz de usuario de Home Assistant.
• Se aplicó la sincronización completa del filtro MAC a las respuestas de las API device_list y wifi_connect_devices.
• El estado de bloqueo en tiempo real se refleja en los atributos device_tracker.

Fase 2: Sincronización dinámica completa de entidades

• Las entidades ya no requieren eliminación manual al cambiar de enrutador o actualizar dispositivos.
• Si el dispositivo ya existe, su estado y atributos se actualizarán automáticamente.
• Evita excepciones de unique_id duplicado en entidades device_tracker.
• Totalmente compatible con el registro de dispositivos de Home Assistant.

Mejoras internas

• Refactorización completa del cliente API de Luci (luci.py) para manejar la nueva lógica de filtro MAC y compatibilidad.
• Funciones auxiliares y enumeraciones centralizadas para una mejor mantenibilidad (helper.py, enum.py).
• Pequeñas optimizaciones en la creación de entidades, el mapeo de la calidad de la señal y la sincronización del estado del enrutador.
• Se han optimizado los registros de desarrollo para garantizar la estabilidad en producción.

🔧 Archivos actualizados

• actualizador.py
• device_tracker.py
• services.py
• services.yaml
• helper.py
• luci.py
• const.py
• compatibilidad.py
• unsupported.py

✅ Esta versión completa la refactorización de la Fase 1 + Fase 2. 🔜 La fase 3 se centrará en el bloqueo de grupos, las escenas y las mejoras de la interfaz de usuario del frontend.

🔥 Importante actualización del backend que estabiliza completamente la compatibilidad con la malla, elimina las redundancias de web scraping e implementa el uso completo de la API nativa de Xiaomi.

✨ Cambios importantes

🔧 Refactorización completa del backend (arquitectura de malla limpia)

• ✅ Se eliminó por completo el rastreo de dispositivos heredados (device_list, wifi_connect_devices).
• ✅ El backend ahora funciona completamente con:
• topo_graph() para la generación de topología de dispositivos y rastreadores.
• new_status() para un conteo preciso de dispositivos por banda y LAN.
• ✅ Cada dispositivo está correctamente asignado a su nodo correcto en la topología de malla.
• ✅ Evita la duplicación de rastreadores de dispositivos entre el enrutador principal y los nodos de la red mallada.
• ✅ Mejora el rendimiento, reduce la carga en los routers y aumenta la estabilidad.

📊 Mejoras en la estabilidad del rastreador

• ✅ Se ha mejorado la lógica del rastreador de dispositivos con una tolerancia ampliada para stay_online.
• ✅ Reduce significativamente las falsas detecciones de not_home causadas por la itinerancia o las desconexiones rápidas.

🧹 Script de limpieza automática del registro de entidades

• ✅ Se incluye un nuevo script de Python (limpiar_miwifi.py).
• ✅ Permite una limpieza segura y completa del registro de entidades, eliminando las entradas duplicadas anteriores de device_tracker.
• ✅ Ayuda a mantener el registro de entidades limpio y coherente después de una refactorización del backend.

🔄 Lógica de actualización dinámica de entidades mantenida

• ✅ Sincronización dinámica completa de sensor.topologia_miwifi con el estado interno del backend.
• ✅ Creación/eliminación totalmente en vivo de entidades update.miwifi_[MAC]_miwifi_panel_frontend.

⚙️ Archivos de backend actualizados

• updater.py — Limpieza completa de la lógica del backend.
• device_tracker.py — Mejoras en el estado estable del rastreador.
• python_scripts/limpiar_miwifi.py — Herramienta de limpieza automática.
• Se mantiene la compatibilidad total con services.py, frontend.py, update.py, config_flow.py y otros módulos.

🧪 Estabilidad alcanzada

• ✅ Backend 100% Mesh compatible con la API nativa de Xiaomi.
• ✅ Se acabó la duplicación de rastreadores entre nodos.
• ✅ El registro de entidades se mantiene constante a largo plazo.
• ✅ Actualización completa inmediata tras cambios en la topología o la conexión.
• ✅ Totalmente compatible con versiones anteriores de instalaciones existentes.

🔖 Requiere MiWiFi Panel Frontend v1.2.3 para una sincronización completa del frontend.

¡Gracias de nuevo a toda la comunidad por la ayuda, los informes, las pruebas y la enorme contribución para el lanzamiento de Clean Backend!

➡️ Para obtener la documentación completa, visite: xiaohack.es