Historial de versiones - MiWiFi XiaoHack Edition

📝 Changelog — Integración MiWiFi

📦 Versión [3.2.5] – 2025-06-27

🔧 Parche crítico: Bloqueo de WAN y detección de capacidades

• ✅ Se solucionó un problema crítico en el servicio miwifi/block_device que provocaba fallos cuando el atributo capabilities no estaba inicializado.
• 🔁 Se agregó detección de capacidad dinámica cuando el enrutador principal (is_main) aún no las ha cargado.
• 🔐 Se ha asegurado de que el cliente Luci realice un login() antes de ejecutar las comprobaciones de compatibilidad para evitar falsos negativos.
• 🧠 Se agregó una instrucción return self.result que faltaba al final de CompatibilityChecker.run() para propagar correctamente las características detectadas.
• 🧱 Acceso reforzado a capabilities mediante getattr(..., {}) para evitar errores de 'NoneType' object has no attribute 'get'.
• 🔎 Registro mejorado para la detección de capacidades y fallos relacionados con la conexión, con diagnósticos más claros.

⚠️ Se recomienda encarecidamente aplicar este parche a todos los usuarios que dependan de las funciones de bloqueo WAN o filtrado MAC.

✅ Compatibilidad

• ✅ Compatible con Home Assistant 2025.4.0 y versiones posteriores.
• ✅ Totalmente compatible con versiones anteriores como v3.2.2.
• ✅ Actualización sin problemas desde v3.2.1+.

📘 Cómo actualizar

1. Reemplace todos los archivos dentro de su directorio custom_components/miwifi/ con el contenido de esta versión.
2. Reinicia completamente Home Assistant.
3. Confirme que la integración se carga sin errores de análisis WAN en Herramientas para desarrolladores > Registros.

📌 Recordatorio para los migrantes

Si estás migrando desde el dmamontov/hass-miwifi original:

➡ Eliminar la integración anterior. ➡ Añade este repositorio a través de HACS como repositorio personalizado:

`` https://github.com/JuanManuelRomeroGarcia/hass-miwifi ``

Mantenido con ❤️ por @JuanManuelRomeroGarcia

📝 Changelog — Integración MiWiFi

📦 Versión v3.2.4 – 2025-06-27

✅ Correcciones y estabilidad

• 🛑 No más advertencias repetidas para funciones no compatibles:
• Las comprobaciones de compatibilidad ahora omiten automáticamente cualquier característica que ya esté listada en unsupported.py.
• Evita que se muestren sugerencias y advertencias repetidas para métodos conocidos que no son compatibles (como wifi_config en CR8806).
• Garantiza un registro más limpio y evita las notificaciones innecesarias de incidencias de GitHub.

• 🧯 No se generará ninguna excepción si la información de la versión de Home Assistant no está disponible:
• Se introdujo un mecanismo de reserva seguro mediante la comprobación de sys.modules para evitar que se produzcan errores cuando falta __version__.
• Garantiza una total resiliencia en los diagnósticos y las sugerencias de solución de problemas en todos los entornos.

⚙️ Mejoras

• 🧠 Incluye un nuevo mecanismo de diagnóstico alternativo y sugerencias estructuradas para problemas en el caso de funciones no compatibles.

• ✅ CompatibilityChecker ahora incluye detección de modelos integrada y filtrado UNSUPPORTED:
• Omite dinámicamente las pruebas en función de la presencia de Model en unsupported.py.
• Lógica centralizada dentro del verificador: no es necesario gestionar las exclusiones externamente.
• Ciclo de vida de integración más limpio y fácil de mantener.

• ✍️ Sugerencia de incidencia de GitHub generada automáticamente:
• Cuando se detectan características no compatibles, la integración sugiere un bloque unsupported.py completo.
• Incluye modelo, modo, versión y enlace directo para abrir un problema con contenido prellenado.
• Evita la ruptura de la integración al tiempo que fomenta la retroalimentación estructurada.

• 🔁 Sigue registrando las funciones omitidas con los mensajes [MiWiFi] ⏭️ Saltando ... para mayor transparencia.

ℹ️ Esta versión es ideal para desarrolladores que mantienen la compatibilidad entre múltiples modelos con limitaciones conocidas.

✅ Compatibilidad

• ✅ Compatible con Home Assistant 2025.4.0 y versiones posteriores.
• ✅ Totalmente compatible con versiones anteriores como v3.2.2.
• ✅ Actualización sin problemas desde v3.2.1+.

📘 Cómo actualizar

1. Reemplace todos los archivos dentro de su directorio custom_components/miwifi/ con el contenido de esta versión.
2. Reinicia completamente Home Assistant.
3. Confirme que la integración se carga sin errores de análisis WAN en Herramientas para desarrolladores > Registros.

📌 Recordatorio para los migrantes

Si estás migrando desde el dmamontov/hass-miwifi original:

➡ Eliminar la integración anterior. ➡ Añade este repositorio a través de HACS como repositorio personalizado:

`` https://github.com/JuanManuelRomeroGarcia/hass-miwifi ``

Mantenido con ❤️ por @JuanManuelRomeroGarcia

📝 Changelog — Integración MiWiFi

📦 Versión v3.2.3 – 2025-06-26

✅ Correcciones y estabilidad

• 🛡️ Se evitan los falsos negativos en la detección de compatibilidad:
• Ahora, CompatibilityChecker se ejecuta solo una vez y solo si el enrutador es el nodo principal (is_main), ya sea por detección automática o selección manual.
• Impide que las pruebas de compatibilidad se inicien prematuramente en nodos de malla o enrutadores que no sean el principal.
• Corrige los informes inexactos de "modelo no compatible" para dispositivos como el R3600 y similares.

⚙️ Mejoras

• La detección de compatibilidad se trasladó a la fase del gráfico de topología (_async_prepare_topo) para garantizar el contexto adecuado del rol del dispositivo.
• Compatibilidad total con la selección manual del router principal a través de la interfaz de usuario, incluso después de la configuración.
• Las pruebas de capacidad ahora están completamente retrasadas hasta que se confirme que el enrutador es el principal.
• ✨ Nuevas traducciones añadidas para una mejor compatibilidad multilingüe en la interfaz.

🔧 Mejoras para desarrolladores

• Mayor seguridad en las comprobaciones de compatibilidad mediante la verificación del modelo y el contexto topológico antes del lanzamiento.
• Mensajes de registro más claros para las capacidades, la detección y el estado de compatibilidad.
• Limpieza interna de llamadas de detección duplicadas.

ℹ️ Consejo: Si anteriormente veías errores de compatibilidad falsos o soporte de funciones incompleto en los nodos de malla, esta actualización debería solucionarlo.

✅ Compatibilidad

• ✅ Compatible con Home Assistant 2025.4.0 y versiones posteriores.
• ✅ Totalmente compatible con versiones anteriores v3.2.2 y v3.2.1.
• ✅ Recomendado para configuraciones con múltiples enrutadores y entornos de red mallada.

📘 Cómo actualizar

1. Reemplace todos los archivos dentro de su directorio custom_components/miwifi/ con el contenido de esta versión.
2. Reinicia completamente Home Assistant.
3. Si el router principal no se detectó automáticamente, utilice el panel de control de MiWiFi para seleccionarlo.

📌 Recordatorio para los migrantes

Si estás migrando desde el dmamontov/hass-miwifi original:

➡ Eliminar la integración anterior. ➡ Añade este repositorio a través de HACS como repositorio personalizado:

`` https://github.com/JuanManuelRomeroGarcia/hass-miwifi ``

Mantenido con ❤️ por @JuanManuelRomeroGarcia

📝 Changelog — Integración MiWiFi

📦 Versión v3.2.2 – 2025-06-24

🚀 Mejoras

• Optimización del rendimiento al inicio: el método check_ports() se reescribió para usar asyncio.open_connection en lugar de socket.connect_ex, eliminando las llamadas bloqueantes del bucle principal de eventos de Home Assistant.
• Esto soluciona los bloqueos breves (<1 minuto) que se producen al iniciar Home Assistant o al cargar la integración por primera vez.
• Se observa una mejora notable en la estabilidad del sistema durante el arranque, especialmente en configuraciones con varios enrutadores o un seguimiento intensivo de dispositivos.
• Mejora del monitor del panel frontal: Se movió la llamada de programación para async_track_time_interval fuera del bloque interno try para garantizar que la comprobación periódica de la versión siempre se programe, incluso si la primera comprobación falla.
• Diagnóstico de autocomprobación mejorado: el módulo self_check.py ahora incluye:
• La versión de la integración de MiWiFi
• La versión instalada del panel de control (si está disponible)
• La versión actual de Home Assistant
• Estas versiones se incluyen en el enlace de incidencias para routers desconocidos con el fin de mejorar la depuración y la asistencia técnica.
• Detección de compatibilidad ampliada: CompatibilityChecker ahora comprueba capacidades adicionales del enrutador:
• Compatibilidad con actualización de firmware (rom_update, flash_permission)
• Compatibilidad con el control de LED
• Configuración de Wi-Fi para invitados y Wi-Fi directo
• Compatibilidad con mapas topológicos
• Compatibilidad con listas de dispositivos (con cable e inalámbricos)
• Los resultados se almacenan en self.result y se pueden usar para habilitar o deshabilitar funciones de forma dinámica.
• Informes automáticos de modelos no compatibles: cuando un modelo de enrutador conocido no supera ninguna comprobación de compatibilidad, la integración sugerirá ahora un problema en GitHub con:
• Las características defectuosas
• Líneas sugeridas para unsupported.py
• Información de la versión de la integración y Home Assistant
• Enlace directo para abrir el problema
• Detección precisa del modo del enrutador: La integración ahora prioriza netmode sobre mode al determinar la función operativa de un enrutador (por ejemplo, nodo de malla, repetidor, etc.), corrigiendo clasificaciones erróneas durante las comprobaciones de capacidad.
• Enumeración __HTML_PLACEHOLDER_0__ ampliada: Se agregó soporte para modos adicionales:
• MESH_NODE (3): enrutadores secundarios conectados a la red de malla (nodos no principales)
• MESH_LEAF (8): nodos hoja de malla más profundos

Ahora, estas funcionalidades se ignoran automáticamente en las comprobaciones de capacidad, como rom_update o per_device_qos, evitando así informes falsos de "no compatibles" para las unidades de malla secundarias.

• Mejor manejo de la opción de reserva: Si netmode no está presente, la integración recurrirá de forma segura a mode o "default" sin errores.
• Contexto de diagnóstico mejorado: El modo detectado ahora se incluye en la sugerencia de incidencias de GitHub para enrutadores no compatibles, lo que ayuda a los mantenedores a priorizar los casos específicos de la red mallada.

🧹 Limpieza de código

• Se eliminaron las importaciones no utilizadas: socket, contextlib.closing.
• Se agregó la importación faltante para MiWiFiPanelUpdate para resolver el error de tiempo de ejecución.
• Defina o importe ATTR_TRACKER_TOTAL_USAGE para eliminar las advertencias.
• Ligera limpieza interna en el manejo de paneles y la lógica de la estructura.
• El código sigue siendo totalmente compatible con versiones anteriores de la integración.

💡 Consejo: Se recomienda a los usuarios que experimenten bloqueos breves durante el inicio de Home Assistant que actualicen a esta versión.

✅ Compatibilidad

• ✅ Compatible con Home Assistant 2025.4.0 y versiones posteriores.
• ✅ Totalmente compatible con versiones anteriores v3.2.1.
• ✅ Se puede instalar de forma segura como reemplazo directo de v3.2.1.

📘 Cómo actualizar

1. Reemplace todos los archivos dentro de su directorio custom_components/miwifi/ con el contenido de esta versión.
2. Reinicia completamente Home Assistant.
3. Confirme que la integración se carga sin errores de análisis WAN en Herramientas para desarrolladores &gt; Registros.

📌 Recordatorio para los migrantes

Si estás migrando desde el dmamontov/hass-miwifi original:

➡ Eliminar la integración anterior. ➡ Añade este repositorio a través de HACS como repositorio personalizado:

`` https://github.com/JuanManuelRomeroGarcia/hass-miwifi ``

Mantenido con ❤️ por @JuanManuelRomeroGarcia

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