🔍Help with testing AsusRouter during the development

[Vaskivskyi]

Intro

Hello, guys.

If you want to help with testing AsusRouter before the new versions are released, you can help by providing the data from your devices for automated tests. More devices covered - more chances there will be no bugs coming to releases.

With integration version 0.24.0 you are also installing asusrouter backend library 1.1.0. Using it you can get a dump of the data used by AsusRouter to provide sensors and other data in HA.

Gather data

• install (if not yet) asusrouter library using pip install asusrouter==1.1.0
• python -m asusrouter -o local/dump/location --host 192.168.1.1 -u admin -p password --ssl --dump --zip
• replace 192.168.1.1, admin and password with your values
• replace local/dump/location with the location where to save dump files
• if you need help, use python -m asusrouter --help
• at the selected location find .zip archive of all the data received from your device

Optional

If you are concerned about privacy, replace the following data in your files:

• Device serial number with e.g. model name (GT-AXE16000)
• MAC addressed. Please, replace it with the compatible format, e.g. 00:00:00:AB:00:15
• IP addresses. Replace with any generic IP address, e.g. 192.168.1.5

Share the files

Send your files (or zip archive with them) to me (at [email protected]) together with your device model + firmware type and version (if not included in files already). I'll create tests which could be run automatically to ensure AsusRouter is always compatible with your device.

You can share 1, 2, 5 or all the files you want. More data can help building better tests. But don't share the same data many times. We need to make sure, the library and the integration work with your data format, not with exact values

P.S. You can even prepare tests by yourself and open PR to the library repository -> https://github.com/Vaskivskyi/asusrouter

Privacy concerns

Any MAC address, IP address and non-generic device name will be replaced with compatible data before adding a test to a public repository. You can check the example of my device data here -> https://github.com/Vaskivskyi/asusrouter/tree/dev/tests/test_data/rt_ax88u_merlin_388