Version History - MiWiFi XiaoHack Edition

📦 v3.0.8 – XiaoHack Edition

This release introduces essential improvements, bugfixes, and new features for better compatibility and performance.

🐛 Fixes & Improvements

• ✅ Added WAN IP sensor

Shows your router’s external IP (wan_ip) in Home Assistant.

• ✅ Added WAN Type sensor

Displays the connection type (pppoe, dhcp, etc.) as reported by your router.

• ✅ WAN speeds now in Mb/s (optional)

Download and upload speeds can now be displayed in Mb/s (megabits per second) instead of raw B/s. ➕ Option available in integration configuration.

• ✅ Mode sensor values are now readable

Shows Default or Mesh instead of numbers (0, 9).

• ✅ Optional unit selection in config flow

You can now choose between Mb/s and B/s when configuring the integration.

• 🔁 Improved sensor class and update logic

Updated the MiWifiSensor class to dynamically switch units and refresh values consistently.

• 🧪 Updated constants, config flow, and options schema.

✅ Compatibility

• ✅ Compatible with Home Assistant 2025.4.0 and above.
• ✅ Fully backward-compatible with previous supported routers.
• ✅ Support for routers in mesh mode.

📘 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. Verify correct loading in Developer Tools > Logs.
4. Visit Settings > Devices & Services > MiWiFi > Configure to set new unit options.

📌 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

📦 v3.0.7 – _XiaoHack Edition_

This release introduces essential bugfixes and compatibility updates following the major v3.0.6 refresh.

🐛 Fixes & Improvements

📁 Added Images . 🧪 Updated Const.

✅ Compatibility

• Compatible with Home Assistant 2025.4.0 and above.
• Fully backward-compatible with previous supported devices.

📘 How to Update

1. Replace the files in your custom_components/miwifi/ folder.
2. Restart Home Assistant completely to apply changes.
3. Check the logs to confirm proper integration loading.

📌 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

📦 v3.0.6 – _XiaoHack Edition_

This release introduces essential bugfixes and compatibility updates following the major v3.0.5 refresh.

🐛 Fixes & Improvements

📁 Added automatic debug log creation in miwifi/Logs/ with router data, warnings, and errors. 🧪 Updated self_check to include router model and detailed API method diagnostics.

📡 New models supported:

• Add model "RN02" – Xiaomi Router BE6500 #6
• Add model "CR8816" – Xiaomi Mi Router CR8816 #9

✅ Compatibility

• Compatible with Home Assistant 2025.4.0 and above.
• Fully backward-compatible with previous supported devices.

📘 How to Update

1. Replace the files in your custom_components/miwifi/ folder.
2. Restart Home Assistant completely to apply changes.
3. Check the logs to confirm proper integration loading.

📌 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

📦 v3.0.5 – _XiaoHack Edition_

This release introduces essential bugfixes and compatibility updates following the major v3.0.4 refresh.

✅ Compatibility

• Compatible with Home Assistant 2025.4.0 and above.
• Fully backward-compatible with previous supported devices.
• Add model "RD12" Xiaomi Router AX1500 EU,
• Add model " RA80V2" Xiaomi AX3000 (CN).

📘 How to Update

1. Replace the files in your custom_components/miwifi/ folder.
2. Restart Home Assistant completely to apply changes.
3. Check the logs to confirm proper integration loading.

📌 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

📦 v3.0.4 – _XiaoHack Edition_

This release introduces essential bugfixes and compatibility updates following the major v3.0.3 refresh.

🐛 Fixes & Improvements

• ✅ Fixed: IndexError when handling devices with empty IP lists.
• ✅ Fixed: ValueError on unrecognized model rd12 by allowing safe fallback.
• ✅ Fixed: AttributeError on missing netmode by implementing fallback support.
• 🔁 Enhanced fallback logic in mode() to use netmode() if xqnetwork/mode fails.
• 🔧 Safe default values (mode = 0) now returned when mode info is missing or unknown.
• 🔍 Added better logging for network mode detection fallbacks.

🧠 Context-Aware Entity Handling

• Improved handling of newly connected devices with missing or partial data.
• Added safety checks in _build_device to handle edge cases and avoid breaking the update loop.

✅ Compatibility

• Compatible with Home Assistant 2025.3.4 and above.
• Fully backward-compatible with previous supported devices.
• Adds robust support for unusual models like "rd12".

📘 How to Update

1. Replace the files in your custom_components/miwifi/ folder.
2. Restart Home Assistant completely to apply changes.
3. Check the logs to confirm proper integration loading.

📌 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