Huawei Mesh Router
vmakeev/huawei_mesh_router · vv0.9.3.2
Huawei mesh router component for Home Assistant
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
switch | Switch or outlet | |
binary_sensor | Sensor (motion, contact, leak, smoke…) | |
sensor | Sensor (temperature, humidity, air quality…) | |
button | Button (as a switch) | |
select | Mode picker (as switches) | |
device_tracker | Presence (as an occupancy sensor) |
What people report
Local polling of Huawei routers. AX3 dual-core failed initially because of a missing NFC switch; Q6 and Q2S are not fully supported yet.
- Works6
- Partly works1
- Not working2
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Honor Router 3 | Works Local | Listed as supportedSaved copySupported devices: Huawei WiFi AX3 Dual-core; Huawei WiFi AX3 Quad-core; Huawei WiFi AX3 Pro; Huawei WiFi Mesh; Huawei WiFi Mesh 3; Huawei WiFi Mesh 7; Honor Router 3; Huawei Q2S; Huawei Q2 Pro; Huawei Q6. Excerpt saved from the README on 2026-10-23. | README | |
| Huawei Q2 Pro | Works Local | Listed as supportedSaved copySupported devices: Huawei WiFi AX3 Dual-core; Huawei WiFi AX3 Quad-core; Huawei WiFi AX3 Pro; Huawei WiFi Mesh; Huawei WiFi Mesh 3; Huawei WiFi Mesh 7; Honor Router 3; Huawei Q2S; Huawei Q2 Pro; Huawei Q6. Excerpt saved from the README on 2026-10-23. | README | |
| Huawei WiFi AX3 Pro | Works Local | Listed as supportedSaved copySupported devices: Huawei WiFi AX3 Dual-core; Huawei WiFi AX3 Quad-core; Huawei WiFi AX3 Pro; Huawei WiFi Mesh; Huawei WiFi Mesh 3; Huawei WiFi Mesh 7; Honor Router 3; Huawei Q2S; Huawei Q2 Pro; Huawei Q6. Excerpt saved from the README on 2026-10-23. | README | |
| Huawei WiFi AX3 Quad-core | Works Local | Listed as supportedSaved copySupported devices: Huawei WiFi AX3 Dual-core; Huawei WiFi AX3 Quad-core; Huawei WiFi AX3 Pro; Huawei WiFi Mesh; Huawei WiFi Mesh 3; Huawei WiFi Mesh 7; Honor Router 3; Huawei Q2S; Huawei Q2 Pro; Huawei Q6. Excerpt saved from the README on 2026-10-23. | README | |
| Huawei WiFi Mesh 3 | Works Local | Listed as supportedSaved copySupported devices: Huawei WiFi AX3 Dual-core; Huawei WiFi AX3 Quad-core; Huawei WiFi AX3 Pro; Huawei WiFi Mesh; Huawei WiFi Mesh 3; Huawei WiFi Mesh 7; Honor Router 3; Huawei Q2S; Huawei Q2 Pro; Huawei Q6. Excerpt saved from the README on 2026-10-23. | README | |
| Huawei WiFi Mesh 7 | Works Local | Listed as supportedSaved copySupported devices: Huawei WiFi AX3 Dual-core; Huawei WiFi AX3 Quad-core; Huawei WiFi AX3 Pro; Huawei WiFi Mesh; Huawei WiFi Mesh 3; Huawei WiFi Mesh 7; Honor Router 3; Huawei Q2S; Huawei Q2 Pro; Huawei Q6. Excerpt saved from the README on 2026-10-23. | README | |
| Huawei WiFi AX3 Dual-core | Partly works Local | Failed on missing NFC switch; NFC disabled in a test branchSaved copy… me the authentication seems to work, unlike in #1, and the integration appears in the menu, but keeps showing this error: ``` Unexpected error fetching Huawei AX3 data: Expecting value: line 1 column 1 (char 0) Traceback (most recent call last): File "/usr/src/homeassistant/homeassistant/helpers/update_coordinator.py", line 205, in _async_refresh self.data = await self._async_update_data() File "/usr/src/homeassistant/homeassistant/helpers/update_coordinator.py", line 164, in _async_update_data return await self.update_method() File … Excerpt saved from GitHub on 2026-10-23. | Issue #10 · 2022-11 | |
| Huawei Q2S | Not working Local | Unsupported API URLs trigger a temporary router banSaved copymy router type is huawei Q6 (lan cable) mesh router, and there are too many warings, as follows: 2023-05-09 09:09:38.286 WARNING (MainThread) [custom_components.huawei_mesh_router.update_coordinator (Huawei Router)] Can not update repeater state Api call error, status:404; code: -2, category: unauthorized 2023-05-09 09:09:38.471 WARNING (MainThread) [custom_components.huawei_mesh_router.update_coordinator (Huawei Router)] Can not update router info: Failed to get initial CSRF; reason: auth_general 2023-05-09 09:09:38.511 WARNING (MainThread) … Excerpt saved from GitHub on 2026-10-23. | Issue #48 · 2023-05 | |
| Huawei Q6 mesh router | Not working Local | Repeated 404 unauthorized warnings; marked not supported yetSaved copymy router type is huawei Q6 (lan cable) mesh router, and there are too many warings, as follows: 2023-05-09 09:09:38.286 WARNING (MainThread) [custom_components.huawei_mesh_router.update_coordinator (Huawei Router)] Can not update repeater state Api call error, status:404; code: -2, category: unauthorized 2023-05-09 09:09:38.471 WARNING (MainThread) [custom_components.huawei_mesh_router.update_coordinator (Huawei Router)] Can not update router info: Failed to get initial CSRF; reason: auth_general 2023-05-09 09:09:38.511 WARNING (MainThread) … Excerpt saved from GitHub on 2026-10-23. | Issue #48 · 2023-05 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local polling
Talks to the device on your network, asking it for updates every so often.
Details
| Installs (analytics) | 314 (0.04%) |
|---|---|
| GitHub stars | 79 |
| Latest version | v0.9.3.2 (2026-02-10) |
| Set up in the UI | Yes |
| Maintainers | @vmakeev |
| License | MIT |
Devices listed in its README
- Huawei WiFi AX3 Dual-core
- Huawei WiFi AX3 Quad-core
- Huawei WiFi AX3 Pro
- Huawei WiFi Mesh
- Huawei WiFi Mesh 3
- Huawei WiFi Mesh 7
- Honor Router 3
- Huawei Q2S
- Huawei Q2 Pro
- Huawei Q6
Notable forks
Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.
| Fork | Stars | Last push | Description |
|---|---|---|---|
| zcmk123/huawei_mesh_router Newer code | ★ 0 | 2026-05-25 | Huawei mesh router component for Home Assistant |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
Sources
- Documentation: https://github.com/vmakeev/huawei_mesh_router
- Source code: https://github.com/vmakeev/huawei_mesh_router
- Issues: https://github.com/vmakeev/huawei_mesh_router/issues
- HACS: https://hacs.xyz
