AsusRouter is a custom integration for Home Assistant to monitor and control your AsusWRT (and AsusWRT-Merlin)-powered router using the AsusRouter python library.
The integration uses the native HTTP(S) API (the same way as WebUI) and relies on direct communication with your device.
You can find the full documentation on the official webpage.
It is recommended to use an HTTPS connection to your router (SSL). While both the SSL and non-SSL connections are fully supported, some devices might have issues with disconnects on HTTP. In order to use SSL, you need to enable it in the router settings: Administration -> System -> Local Access Config -> Authentication Method. Put it to BOTH (recommended) or HTTPS. Make note of the port number (default is 8443).
The integration might show a different number of connected devices compared to the WebUI network map. In this case, refer to the number of devices shown in the AiMesh section of the WebUI. Those two are different regardless of the actual use of AiMesh.
👍 Vote for the feature request!
Firmware versions 3.0.0.4.x and 3.0.0.6.x are fully supported (older versions might have a limited amount of sensors available). When talking about the FW, 3.0.0.4 might be missed since it is the same all the time. Important is only the last part, e.g. 386.48631 or 106.xxxxx for the stock or 386.7 for Merlin FW.
Firmware 5.x.x (some DSL models) is NOT supported (not AsusWRT).
You can add this repository to your HACS:
HACS -> Integrations -> Explore & Download Repositories -> AsusRouter
Copy content of the stable branch custom_components/asusrouter/ to custom_components/asusrouter/ in your Home Assistant folder.
After AsusRouter is installed, you can add your device from Home Assistant UI.
To connect to the device you need to provide the following data:
- IP address or hostname
- Username (the one you use to log into the WebUI)
- Password
- Whether to use an SSL connection
Almost all the integration settings can be reconfigured later via the Configure button on the Integrations' page without the need to remove your device and add it again.
AsusRouter supports 14+ groups of features, including monitoring of:
- connected device, CPU, guest WLAN, LED, load average, network, OpenVPN, parental control, ports, RAM, temperature, WAN, WLAN.
and control of:
- guest WLAN, LED, OpenVPN, parental control, WLAN.
as well as the following HA platforms:
binary_sensor,button,device_tracker,light,sensor,switch,update
and HA events and services.
AsusRouter supports virtually every AsusWRT-powered device. This list is purely based on the reports from the users. Other devices with the compatible firmware should work as well.
| Model | Status | Tested firmware | Find it on Amazon1 |
|---|---|---|---|
| GT-BE98 | 💛 Expected to work | find it | |
| GT-BE98 Pro | 💛 Expected to work | find it | |
| RT-BE88U | 💛 Expected to work | find it | |
| RT-BE96U | 💛 Expected to work | find it | |
| TUF-BE3600 | 💛 Expected to work | find it | |
| TUF-BE6500 | 💛 Expected to work | find it | |
| ZenWiFi BD4 | 💛 Expected to work | find it | |
| ZenWiFi BQ16 | 💛 Expected to work | find it | |
| ZenWiFi BQ16 Pro | 💛 Expected to work | find it | |
| ZenWiFi BT10 | 💛 Expected to work | find it |
| Model | Status | Tested firmware | Find it on Amazon1 |
|---|---|---|---|
| GT-AXE11000 | 💛 Expected to work | find it | |
| GT-AXE16000 | 💚 Confirmed | Stock:388.21617 |
find it |
| RT-AXE7800 | 💚 Confirmed | Stock:388_22068 |
find it |
| ZenWiFi ET8 | 💚 Confirmed | Stock:388.23759 |
find it |
| ZenWiFi Pro ET12 | 💚 Confirmed | Stock:388.23013 |
find it |
| Model | Status | Tested firmware | Find it on Amazon1 |
|---|---|---|---|
| DSL-AX82U | 💚 Confirmed | Merlin:386.07_0-gnuton0_beta2 |
find it |
| GT-AX11000 | 💚 Confirmed | Merlin:386.7_2388.1_0388.4_0 |
find it |
| GT-AX11000 Pro | 💚 Confirmed | Stock:388.24198 |
find it |
| GT-AX6000 | 💛 Expected to work | find it | |
| GT6 | 💛 Expected to work | find it | |
| RT-AX3000P | 💛 Expected to work | find it | |
| RT-AX52 | 💛 Expected to work | find it | |
| RT-AX53U | 💚 Confirmed | Stock:386.69061 |
find it |
| RT-AX5400 | 💛 Expected to work | find it | |
| RT-AX55 | 💚 Confirmed | Stock:386.50410386.52041 |
find it |
| RT-AX56U | 💚 Confirmed | Merlin:386.7_2388.1_0388.2_2 |
find it |
| RT-AX57 | 💛 Expected to work | find it | |
| RT-AX57 Go | 💛 Expected to work | find it | |
| RT-AX57M | 💛 Expected to work | find it | |
| RT-AX58U | 💚 Confirmed | Stock:386.49674388.22237386.7_2388.1_0388.4_0388.7.0 |
find it |
| RT-AX59U | 💛 Expected to work | find it | |
| RT-AX68U | 💚 Confirmed | Stock:388.21732 |
find it |
| RT-AX82U | 💚 Confirmed | Stock:386.48664386.49674 |
find it |
| RT-AX86S | 💚 Confirmed | Stock:386.46061386.48260386.49447388.22525386.7_2 |
find it |
| RT-AX86U | 💚 Confirmed | Stock:386.46061386.48260386.49447388.22525386.7_2388.4_0 |
find it |
| RT-AX86U Pro | 💚 Confirmed | Stock:388.23565 |
find it |
| RT-AX88U | 💚 Confirmed | Stock:386.45934386.48631388.24198386.5_2386.8_0388.1_0388.2_0388.4_0388.7_0 |
find it |
| RT-AX88U Pro | 💚 Confirmed | Merlin:388.4_0 |
find it |
| RT-AX89X | 💚 Confirmed | find it | |
| RT-AX92U | 💚 Confirmed | Stock:386.46061 |
find it |
| TUF-AX3000 V2 | 💚 Confirmed | Stock:388.23785 |
find it |
| TUF-AX4200 | 💛 Expected to work | find it | |
| TUF-AX5400 | 💚 Confirmed | Stock:386.50224388.21224388.22525388.23285388.4_0 |
find it |
| TUF-AX6000 | 💚 Confirmed | Stock:388.32432 |
find it |
| ZenWiFi AX (XT8) | 💚 Confirmed | Stock:386.48706388.23285386.7_2-gnuton1 |
find it |
| ZenWiFi AX Hybrid (XP4) | 💛 Expected to work | find it | |
| ZenWiFi AX Mini (XD4) | 💚 Confirmed | Stock:386.48790386.49599 |
find it |
| ZenWiFi Pro XT12 | 💚 Confirmed | Stock:388.22127 |
find it |
| ZenWiFi XD4 Plus | 💛 Expected to work | find it | |
| ZenWiFi XD4S | 💛 Expected to work | find it | |
| ZenWiFi XD5 | 💛 Expected to work | find it | |
| ZenWiFi XD6 | 💚 Confirmed | Stock:388.21380 |
find it |
| ZenWiFi XD6S | 💚 Confirmed | Stock:388.21380 |
find it |
| ZenWiFi XT9 | 💚 Confirmed | Stock:388_23285 |
find it |
| Model | Status | Tested firmware | Find it on Amazon1 |
|---|---|---|---|
| 4G-AC55U | 💚 Confirmed | Stock:380.8102 |
find it |
| DSL-AC68U | 💚 Confirmed | Stock:386.47534386.50117386.4-gnuton2386.7_2-gnuton1 |
find it |
| RT-AC51U | 💚 Confirmed | Stock:380.8591 |
find it |
| RT-AC52U B1 | 💚 Confirmed | find it | |
| RT-AC5300 | 💚 Confirmed | Merlin:386.7_2 |
find it |
| RT-AC57U V3 | 💚 Confirmed | Stock:386.21649 |
find it |
| RT-AC58U | 💚 Confirmed | find it | |
| RT-AC66U | 💚 Confirmed | Merlin:380.70_0 |
find it |
| RT-AC66U B1 | 💚 Confirmed | Stock:386.51255 |
find it |
| RT-AC68U | 💚 Confirmed | Stock:386.49703386.5_2386.7_0 |
find it |
| RT-AC85P | 💚 Confirmed | Stock:382.52516 |
find it |
| RT-AC86U | 💚 Confirmed | Stock:386.48260386.49709386.7_0386.7_2386.9_0 |
find it |
| RT-AC87U | 💚 Confirmed | Merlin:384.13_10 |
find it |
| RT-AC88U | 💚 Confirmed | Stock:386.48260386.5_0386.7_beta1386.12_2 |
find it |
| RT-ACRH17 | 💚 Confirmed | Stock:382.52517 |
find it |
| ZenWiFi AC Mini(CD6) | 💛 Expected to work | find it |
| Model | Status | Tested firmware | Find it on Amazon1 |
|---|---|---|---|
| RT-N66U | 💚 Confirmed | find it |
Here is the list of features being in process of development or considered for the future development. If you cannot find the feature you would like to have in the integration, please, open a new feature request.
| Group | Feature | Status |
|---|---|---|
| Aura RGB |
|
on hold (a device with Aura RGB support is required for development and testing) |
| Connected device | considered |
If you have found an issue working with the integration or just want to ask for a new feature, please fill in a new issue.
You are also welcome to submit pull requests to the repository!
This integration is a free-time project. If you like it, you can support me by buying a coffee.
Moreover, you can support the integration by using the Amazon links provided in the device lists. Any purchase (even not related to the exact product) might bring a small commission to the project.
The initial codebase for this integration is highly based on Home Assistant core integration AsusWRT and ollo69/ha_asuswrt_custom.
![@dependabot[bot]](https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}
