Historial de versiones - MiWiFi XiaoHack Edition

📝 Changelog — Integración MiWiFi

📦 Versión v3.4.9 – 2026-01-01

✅ Correcciones y estabilidad

• 🧩 Registro no compatible migrado al almacenamiento de Home Assistant

Se reemplazó el flujo de trabajo heredado unsupported_user.py con __HTML_PLACEHOLDER_1__ (persistencia basada en almacenamiento). Esto evita problemas de permisos de escritura dentro de custom_components y hace que el comportamiento sea coherente en todas las instalaciones de alta disponibilidad.

• 🔁 No se repetirán las sugerencias "no compatibles" después de reiniciar

Las comprobaciones de compatibilidad ahora tratan las características predefinidas no compatibles como N/A (Ninguna) en lugar de fallos, por lo que los diagnósticos no volverán a activar la misma advertencia en cada reinicio.

• 🛡️ Se ha eliminado el ruido de compatibilidad con la red Wi-Fi para invitados

La anterior comprobación de compatibilidad de la red Wi-Fi para invitados podía generar falsos negativos debido a la incompatibilidad entre los métodos y los puntos finales del cliente. Esta comprobación se eliminó o neutralizó para evitar recomendaciones incorrectas de "no compatibilidad".

⚙️ Mejoras

• ➕ La opción "Agregar a elementos no compatibles" ya funciona desde el sistema de diagnóstico.

La acción de diagnóstico ahora utiliza un punto final dedicado (/api/miwifi/add_unsupported) que realiza una llamada de servicio autenticada a miwifi.add_unsupported.

• 🧠 Fusión automática de modelos base + modelos no compatibles con el usuario

La integración ahora fusiona:

• Registro base NO COMPATIBLE (incluido con la integración)
• Entradas definidas por el usuario almacenadas en .storage/miwifi/unsupported_user.json

• 🧼 Experiencia de usuario mejorada para la acción de diagnóstico

La página de confirmación regresa automáticamente a Home Assistant después de la llamada al servicio, por lo que los usuarios no necesitan cerrar manualmente páginas adicionales.

✅ Compatibilidad

• ✅ Compatible con Home Assistant 2025.5.0+
• ✅ No se producen cambios incompatibles con las configuraciones existentes.

(El archivo heredado unsupported_user.py seguirá siendo compatible mediante la lógica de migración/fusión, si está presente).

📘 Cómo actualizar

1. Reemplace todos los archivos dentro de custom_components/miwifi/ con el contenido de esta versión.
2. Reiniciar Home Assistant.
3. (Opcional) Si anteriormente utilizó unsupported_user.py, confirme que las nuevas entradas ahora se almacenan en:

.storage/miwifi/unsupported_user.json

1. Si el diagnóstico sugiere agregar una característica a la lista de elementos no compatibles, haga clic en el enlace de acción y verifique que el modelo aparezca en el JSON de almacenamiento.

ℹ️ Información adicional

• El flujo de trabajo compatible "Agregar elementos no compatibles" ahora prioriza el almacenamiento (recomendado para todos los usuarios).
• Si ve entradas como "new" en el archivo de almacenamiento, asegúrese de que la clave de la función coincida con el nombre de la función de CompatibilityChecker (por ejemplo, wifi_config, mac_filter, etc.); de lo contrario, se almacenará pero no se aplicará.

💖 Soporte y donaciones

Si esta integración le resulta útil y desea apoyar su desarrollo continuo:

• 💸 Wise
• 💸 PayPal

📌 Resumen de cambios (v3.4.8 → v3.4.9)

📝 Registro de cambios — MiWiFi XiaoHack Edition (Integración con Home Assistant)

📦 Versión v3.4.7 — 2025-12-28

✅ Correcciones y estabilidad

• 🐞 Se corrigió la detección de modo incorrecto en CompatibilityChecker: los enrutadores que informan modos numéricos (por ejemplo, mode=2) ya no recurren incorrectamente a DEFAULT.
• 🧩 Comportamiento “SKIP” adecuado para comprobaciones no aplicables: devolver None de las comprobaciones de compatibilidad (p. ej. AP / Repetidor / Malla) ahora se trata como *omisión intencional* en lugar de activar reintentos y falsas advertencias de “no compatible”.
• 🛡️ Se redujeron los falsos positivos en registros como:
• La función 'device_list' falló después de 5 intentos...
• La función 'topo_graph' falló después de 5 intentos...

cuando el enrutador está funcionando en los modos Punto de acceso / Repetidor / Malla donde esos puntos finales pueden no ser confiables o no ser aplicables.

⚙️ Mejoras

• 🧠 Análisis en modo unificado utilizando el Mode(IntEnum) existente como única fuente de verdad:
• Análisis numérico primero (Mode(int(...)))
• Frase/alias de reserva ("ap", "router", etc.)
• 🔍 Salida de depuración más consistente para el análisis del modo de compatibilidad y la evaluación de características.

✅ Compatibilidad

• ✅ Compatibilidad mejorada para RA82 y modelos similares que informan mode=2 (Punto de acceso), evitando la clasificación incorrecta del modo y las sugerencias "no compatibles" innecesarias.
• ✅ Las comprobaciones de compatibilidad ahora funcionan correctamente en:
• Modo de enrutador DEFAULT (0)
• REPETIDOR (1)
• PUNTO_DE_ACCESO (2)
• MESH_NODE (3)
• HOJA_DE_MALLA (8)
• MALLA (9)

📘 Cómo actualizar

1. Descarga la versión v3.4.8 desde la página de lanzamientos de GitHub.
2. Reemplazar la carpeta de integración:

• custom_components/miwifi/

1. Reiniciar Home Assistant.
2. (Opcional) Borre la caché del navegador si también está utilizando el panel MiWiFi.

ℹ️ Información adicional

• Esta versión se centra en la fiabilidad de CompatibilityChecker y no modifica la lógica de control del enrutador.
• No se esperan cambios importantes.

💖 Soporte y donaciones

Si este proyecto te resulta útil y quieres apoyar su desarrollo futuro:

• ⭐ Marca el repositorio con una estrella en GitHub.
• 🐛 Informa de los problemas y comparte los registros/capturas de topología para mejorar la compatibilidad con más routers.
• 💬 Comparte capturas de pantalla y comentarios sobre tu configuración para que podamos seguir mejorando la experiencia.
• 💸 Wise
• 💸 PayPal

Cada comentario ayuda a mantener MiWiFi XiaoHack Edition en buen estado y en constante evolución. 🙌

📊 Resumen de cambios

📝 Changelog — Integración MiWiFi

📦 Versión v3.4.7 — 2025-12-19

🆕 Modelo compatible

• ✅ Se agregó compatibilidad con el nuevo modelo de enrutador RC02 #194

📘 Cómo actualizar

1. HACS: Abra HACS → *Integraciones* → MiWiFi → Actualizar → Reinicie Home Assistant.
2. Manual: Reemplace la carpeta custom_components/miwifi/ con la nueva versión → Reinicie Home Assistant.
3. Después de reiniciar, verifique:

• Las reglas NAT se muestran correctamente en su enrutador principal.
• Agregar o eliminar reglas funciona como se espera.
• (Opcional) Compruebe los registros de la ruta NAT seleccionada (predeterminada o alternativa).

ℹ️ Información adicional

• Si anteriormente aplicaste parches a los puntos finales por modelo, el nuevo mapa centralizado tendrá prioridad.
• Para obtener información de diagnóstico, habilite el registro de depuración para custom_components.miwifi y busque mensajes sobre rutas NAT detectadas automáticamente.

💖 Soporte y donaciones

Si este proyecto te resulta útil y quieres apoyar su desarrollo futuro:

• ⭐ Marca el repositorio con una estrella en GitHub.
• 🐛 Informa de los problemas y comparte los registros/capturas de topología para mejorar la compatibilidad con más routers.
• 💬 Comparte capturas de pantalla y comentarios sobre tu configuración para que podamos seguir mejorando la experiencia.
• 💸 Wise
• 💸 PayPal

Cada comentario ayuda a mantener MiWiFi XiaoHack Edition en buen estado y en constante evolución. 🙌

📝 Changelog — Integración MiWiFi

📦 Versión v3.4.6 — 2025-12-06

🆕 Modelo compatible

• ✅ Se agregó compatibilidad con el nuevo modelo de enrutador R4ACv2 #183

✅ Correcciones y estabilidad

-

⚙️ Mejoras

-

🧩 Compatibilidad

-

📘 Cómo actualizar

1. HACS: Abra HACS → *Integraciones* → MiWiFi → Actualizar → Reinicie Home Assistant.
2. Manual: Reemplace la carpeta custom_components/miwifi/ con la nueva versión → Reinicie Home Assistant.
3. Después de reiniciar, verifique:

• Las reglas NAT se muestran correctamente en su enrutador principal.
• Agregar o eliminar reglas funciona como se espera.
• (Opcional) Compruebe los registros de la ruta NAT seleccionada (predeterminada o alternativa).

ℹ️ Información adicional

• Si anteriormente aplicaste parches a los puntos finales por modelo, el nuevo mapa centralizado tendrá prioridad.
• Para obtener información de diagnóstico, habilite el registro de depuración para custom_components.miwifi y busque mensajes sobre rutas NAT detectadas automáticamente.

💖 Soporte y donaciones

Si este proyecto te resulta útil y quieres apoyar su desarrollo futuro:

• ⭐ Marca el repositorio con una estrella en GitHub.
• 🐛 Informa de los problemas y comparte los registros/capturas de topología para mejorar la compatibilidad con más routers.
• 💬 Comparte capturas de pantalla y comentarios sobre tu configuración para que podamos seguir mejorando la experiencia.
• 💸 Wise
• 💸 PayPal

Cada comentario ayuda a mantener MiWiFi XiaoHack Edition en buen estado y en constante evolución. 🙌

📝 Registro de cambios — Integración con MiWiFi 📦 Versión v3.4.5 – 2025-11-27

✅ Correcciones y estabilidad

• Mejora del manejo interno de los contadores de tráfico del enrutador:
• Si el enrutador no expone el punto final de tráfico misystem (o devuelve datos inesperados), la integración ahora falla de forma controlada sin interrumpir las actualizaciones del dispositivo.
• Se han añadido comprobaciones de seguridad al analizar los valores de descarga / carga por dispositivo para evitar errores de tipo/análisis en algunos firmwares.
• Pequeñas modificaciones internas en el flujo de actualización para que los dispositivos Wi-Fi y LAN mantengan siempre sus atributos actualizados, incluso si no se dispone de los totales de tráfico.
• Mejoras en la fiabilidad del purgado automático:
• El servicio purge_inactive_devices ahora maneja correctamente los rastreadores de dispositivos sin MAC ni last_activity (por ejemplo, entradas antiguas _2 que se quedan como no disponibles) cuando include_orphans_without_age está habilitado, de modo que se pueden eliminar limpiamente del registro de entidades/dispositivos.
• El programador global de purga automática se ha alineado con el nuevo esquema de servicio y ahora lo llama con parámetros consistentes (only_randomized: false, include_orphans: true, include_orphans_without_age: true), lo que garantiza que los rastreadores inactivos, duplicados y huérfanos con más de N días de antigüedad se eliminen realmente.

⚙️ Mejoras

Uso total por dispositivo (descarga + subida)

• Nuevo atributo: total_usage para cada dispositivo rastreado, ahora respaldado por contadores del enrutador:
• La integración lee la información global del misystem (lista de dispositivos) y, para cada MAC, suma:
• descargar + subir → total de bytes utilizados por ese dispositivo.
• Estos totales se aplican a todos los dispositivos conocidos (Wi-Fi y LAN) cada vez que se actualiza el actualizador.
• El atributo total_usage del rastreador de dispositivos ahora utiliza un formato más legible:
• Si el uso es inferior a 1 GB, se muestra en MB (con 2 decimales), por ejemplo, 257,34 MB.
• Si el uso es de 1 GB o más, se muestra en GB (con 2 decimales), por ejemplo, 3,50 GB.
• El comportamiento es totalmente automático:
• Si el enrutador expone el punto final misystem con contadores por dispositivo, el atributo se rellena.
• De lo contrario, el atributo vuelve a tener el valor 0 MB sin errores.

✅ Compatibilidad

• No se producirán cambios incompatibles con las instalaciones existentes:
• Los enrutadores sin un punto final misystem compatible simplemente no mostrarán los totales por dispositivo (el atributo se mantiene en 0 MB).
• Los enrutadores que ya exponen contadores de descarga / carga (como la clase RA70/RA81) se beneficiarán automáticamente del nuevo atributo total_usage.
• La nueva lógica funciona con ambos:
• Enrutadores principales y
• Dispositivos Mesh/LAN conectados a ellos, siempre que el enrutador informe su MAC y tráfico en misystem.
• La lógica de purga mejorada afecta únicamente a las entidades/dispositivos MiWiFi y es segura para configuraciones mixtas:
• Solo eliminará los rastreadores de dispositivos MiWiFi y sus dispositivos asociados que coincidan con las reglas de inactividad y que no se compartan con otras entradas de configuración.

📘 Cómo actualizar

1. De HACS (recomendado):

• Abra HACS → Integraciones.
• Localiza MiWiFi XiaoHack Edition.
• Haz clic en “Actualizar” (si está disponible) y reinicia Home Assistant.

1. Actualización manual:

• Descarga la carpeta custom_components/miwifi para la versión v3.4.4 desde el repositorio.
• Reemplace su carpeta custom_components/miwifi existente.
• Reinicia Home Assistant.

1. Después del reinicio:

• Comprueba Ajustes → Dispositivos y servicios → MiWiFi para asegurarte de que la integración se ha cargado sin errores.
• Abra cualquier rastreador de dispositivos MiWiFi y verifique el nuevo atributo total_usage (puede que tarde un ciclo de actualización en aparecer).
• Opcionalmente, ejecute el servicio __HTML_PLACEHOLDER_0__ (con apply: false) para ver qué se eliminaría y, a continuación, con apply: true para limpiar realmente los rastreadores antiguos.

ℹ️ Información adicional

• El valor total_usage se calcula a partir de los contadores del lado del enrutador:
• Representa el tráfico total desde que se iniciaron los contadores del enrutador (normalmente desde el último reinicio o restablecimiento), no por día/hora.
• Los valores pueden restablecerse si:
• El enrutador se reinicia o
• El firmware reinicia esos contadores internamente.
• Detalles de la unidad de visualización:
• El atributo de Home Assistant ya está formateado como cadena (XXX.XX MB / XXX.XX GB) para facilitar su lectura.
• Si desea crear sensores/gráficos en MB/GB puros, puede:
• Cree un Sensor de plantilla que analice la parte numérica y la unidad, o
• Lee el atributo sin procesar de custom_components en una integración/automatización personalizada.
• Notas de purga automática:
• El planificador global almacena en auto_purge.json la última ejecución, la próxima fecha prevista, los parámetros y un breve historial de ejecuciones.
• Umbral de inactividad = every_days → este es el valor que se pasa automáticamente como days a purge_inactive_devices.

💖 Soporte y donaciones

Si este proyecto te resulta útil y quieres apoyar su desarrollo futuro:

• ⭐ Marca el repositorio con una estrella en GitHub.
• 🐛 Informa de los problemas y comparte los registros/capturas de topología para mejorar la compatibilidad con más routers.
• 💬 Comparte capturas de pantalla y comentarios sobre tu configuración para que podamos seguir mejorando la experiencia.
• 💸 Wise
• 💸 PayPal

Cada comentario ayuda a mantener MiWiFi XiaoHack Edition en buen estado y en constante evolución. 🙌

Resumen de cambios (v3.4.3 → v3.4.5)