Historial de versiones - MiWiFi XiaoHack Edition

📝 Changelog — Integración MiWiFi

📦 Versión v3.3.4 — 2025-08-05

✨ Nuevas funciones

• Nuevo servicio: __HTML_PLACEHOLDER_0__
• Genera un volcado JSON completo del enrutador principal, que incluye:
• Información sobre el estado del sistema y el hardware
• Configuración de red (WAN, Wi-Fi, topología)
• Información sobre dispositivos conectados y filtros MAC.
• Reglas NAT (single y range)
• Configuración de QoS
• Configuración Wi-Fi completa opcional (SSID, cifrado, etc.)
• Bloques seleccionables: Puedes elegir qué secciones incluir.
• Enmascaramiento de datos sensibles: Opción para anonimizar automáticamente las contraseñas y las direcciones MAC.
• Exportado como __HTML_PLACEHOLDER_0__ para facilitar la descarga, manteniendo el archivo .json sin procesar en /config/www/miwifi/exports.
• Campos traducidos en todos los idiomas compatibles: 🇺🇸 inglés, 🇪🇸 español, 🇩🇪 alemán, 🇫🇷 francés, 🇧🇷 portugués, 🇷🇺 ruso, 🇹🇷 turco, 🇨🇳 chino simplificado.

✅ Correcciones y estabilidad

• Formato JSON ajustado para una mejor legibilidad (sangría de 4 espacios).
• Notificaciones mejoradas: La notificación persistente ahora proporciona un enlace de descarga directa al archivo .zip.

⚙️ Mejoras

• Se han añadido traducciones completas en varios idiomas para los nuevos campos de servicio.
• Se preparó el backend para la futura integración del panel (botón para activar el volcado directamente desde la interfaz de usuario).

📘 Cómo actualizar

1. Reemplaza todos los archivos en custom_components/miwifi/ con la nueva versión.
2. Reiniciar Home Assistant.
3. Acceda a Herramientas para desarrolladores → Servicios, seleccione miwifi.dump_router_data y configure las opciones de volcado.
4. Compruebe /config/www/miwifi/exports/ para encontrar el archivo .zip con el volcado del router.

💖 Soporte y donaciones

Si esta integración te resulta útil, considera apoyar su desarrollo:

• Wise
• PayPal

Cada contribución me ayuda a dedicar más tiempo a desarrollar y mejorar MiWiFi. ¡Gracias! 🙌

📝 Changelog — Integración MiWiFi

📦 Versión v3.3.4 – 2025-08-02

✨ Nuevas funciones

• Añadir directamente funciones no compatibles a través del servicio

Cuando falla una comprobación de compatibilidad, ahora puede utilizar el nuevo servicio miwifi.add_unsupported para agregar un par modelo/característica directamente a unsupported_user.py sin editar archivos manualmente.

• Verificación de doble capa para detectar duplicados

Ahora, el servicio comprueba tanto el archivo original __HTML_PLACEHOLDER_0__ como el archivo de usuario __HTML_PLACEHOLDER_1__ antes de añadir entradas, evitando así duplicados innecesarios.

• Notificaciones dinámicas

Se agregaron notificaciones contextuales:

• ➕ Agregado: Cuando se agrega correctamente un modelo/función.
• ⚠️ Ya existe: Cuando el modelo/característica ya está presente en unsupported.py o unsupported_user.py.

• Soporte multilingüe para nuevas notificaciones

Se han añadido nuevas claves de traducción para todos los idiomas compatibles, con el fin de proporcionar información más clara al usuario.

✅ Correcciones y estabilidad

• Carga dinámica de módulos mejorada:

Carga correctamente unsupported_user.py incluso cuando se utilizan importaciones relativas.

• Operaciones de archivos no bloqueantes:

Las operaciones de escritura de archivos para unsupported_user.py ahora se ejecutan de forma segura para subprocesos, evitando así el bloqueo del bucle de eventos de Home Assistant.

⚙️ Mejoras del backend

• Refactorización de código en __HTML_PLACEHOLDER_0__:

Se agregó get_combined_unsupported() para fusionar dinámicamente unsupported.py y unsupported_user.py para realizar comprobaciones de compatibilidad.

• Comprobador de compatibilidad extendido:

Ahora utiliza el registro combinado no compatible, lo que permite que las entradas personalizadas surtan efecto de inmediato.

✅ Compatibilidad

• ✅ Compatible con Home Assistant 2025.7.4 y versiones posteriores.
• 🧩 Es totalmente compatible con todas las versiones del panel a partir de la 1.3.0.

📘 Cómo actualizar

1. Reemplace todos los archivos dentro de su carpeta custom_components/miwifi/ con el contenido de esta versión.
2. Reiniciar Home Assistant.
3. Utilice el nuevo servicio miwifi.add_unsupported a través de Herramientas para desarrolladores → Servicios para agregar dinámicamente funciones no compatibles.

ℹ️ Información adicional

• Seguridad de los archivos:

Los cambios se almacenan en unsupported_user.py y se conservan durante las actualizaciones.

• Soporte de doble capa:

Ahora la integración lee tanto del archivo unsupported.py (entradas del mantenedor) como del archivo unsupported_user.py (tus entradas personalizadas).

💖 Soporte y donaciones

Si esta integración te resulta útil y quieres apoyar su desarrollo continuo, puedes hacer una donación aquí:

• 💸 Wise
• 💸 PayPal

Cada contribución me ayuda a dedicar más tiempo a desarrollar y mejorar MiWiFi. ¡Gracias! 🙌

📝 Changelog — Integración MiWiFi

📦 Versión v3.3.3 – 2025-08-01

✨ Nuevas funciones

• Limpieza automática para exportaciones de registros:
• El servicio miwifi.download_logs ahora elimina automáticamente los archivos ZIP antiguos, conservando solo el más reciente.
• Calentamiento para los manejadores de registros:
• Ahora, todos los archivos de registro se abren y se inicializan previamente durante el arranque para evitar retrasos o bloqueos cuando se escribe el primer registro.

🛠 Correcciones críticas

• Se eliminó el bloqueo de E/S en la inicialización del registrador:
• Se eliminaron las advertencias de Detected blocking call to open() causadas por la creación tardía del manejador de archivos.
• Ahora, todos los gestores de registros abren los archivos fuera del bucle de eventos, lo que mejora la estabilidad del inicio.
• Se han corregido los errores del servicio __HTML_PLACEHOLDER_0__:
• Se corrigió la creación del directorio usando exist_ok=True, resolviendo [Errno 17] El archivo ya existe al exportar los registros.

✅ Correcciones y estabilidad

• Mayor fiabilidad en la detección de compatibilidad:
• CompatibilityChecker ahora realiza hasta 5 veces (anteriormente 2), lo que reduce los falsos negativos para funciones como rom_update.
• Capacidades detectadas previamente conservadas:
• Si una función se detectaba como compatible anteriormente, ya no se marca como no compatible debido a fallos temporales de red o de la API.
• 🛠️ Lógica de registro de panel fijo:
• El panel ahora solo se vuelve a registrar si cambia la versión del frontend.
• Evita la duplicación de mensajes de registro:
• [MiWiFi] Versión del panel local cargada...
• [MiWiFi] Panel registrado correctamente...
• 🛠️ Inicialización del registrador mejorada:
• Se inicializa solo una vez por integración, evitando así la necesidad de recrear los controladores para cada nodo.
• Evita mensajes duplicados cuando hay varios nodos Mesh activos.
• 🛠️ Gestión optimizada de múltiples nodos:
• Únicamente el router principal gestiona el panel y los servicios globales.
• 🛠 Se evitó el bloqueo durante los reinicios programados del enrutador Solo v3.3.3rc3:

Cuando el enrutador se reinicia (por ejemplo, en el reinicio programado a las 3 AM), topo_graph puede devolver temporalmente None. Ahora, la integración omite de forma segura las comprobaciones de compatibilidad en este estado, evitando AttributeError: el objeto 'NoneType' no tiene el atributo 'get'. Se han añadido registros más claros que indican cuándo se omite la comprobación de compatibilidad debido a un reinicio.

⚙️ Mejoras del backend

• Renovación del sistema de registro:
• Ahora, los manejadores se inicializan de forma anticipada y se calientan para evitar bloqueos durante la ejecución.
• Gestión de registros de limpieza:
• Los archivos ZIP exportados se eliminan automáticamente, dejando solo el archivo más reciente para su descarga.
• 🔧 Depuración más clara:
• Prefijos de registro diferenciados para facilitar el diagnóstico en múltiples enrutadores.
• Mensajes más descriptivos en el panel durante las comprobaciones de versión.
• 🔧 Preparado para la compatibilidad futura con actualizaciones dinámicas del panel.
• Se ha mejorado el registro de eventos para indicar claramente cuándo se pospone la detección de compatibilidad debido a la indisponibilidad del enrutador (por ejemplo, un reinicio en curso).

🚫 Capacidades

• Se ha mejorado el manejo de fallos intermitentes en las comprobaciones de compatibilidad, lo que reduce la probabilidad de que se marquen incorrectamente las funciones como no compatibles.

🆕 Modelo compatible

• *(No se han añadido nuevos modelos en esta versión preliminar)*

🧹 Limpieza de código

• Se ha modificado el verificador de compatibilidad para que utilice los estados de capacidad almacenados en caché cuando estén disponibles.
• Se ha simplificado el servicio de exportación de registros con una limpieza y un manejo de errores más claros.

✅ Compatibilidad

• ✅ Compatible con Home Assistant 2025.5.0 y versiones posteriores.
• 🧩 Compatible con todas las versiones del panel a partir de la 1.3.0.

📘 Cómo actualizar

1. Reemplace todos los archivos dentro de su carpeta custom_components/miwifi/ con el contenido de esta versión.
2. Reiniciar Home Assistant.
3. (Opcional) Utilice el servicio miwifi.download_logs para confirmar el nuevo comportamiento de exportación de registros.

ℹ️ Esta versión preliminar se centra en mejoras de estabilidad y reducción de falsos positivos en la detección de capacidades.

💖 Soporte y donaciones

Si esta integración te resulta útil y quieres apoyar su desarrollo continuo, puedes hacer una donación aquí:

• 💸 Wise
• 💸 PayPal

Cada contribución me ayuda a dedicar más tiempo a desarrollar y mejorar MiWiFi. ¡Gracias! 🙌

📝 Changelog — Integración MiWiFi

📦 Versión v3.3.2 – 2025-07-16

✨ Nuevas funciones

• 🔍 Informe detallado de errores de conexión del router durante la configuración:

Ahora se muestran los motivos específicos del error (por ejemplo, tiempo de espera agotado, rechazo, error 500) directamente en la interfaz de usuario al agregar o editar el enrutador. Esto ayuda a diagnosticar los problemas de conexión con mayor claridad y evita mensajes vagos de "error desconocido".

🧪 Ejemplo:

❌ Error al conectar con el router: Timeout reading from 192.168.31.1

• 📦 Nuevo servicio: __HTML_PLACEHOLDER_0__

Permite a los usuarios descargar todos los registros de MiWiFi como un archivo ZIP directamente desde el panel de integración o a través de los servicios de Home Assistant. Se genera automáticamente un enlace en el que se puede hacer clic para guardar o compartir fácilmente.

• 🧹 Nuevo servicio: __HTML_PLACEHOLDER_0__

Elimina todos los archivos .log y los recrea instantáneamente sin necesidad de reiniciar la integración manualmente. Útil para borrar registros desde el frontend o mediante automatizaciones.

• 💬 Notificaciones localizadas y centralizadas

Todas las notificaciones (dispositivo nuevo detectado, router no compatible, registros listos, contraseña generada, etc.) ahora se traducen dinámicamente según la configuración de idioma de Home Assistant.

• 🧭 Clase unificada __HTML_PLACEHOLDER_0__

Ahora, todas las notificaciones y la gestión de traducciones se realizan a través de una única clase reutilizable. Esto mejora la facilidad de mantenimiento y garantiza la coherencia en todos los servicios.

• 🌐 Se agregó soporte para la traducción al chino simplificado (zh-Hans)

✅ Correcciones y estabilidad

• 🔁 Se redujeron los registros repetitivos al leer la versión del panel de la interfaz:

Se almacenó en caché la versión cargada (read_local_version) en la memoria para evitar saturar los registros con Versión del panel local cargada: .... Garantiza que este mensaje aparezca solo una vez por ciclo de actualización o en la primera instalación.

• 🧹 Se evitaron registros repetidos de "Panel actualizado" durante la monitorización del panel:

Ahora solo se registra una vez, a menos que cambie la versión. Mantiene los registros de Home Assistant más limpios y fáciles de leer.

• ✅ Se ha mejorado el comportamiento del formulario de configuración para proporcionar mensajes de error más claros cuando falla la conexión con el enrutador.
• ✅ Ahora registra el código de error HTTP exacto (403, 404, 408, etc.) y el motivo (No se pudo obtener el token, La llamada de conexión falló, etc.) durante la validación de acceso inicial.

⚙️ Mejoras del backend

• 🧠 La lógica interna ahora almacena y reutiliza la última versión del frontend verificada, lo que mejora la eficiencia y el rendimiento generales.
• ✅ save_local_version() borra la caché de versiones interna para forzar una recarga cuando sea necesario.
• 🛠 Se ha refactorizado async_verify_access() para que devuelva tanto el código HTTP como el motivo del error, lo que permite un mejor diagnóstico.
• 🧾 Ahora los errores se registran en detalle y se traducen en mensajes claros para el usuario a través de router.error_with_reason.
• 🧱 Refactorización completa de la lógica interna de persistent_notification utilizando la clase MiWiFiNotifier.
• 🌍 Las traducciones dinámicas ahora se cargan desde el disco si no están ya almacenadas en la memoria caché.
• 📚 Cobertura completa de teclas en los archivos de traducción: new_device, download_ready, unsupported_router, self_check, calc_passwd, suggest_unsupported.
• 🧠 Se agregó registro de nivel de depuración en config_flow.py, helper.py y updater.py para diagnosticar fallas de conexión incluso antes de que se configure la integración.
• 💡 El sistema de errores ahora genera claves de error como router.error_with_reason::reason_text para que el mensaje exacto aparezca en la interfaz de usuario.
• 🧾 Los motivos de error como "No se pudo obtener el token" o "Error en la llamada de conexión" ahora se muestran claramente a los usuarios, lo que ayuda a distinguir entre direcciones IP no válidas, contraseñas incorrectas o enrutadores no compatibles.
• 🧠 Se reemplazó la condición anterior basada en topo_graph.is_main con una detección de características adecuada a través de capabilities["portforward"].

Esto garantiza que las reglas NAT solo se obtengan cuando el enrutador las admita oficialmente.

• 🧪 Se ha añadido una nueva comprobación de compatibilidad: portforward.

Esto verifica dinámicamente si el enrutador admite la API xqnetwork/portforward mediante el CompatibilityChecker.

• 📊 El sensor MiWiFi NAT Rules ahora solo se activa en los routers que admiten explícitamente las funciones NAT, lo que reduce los errores y los falsos positivos en los nodos de malla o en los modelos no compatibles.

• ✅ Se eliminó la dependencia innecesaria de la detección de la topología de la malla (topo_graph) para las funciones relacionadas con NAT.

✅ Compatibilidad

• 🌐 Se agregó soporte para la traducción al chino simplificado (zh-Hans)
• ✅ Compatible con Home Assistant 2025.5.0 y versiones posteriores.
• 🧩 Compatible con todas las versiones del panel a partir de la 1.3.0.

📘 Cómo actualizar

1. Reemplace todos los archivos dentro de su carpeta custom_components/miwifi/ con el contenido de esta versión.
2. Reiniciar Home Assistant.
3. Comprueba que el panel MiWiFi se carga correctamente y que los registros repetitivos han desaparecido de Herramientas para desarrolladores > Registros.

ℹ️ Esta versión mejora la claridad de los registros y el rendimiento del backend al eliminar los mensajes de estado repetidos de las comprobaciones de versión del panel.

💖 Soporte y donaciones

Si esta integración te resulta útil y quieres apoyar su desarrollo continuo, puedes hacer una donación aquí:

• 💸 Wise
• 💸 PayPal

Cada contribución me ayuda a dedicar más tiempo a desarrollar y mejorar MiWiFi. ¡Gracias! 🙌

📝 Changelog — Integración MiWiFi

📦 Versión v3.3.1 – 2025-07-14

✅ Correcciones y estabilidad

• 🧵 Se evitó el bloqueo del bucle de eventos al cargar las traducciones:
• Se reemplazaron las llamadas directas a load_json() con await hass.async_add_executor_job(...) al leer archivos de traducción desde el disco. #42
• Esto soluciona la advertencia de Home Assistant:

_“Se detectó una llamada bloqueante a open(...) dentro del bucle de eventos...”_

⚙️ Mejoras

• 🌐 Descarga automáticamente la última versión del panel de interfaz en la primera instalación:
• Cuando el archivo de versión local (.storage/miwifi/miwifi_panel_version.json) no existe (instalación nueva), la integración ahora obtiene la última versión disponible del panel de GitHub usando version.json.
• Esto reemplaza la lógica de reserva codificada DEFAULT_PANEL_VERSION.

✅ Compatibilidad

• ✅ Compatible con Home Assistant 2025.6.0 y versiones posteriores.
• 🔁 Totalmente compatible con versiones anteriores de paneles instalados previamente (versión 1.2.3 y superiores).

📘 Cómo actualizar

1. Reemplace todos los archivos dentro de su carpeta custom_components/miwifi/ con el contenido de esta versión.
2. Reiniciar Home Assistant.
3. Comprueba que el panel MiWiFi se carga correctamente y que no aparecen advertencias de blocking call to open en los registros.

ℹ️ Esta versión mejora el comportamiento de la primera instalación y garantiza la compatibilidad a largo plazo con las próximas versiones de Home Assistant.

💖 Soporte y donaciones

Si esta integración te resulta útil y quieres apoyar su desarrollo continuo, puedes hacer una donación aquí:

• 💸 Wise
• 💸 PayPal

Cada contribución me ayuda a dedicar más tiempo a desarrollar y mejorar MiWiFi. ¡Gracias! 🙌