Version History - MiWiFi XiaoHack Edition

📦 MiWiFi XiaoHack Edition – v3.1.3

🚀 Frontend-integrated logging and improved fallback detection in the MiWiFi integration for Home Assistant. This version brings better diagnostics from the web panel and a robust backend logging system for developers and advanced users.

✨ New Features

🆕 New log_panel service

• The MiWiFi panel can now send log messages directly to Home Assistant's home-assistant.log.
• Helps diagnose errors like missing topology, failed reloads, or JS-side issues.
• Each log is tagged with [PanelJS] for easy filtering in the backend logs.
• Service: miwifi.log_panel

🛜 Logging from all panel modules

• All pages (status, topologia, mesh, settings, miwifi-devices, router, and panel-frontend) now log important user actions and fallback behavior to the backend.
• Navigation actions and reload triggers are now traced for debugging.

🔄 Behavior Fixes

✅ Fallback router detection

• Improved detection of the main router using:
• graph.is_main === true if available (from backend)
• or fallback to show === 1 && assoc === 1
• or final fallback to mode === 0

🧹 Encoding cleanup

• Fixed multiple utf-8 decoding errors in updater.py that caused integration import failures.
• All strings are now fully compatible across environments and Python versions.

🛠 Technical Changes

• Added logToBackend() utility in utils.js.
• New service log_panel registered in services.py and wired in the backend.
• status.js, topologia.js, mesh.js, settings.js, and router.js include detailed log triggers.
• Auto-refresh issues and white panel detection now log root causes.
• panel-frontend.js now logs when Ctrl+F5 is required, and when settings are applied or fail.

🧪 Validated

• ✅ miwifi.log_panel accepts log messages and records them in home-assistant.log.
• ✅ Logs appear tagged with PanelJS and are categorized by severity.
• ✅ Fallback detection works with routers not marked as is_main.
• ✅ Frontend changes survive cache with updated version strings.

🧩 Requirements

• Home Assistant 2025.0 or newer.
• Panel version ≥ 1.2.2 and enable_panel: true set in the config.

Thanks for supporting the project ✨ Stay updated via xiaohack.es or GitHub

📦 MiWiFi XiaoHack Edition – v3.1.2

🚀 Maintenance and stability improvements for the MiWiFi integration in Home Assistant. This version fixes panel update handling, improves version storage, and ensures reliable behavior from the first install.

✨ New Features

🆕 New update.miwifi_panel_frontend entity

• Added an UpdateEntity for the MiWiFi panel (frontend).
• Automatically checks GitHub for newer versions.
• Allows updating with one click via the Home Assistant UI.
• Displays a persistent notification after updating to remind users to refresh (Ctrl+F5).

🔁 Automatic version tracking

• The local panel version is stored at .storage/miwifi/miwifi_panel_version.json.
• If the file doesn’t exist, it is automatically created with version 1.0.

🔄 Behavior fixes

• Fixed an issue where the update entity was marked as "unavailable" when local version was 0.0.
• The panel update entity now initializes correctly even on first install.

🛠 Technical Changes

• frontend.py now correctly handles default version creation.
• Global state helpers added for panel_enabled and log_level.
• Errors like save_local_version not defined and dt_util import issues resolved.

🧪 Validated

• ✅ update.miwifi_panel_frontend is created after integration setup.
• ✅ Remote updates are detected from version.json.
• ✅ Panel can be updated directly from UI.
• ✅ No errors after browser refresh post-update.

🧩 Requirements

• Home Assistant 2024.4 or newer.
• Panel must be enabled from the integration config (enable_panel: true).

Thanks for supporting the project ✨ Stay updated via xiaohack.es or GitHub.

📦 MiWiFi XiaoHack Edition – v3.1.1

🚀 Advanced integration for Xiaomi and Redmi routers with full panel support, mesh capabilities, and update management.

🔧 Maintained by @JuanManuelRomeroGarcia – xiaohack.es

✨ What’s New in Version 3.1.1

🆕 Panel Frontend Auto-Update Support

• Detects and tracks version of the custom MiWiFi frontend panel (JavaScript UI).
• New entity update.miwifi_panel_frontend allows updating the panel directly from Home Assistant UI.
• After updating, a persistent_notification informs users to refresh their browser (Ctrl+F5).
• Automatically links to the main device (Xiaomi/Redmi router) for consistent management.

⚠️ UI Version Warning

• The MiWiFi panel now shows a version warning if the UI is outdated.
• Uses backend version comparison between __MIWIFI_VERSION__ and the installed panel version.

🧰 Key Features

• 🔧 WiFi control: 2.4GHz / 5GHz / 5G Game / Guest
• 🧠 Memory and CPU info
• 🌐 WAN IP, speed sensors (configurable MB/s or B/s)
• 📶 Realtime device tracking by MAC/IP
• 🔁 OTA firmware update support
• 🌐 Fully localized: 🇪🇸 Spanish and 🇬🇧 English
• 🪛 Log level selector from config panel
• 🖼 Optional frontend panel inspired by Xiaomi's original UI

✅ Compatibility

• ✅ Home Assistant 2025.4.0 or later
• ✅ Works with Xiaomi and Redmi routers (AX/BE series)
• ✅ Mesh networks and repeaters supported

📘 How to Use

1. Go to Settings → Devices & Services → MiWiFi
2. Ensure update.miwifi_panel_frontend appears
3. If an update is available, click Update
4. Wait for the notification, then press Ctrl+F5 in your browser

Important: The integration fetches remote files from miwifi-panel-frontend — make sure version.json and files.json are up to date.

🔄 Changelog

From v3.1.0 → v3.1.1

• ➕ Added update entity for MiWiFi panel
• ➕ Persistent notification after successful panel update
• ➕ Improved device linking via MAC
• 🐛 Fixed update_coordinator warnings
• ♻️ Refactored async_install and async_added_to_hass logic

📎 Links

• 💡 Project: hass-miwifi
• 🎨 Panel: miwifi-panel-frontend
• 🌐 Web: xiaohack.es

📦 MiWiFi XiaoHack Edition – v3.1.0

🚀 Advanced integration for Xiaomi and Redmi routers with visual panel and Mesh support.

🛠 Maintained by @JuanManuelRomeroGarcia – xiaohack.es

✨ What's New in Version 3.1.0

🖼 Integrated MiWiFi Panel (new graphical panel)

• Xiaomi-style network topology: main router, Mesh nodes, and connected clients.
• Can be enabled from integration options (enable_panel: true).
• Professional design: blue background #1a73e8, white text, responsive and clean layout.
• No need for external Lovelace cards.

📶 New Supported Model: Redmi Router RN07

• Full support for internal model RA83 (AX3000 Enhanced Edition).
• Works with repeater and mesh modes, fully controllable via the UI.

🧰 General Features

• 🔧 WiFi management (2.4GHz, 5GHz, 5GHz Game, Guest).
• 📈 Sensors for RAM, temperature, WAN IP, network speeds, mode, etc.
• 👁️ Device tracking with device_tracker.
• 🧠 Automatic detection of Mesh nodes.
• 🔄 OTA firmware updates when available.
• 🌐 Log level selector from the UI (warning, info, debug).
• 🌍 Full localization in Spanish and English.

✅ Compatibility

• Compatible with Home Assistant 2025.4.0+.
• Backward-compatible with versions v3.0.8 and v3.0.9.
• Supports popular Xiaomi and Redmi routers.

See the full model list in the compatibility wiki.

🔄 How to Update

1. Replace all contents of the custom_components/miwifi/ directory with this version's files.
2. Fully restart Home Assistant.
3. Go to Settings → Devices & Services → MiWiFi → Options and configure:

• Log level.
• Enable or disable the MiWiFi panel.

📌 Migrating from the Original Repo

If you're coming from dmamontov/hass-miwifi:

1. Remove the original integration from Home Assistant.
2. Add this repository as a custom source in HACS:

`` https://github.com/JuanManuelRomeroGarcia/hass-miwifi ``

📘 Full Changelog: v3.0.9...v3.1.0

📦 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