Version History - MiWiFi XiaoHack Edition

📦 v3.0.8b4 – XiaoHack Edition

This is a hotfix release for the 3.0.8 version of the MiWiFi integration. It includes an important bugfix that ensures stability when parsing WAN info responses.

🐛 Bugfix

• ✅ Fixed crash when WAN info returns a boolean instead of a dict

Prevented "Error while preparing WAN info: 'bool' object has no attribute 'get'". #10 The integration now properly validates the structure of the WAN response before attempting to parse it.

✅ Compatibility

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

📘 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

📦 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