Home Assistant custom component for control Huawei mesh routers over LAN.
- obtaining information about all routers and connected devices in the entire mesh network:
- connected devices tracking and tagging
- device connection parameters (frequency, signal strength, guest and hilink devices, upload/download rates)
- name of the specific router to which the device is connected
- number of connected devices (total and for each individual router)
- Wi-Fi access management:
- enable/disable/configure the guest Wi-Fi network
- enable or disable Wi-Fi access control
- add/remove devices from blacklist/whitelist
- Wi-Fi access switch per client device
- enabling and disabling access to specific sites
- hardware and firmware version of the primary router
- Internet connection details (IP address, status, upload/download rates)
- uptime of each router
- control of the NFC (OneHop Connect) on each router separately
- control of the Fast Roaming function (802.11r)
- control of the Target Wake Time (reduce power consumption of Wi-Fi 6 devices in sleep mode)
- port mapping switches
- reboot buttons
- events for connecting, disconnecting, or moving devices over a mesh network
- automatic detection of available functions
| Name | Model | Notes |
|---|---|---|
| Huawei WiFi AX3 Dual-core | WS7100 | No NFC switches (unsupported by router) |
| Huawei WiFi AX3 Quad-core | WS7200 | |
| Huawei WiFi AX3 Pro | WS7206 | |
| Huawei WiFi Mesh | AC2200 | |
| Huawei WiFi Mesh 3 | WS8100 | My router model. All features are available |
| Huawei WiFi Mesh 7 | WS8800 | |
| Honor Router 3 | XD20 |
Other Huawei routers based on HarmonyOS (except Chinese domestic market) most likely will work.
| Name | Model | Notes |
|---|---|---|
| Huawei Q2S | WS5281 | The router blocks requests from the component |
| Huawei Q2 Pro | WS5280 | The router blocks requests from the component |
| Huawei Q6 | WS7290 | The router blocks requests from the component |
As far as I can understand, problems arise with routers designed for the domestic market of China. Unfortunately, I do not have such devices available so that I can try to find out the reasons for this behavior.
Copy huawei_mesh_router folder from latest release to custom_components folder in your Home Assistant config folder and restart Home Assistant. The final path to folder should look like this: <home-assistant-config-folder>/custom_components/huawei_mesh_router.
HACS -> type huawei mesh router -> click on it -> press DOWNLOAD button and follow the instructions.
Or simply click the button below:
Configuration > Integrations > Add Integration > Huawei Mesh Router
By default, Huawei mesh routers use the username admin, although it is not displayed in the web interface and mobile applications.
If the component does not work, or does not work correctly, try to go to the troubleshooting section
You can perform advanced configuration of the component after adding it.
To do this, click on the intergation, and in the tab that opens, click CONFIGURE
Advanced settings include:
| Name | Default |
|---|---|
| Update interval | 30 seconds |
| Enabling or disabling Device Wi-Fi Access switches | Disabled |
| Enabling or disabling Number of connected devices for each router | Disabled |
| Enabling or disabling Device tags | Disabled |
| Enabling or disabling Devices tracking | Disabled |
| Enabling or disabling Router-specific zones | Disabled |
| Enabling or disabling Website filtering switches | Disabled |
| Enabling or disabling Event entities | Disabled |
| Enabling or disabling Port mapping switches | Disabled |
Note: click SUBMIT to go to the next page
Note: click SUBMIT to save the changes and complete the setup
The component allows you to track all devices connected to your mesh network. Each router can provide information about the zone to which all devices connected to it will be assigned (if enabled in the advanced options). Read more
You can attach one or more tags to each client device in order to be able to use in automation the number of devices marked with a tag, connected to a specific router, or to the entire mesh network. Read more
- Reboot router (read more)
- NFC (read more)
- Wi-Fi 802.11r (read more)
- Wi-Fi TWT (read more)
- Wi-Fi Access Control (read more)
- Device Wi-Fi Access (read more)
- Website filtering (read more)
- Guest network (read more)
- Port mapping (read more)
- Add device to the whitelist (read more)
- Add device to the blacklist (read more)
- Remove device from the whitelist (read more)
- Remove device from the blacklist (read more)
- Configure the parameters of the guest Wi-Fi network (read more)
- The dependent router has connected to the mesh network (read more)
- The dependent router disconnected from the mesh network (read more)
- The device has connected to the mesh network (read more)
- The device disconnected from the mesh network (read more)
- The device has changed the router within the mesh network (read more)