Historial de versiones - MiWiFi XiaoHack Edition

📝 Registro de cambios — Integración con MiWiFi 📦 Versión v3.4.4 – 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.4)

📝 Changelog — Integración MiWiFi

📦 Versión v3.4.3 — 2025-11-07

🆕 Modelo compatible

• ✅ Se agregó compatibilidad con el nuevo modelo de enrutador RD04 #150

✅ Correcciones y estabilidad

• Detección automática de NAT/Reenvío de puertos: Si la ruta predeterminada xqnetwork/portforward falla, la integración recurre a __HTML_PLACEHOLDER_1__ y actualiza todo el grupo de rutas NAT (agrega/elimina/aplica) según corresponda. Esto restablece las reglas NAT en los firmwares que usan xqsystem/*.
• Gestión más robusta de las llamadas de cierre de sesión/ROM/NAT mediante la lectura de rutas del nuevo mapa de enrutamiento en lugar de cadenas codificadas directamente.
• Pequeñas correcciones para eliminar llamadas obsoletas y mensajes de depuración.

⚙️ Mejoras

• Se introdujo un mapa centralizado __HTML_PLACEHOLDER_0__ (en luci.py) y el uso interno de __HTML_PLACEHOLDER_2__ en todos los métodos de la API (inicio de sesión, estado, Wi-Fi, QoS, NAT, ROM...).

→ La personalización de rutas por modelo ahora es sencilla y localizada.

• Borre los registros de depuración para indicar qué ruta NAT se seleccionó (predeterminada o alternativa) y por qué.
• Normalización del modelo a minúsculas para evitar discrepancias que distingan entre mayúsculas y minúsculas.

🧩 Compatibilidad

• Compatibilidad confirmada para puntos finales NAT en firmwares que exponen __HTML_PLACEHOLDER_0__ (por ejemplo, RC06 y variantes similares).
• Sin cambios incompatibles. La versión mínima de Home Assistant permanece sin cambios.

📘 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.

🙌 Expresiones de gratitud

Muchísimas gracias a Harpik por el trabajo preliminar en la personalización de la ruta de la API y a Jose Manuel Usero por sus valiosas aportaciones para la detección mejorada de NAT. Vuestras contribuciones hicieron posible este lanzamiento. 💪

Resumen de cambios

📝 Changelog — Integración MiWiFi

📦 Versión v3.4.2 – 2025-10-23

✨ Nuevas funciones

• 🔐 Detección automática de protocolo (HTTPS primero):

La integración ahora intenta automáticamente usar HTTPS primero y, si el enrutador no responde correctamente, recurre de forma segura a HTTP. Constantes añadidas: ``python PROTOCOL_AUTO = "auto" PROTOCOL_HTTP = "http" PROTOCOL_HTTPS = "https" PROTOCOLO_PREDETERMINADO = PROTOCOLO_AUTOMÁTICO PROTOCOL_OPTIONS = [PROTOCOL_AUTO, PROTOCOL_HTTP, PROTOCOL_HTTPS] `` La URL base se compone dinámicamente en función del protocolo detectado, que se almacena en caché para agilizar las solicitudes.

• 🧠 Alternativa al enrutador principal (integración única):

Cuando solo se configura una instancia de MiWiFi, se marca automáticamente como el enrutador principal (is_main=True) con indicadores de trazabilidad: ``python is_main_auto = Verdadero auto_reason = "single_integration_fallback" `` evitar situaciones de “no hay enrutador principal” y mantener la consistencia de los sensores dependientes.

🛠 Correcciones críticas

• 🧩 Robustez del protocolo: evita estados “indecisos”: cualquier respuesta que no sea 5xx bloquea el protocolo de forma segura.
• 🧭 Detección mejorada del router principal: lógica más predecible al combinar configuraciones manuales y automáticas.

✅ Correcciones y estabilidad

• 📝 Registros más claros: mensaje de debug explícito cuando el enrutador se configura a través de *single_integration_fallback*.
• 🔄 Detección de protocolo en caché: _detect_protocol() ahora almacena su resultado para evitar pruebas repetidas por enrutador.

⚙️ Mejoras del backend

• 🧱 Se agregó _get_url() para construir la URL base dinámicamente utilizando el protocolo detectado.
• 🧪 _detect_protocol() ahora utiliza un cliente HTTP asíncrono con un tiempo de espera de 5 segundos para pruebas no bloqueantes.
• ⚙️ Todas las constantes de protocolo están agrupadas en un bloque Constantes de protocolo específico con la documentación adecuada.

🧹 Limpieza de código

• ♻️ Se han reordenado las constantes y las cadenas de documentación para mayor claridad.
• 🧽 Se eliminaron ramas redundantes en la lógica de detección del enrutador principal.

✅ Compatibilidad

• ✅ Compatible con Home Assistant 2025.5.0 +
• ✅ Totalmente compatible con todos los Paneles MiWiFi 1.3.0 +

📘 Cómo actualizar

1. Reemplace su carpeta custom_components/miwifi/ con esta versión.
2. Reiniciar Home Assistant.
3. Compruebe los registros de depuración de Home Assistant para confirmar la detección del protocolo y la correcta asignación del router principal.

🙌 Créditos

• 💡 Harpik — por el concepto y la base técnica de la detección de protocolo HTTPS-first.
• 🔍 José Manuel Usero — por mejorar la detección del enrutador principal y la precisión del enrutador de respaldo.
• 💖 Muchísimas gracias a toda la comunidad de XiaoHack por probar, informar y apoyar el proyecto.

💖 Soporte y donaciones

Si te gusta esta integración y quieres apoyar su desarrollo:

• 💸 Wise
• 💸 PayPal

¡Gracias por tu apoyo! 🙌

Resumen de cambios (v3.4.1 → v3.4.2)

📝 Changelog — Integración MiWiFi

📦 Versión v3.4.1 – 2025-10-13

🆕 Modelo compatible

• ✅ Se ha añadido compatibilidad con el nuevo modelo de router RN09.

✅ Compatibilidad

• ✅ Compatible con Home Assistant 2025.8.0 y versiones posteriores.

📘 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. Agregue manualmente su primer enrutador para activar la detección automática de la red mallada para los demás dispositivos.

💖 Soporte y donaciones

Si este proyecto te resulta útil, considera apoyar su desarrollo. ¡Gracias por mantener vivo el ecosistema de XiaoHack!

• 💸 Wise
• 💸 PayPal

¡Gracias por tu apoyo! 🙌

ℹ️ Esta actualización mejora la claridad de la detección, la fiabilidad y la retroalimentación visual, especialmente para los usuarios con varios routers.

Mantenido con ❤️ por @JuanManuelRomeroGarcia

📝 Changelog — Integración MiWiFi

📦 Versión v3.4.0 – 2025-09-09

🆕 Modelo compatible

• ✅ Se ha añadido compatibilidad con el nuevo modelo de router CR8809

✅ Compatibilidad

• ✅ Compatible con Home Assistant 2025.8.0 y versiones posteriores.

📘 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. Agregue manualmente su primer enrutador para activar la detección automática de la red mallada para los demás dispositivos.

💖 Soporte y donaciones

Si este proyecto te resulta útil, considera apoyar su desarrollo. ¡Gracias por mantener vivo el ecosistema de XiaoHack!

• 💸 Wise
• 💸 PayPal

¡Gracias por tu apoyo! 🙌

ℹ️ Esta actualización mejora la claridad de la detección, la fiabilidad y la retroalimentación visual, especialmente para los usuarios con varios routers.

Mantenido con ❤️ por @JuanManuelRomeroGarcia