[Custom Component] MiWiFi – XiaoHack Edition (Xiaomi Router Integration)

Share your Projects! Custom Integrations
,
1

Hi everyone! :wave:

I’ve revived and extended the original MiWiFi integration which hasn’t been updated since 2023.

This new fork includes bug fixes, improved router support, and active development, including mesh/repeater mode improvements, device tracking, and more!

:link: GitHub Repository:

:point_right: GitHub - JuanManuelRomeroGarcia/hass-miwifi: MiWiFi for Home Assistant

:globe_with_meridians: Compatible with Home Assistant >= 2023.3.0

:sparkles: Features

  • :white_check_mark: Works with most Xiaomi routers

  • :satellite: Mesh & Repeater mode support

  • :repeat: Device tracker with full LAN/WiFi/GUEST split

  • :arrows_counterclockwise: Automatic firmware update detection

  • :bulb: LED light control entity

  • :chart_with_upwards_trend: Wi-Fi signal and bandwidth sensors

  • :wrench: Option to force-load in mesh mode

  • :brain: Automatic device restoration & cleanup

:hammer_and_wrench: Installation via HACS

  1. Go to HACS > Integrations > Custom Repositories

  2. Add this repo:


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

  1. Choose category: Integration

  2. Search for MiWiFi (XiaoHack Edition), install, and restart Home Assistant

  3. Configure via Settings > Devices & Services

:test_tube: Supported Routers

  • Mi Router 4A Gigabit V2 (R4AV2)

  • Xiaomi Router AC1200 (RB02)

  • Xiaomi 5G CPE Pro (CB0401)

  • Plus many other Xiaomi/Mi/Redmi routers

:package: Latest Version – v3.0.3

Check full changelog here:

:point_right: Releases · JuanManuelRomeroGarcia/hass-miwifi · GitHub

:speech_balloon: Feedback & Support

Feel free to open issues or suggest improvements on GitHub!

This is a community-driven effort, and your support helps keep it alive. :blush:

Made with :heart: by [@JuanManuelRomeroGarcia]

2 Likes
2

:package: v3.0.5 – XiaoHack Edition

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

:white_check_mark: 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).

:blue_book: How to Update

Replace the files in your custom_components/miwifi/ folder.

Restart Home Assistant completely to apply changes.

Check the logs to confirm proper integration loading.

:pushpin: Reminder for Migrators

If you’re migrating from the original dmamontov/hass-miwifi:

:arrow_right: Remove the old integration.

:arrow_right: Add this repo via HACS as a custom repository:

Maintained with :heart: by
@JuanManuelRomeroGarcia

1 Like
3
4

:package: v3.0.8 – XiaoHack Edition

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

:bug: Fixes & Improvements

  • :white_check_mark: Added WAN IP sensor
    Shows your router’s external IP (wan_ip) in Home Assistant.

  • :white_check_mark: Added WAN Type sensor
    Displays the connection type (pppoe, dhcp, etc.) as reported by your router.

  • :white_check_mark: 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.
    :heavy_plus_sign: Option available in integration configuration.

  • :white_check_mark: Mode sensor values are now readable
    Shows Default or Mesh instead of numbers (0, 9).

  • :white_check_mark: Optional unit selection in config flow
    You can now choose between Mb/s and B/s when configuring the integration.

  • :repeat: Improved sensor class and update logic
    Updated the MiWifiSensor class to dynamically switch units and refresh values consistently.

  • :test_tube: Updated constants, config flow, and options schema.

:white_check_mark: Compatibility

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

:blue_book: 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.

:pushpin: Reminder for Migrators

If you’re migrating from the original dmamontov/hass-miwifi:

:arrow_right: Remove the old integration.
:arrow_right: Add this repo via HACS as a custom repository:

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

Maintained with :heart: by @JuanManuelRomeroGarcia

Full Changelog: Comparing v3.0.7...v3.0.8 · JuanManuelRomeroGarcia/hass-miwifi · GitHub