Version History - MiWiFi XiaoHack Edition

📦 v3.0.9 – XiaoHack Edition

This is a feature release that builds upon the solid base of v3.0.8b4. It introduces global logging control, full Spanish localization, and support for a new Xiaomi router model.

✨ New Features

• 🌐 Global Log Level Selector in the UI #12

You can now choose between warning, info, or debug from the integration options. The log level applies to all routers and updates without requiring code changes.

• 🌍 Spanish Translations Added

All forms, sensors, and entity states are now fully localized to Spanish. The integration dynamically adapts based on the user's selected language in Home Assistant.

• 📶 New Device Supported: Xiaomi Router AX1500

Added support for model RD04v2 — fully compatible and auto-detected. #11

🧰 Improvements

• ✅ Refactored logging system with per-level rotating log files:

miwifi_debug.log, miwifi_info.log, miwifi_warning.log, etc.

• ✅ Cleaner code structure for configuration flows and global settings.
• ✅ Translation files aligned with Home Assistant standards.

✅ Compatibility

• ✅ Compatible with Home Assistant 2025.4.0 and above.
• ✅ Fully backward-compatible with all 3.0.8 and 3.0.8b4 setups.
• ✅ Safe to install as a drop-in replacement for previous XiaoHack releases.

📘 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. Go to Settings → Devices & Services → MiWiFi → Options, and set your desired log level.

📌 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.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