Skip to content

vmakeev/huawei_mesh_router

Repository files navigation

Control Huawei mesh routers from Home Assistant

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

Hacs Default License Active installatons

Release ReleaseDate Maintained

Localization contribute

Russian English Brazilian Portuguese Español Slovak

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
  • Internet access time control switches
  • reboot buttons
  • events for connecting, disconnecting, or moving devices over a mesh network
  • automatic detection of available functions

Confirmed supported models

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.

Not supported models

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.

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:

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

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

Integration

Integration details

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

Options 1/2

Note: click SUBMIT to go to the next page

Options 2/2

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

Controls

Buttons

Switches

Selects

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