API wrapper for communication with ASUSWRT-powered routers using HTTP protocol
Project description
AsusRouter
AsusRouter is an API wrapper for communication with ASUSWRT-powered routers using HTTP(S) protocols. The library supports both the stock AsusWRT firmware and AsusWRT-Merlin.
Up till now, it is only used for the custom AsusRouter Home Assistant integrartion. But I am always open to making it suitable for any other use.
Installation
Installation of the latest release is available from PyPI:
pip install asusrouter
Usage
Once installed, you can import the AsusRouter
class from the module. Example shows the default parameters except for host
, username
and password
.
from asusrouter import AsusRouter
router = AsusRouter(host = "router.my.address", #required - both IP and URL supported
username = "admin", #required
password = "password", #required
port = None, #optional - default port would be selected based on use_ssl parameter
use_ssl = False, #optional
cert_check = True, #optional
cert_path = "", #optional
cache_time = 5, #optional
enable_monitor = True, #optional
enable_control = False) #optional
The module has the initialization method to load all the known data (all the monitors and methods from the next section, require enable_monitor
to be True
):
router.async_initialize()
Monitors and additional methods
Most of the values, obtained from the router are grouped in several monitor methods to decrease the amount of data sent between the library and the device. All of them require the enable_monitor
parameter of AsusRouter
to be set to True
.
async_monitor_main()
async_monitor_nvram()
async_monitor_misc()
async_monitor_devices()
A detailed description of monitors and monitoring methods is available here (in work).
Commands
AsusRouter
class supports sending commands to the device using the async_command
method. Sending commands requires the enable_command
parameter of AsusRrouter
to be set to True
.
For example, to reboot the device:
# This command will REBOOT your device if connected!
router.async_command(commands = {"rc_service": "reboot"}, action_mode = "apply")
Commands to the method should be sent as a dict
of command: value
. Please, refer to the Command List (in work) for a detailed explanation of the available commands.
Supported devices
AsusRouter supports virtually every AsusWRT-powered device.
WiFi 7 | 802.11be
Model | Status | Tested firmware | Find it on Amazon[^amazon] |
---|---|---|---|
GT-BE98 | :yellow_heart: Expected to work | find it | |
RT-BE96U | :yellow_heart: Expected to work | find it |
WiFi 6e | 802.11axe
Model | Status | Tested firmware | Find it on Amazon[^amazon] |
---|---|---|---|
GT-AXE11000 | :yellow_heart: Expected to work | find it | |
GT-AXE16000 | :yellow_heart: Expected to work | find it | |
RT-AXE7800 | :yellow_heart: Expected to work | find it |
WiFi 6 | 802.11ax
Model | Status | Tested firmware | Find it on Amazon[^amazon] |
---|---|---|---|
DSL-AX82U | :green_heart: Confirmed | Merlin:386.07_0-gnuton0_beta2 |
find it |
GT-AX11000 | :green_heart: Confirmed | Merlin:386.7_2 |
find it |
GT-AX11000 Pro | :yellow_heart: Expected to work | find it | |
GT-AX6000 | :yellow_heart: Expected to work | find it | |
GT6 | :yellow_heart: Expected to work | find it | |
RT-AX55 | :green_heart: Confirmed | find it | |
RT-AX56U | :green_heart: Confirmed | Merlin:386.7_2 |
find it |
RT-AX58U | :green_heart: Confirmed | Stock:386_49674 386.7_2 |
find it |
RT-AX68U | :green_heart: Confirmed | find it | |
RT-AX82U | :green_heart: Confirmed | Stock:386_48664 386.49674 |
find it |
RT-AX86S | :green_heart: Confirmed | Stock:386_49447 |
find it |
RT-AX86U | :green_heart: Confirmed | Stock:386_46061 386_48260 386.7_2 |
find it |
RT-AX88U | :green_heart: Confirmed | Stock:386_45934 386_48631 386.5_2 386.8_0 388.1_0 |
find it |
RT-AX89X | :green_heart: Confirmed | find it | |
RT-AX92U | :green_heart: Confirmed | Stock:386_46061 |
find it |
TUF-AX5400 | :green_heart: Confirmed | find it | |
ZenWiFi AX (XT8) | :green_heart: Confirmed | Stock:386_48706 386.07_2-gnuton1 |
find it |
ZenWiFi AX Mini (XD4) | :green_heart: Confirmed | Stock:386_48790 386_49599 |
find it |
WiFi 5 | 802.11ac
Model | Status | Tested firmware | Find it on Amazon[^amazon] |
---|---|---|---|
4G-AC55U | :green_heart: Confirmed | find it | |
DSL-AC68U | :green_heart: Confirmed | Stock:386_47534 386.04-gnuton2 |
find it |
RT-AC51U | :green_heart: Confirmed | Stock:380_8591 |
find it |
RT-AC52U B1 | :green_heart: Confirmed | find it | |
RT-AC5300 | :green_heart: Confirmed | Merlin:386.7_2 |
find it |
RT-AC57U V3 | :green_heart: Confirmed | Stock:386_21649 |
find it |
RT-AC58U | :green_heart: Confirmed | find it | |
RT-AC66U | :green_heart: Confirmed | Merlin:380.70_0 |
find it |
RT-AC66U B1 | :green_heart: Confirmed | find it | |
RT-AC68U | :green_heart: Confirmed | Merlin:386.5_2 386.7_0 |
find it |
RT-AC86U | :green_heart: Confirmed | Stock:386_48260 386.7_0 386.7_2 |
find it |
RT-AC87U | :green_heart: Confirmed | Merlin:384.13_10 |
find it |
RT-AC88U | :green_heart: Confirmed | Merlin:386.7_beta1 |
find it |
RT-ACRH17 | :green_heart: Confirmed | Stock:382.52517 |
find it |
WiFi 4 | 802.11n
Model | Status | Tested firmware | Find it on Amazon[^amazon] |
---|---|---|---|
RT-N66U | :green_heart: Confirmed | find it |
Support the library
Issues and Pull requests
If you have found an issue working with the library 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!
Check it with your device
Testing the library with different devices would help a lot in the development process. Unfortunately, currently, I have only one device available, so your help would be much appreciated.
Other support
This library is a free-time project. If you like it, you can support me by buying a coffee.
[^amazon]: As an Amazon Associate I earn from qualifying purchases. Not like I ever got anything yet (:
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for asusrouter-0.18.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c1b009501837251ad57a001e430102c0c3951bb810daf260b61429cd1968078c |
|
MD5 | 8c684493c055422bc18add1f69e862db |
|
BLAKE2b-256 | 96f0ce098833b7c09c161ecff7c9351b8b9d275d3ecc3a5587d79395859dbcbf |