Version History - MiWiFi XiaoHack Edition

📦 Version v3.2.9 – 2025-07-10

✅ Fixes & Stability

• 🔇 Compatibility warnings are now suppressed when the router is manually marked as primary (is_main_auto = False).
• Prevents false positives and unnecessary suggestions for unsupported.py.
• Logs remain clean, while the system continues to work with manually selected routers.
• ✅ The CompatibilityChecker still runs for manually selected primary nodes, but without logging warnings, so the panel can still disable unsupported features as needed.
• 🧭 The update panel creation logic now logs whether the primary router was auto-detected or manually selected, improving transparency during debugging and testing.

⚙️ Improvements

• 📡 New __HTML_PLACEHOLDER_0__:
• Shows the total number of NAT rules (ftype=1 and ftype=2) from the main router.
• Exposes attributes like source IP and detailed lists of each rule type.
• Only active on the router marked as primary (is_main = True), whether auto or manual.

• 🛠️ Enhanced __HTML_PLACEHOLDER_0__:
• Now includes:
• panel_version (frontend version)
• Global log_level
• wan_speed_unit
• panel_active flag
• last_checked timestamp

• 📢 New device detection & alert:
• When a completely new device (MAC not seen before) connects to the network, a persistent notification is triggered.
• Example:

_"📶 New device connected: MyPhone (12:34:56:78:9A:BC)"_

• Only shown once per new MAC.

• 🔒 Service notification for WAN access control:
• When a device is blocked or unblocked using the service miwifi.block_device, a localized persistent notification is shown.
• Example (EN): _"Device María’s Laptop has been automatically BLOCKED."_

• 🌍 All persistent notifications are now localized using translations/en.json and translations/es.json.
• Includes: new device alerts, unsupported router warnings, and MAC filter results.

✅ Compatibility

• Fully compatible with Home Assistant 2025.5.0 and newer.
• Tested with Xiaomi AX6, AX3600, AX3000T, AX1800, and partial mesh setups.

📘 How to Update

1. Replace all files in your custom_components/miwifi/ directory with this release.
2. Add or update translations/en.json and translations/es.json.
3. Restart Home Assistant completely.
4. Confirm the integration loads without warnings in Developer Tools > Logs.

ℹ️ This version improves robustness, multilingual support, NAT visibility, and user alerts — making MiWiFi safer and smarter for everyday use.

📦 Version v3.2.8 – 2025-07-04

✨ New Features

• 🌐 NAT Rules Sensor: New sensor.miwifi_nat_rules entity to display and track all NAT port forwarding rules from the main router.
• ➕ Added support for creating port forwarding rules:
• miwifi.add_port for individual ports (ftype=1)
• miwifi.add_range_port for port ranges (ftype=2)
• 🗑️ Added miwifi.delete_port service to delete rules by protocol and port.
• 🔄 New miwifi.refresh_nat_rules service to force refresh of NAT rules and update the sensor.
• 📡 Included miwifi.list_ports service to list rules directly by ftype (1 or 2).

⚙️ Backend Improvements

• 🔧 Enhanced backend logic to detect and load NAT rules only when the router is marked as is_main.
• 📥 Extended LuciUpdater with self.data["nat_rules"] handling.
• 🔃 Sensor auto-updates on service calls without needing full page reload.
• 🧠 Refactored service fallback logic for refresh_nat_rules to locate main router dynamically (no device_id required).
• 💾 Added async_update_from_updater method to MiWifiNATRulesSensor for immediate update after rule changes.

🚫 Capabilities

• ➖ Explicitly marked RM1800 as unsupported for mac_filter in capabilities.

✅ Compatibility

• ✅ Compatible with Home Assistant 2025.5.0 and newer.
• 🧩 Compatible with all panel versions from 1.3.0+.
• ⬅️ Safe fallback if no main router is detected: NAT services won’t execute.

📘 How to Update

1. Replace all files in custom_components/miwifi/ with the new version.
2. Restart Home Assistant.
3. The new sensor.miwifi_nat_rules will appear automatically if a main router is detected.
4. You can now use the new services (add_port, add_range_port, delete_port, refresh_nat_rules) via Developer Tools or the panel.

🧠 This version introduces the groundwork for full NAT management within the panel. Make sure your router is correctly marked as is_main.

Maintained with ❤️ by @JuanManuelRomeroGarcia

📦 Version v3.2.7 – 2025-07-03

🛠 Critical Fixes

• 🐛 Fixed an import error in async_update_panel_entity that prevented the miwifi.select_main_router service from working properly.
• 🔧 Replaced from .update_panel with from .update in updater.py.
• ✅ Verified correct creation/removal of the update.miwifi_*_miwifi_panel_frontend entity based on the main router status.

🔥 This version is mandatory to enable proper manual selection of the main node.

✅ 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 v3.2.6 – 2025-07-02

🆕 Compatibility Model

• ✅ Added support for new router model RD05

✅ 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 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