Historial de versiones - MiWiFi XiaoHack Edition

📦 Versión v3.3.0 – 2025-07-12

🚨 Aviso importante

Tras actualizar a la versión 3.3.0, es posible que reciba una notificación persistente por cada dispositivo conectado.

Esto es normal y solo ocurre una vez, ya que la nueva versión crea un almacén persistente de direcciones MAC conocidas.

Una vez que se complete este análisis inicial, las notificaciones futuras solo aparecerán para dispositivos realmente nuevos.

✅ Correcciones y estabilidad

• 🧠 Se ha rediseñado el sistema de notificaciones para garantizar que las traducciones se carguen de forma fiable, incluso en la primera ejecución.
• 🐞 Se corrigió un ImportError que ocurría al intentar usar build_nested_translations desde un helper inexistente.
• 🔄 Lógica de carga de traducción unificada entre panel_update y device_tracker, lo que garantiza un comportamiento coherente en todos los componentes.

⚙️ Mejoras

• 📢 Notificaciones persistentes localizadas para nuevos dispositivos:
• Los nuevos dispositivos (MAC no vistos anteriormente) ahora activan notificaciones persistentes totalmente traducidas al lenguaje de Home Assistant.
• Ejemplo (FR):

_"📶 Nuevo dispositivo conectado: Mon Téléphone\n💻 MAC: 12:34:56:78:9A:BC\n🌐 IP: 192.168.1.100\n📡 Conexión: Wi-Fi 2.4G"_

• Traducciones incluidas para:
• Tipos de conexión del dispositivo (LAN, Wi-Fi 2.4G, 5G, Invitado, Juegos 5G)
• Mensajes y títulos de notificación

• 🛡️ Servicio: __HTML_PLACEHOLDER_0__:
• Ahora envía notificaciones localizadas persistentes cuando se bloquea o desbloquea el acceso a la WAN de un dispositivo.
• Mensajes totalmente traducidos con marcadores de posición dinámicos (nombre del dispositivo, estado).
• Ejemplo (ES): _"Dispositivo Juan’s PC ha sido BLOQUEADO automáticamente."_

• 💾 Nuevo almacén de notificaciones persistentes basado en MAC:
• Ahora se utiliza un archivo de almacenamiento persistente para recordar qué direcciones MAC ya han activado una notificación.
• Esto evita las notificaciones duplicadas y permite que el sistema detecte dispositivos realmente nuevos.

• 🌐 Notificaciones que tienen en cuenta el idioma:
• Ahora, si no están en caché, las traducciones se cargan directamente desde el archivo translations/<lang>.json correcto.
• Funciona de forma fiable con cualquier idioma compatible con Home Assistant (en, es, fr, de, etc.).

✅ Compatibilidad

• Totalmente compatible con Home Assistant 2025.6.0 y versiones posteriores.
• Probado en configuraciones multilingües utilizando español, alemán y francés.
• Compatible con routers: AX3600, AX6, AX1800 y redes de malla mixta.

📘 Cómo actualizar

1. Reemplace todos los archivos en su directorio custom_components/miwifi/ con esta versión.
2. Asegúrese de tener actualizados los archivos translations/en.json, translations/es.json y, opcionalmente, fr.json y de.json.
3. Reinicia completamente Home Assistant.
4. Inicie una nueva conexión de dispositivo o utilice el servicio block_device para probar las notificaciones localizadas.

ℹ️ Esta versión ofrece notificaciones multilingües persistentes, un rastreador de dispositivos en tiempo real y un sistema de traducción estable, lo que hace que MiWiFi sea más inteligente y esté más atento al usuario que nunca.

📦 Versión v3.2.9 – 2025-07-10

✅ Correcciones y estabilidad

• 🔇 Las advertencias de compatibilidad ahora se suprimen cuando el enrutador se marca manualmente como principal (is_main_auto = False).
• Evita falsos positivos y sugerencias innecesarias para unsupported.py.
• Los registros permanecen limpios, mientras que el sistema continúa funcionando con enrutadores seleccionados manualmente.
• ✅ El CompatibilityChecker sigue ejecutándose para los nodos primarios seleccionados manualmente, pero sin registrar advertencias, por lo que el panel aún puede deshabilitar las funciones no compatibles según sea necesario.
• 🧭 La lógica de creación del panel de actualización ahora registra si el enrutador principal fue detectado automáticamente o seleccionado manualmente, lo que mejora la transparencia durante la depuración y las pruebas.

⚙️ Mejoras

• 📡 Nuevas reglas __HTML_PLACEHOLDER_0__:
• Muestra el número total de reglas NAT (ftype=1 y ftype=2) del enrutador principal.
• Muestra atributos como la dirección IP de origen y listas detalladas de cada tipo de regla.
• Solo está activo en el enrutador marcado como principal (is_main = True), ya sea automático o manual.

• 🛠️ Configuración mejorada del sensor __HTML_PLACEHOLDER_0__:
• Ahora incluye:
• panel_version (versión del frontend)
• Nivel de registro global
• unidad_de_velocidad_wan
• Bandera panel_active
• marca de tiempo last_checked

• 📢 Detección y alerta de nuevos dispositivos:
• Cuando un dispositivo completamente nuevo (MAC no visto antes) se conecta a la red, se activa una notificación persistente.
• Ejemplo:

_"📶 Nuevo dispositivo conectado: MyPhone (12:34:56:78:9A:BC)"_

• Solo se muestra una vez por cada nuevo MAC.

• 🔒 Notificación de servicio para el control de acceso WAN:
• Cuando un dispositivo se bloquea o desbloquea mediante el servicio miwifi.block_device, se muestra una notificación persistente localizada.
• Ejemplo (EN): _"El portátil de María ha sido BLOQUEADO automáticamente."_

• 🌍 Todas las notificaciones persistentes ahora están localizadas usando translations/en.json y translations/es.json.
• Incluye: alertas de nuevos dispositivos, advertencias de enrutadores no compatibles y resultados de filtros MAC.

✅ Compatibilidad

• Totalmente compatible con Home Assistant 2025.5.0 y versiones posteriores.
• Probado con Xiaomi AX6, AX3600, AX3000T, AX1800 y configuraciones de malla parcial.

📘 Cómo actualizar

1. Reemplace todos los archivos en su directorio custom_components/miwifi/ con esta versión.
2. Agregue o actualice translations/en.json y translations/es.json.
3. Reinicia completamente Home Assistant.
4. Confirma que la integración se carga sin advertencias en Herramientas para desarrolladores > Registros.

ℹ️ Esta versión mejora la robustez, la compatibilidad multilingüe, la visibilidad NAT y las alertas para el usuario, lo que hace que MiWiFi sea más seguro e inteligente para el uso diario.

📦 Versión v3.2.8 – 2025-07-04

✨ Nuevas funciones

• 🌐 Sensor de reglas NAT: Nueva entidad sensor.miwifi_nat_rules para mostrar y rastrear todas las reglas de reenvío de puertos NAT del enrutador principal.
• ➕ Se agregó compatibilidad para crear reglas de reenvío de puertos:
• miwifi.add_port para puertos individuales (ftype=1)
• miwifi.add_range_port para rangos de puertos (ftype=2)
• 🗑️ Se agregó el servicio miwifi.delete_port para eliminar reglas por protocolo y puerto.
• 🔄 Nuevo servicio miwifi.refresh_nat_rules para forzar la actualización de las reglas NAT y actualizar el sensor.
• 📡 Se incluye el servicio miwifi.list_ports para listar las reglas directamente por ftype (1 o 2).

⚙️ Mejoras del backend

• 🔧 Lógica de backend mejorada para detectar y cargar reglas NAT solo cuando el enrutador está marcado como is_main.
• 📥 Se ha extendido LuciUpdater con manejo de self.data["nat_rules"].
• 🔃 El sensor se actualiza automáticamente en las llamadas de servicio sin necesidad de recargar la página completa.
• 🧠 Se ha refactorizado la lógica de reserva del servicio para refresh_nat_rules para localizar el enrutador principal dinámicamente (no se requiere device_id).
• 💾 Se agregó el método async_update_from_updater a MiWifiNATRulesSensor para una actualización inmediata después de los cambios en las reglas.

🚫 Capacidades

• ➖ Se marcó explícitamente RM1800 como no compatible para mac_filter en las capacidades.

✅ 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.
• ⬅️ Opción de reserva segura si no se detecta un enrutador principal: los servicios NAT no se ejecutarán.

📘 Cómo actualizar

1. Reemplaza todos los archivos en custom_components/miwifi/ con la nueva versión.
2. Reiniciar Home Assistant.
3. La nueva regla sensor.miwifi_nat_rules aparecerá automáticamente si se detecta un router principal.
4. Ahora puede utilizar los nuevos servicios (add_port, add_range_port, delete_port, refresh_nat_rules) a través de las Herramientas para desarrolladores o del panel.

🧠 Esta versión sienta las bases para la gestión completa de NAT dentro del panel. Asegúrese de que su enrutador esté correctamente marcado como is_main.

Mantenido con ❤️ por @JuanManuelRomeroGarcia

📦 Versión v3.2.7 – 2025-07-03

🛠 Correcciones críticas

• 🐛 Se corrigió un error de importación en async_update_panel_entity que impedía que el servicio miwifi.select_main_router funcionara correctamente.
• 🔧 Se reemplazó from .update_panel por from .update en updater.py.
• ✅ Se verificó la correcta creación/eliminación de la entidad update.miwifi_*_miwifi_panel_frontend en función del estado del enrutador principal.

🔥 Esta versión es obligatoria para permitir la selección manual adecuada del nodo principal.

✅ Compatibilidad

• ✅ Compatible con Home Assistant 2025.5.0 y versiones posteriores.
• ✅ Totalmente compatible con versiones anteriores como v3.2.4.
• ⚠️ Problema conocido: los routers que solo funcionan con la versión 3.1.4 pueden requerir el modo heredado o una instalación nueva.

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

ℹ️ 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.2.6 – 2025-07-02

🆕 Modelo compatible

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

✅ Compatibilidad

• ✅ Compatible con Home Assistant 2025.5.0 y versiones posteriores.
• ✅ Totalmente compatible con versiones anteriores como v3.2.4.
• ⚠️ Problema conocido: los routers que solo funcionan con la versión 3.1.4 pueden requerir el modo heredado o una instalación nueva.

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

ℹ️ 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