Historial de versiones - MiWiFi XiaoHack Edition

📝 Changelog — Integración MiWiFi

📦 Versión v3.5.0 – 2026-01-03

✅ Correcciones y estabilidad

• 🧠 Exposición estable de métricas por dispositivo: las métricas de tráfico/uso del dispositivo ahora se exponen a través de entidades de sensores dedicadas (en lugar de depender únicamente de los atributos device_tracker), lo que mejora la compatibilidad entre paneles y automatizaciones.
• 🔄 Actualizaciones dinámicas y fiables: los nuevos sensores de dispositivos se crean automáticamente cuando se detecta un nuevo cliente, sin necesidad de reiniciar Home Assistant (conectados al mismo flujo interno de actualización/señalización).
• 🧹 Ciclo de vida de entidades más limpio: los sensores de los dispositivos siguen la misma lógica de limpieza que los dispositivos rastreados, evitando entidades huérfanas después de las purgas.

⚙️ Mejoras

• 📡 Nuevos sensores por dispositivo (un conjunto por entidad cliente), creados a partir de la misma fuente autorizada (updater.devices) utilizada por el rastreador:
• sensor.<entidad>_velocidad_de_descenso
• sensor.<entidad>_velocidad_de_subida
• sensor.<entidad>_uso_total
• sensor.<entidad>_calidad_de_la_señal
• sensor.<entidad>_señal
• sensor.<entidad>_ip
• sensor.<entidad>_conexión
• sensor.<entidad>_en línea
• sensor.<entidad>_última_actividad
• sensor.<entidad>_primer_visto
• sensor.<entidad>_internet_bloqueado

• 📏 Unidades legibles por humanos (enfoque de alta disponibilidad recomendado):
• La velocidad de los dispositivos se muestra como DATA_RATE con unidades nativas en Bytes/s, lo que permite a Home Assistant mostrar automáticamente kB/s / MB/s cuando corresponda.
• El uso total se muestra como DATA_SIZE con unidades nativas en Bytes, lo que permite a Home Assistant mostrar automáticamente MB / GB en función del valor.

• 🔗 Coherencia en el registro de dispositivos: los sensores están vinculados a la misma entrada del dispositivo cliente (por MAC), lo que mejora la experiencia de la página del dispositivo y la agrupación de entidades.

✅ Compatibilidad

• ✅ Totalmente compatible con las entidades device_tracker.miwifi_* existentes.
• ✅ No hay cambios incompatibles en los atributos del rastreador; los sensores son aditivos.
• ✅ Utiliza las mejores prácticas de Home Assistant (device_class, state_class) para preservar las estadísticas, el historial y el formato de la interfaz de usuario.

📘 Cómo actualizar

1. Actualiza los archivos de integración a la versión 3.5.0.
2. Reiniciar Home Assistant.
3. Opcional (recomendado si ya ha probado versiones anteriores):

• Si observa que aún se muestran unidades antiguas, revise la configuración de la entidad (anulaciones de unidades personalizadas) o elimine las entidades afectadas del Registro de entidades y vuelva a empezar.

ℹ️ Información adicional

Ejemplo: nuevas entidades por dispositivo

• Antes: el tráfico/uso solo estaba disponible dentro de los atributos device_tracker.
• Ahora: puedes crear paneles/automatizaciones directamente utilizando sensores como:
• sensor.servidor_down_speed
• sensor.servidor_total_usage

Notas

• La velocidad y el uso se muestran con unidades nativas estables; Home Assistant se encarga de la escala legible (MB/s, GB, etc.) en la interfaz de usuario.

💖 Soporte y donaciones

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

• 💸 Wise
• 💸 PayPal

🧾 Resumen de cambios

📝 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. 🙌