Version History - MiWiFi XiaoHack Edition

This release makes automatic device cleanup safer and fixes client tracking on Mesh networks, with contributions from @brembygit.

Changes

• Scheduled automatic cleanup is now more conservative: it targets randomized MAC addresses and preserves devices whose age cannot be determined. Set the interval to 0 days to disable it. Manual cleanup and its dry run remain available (#321).
• Correct Mesh client counts and attribute clients to the node actually serving them, including nodes whose backhaul MAC differs from the MAC they report for themselves (#322).
• When a client moves between the main router and a Mesh node, Home Assistant updates its device location and "Connected via" link without reloading the integration. The tracker and sensors stay together, and stale MiWiFi-only device rows are removed (#323).
• Adapt device registry and targeted service lookups to current Home Assistant APIs while keeping compatibility fallbacks for older versions (#323).
• Update the bundled panel version and its cache references to 3.8.0.

Thanks to @brembygit for contributing to all three fixes and working with us on the follow-up corrections. We tested a client's movement from the main router to Mesh and back on Home Assistant 2026.9.3; all 12 entities were retained.

Upgrade

Update the integration through HACS, restart Home Assistant, and refresh your browser. The panel remains bundled with the integration and needs no separate installation.

Integrated Panel and HACS Update

• Bundled the MiWiFi panel, translations, images and Lit dependencies inside custom_components/miwifi.
• The panel now updates together with the integration through HACS.
• Removed separate frontend downloads and remote panel monitoring.
• No separate Lovelace resource or panel_custom YAML configuration is required.

Fixes and Stability

• Fixed panel listeners and timers remaining active after leaving the panel, which caused duplicate requests and misleading missing-router messages.
• Updated Home Assistant device registry lookups and parent-device references for current APIs, with compatibility fallbacks.
• Fixed device cleanup with long registry identifiers (#313).
• Adapted registry iteration for newer Home Assistant versions (#318).
• Added compatibility handling for the public ScannerEntity import (#309).
• Reduced repeated router-mode requests and log messages (#312, #319).
• Improved sensor initialization and Mesh device tracking.

Router Compatibility

• Added recognition for RP01 and RP03 based on reported API compatibility (#315, #316, #317).
• Improved support for RD03V2 and newer Xiaomi firmware variants.

Frontend Improvements

• Added local fallback icons for unknown router models.
• Improved translation fallback for unsupported languages.
• Corrected the issue-report link.
• Aligned panel resource versions with the integration.

Updating

1. Update through HACS, or copy the complete custom_components/miwifi folder.
2. Restart Home Assistant.
3. Refresh the browser with Ctrl+F5.

Existing /config/www/miwifi files are preserved but are no longer used by the panel. Generated diagnostic downloads continue using /local/miwifi/exports/.

📝 Changelog — MiWiFi Integration

📦 Version v3.6.0 – 2026-05-01

✅ Fixes & Stability

• 📶 Fixed wrong connection detection on routers with dedicated IoT WiFi
• Devices are now correctly separated between 5G Game and IoT on supported routers.
• Prevents IoT clients from being incorrectly grouped as 5G Game.

• 🧩 Fixed device classification for dedicated IoT firmwares
• Added proper handling for routers where the firmware reports IoT and Gaming as separate connection types.
• Improves connection accuracy on supported models such as RC01 / BE10000 and RC06 / BE7000.

• 📊 Fixed missing IoT counters in backend sensors
• Added support for the dedicated devices_iot sensor.
• Improves consistency between device trackers, router counters and frontend summaries.

• 🌐 Fixed Mesh/IP propagation stability for devices connected through leaf nodes
• Preserves device data more reliably when clients are associated through Mesh nodes.
• Helps avoid missing or inconsistent information during parent/leaf refresh cycles.

⚙️ Improvements

• 🧠 Added dedicated IoT connection handling
• The backend now supports IoT as a first-class connection type.
• Keeps compatibility with existing LAN, 2.4G, 5G, Guest, and 5G Game handling.

• 📦 Extended compatibility logic for newer Xiaomi firmwares
• Added safer handling for routers exposing dedicated IoT WiFi capabilities.
• Keeps legacy router behavior unchanged where IoT-specific data is not available.

• 🔄 Improved Mesh-aware device counting
• Router counters now align better with devices associated through main and Mesh nodes.
• Reduces incorrect grouping when the backend already knows the real parent node.

✅ Compatibility

• ✅ Compatible with standard Xiaomi router setups.
• ✅ Added dedicated IoT WiFi handling for supported routers.
• ✅ Compatible with RC01 / BE10000 and RC06 / BE7000 when the firmware exposes separate IoT data.
• ✅ Older routers continue working normally without requiring IoT-specific support.

📘 How to Update

1. Replace your custom_components/miwifi/ folder with the contents of this release.
2. Restart Home Assistant.
3. Check that devices connected through IoT now appear correctly in the integration.

ℹ️ Additional Information

• Added backend support for IoT as a dedicated connection type.
• Added support for the devices_iot sensor.
• Improved grouping and counting logic for routers with dedicated IoT WiFi.

💖 Support & Donations

If you find this integration useful and want to support continued development:

• 💸 Wise
• 💸 PayPal

📝 Changelog — MiWiFi Integration

📦 Version v3.5.9 – 2026-03-25

🆕 Compatibility Model

• ✅ Added support for new router model RD03V2 #305

✅ Fixes & Stability

• ⏱️ Added timeout to panel version check #303
• Prevents panel version checks from hanging indefinitely when the remote source is slow or temporarily unavailable.
• Improves overall responsiveness and avoids blocking related update/version validation flows.

⚙️ Improvements

• 📦 Extended model compatibility
• Added detection/support for RD03V2 to improve compatibility with newer Xiaomi router variants.

✅ Compatibility

• ✅ Compatible with standard Xiaomi router setups.
• ✅ Added support for RD03V2 router variants.

📘 How to Update

1. Replace your custom_components/miwifi/ folder with the contents of this release.
2. Restart Home Assistant.

ℹ️ Additional Information

• Merged PR: #303 (feat: add timeout to panel version check)
• Merged PR: #305 (add support for router model RD03V2)

💖 Support & Donations

If you find this integration useful and want to support continued development:

• 💸 Wise
• 💸 PayPal

📝 Changelog — MiWiFi Integration

📦 Version v3.5.8 – 2026-02-22

🆕 Compatibility Model

• ✅ Added support for new router model RP04 #301

✅ Fixes & Stability

• 🧩 Fixed “mode” detection on firmware variants that return __HTML_PLACEHOLDER_0__
• When the primary endpoint qnetwork/get_netmode fails, the integration falls back to netmode().
• Some firmwares return the field as netmode (and omit mode), which can break downstream logic expecting mode.
• We now normalize the fallback payload: if netmode exists and mode is missing, we mirror it (mode = netmode) to keep a consistent response shape.

⚙️ Improvements

• No other changes in this release.

✅ Compatibility

• ✅ Improved compatibility with provider / customized firmwares that expose __HTML_PLACEHOLDER_0__ instead of __HTML_PLACEHOLDER_1__ in the fallback API.

📘 How to Update

1. Replace your custom_components/miwifi/ folder with the contents of this release.
2. Restart Home Assistant.

ℹ️ Additional Information

• Merged PR: #300 (“convert netmode field to mode field for compatibility”)
• Thanks to @Mythologyli for the contribution.