Version History - MiWiFi XiaoHack Edition

📝 Changelog — MiWiFi Integration

📦 Version [3.2.5] – 2025-06-27

🔧 Critical Patch: WAN Blocking & Capability Detection

• ✅ Fixed a critical issue in the miwifi/block_device service that caused failures when the capabilities attribute was not initialized.
• 🔁 Added dynamic capability detection when the main router (is_main) hasn’t loaded them yet.
• 🔐 Ensured the Luci client performs a login() before running compatibility checks to avoid false negatives.
• 🧠 Added a missing return self.result statement at the end of CompatibilityChecker.run() to properly propagate detected features.
• 🧱 Hardened access to capabilities using getattr(..., {}) to prevent 'NoneType' object has no attribute 'get' errors.
• 🔎 Improved logging for capability detection and connection-related failures, with clearer diagnostics.

⚠️ This patch is strongly recommended for all users relying on WAN blocking or MAC filtering features.

✅ Compatibility

• ✅ Compatible with Home Assistant 2025.4.0 and above.
• ✅ Fully backward-compatible with v3.2.2.
• ✅ Smooth upgrade from v3.2.1+.

📘 How to Update

1. Replace all files inside your custom_components/miwifi/ directory with the contents of this release.
2. Restart Home Assistant completely.
3. Confirm the integration loads without WAN parsing errors in Developer Tools > Logs.

📌 Reminder for Migrators

If you're migrating from the original dmamontov/hass-miwifi:

➡ Remove the old integration. ➡ Add this repo via HACS as a custom repository:

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

Maintained with ❤️ by @JuanManuelRomeroGarcia

📝 Changelog — MiWiFi Integration

📦 Version v3.2.4 – 2025-06-27

✅ Fixes & Stability

• 🛑 No more repeated warnings for unsupported features:
• Compatibility checks now automatically skip any feature already listed in unsupported.py.
• Prevents repeated suggestions and warnings for known unsupported methods (like wifi_config on CR8806).
• Ensures a cleaner log and avoids unnecessary GitHub issue prompts.

• 🧯 No exception raised if Home Assistant version info is unavailable:
• Introduced a safe fallback using sys.modules check to avoid triggering errors when __version__ is missing.
• Ensures full resilience in diagnostics and issue suggestions across all environments.

⚙️ Improvements

• 🧠 Includes new diagnostics fallback and structured issue suggestion for unsupported features.

• ✅ CompatibilityChecker now includes built-in model detection and UNSUPPORTED filtering:
• Dynamically skips tests based on Model presence in unsupported.py.
• Centralized logic inside the checker — no need to manage exclusions externally.
• Cleaner and more maintainable integration lifecycle.

• ✍️ Auto-generated GitHub issue suggestion:
• When unsupported features are detected, the integration suggests a full unsupported.py block.
• Includes model, mode, version, and direct link to open an issue with prefilled content.
• Prevents integration breakage while encouraging structured feedback.

• 🔁 Keeps logging skipped features with [MiWiFi] ⏭️ Skipping ... messages for transparency.

ℹ️ This version is ideal for developers maintaining compatibility across multiple models with known limitations.

✅ Compatibility

• ✅ Compatible with Home Assistant 2025.4.0 and above.
• ✅ Fully backward-compatible with v3.2.2.
• ✅ Smooth upgrade from v3.2.1+.

📘 How to Update

1. Replace all files inside your custom_components/miwifi/ directory with the contents of this release.
2. Restart Home Assistant completely.
3. Confirm the integration loads without WAN parsing errors in Developer Tools > Logs.

📌 Reminder for Migrators

If you're migrating from the original dmamontov/hass-miwifi:

➡ Remove the old integration. ➡ Add this repo via HACS as a custom repository:

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

Maintained with ❤️ by @JuanManuelRomeroGarcia

📝 Changelog — MiWiFi Integration

📦 Version v3.2.3 – 2025-06-26

✅ Fixes & Stability

• 🛡️ False negatives avoided in compatibility detection:
• CompatibilityChecker now runs only once and only if the router is the main node (is_main), either by automatic detection or manual selection.
• Prevents compatibility tests from launching prematurely on mesh nodes or non-primary routers.
• Fixes inaccurate "unsupported model" reports for devices like the R3600 and similar.

⚙️ Improvements

• Compatibility detection moved into the topology graph phase (_async_prepare_topo) to ensure proper device role context.
• Full support for manual selection of the main router via the frontend, even after setup.
• Capability tests are now fully delayed until the router is confirmed as main.
• ✨ New translations added for better multilingual support in the interface.

🔧 Developer Enhancements

• Improved safety of compatibility checks by verifying model and topo context before launching.
• Clearer log messages for capabilities, detection, and compatibility status.
• Internal cleanup of duplicated detection calls.

ℹ️ Tip: If you previously saw false compatibility errors or incomplete feature support on mesh nodes, this update should resolve it.

✅ Compatibility

• ✅ Compatible with Home Assistant 2025.4.0 and above.
• ✅ Fully backward-compatible with v3.2.2 and v3.2.1.
• ✅ Recommended for multi-router setups and mesh environments.

📘 How to Update

1. Replace all files inside your custom_components/miwifi/ directory with the contents of this release.
2. Restart Home Assistant completely.
3. Use the MiWiFi panel to select your main router if it was not auto-detected.

📌 Reminder for Migrators

If you're migrating from the original dmamontov/hass-miwifi:

➡ Remove the old integration. ➡ Add this repo via HACS as a custom repository:

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

Maintained with ❤️ by @JuanManuelRomeroGarcia

📝 Changelog — MiWiFi Integration

📦 Version v3.2.2 – 2025-06-24

🚀 Improvements

• Startup performance optimization: the check_ports() method was rewritten to use asyncio.open_connection instead of socket.connect_ex, removing blocking calls from Home Assistant’s main event loop.
• This resolves brief freezes (<1 minute) when starting Home Assistant or loading the integration for the first time.
• Noticeable improvement in system stability during boot, especially in setups with multiple routers or heavy device tracking.
• Frontend panel monitor improved: moved the scheduling call for async_track_time_interval out of the internal try block to ensure the periodic version check is always scheduled, even if the first check fails.
• Self-check diagnostics improved: the self_check.py module now includes:
• The version of the MiWiFi integration
• The installed version of the frontend panel (if available)
• The current version of Home Assistant
• These versions are included in the issue link for unknown routers to improve debugging and support.
• Extended compatibility detection: CompatibilityChecker now checks additional router capabilities:
• Firmware update support (rom_update, flash_permission)
• LED control support
• Guest Wi-Fi and direct Wi-Fi configuration
• Topology map support
• Device list support (wired + wireless)
• Results are stored in self.result and can be used to dynamically enable or disable features.
• Automatic unsupported model reporting: when a known router model fails any compatibility check, the integration will now suggest a GitHub issue with:
• The failing features
• Suggested lines for unsupported.py
• Version info of the integration and Home Assistant
• A direct link to open the issue
• Accurate router mode detection: The integration now prioritizes netmode over mode when determining a router's operating role (e.g., mesh node, repeater, etc.), fixing misclassifications during capability checks.
• Expanded __HTML_PLACEHOLDER_0__ enum: Added support for additional modes:
• MESH_NODE (3): mesh-connected child routers (non-main nodes)
• MESH_LEAF (8): deeper mesh leaf nodes

These are now automatically ignored in capability checks like rom_update or per_device_qos, avoiding false "unsupported" reports for secondary mesh units.

• Better fallback handling: If netmode is not present, the integration will safely fall back to mode or "default" without errors.
• Improved diagnostics context: The detected mode is now included in the GitHub issue suggestion for unsupported routers, helping maintainers triage mesh-specific cases.

🧹 Code Cleanup

• Removed unused imports: socket, contextlib.closing.
• Added missing import for MiWiFiPanelUpdate to resolve runtime error.
• Defined or imported ATTR_TRACKER_TOTAL_USAGE to eliminate warnings.
• Slight internal cleanup in panel handling and structure logic.
• Code remains fully backward-compatible with previous integration versions.

💡 Tip: Users experiencing brief lock-ups during Home Assistant startup are encouraged to upgrade to this version.

✅ Compatibility

• ✅ Compatible with Home Assistant 2025.4.0 and above.
• ✅ Fully backward-compatible with v3.2.1.
• ✅ Safe to install as a drop-in replacement for v3.2.1.

📘 How to Update

1. Replace all files inside your custom_components/miwifi/ directory with the contents of this release.
2. Restart Home Assistant completely.
3. Confirm the integration loads without WAN parsing errors in Developer Tools &gt; Logs.

📌 Reminder for Migrators

If you're migrating from the original dmamontov/hass-miwifi:

➡ Remove the old integration. ➡ Add this repo via HACS as a custom repository:

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

Maintained with ❤️ by @JuanManuelRomeroGarcia

This update improves update entity behavior and adds dynamic release notes support for the panel frontend.

🆕 What's New in v3.2.1

📦 GitHub Release Notes Support

• ✨ Added async_release_notes() to the update entity. (From Update.panel_frontend)
• 📄 Automatically fetches release descriptions from GitHub using:

https://api.github.com/repos/JuanManuelRomeroGarcia/miwifi-panel-frontend/releases/tags/vX.Y.Z

• 🧠 If the release notes are available, they will now be shown directly in the Home Assistant UI under the update.miwifi_panel_frontend entity.
• 🛑 Graceful fallback to None if release data is not found or errors occur.

📶 Signal Quality Calculation Fixed

• 🛠 Fixed incorrect signal_quality mapping in device tracker attributes.
• 🧠 The backend previously treated signal values (0–100 scale) as if they were in dBm (e.g. -65), resulting in inaccurate quality levels.
• ✅ Updated map_signal_quality() to work properly with percentage-based signal values:

🛠 Improvements

• Improved logging on GitHub API failures and fallbacks.
• Better handling of missing or invalid version data.
• Full support for release_summary and release_notes fields when available.

✅ Compatibility

Requires: Home Assistant 2023.10 or newer

Compatible with: MiWiFi Panel Frontend v1.3.0 or later

No breaking changes

© 2025 – XiaoHack Project 🔗 GitHub: JuanManuelRomeroGarcia/hass-miwifi