Control Huawei mesh routers from Home Assistant

Home Assistant custom component for control Huawei mesh routers over LAN.

Key features

• 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

Confirmed supported models

Other Huawei routers based on HarmonyOS (except Chinese domestic market) most likely will work.

Not supported models

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.

Installation

Manual

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

HACS -> type huawei mesh router -> click on it -> press DOWNLOAD button and follow the instructions.

Or simply click the button below:

Configuration

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.

Troubleshooting

If the component does not work, or does not work correctly, try to go to the troubleshooting section

Advanced options

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

Note: click SUBMIT to go to the next page

Note: click SUBMIT to save the changes and complete the setup

Devices tracking

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

Sensors

• Number of connected devices (read more)
• Uptime (read more)
• Internet connection (read more)

Controls

Buttons

• Reboot router (read more)

Switches

• 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)

Selects

• Wi-Fi access control mode (read more)
• Router-specific zone (read more)

Services

• 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)

Events

Regular events

• 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)

Events as entities

• Router events (read more)
• Device events (read more)