Historial de versiones - MiWiFi XiaoHack Edition

📦 Edición MiWiFi XiaoHack – v3.1.3

🚀 Registro integrado en el frontend y detección de fallos mejorada en la integración de MiWiFi para Home Assistant. Esta versión ofrece mejores diagnósticos desde el panel web y un sistema de registro de backend robusto para desarrolladores y usuarios avanzados.

✨ Nuevas funciones

🆕 Nuevo servicio log_panel

• El panel MiWiFi ahora puede enviar mensajes de registro directamente al archivo home-assistant.log de Home Assistant.
• Ayuda a diagnosticar errores como topología faltante, recargas fallidas o problemas del lado de JavaScript.
• Cada registro está etiquetado con [PanelJS] para facilitar el filtrado en los registros del backend.
• Servicio: miwifi.log_panel

🛜 Registro de todos los módulos del panel

• Todas las páginas (status, topologia, mesh, settings, miwifi-devices, router y panel-frontend) ahora registran las acciones importantes del usuario y el comportamiento de reserva en el backend.
• Ahora se realiza un seguimiento de las acciones de navegación y los desencadenantes de recarga para la depuración.

🔄 Correcciones de comportamiento

✅ Detección de enrutador de reserva

• Detección mejorada del enrutador principal mediante:
• graph.is_main === true si está disponible (desde el backend)
• o recurrir a show === 1 && assoc === 1
• o bien, como último recurso, recurrir a mode === 0.

🧹 limpieza de codificación

• Se corrigieron varios errores de decodificación utf-8 en updater.py que causaban fallos en la importación de la integración.
• Ahora todas las cadenas son totalmente compatibles entre diferentes entornos y versiones de Python.

🛠 Cambios técnicos

• Se ha añadido la utilidad logToBackend() en utils.js.
• Nuevo servicio log_panel registrado en services.py y conectado en el backend.
• Los archivos status.js, topologia.js, mesh.js, settings.js y router.js incluyen activadores de registro detallados.
• Ahora se registran las causas raíz de los problemas de actualización automática y de la detección de paneles en blanco.
• El archivo panel-frontend.js ahora registra cuándo se requiere presionar Ctrl+F5 y cuándo se aplican o fallan las configuraciones.

🧪 Validado

• ✅ miwifi.log_panel acepta mensajes de registro y los guarda en home-assistant.log.
• ✅ Los registros aparecen etiquetados con PanelJS y se clasifican por gravedad.
• ✅ La detección de reserva funciona con enrutadores que no están marcados como is_main.
• ✅ Los cambios en el frontend se conservan en la caché con cadenas de versión actualizadas.

🧩 Requisitos

• Home Assistant 2025.0 o posterior.
• Versión del panel ≥ 1.2.2 y enable_panel: true configurado en la configuración.

Gracias por apoyar el proyecto ✨ Mantente al día a través de xiaohack.es o GitHub

📦 Edición MiWiFi XiaoHack – v3.1.2

🚀 Mejoras de mantenimiento y estabilidad para la integración de MiWiFi en Home Assistant. Esta versión corrige la gestión de actualizaciones del panel, mejora el almacenamiento de versiones y garantiza un funcionamiento fiable desde la primera instalación.

✨ Nuevas funciones

🆕 Nueva entidad update.miwifi_panel_frontend

• Se agregó una UpdateEntity para el panel MiWiFi (frontend).
• Comprueba automáticamente si hay versiones más recientes en GitHub.
• Permite actualizar con un solo clic a través de la interfaz de usuario de Home Assistant.
• Tras la actualización, muestra una notificación persistente para recordar a los usuarios que actualicen la página (Ctrl+F5).

🔁 Seguimiento automático de versiones

• La versión del panel local se almacena en .storage/miwifi/miwifi_panel_version.json.
• Si el archivo no existe, se crea automáticamente con la versión 1.0.

🔄 Correcciones de comportamiento

• Se solucionó un problema por el cual la entidad de actualización se marcaba como "no disponible" cuando la versión local era 0.0.
• La entidad de actualización del panel ahora se inicializa correctamente incluso en la primera instalación.

🛠 Cambios técnicos

• frontend.py ahora gestiona correctamente la creación de la versión predeterminada.
• Se han añadido funciones auxiliares de estado global para panel_enabled y log_level.
• Se han resuelto errores como save_local_version no está definido y problemas de importación de dt_util.

🧪 Validado

• ✅ update.miwifi_panel_frontend se crea después de la configuración de la integración.
• ✅ Las actualizaciones remotas se detectan desde version.json.
• ✅ El panel se puede actualizar directamente desde la interfaz de usuario.
• ✅ No se producen errores tras actualizar el navegador después de la actualización.

🧩 Requisitos

• Home Assistant 2024.4 o posterior.
• El panel debe estar habilitado desde la configuración de integración (enable_panel: true).

Gracias por apoyar el proyecto ✨ Mantente al día a través de xiaohack.es o GitHub.

📦 Edición MiWiFi XiaoHack – v3.1.1

🚀 Integración avanzada para routers Xiaomi y Redmi con soporte completo para panel de control, capacidades de red mallada y gestión de actualizaciones.

🔧 Mantenido por @JuanManuelRomeroGarcia – xiaohack.es

✨ Novedades de la versión 3.1.1

🆕 Soporte para actualización automática del panel de control

• Detecta y realiza un seguimiento de la versión del panel frontal personalizado de MiWiFi (interfaz de usuario en JavaScript).
• La nueva entidad update.miwifi_panel_frontend permite actualizar el panel directamente desde la interfaz de usuario de Home Assistant.
• Tras la actualización, una notificación persistente informa a los usuarios que deben actualizar su navegador (Ctrl+F5).
• Se conecta automáticamente al dispositivo principal (router Xiaomi/Redmi) para una gestión coherente.

⚠️ Advertencia sobre la versión de la interfaz de usuario

• El panel de MiWiFi ahora muestra una advertencia de versión si la interfaz de usuario está desactualizada.
• Utiliza la comparación de versiones del backend entre __MIWIFI_VERSION__ y la versión del panel instalado.

🧰 Características principales

• 🔧 Control WiFi: 2.4GHz / 5GHz / 5G Juego / Invitado
• 🧠 Información sobre la memoria y la CPU
• 🌐 IP WAN, sensores de velocidad (configurables en MB/s o B/s)
• 📶 Seguimiento de dispositivos en tiempo real por MAC/IP
• 🔁 Compatibilidad con actualización de firmware OTA
• 🌐 Totalmente localizado: 🇪🇸 Español y 🇬🇧 Inglés
• 🪛 Selector de nivel de registro desde el panel de configuración
• 🖼 Panel frontal opcional inspirado en la interfaz de usuario original de Xiaomi.

✅ Compatibilidad

• ✅ Home Assistant 2025.4.0 o posterior
• ✅ Compatible con routers Xiaomi y Redmi (series AX/BE)
• ✅ Compatible con redes malladas y repetidores

📘 Cómo usar

1. Ve a Ajustes → Dispositivos y servicios → MiWiFi
2. Asegúrese de que update.miwifi_panel_frontend aparezca
3. Si hay una actualización disponible, haga clic en Actualizar.
4. Espera la notificación y luego presiona Ctrl+F5 en tu navegador.

Importante: La integración obtiene archivos remotos de miwifi-panel-frontend; asegúrese de que version.json y files.json estén actualizados.

🔄 Registro de cambios

De v3.1.0 → v3.1.1

• ➕ Se agregó una entidad de actualización para el panel MiWiFi
• ➕ Notificación persistente tras la actualización exitosa del panel
• ➕ Enlace de dispositivos mejorado a través de MAC
• 🐛 Se corrigieron las advertencias de update_coordinator
• ♻️ Se ha refactorizado la lógica de async_install y async_added_to_hass.

📎 Campo de golf

• 💡 Proyecto: hass-miwifi
• 🎨 Panel: miwifi-panel-frontend
• 🌐 Web: xiaohack.es

📦 Edición MiWiFi XiaoHack – v3.1.0

🚀 Integración avanzada para routers Xiaomi y Redmi con panel visual y soporte para redes Mesh.

🛠 Mantenido por @JuanManuelRomeroGarcia – xiaohack.es

✨ Novedades de la versión 3.1.0

🖼 Panel MiWiFi integrado (nuevo panel gráfico)

• Topología de red al estilo Xiaomi: enrutador principal, nodos Mesh y clientes conectados.
• Se puede habilitar desde las opciones de integración (enable_panel: true).
• Diseño profesional: fondo azul #1a73e8, texto blanco, diseño limpio y adaptable.
• No se necesitan tarjetas Lovelace externas.

📶 Nuevo modelo compatible: Redmi Router RN07

• Compatibilidad total con el modelo interno RA83 (AX3000 Enhanced Edition).
• Funciona con los modos repetidor y de malla, y es totalmente controlable a través de la interfaz de usuario.

🧰 Características generales

• 🔧 Gestión de WiFi (2,4 GHz, 5 GHz, 5 GHz para juegos, invitados).
• 📈 Sensores para RAM, temperatura, IP WAN, velocidades de red, modo, etc.
• 👁️ Seguimiento de dispositivos con device_tracker.
• 🧠 Detección automática de nodos de malla.
• 🔄 Actualizaciones de firmware OTA cuando estén disponibles.
• 🌐 Selector de nivel de registro desde la interfaz de usuario (advertencia, información, depuración).
• 🌍 Localización completa en español e inglés.

✅ Compatibilidad

• Compatible con Home Assistant 2025.4.0+.
• Compatible con versiones anteriores: v3.0.8 y v3.0.9.
• Compatible con los populares routers Xiaomi y Redmi.

Vea la lista completa de modelos en la wiki de compatibilidad.

🔄 Cómo actualizar

1. Reemplace todo el contenido del directorio custom_components/miwifi/ con los archivos de esta versión.
2. Reinicia completamente Home Assistant.
3. Ve a Ajustes → Dispositivos y servicios → MiWiFi → Opciones y configura:

• Nivel de registro.
• Habilitar o deshabilitar el panel MiWiFi.

📌 Migración desde el repositorio original

Si vienes de dmamontov/hass-miwifi:

1. Elimina la integración original de Home Assistant.
2. Agregue este repositorio como una fuente personalizada en HACS:

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

📘 Registro completo de cambios: v3.0.9...v3.1.0

📦 v3.0.9 – Edición XiaoHack

Esta es una versión con nuevas funciones que se basa en la sólida base de la versión v3.0.8b4. Introduce control global de registro, localización completa al español y compatibilidad con un nuevo modelo de router Xiaomi.

✨ Nuevas funciones

• 🌐 Selector de nivel de registro global en la interfaz de usuario #12

Ahora puedes elegir entre warning, info o debug en las opciones de integración. El nivel de registro se aplica a todos los enrutadores y actualizaciones sin necesidad de realizar cambios en el código.

• 🌍 Traducciones al español añadidas

Todos los formularios, sensores y estados de las entidades están ahora completamente localizados al español. La integración se adapta dinámicamente en función del idioma seleccionado por el usuario en Home Assistant.

• 📶 Nuevo dispositivo compatible: Router Xiaomi AX1500

Se agregó compatibilidad con el modelo RD04v2: totalmente compatible y detectado automáticamente. #11

🧰 Mejoras

• ✅ Sistema de registro rediseñado con archivos de registro rotativos por nivel:

miwifi_debug.log, miwifi_info.log, miwifi_warning.log, etc.

• ✅ Estructura de código más limpia para flujos de configuración y ajustes globales.
• ✅ Archivos de traducción alineados con los estándares de Home Assistant.

✅ Compatibilidad

• ✅ Compatible con Home Assistant 2025.4.0 y versiones posteriores.
• ✅ Totalmente compatible con versiones anteriores, incluyendo todas las configuraciones 3.0.8 y 3.0.8b4.
• ✅ Se puede instalar de forma segura como reemplazo directo de versiones anteriores de XiaoHack.

📘 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. Ve a Ajustes → Dispositivos y servicios → MiWiFi → Opciones y configura el nivel de registro que desees.

📌 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