Historial de versiones - MiWiFi XiaoHack Edition

Versión de mantenimiento que incluye los problemas #345, #347 y #348, gracias a @brembygit.

Correcciones

• Conservar los contadores de clientes de las hojas de malla de carga forzada cuando el padre envía su censo de clientes.
• Guarda las reglas de reemplazo de direcciones MAC privadas mediante el iterador del registro de dispositivos compatible con Home Assistant, incluyendo los clientes históricos que solo están presentes en el registro. Mantén la compatibilidad con las estructuras de registro anteriores.
• Lee los contadores de carga forzada una vez por ciclo de sondeo, y los fallos de los puntos finales se gestionan mediante la ruta de error de actualización existente.
• Resuelva los alias MAC de backhaul del enrutador conocidos solo cuando la identidad del enrutador y la propiedad de la entrada de integración coincidan.
• La función Cancelar sustituyó a los plazos de purga automática, evitando así ejecuciones duplicadas y temporizadores residuales tras la cancelación.
• Conservar de forma consistente los valores anidados de canal/ancho de banda Wi-Fi en las instantáneas de escritura.
• Utilice la función de devolución de llamada de actualización del coordinador compatible, espere a que se establezca la topología antes de aprovisionar los sensores del cliente y limpie los coordinadores de inicio de sesión temporales tanto en caso de éxito como de fallo.
• Cancela los temporizadores de detección al apagar Home Assistant, elimina el historial del enrutador almacenado cuando se borra una entrada descargada, censura los datos de diagnóstico del dispositivo y restaura los iconos de descripción de entidades.

Pruebas y compatibilidad

El conjunto completo de pruebas heredadas se ha reparado y es obligatorio en la integración continua (CI). Ya no oculta los fallos tras un flujo de trabajo exitoso. La validación requerida abarca HA Core 2026.10.0 heredado, conjuntos de pruebas mantenidos en HA 2026.10.0 y 2026.9.3, HACS, hassfest, regresiones independientes y el comportamiento de la interfaz de usuario/empaquetado del frontend.

Mejora

Actualiza mediante HACS, reinicia Home Assistant y actualiza el navegador. El panel se incluye y su versión en caché se actualiza junto con la integración. Las reglas de direcciones MAC privadas existentes permanecen configuradas. El reemplazo automático sigue siendo opcional para los clientes configurados individualmente con nombres de enrutador únicos; cuando se cambia el nombre de un dispositivo, se incluyen sus nombres de enrutador anterior y actual en la regla.

Esta actualización de mantenimiento no cierra todos los informes específicos del enrutador. El informe n.° 329 aún espera la validación diagnóstica del usuario que lo reportó; las propuestas restantes sobre la función de la topología, la verificación de Wi-Fi y la limpieza de los nodos de la malla permanecen separadas.

Registro completo de cambios · Guía de direcciones MAC privadas

Versión validada: 204 pruebas heredadas superadas; HA 2026.10.0 mantenida: 193 superadas; HA 2026.9.3 mantenida: 192 superadas, 1 omisión específica de la versión. Las comprobaciones de HACS, hassfest y standalone/frontend superadas. Home Assistant CI · Validation CI. El árbol de versiones fusionadas coincide exactamente con la rama probada.

MiWiFi v3.9.0

Gestión privada de MAC

Agregue la opción de reemplazo automático para clientes cuyos nombres de enrutador identifiquen de forma única el mismo dispositivo físico. En la configuración del panel principal del enrutador, seleccione los clientes, ingrese los alias anteriores/actuales, elimine las reglas y guarde. La lista compacta está traducida a los ocho idiomas del panel.

El proceso de reemplazo espera listas de clientes completas y actualizadas de cada nodo MiWiFi cargado y una única dirección MAC conectada. Elimina los rastreadores y sensores de cliente MiWiFi asociados más antiguos en todos los nodos, incluidos los clientes históricos no disponibles que se conservan únicamente en el registro de HA. Las reglas y la supresión de direcciones MAC retiradas se mantienen tras recargas y reinicios; una reconexión real puede volver a admitir una dirección MAC antigua.

Esta función está desactivada por defecto. Actívela solo para clientes físicos únicos. Elimina las entidades MiWiFi de la antigua dirección MAC; los ID de entidad/dispositivo, las áreas, los nombres personalizados, las asignaciones de personas y las referencias de automatización no se transfieren. Revise cualquier elemento que haga referencia a un rastreador antiguo. No gestiona las reservas DHCP ni modifica la configuración de privacidad del cliente.

Guía en inglés · Guía en español

Limpieza y fiabilidad de la malla

• Restringir la eliminación de inactividad a MACs específicos, limpiar los sensores de cliente asociados e informar totales precisos de entidades/dispositivos en las vistas previas y aplicar respuestas. La actividad reciente en cualquier nodo cargado protege al cliente.
• Mantiene la supresión de los registros eliminados y borra las copias guardadas del cliente en todos los nodos, evitando que los registros obsoletos o fuera de línea se vuelvan a crear después de recargas o reinicios.
• Mantenga un censo reciente de clientes principales completado en las hojas de malla; borre los marcadores obsoletos de clientes que se mudaron cuando los clientes regresen.
• Agregue diagnósticos de mesh_support limitados para todos los nodos cargados, con relaciones MAC/IP/entrada anonimizadas consistentes e historial de contadores, sin solicitudes adicionales al enrutador. Solo mesh_support está anonimizado para su uso público; otras secciones de diagnóstico pueden contener datos privados. Guía de diagnóstico.
• Elimine la entidad de actualización de interfaz de panel independiente obsoleta. El panel continúa actualizándose con la integración; las entidades de actualización de firmware del enrutador permanecen disponibles.

Compatibilidad y validación de Home Assistant

Adaptamos el entorno de pruebas, la propiedad explícita de la entrada de configuración del coordinador y la compatibilidad con el disparador de dispositivo clásico del problema #325, gracias a @brembygit. Esto restaura el comportamiento de la API/YAML del disparador clásico en la HA actual; no agrega esos disparadores al selector basado en destino más reciente.

Validación local: 135 pruebas mantenidas más 65 pruebas independientes se superan en HA 2026.10.0; 134 pruebas mantenidas se superan y se omite una prueba de registro más reciente en HA 2026.9.3. Se comprueban el empaquetado del frontend, el comportamiento del panel y los ocho diccionarios de idiomas. Las pruebas en un enrutador real confirmaron la limpieza, el reemplazo de la función de vigilancia renombrada y el comportamiento correcto después de un reinicio completo de HA.

Las pruebas heredadas siguen reportándose por separado y no se han corregido. El problema n.° 329 permanece abierto para su verificación en los enrutadores del usuario que lo reportó. Esta versión no incluye la solución al problema de la carrera entre el enrutador y el sensor en el problema n.° 333, el caso de carga forzada inalámbrica en el problema n.° 334, las reservas DHCP en el problema n.° 314 ni los cambios separados en las solicitudes de extracción n.° 324, n.° 326, n.° 327 y n.° 331.

Instalar

Actualiza la integración a la versión 3.9.0 mediante HACS, reinicia Home Assistant y, a continuación, actualiza el panel. El panel y las traducciones vienen incluidos; no es necesario instalar una interfaz por separado. Las reglas de direcciones MAC privadas se configuran una sola vez por cliente y se conservan incluso después de reiniciar el sistema.

GitHub CI en la confirmación de lanzamiento firmada pasó HACS, hassfest y regresiones y ambas suites de Home Assistant mantenidas. El trabajo heredado experimental informa sus fallos heredados por separado.

• Durante la configuración, se reconoce el RN12 (Xiaomi Range Extender AX1500) y se añade su imagen al panel y a la galería README (#343). El usuario confirmó la configuración mediante HTTPS con el firmware 1.0.63; las funciones individuales dependen de las capacidades de la API del router.
• Acepte la carga útil de configuración del panel en miwifi.apply_config, valide sus tres campos admitidos, mantenga el acceso solo para administradores y documente la acción en services.yaml (#337).
• Recrear el rastreador de un cliente conocido cuando su plataforma original se descarga después de que el cliente se mueva a otra entrada de la malla. Conservar el ID de la entidad y mantener las notificaciones de nuevos dispositivos restringidas a los descubrimientos reales (#332).
• Lee las filas de dispositivos de un solo propietario a través de config_entry_id para evitar los informes de obsolescencia de Home Assistant 2026.10. Conserva los múltiples propietarios en dispositivos compuestos y núcleos antiguos, incluidas las medidas de seguridad para la eliminación de dispositivos inactivos (relacionado con el problema n.° 344).
• Impide que un rastreador vincule su fila de dispositivo consigo mismo cuando una dirección MAC principal almacenada, una dirección MAC alternativa o identificadores combinados se resuelven en la propia fila del cliente. Conserva el cliente y omite únicamente el enlace principal no válido.
• Actualizar la versión de la caché del panel de integración y del paquete a la versión 3.8.4 y agregar cobertura de regresión para la validación de la configuración, la recuperación del rastreador, los enlaces principales y la propiedad del dispositivo.

Gracias a @brembygit por la reproducción del problema #332, las pruebas independientes del enrutador y la cobertura de dispositivos compuestos en el problema #344, y al informante del problema #343 por verificar la configuración de RN12.

Validación

Se superaron 126 pruebas: 69 pruebas específicas en Home Assistant Core 2026.10.0 y 57 pruebas independientes de regresión, contador de clientes y seguridad de exportación privada. Las comprobaciones de empaquetado y sintaxis del frontend también se superaron. La cobertura incluye el registro de servicios reales y las plataformas de entidades, la recuperación tras recarga/desactivación del rastreador con carga forzada habilitada y deshabilitada, los ID de entidad conservados, la prevención de duplicados, las entidades deshabilitadas, los enlaces principales válidos y la propiedad de dispositivos heredados/compuestos.

Las pruebas manuales confirmaron que la configuración del panel se guarda correctamente y que los clientes siguen actualizándose tras la recarga. El rastreador de un portátil desconectado no se cargaba debido a un enlace de padre propio; tras la protección, el inicio y la reconexión/recarga funcionaron sin ese error. Las pruebas independientes en una malla cableada RD28/RA82 confirmaron la solución del problema n.º 332: los rastreadores afectados se recuperaron en 30 segundos tras la recarga o desactivación del origen, conservaron sus ID y la propiedad del nodo servidor, y permanecieron activos tras la reactivación del origen.

Actualización y trabajos restantes

Actualiza mediante HACS, reinicia Home Assistant y actualiza el navegador. El panel viene incluido con la integración. Esta versión no corrige los datos de padre incorrectos que ya haya informado un router o que se muestren en el panel; la etiqueta de padre propio observada sigue bajo investigación. El manejo independiente de errores de conexión NAT y la condición de carrera de duplicación de sensor de router (#333) no se corrigen aquí. Las solicitudes de extracción #324-#327 y #331 siguen siendo trabajos independientes.

• Evitar la creación duplicada de sensores de cliente cuando varios enrutadores mantienen el mismo cliente al iniciar o durante la itinerancia. Omitir un sensor solo mientras una plataforma de sensores MiWiFi activa lo proporcione; las entradas de registro existentes no bloquean la recuperación del sensor después de reiniciar o reconectar (#330).
• Restablecer los contadores de clientes autocontados una vez por ciclo de sondeo en puntos de acceso y otras funciones de repetidor sin carga forzada. Conservar los contadores enviados a los nodos hoja por su padre y el comportamiento de puerta de enlace/carga forzada existente (#341, corrige #340).
• Se agregó una prueba de regresión real de Home Assistant para un cliente desconectado que fue restaurado por dos enrutadores. El control reproduce identificadores duplicados sin el filtro de plataforma en vivo; la ruta corregida proporciona cada sensor del cliente una sola vez.
• Actualice la versión de la caché del panel de integración y del panel incluido a la versión 3.8.3.

Gracias a @brembygit por #330 y #341.

Validación

Se superaron 39 pruebas de regresión independientes, 7 pruebas de contador de clientes, 8 pruebas en Home Assistant 2026.9.3, 5 pruebas de seguridad de exportación y las comprobaciones de empaquetado de la interfaz. Las pruebas manuales confirmaron el inicio sin ID duplicados con un cliente desconectado, la recuperación del sensor al reconectarse, el funcionamiento de los sensores del cliente de malla y la itinerancia, y recuentos de clientes estables durante los cambios de nodo. El caso de acumulación de puntos de acceso se reprodujo en las pruebas automatizadas (de 4 clientes pasaron a ser 12 después de tres ciclos antes de la corrección; siguen siendo 4 después de la misma).

La pérdida independiente del rastreador después de recargar su entrada de origen (#332) y la carrera de duplicación de enrutador-sensor no confirmada (#333) permanecen fuera de esta versión.

Mejora

Actualiza mediante HACS, reinicia Home Assistant y actualiza el navegador. El panel permanece integrado. Esta versión no corrige las estadísticas históricas de clientes registradas antes de la corrección.

Esta versión reduce las recargas innecesarias del enrutador y corrige las mediciones de cliente faltantes, con contribuciones de @brembygit.

Correcciones

• Guardar las opciones de un enrutador ahora solo recarga ese enrutador. Todas las entradas se recargan cuando cambia la configuración efectiva del sensor de cliente en toda la malla. La programación de purga automática global se almacena una sola vez, sin copiarla a cada enrutador y activar recargas repetidas (#336, se confirmó la propagación de recargas en #333).
• Los clientes detectados únicamente a través de la lista Wi-Fi de un nodo informan velocidades faltantes como desconocidas en lugar de cero. El tiempo de actividad del cliente vacío también se informa como desconocido. Las mediciones disponibles del enrutador principal se conservan; las velocidades de los clientes sin conexión permanecen en cero (#338).
• Se restauró la galería de fotos del enrutador en el README, se cambiaron las imágenes del actualizador a los recursos incluidos y se eliminaron las imágenes raíz duplicadas (#335).
• Se actualizaron las referencias de la caché del panel de integración y del paquete a la versión 3.8.2.

Validación

• Se han superado 34 pruebas de regresión independientes, 5 pruebas de seguridad de exportación y las comprobaciones de empaquetado del frontend.
• Las pruebas manuales de la red mallada cableada RC01 + RC06 confirmaron el tiempo de actividad y la velocidad del cliente, la recuperación tras reinicio, la itinerancia en ambas direcciones, la recarga de opciones por nodo sin interrumpir el enrutador principal y la eliminación/restauración automática del sensor del cliente cuando cambia la configuración efectiva de toda la red mallada.
• El caso de datos faltantes únicamente en la lista de Wi-Fi está cubierto por pruebas automatizadas y no se reprodujo en esta configuración de red mallada cableada.

El problema de la duplicación de la condición de carrera del sensor del enrutador, también reportado en el número 333, sigue sin confirmarse. Esta versión corrige el problema confirmado de la propagación de la recarga sin pretender resolver esa condición de carrera ni el problema independiente de la recarga del rastreador #332.

Mejora

Actualiza mediante HACS, reinicia Home Assistant y actualiza el navegador. El panel sigue incluido en la integración y no requiere instalación adicional. Los sensores cliente permanecen activados en toda la red mesh mientras cualquier entrada del router los active; la opción aún no es un único conmutador compartido.