Version History - MiWiFi XiaoHack Edition

📦 Version v3.3.0 – 2025-07-12

🚨 Important Notice

After updating to v3.3.0, you may receive one persistent notification per device currently connected.

This is expected and only occurs once, as the new version creates a persistent store of known MACs.

Once this initial sweep is complete, future notifications will only appear for genuinely new devices.

✅ Fixes & Stability

• 🧠 Reworked the notification system to ensure translations are loaded reliably, even on first run.
• 🐞 Fixed an ImportError that occurred when trying to use build_nested_translations from a non-existent helper.
• 🔄 Unified translation loading logic between panel_update and device_tracker, ensuring consistent behavior across components.

⚙️ Improvements

• 📢 Localized persistent notifications for new devices:
• New devices (MAC not seen before) now trigger persistent notifications fully translated into the Home Assistant language.
• Example (FR):

_"📶 Nouveau dispositif connecté : Mon Téléphone\n💻 MAC: 12:34:56:78:9A:BC\n🌐 IP: 192.168.1.100\n📡 Connexion : Wi-Fi 2.4G"_

• Translations included for:
• Device connection types (LAN, Wi-Fi 2.4G, 5G, Guest, 5G Gaming)
• Notification messages and titles

• 🛡️ Service: __HTML_PLACEHOLDER_0__:
• Now sends persistent localized notifications when a device is blocked or unblocked from WAN access.
• Fully translated messages with dynamic placeholders (device name, status).
• Example (ES): _"Dispositivo Juan’s PC ha sido BLOQUEADO automáticamente."_

• 💾 New MAC-based persistent notification store:
• A persistent storage file is now used to remember which MAC addresses have already triggered a notification.
• This prevents duplicate notifications and allows the system to detect truly new devices.

• 🌐 Language-aware notifications:
• Translations are now loaded directly from the correct translations/<lang>.json file if not cached.
• Works reliably with any supported Home Assistant language (en, es, fr, de, etc.).

✅ Compatibility

• Fully compatible with Home Assistant 2025.6.0 and newer.
• Tested on multilingual setups using Spanish, German, and French.
• Compatible with routers: AX3600, AX6, AX1800, and mixed mesh networks.

📘 How to Update

1. Replace all files in your custom_components/miwifi/ directory with this release.
2. Ensure you have the updated translations/en.json, translations/es.json, and optionally fr.json, de.json.
3. Restart Home Assistant completely.
4. Trigger a new device connection or use the block_device service to test localized notifications.

ℹ️ This version delivers persistent multilingual notifications, a real-time device tracker, and a stable translation system — making MiWiFi smarter and more user-aware than ever.

📦 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