Version History - MiWiFi XiaoHack Edition

📝 Changelog — MiWiFi Integration

📦 Version v3.2.6 – 2025-07-02

✅ Fixes & Stability

• 🛡️ Prevented startup failures on routers that don't support certain endpoints:
• Wrapped calls to macfilter_info, avaliable_channels, and rom_update in try/except to avoid full integration crashes.
• Routers that fail to respond now continue loading without blocking the whole update cycle.

• 🚫 Removed compatibility detection from early topology fetch:
• Avoids premature calls to unsupported endpoints during setup.
• Ensures compatibility checks only run when the router is confirmed to be accessible and stable.

• 🧱 Added support for multiple fallback IPs in discovery:
• Now attempts 192.168.1.1, 192.168.0.1, and 192.168.31.1 during initial detection.

-🛑 Silenced compatibility warnings for features manually marked as unsupported:

• Features like wifi_config are no longer executed or shown if already listed in unsupported.py.
• Prevents repeated false warnings for verified unsupported models (e.g., CR8806).

⚙️ Improvements

• 🔍 Compatibility detection (CompatibilityChecker) has been moved to a new method:
• Now runs at the end of the update process (_async_prepare_compatibility).
• Prevents false negatives or timeouts during early startup.
• Better separation of responsibilities and easier future maintenance.

• 🧠 Future-ready: allows skipping or customizing capability checks by model or IP without affecting the rest of the update flow.

• 🎨 Enhanced device discovery UI:
• Detected routers now display their model and IP address in the discovery card (e.g., RC06 (192.168.1.39)).
• Model is extracted directly from the topo_graph() response if available.

✅ Compatibility

• ✅ Compatible with Home Assistant 2025.5.0 and above.
• ✅ Fully backward-compatible with v3.2.4.
• ⚠️ Known issue: routers that only work on v3.1.4 may require legacy mode or a fresh install.

📘 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. Add your first router manually to trigger automatic mesh discovery for the remaining devices.

ℹ️ This release improves detection clarity, reliability, and visual feedback—especially for users with multiple routers.

Maintained with ❤️ by @JuanManuelRomeroGarcia

📝 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