Version History - MiWiFi XiaoHack Edition

🛠 MiWiFi XiaoHack Edition – v3.1.4

This release fixes a critical bug affecting the detection of the main router when the assoc field was missing from the topology graph.

🐛 Bugfixes

• ✅ Improved main node (is_main) detection logic:
• Routers without the assoc field will now correctly fall back to the show + mode method.
• This fixes the issue where:
• The update.miwifi_panel_frontend entity was not being created.
• The network topology did not load in the panel.
• Main router detection failed in status.js, mesh.js, settings.js, and topologia.js.

ℹ️ How to Update

1. In Home Assistant, go to the update.miwifi_xiaohack_integration entity.
2. Click “Update”.
3. Restart Home Assistant.
4. Refresh your browser (Ctrl + F5) to load the latest panel.

Thanks to the community for reporting and testing! For more info, visit xiaohack.es or check the GitHub repository.

📦 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