Xiaomi MiWiFi component for tracking devices and managing routers

MiWiFi for Home Assistant

hacs_badge Telegram

The component allows you to monitor devices and manage routers based on MiWiFi from Home Assistant.

:exclamation: Supports routers with original or original patched MiWifi firmware

:exclamation: On the modified firmware, not all functionality may work

More info

Supported routers

Many more Xiaomi and Redmi routers supported by MiWiFi

Check list

Required
  • xqsystem/login - Authorization.
  • xqsystem/init_info - Basic information about the router.
  • misystem/status - Basic information about the router. Diagnostic data, memory, temperature, etc.
  • xqnetwork/mode - Operating mode. Repeater, Access Point, Mesh, etc.
Additional
  • misystem/topo_graph - Topography, auto discovery does not work without it.
  • xqsystem/check_rom_update - Getting information about a firmware update
  • xqnetwork/wan_info - WAN port information.
  • misystem/led - Interaction with LEDs.
  • xqnetwork/wifi_detail_all - Getting information about WiFi adapters
  • xqnetwork/wifi_diag_detail_all - Getting information about guest WiFi
  • xqnetwork/avaliable_channels - Gets available channels for WiFi adapter
  • xqnetwork/wifi_connect_devices - Get information about connected devices
  • misystem/devicelist - More information about connected devices
  • xqnetwork/wifiap_signal - AP signal in repeater mode
  • misystem/newstatus - Additional information about connected devices for force load mode
Action
  • xqsystem/reboot - Reboot
  • xqsystem/upgrade_rom - Firmware update.
  • xqsystem/flash_permission - Clear permission. Required only for firmware updates.
  • xqnetwork/set_wifi - Update WiFi settings. Causes the adapter to reboot.
  • xqnetwork/set_wifi_without_restart - Update Guest WiFi settings.

:exclamation: If your router is not listed or not tested, try adding an integration, it will check everything and give a link to create an issue. You just have to click Submit new issue

:exclamation: If at the time of adding the integration only Router {ip} not supported message is displayed, please create an issue with the message that the router is not supported, indicating the model of the router.

Summary

  • :green_circle: - Supported
  • :red_circle: - Not supported
  • :white_circle: - Not tested
Image Router Code Required Additional Action
Redmi Router AX6000 RB06 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Redmi Router AX5400 RA74 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Redmi Gaming Router AX5400 RB04 :green_circle::green_circle::green_circle::green_circle: :green_circle::white_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::white_circle::green_circle::green_circle::green_circle:
Xiaomi Router CR8808 CR8808 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Xiaomi Mesh System AX3000 RA82 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Xiaomi Router AX3200 RB01 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Redmi Router AX1800 RA71 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Redmi Router AX6S RB03 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Xiaomi Router AX3000 RA80 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Redmi Router AX3000 RA81 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Xiaomi China Unicom WiFi 6 Router CR6606 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Xiaomi Router AX9000 RA70 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Redmi Router AX5 RA50 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Xiaomi Router AX6000 RA72 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Redmi Router AX6 RA69 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi Router 4 Pro R1350 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi AIoT Router AC2350 R2350 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Redmi Router AX5 RA67 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi Router AX1800 RM1800 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Xiaomi AIoT Router AX3600 R3600 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Redmi Router AC2100 RM2100 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi Router AC2100 R2100 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi Router Mesh D01 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::red_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi Router 4A R4AC :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::red_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi Router 4A Gigabit R4A :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::red_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi Router 4C R4CM :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::red_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi Router 4Q R4C :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::red_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi Router 4 R4 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::red_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi Router 3A R3A :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::red_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi Router 3C R3L :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::red_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi Router HD R3D :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::red_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi Router Pro R3P :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::red_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi Router 3G R3G :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::red_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi Router 3 R3 :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::red_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi Router R2D R2D :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::red_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi Router Lite R1CL :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::red_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi Router Mini R1CM :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::red_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
Mi Router R1D R1D :green_circle::green_circle::green_circle::green_circle: :green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::green_circle::red_circle: :green_circle::green_circle::green_circle::green_circle::green_circle:
3 Likes

Hi @dmamontov. First of all thank You for sharing your component.

My feedback:

I’ve integrated component to my setup with ax3600 global version (FW 3.0.22) and AX1800 (global,; FW 3.0.34)

AX3600 was added as device, but integration has no entties
AX1800 was added without device and entitties

Do You think that is firmware related problem?

Best regards!

Have you reloaded hass? if yes enable debug mode and restart. on the logs it will be clear what the matter is.

logger:
  default: error
  logs:
    ...
    custom_components.miwifi: debug

Debag will help you understand what’s the matter

Yes i reloaded HA (few times)

In logs i have:

I am fairy new in HA so need some time to add properlly logger;).

Update the integration. Fixed this error

When I added logger i have also:

Update the integration v1.0.1. Fixed this error

Updated, restarted - everything works now.

Awsome - thank You Very much!

1 Like

Hi there!
I’ve got a Xiaomi Router HD and it’s not working.
Some logs:

2021-03-12 11:49:13 DEBUG (MainThread) [custom_components.miwifi.core.luci_data] MiWiFi Incorrect config (192.168.0.111) KeyError('model')

Update the component. Fixed, should fix the problem. There is no way to test it on your router. His api is old enough. If there are more errors, write to me in my telegram @dslonyara, I will try to solve it in real time.

Thanks @dmamontov, i’m using v1.0.1
I don’t know how to add you in telegram

Upgrade to 1.0.2.

Thanks to everyone who helps to test on new routers)

2 Likes

Hello l am having Redmi AC 2100 white router. 2.0.23 CN
No device, no entities created.
Edit: Rebooted router. Working now.
Performance table working. Need to put Router Mac manually.
Thank you for sharing @dmamontov

1 Like

Hello, I have this error, and integration not working for me, say: Invalid IP

Logger: homeassistant.setup
Source: custom_components/miwifi/__init__.py:45
First occurred: 7:51:17 (1 occurrences)
Last logged: 7:51:17

Error during setup of component miwifi
Traceback (most recent call last):
  File "/usr/src/homeassistant/homeassistant/setup.py", line 213, in _async_setup_component
    result = await task
  File "/config/custom_components/miwifi/__init__.py", line 45, in async_setup
    hass.data[DOMAIN][router[CONF_IP_ADDRESS]] = router
KeyError: 'miwifi'

Are you configuring via yml or frontend? The Invalid IP error is called when there is no way to reach the given ip, it can be connection timeout, etc. try restarting your router. Specify which router model?
I recommend configuring it through the interface instead of yml

Fixed the error. Update to 1.0.7

1 Like

Hi,

I confirm that the MiWiFi component works for my Global AX3600 set up as wired extender. One exception though: the list of devices is totally empty, whereas on the Android app I can see all my devices.

I tried using the API directly from a web browser and I got the answer {"mac":"XX:XX:XX:XX:XX:XX","list":[],"code":0}, which confirms that the issue is not in the Home Assistant component.

Does the Android app use a different API?

try it

Q. Can I use the router in repeater mode or access point mode without a parent MiWiFi device?

A. It is possible with the force_load_repeater_devices option enabled. But there is a limitation. You will not see IP, uptime, and connection type, but the name will be the mac-address.

It is advisable to restart after

Sorry, forgot to say that I had already seen this and tried it. I didn’t see any difference (and I still saw the uptime!)

Edit to add: I tried the option in the GUI (Forced booting of devices in repeater mode [PRO]). Can you please confirm it is the same thing as force_load_repeater_devices?

Just tried it again and now it works :smiley:

This time I restarted both the router and Home Assistant. Maybe that is what did the trick.

Edited again to add: uptime still displayed correctly.