Asusrouter

<a href="https://www.buymeacoffee.com/vaskivskyi" target="_blank"><img src="https://asusrouter.vaskivskyi.com/BuyMeACoffee-badge.png" alt="Buy Me A Coffee" /></a> | [📑 Release note ](https://asusrouter.vaskivskyi.com/log/library.html#_1-6-0-🐣-parental-control-clients-stability) | [📖 Documentation](https://asusrouter.vaskivskyi.com/) | [⭐️ Star AsusRouter](https://github.com/Vaskivskyi/asusrouter) | [⭐️ Home Assistant Integration](https://github.com/Vaskivskyi/ha-asusrouter)

🚀 Features

- Added `AsusSystem.REBUILD_AIMESH` state to start AiMesh optimization
- Added `int_as_bits` and `int_as_capabilities` converters
- Added `AccessPoint` dataclass
- Added support for ports when using modern endpoint for `AsusData.PORTS`:
- Monitor the main (default, no arguments), selected (providing `device = MAC_ADDRESS`) or all (`device = "all"`) AiMesh node(s)
- `PortSpeed` members: `LINK_10` (10 Mb/s), `LINK_5000` (5 Gb/s)
- `USBSpeed` members: `USB_20` (480 Mb/s), `USB_30` (5 Gb/s), `USB_31` (10 Gb/s), `USB_32` (20 Gb/s)
- `PortType` members:
- `MOCA`, `SFPP` (implemented)
- `POWERLINE` (planned)
- `PortCapability` members: `WAN`, `LAN`, `GAME`, `PLC`, `WAN2`, `WAN3`, `SFPP`, `USB`, `MOBILE`, `WANLAN`, `MOCA`, `IPTV_BRIDGE`, `IPTV_VOIP`, `IPTV_STB`, `DUALWAN_SECONDARY`, `DUALWAN_PRIMIRY`
- Added support for ports when using legacy endpoint for `AsusData.PORTS`:
- `PortSpeed` members: `LINK_10` (10 Mb/s), `LINK_5000` (5 Gb/s), `LINK_10000` (10 Gb/s)
- Added parental control rule features:
- Allowed `ParentalControlRule` to be sent as a state to `AsusRouter.async_set_state`
- Added `PCRuleType` enum with members:
- `DISABLE`, `BLOCK`, `TIME` corresponding to the rule types - using any of them as the rule type will add or update the rule
- `REMOVE` - using this as a type will remove the rule for a corresponding MAC address
- Switched to creation of a new session if the old one is not available anymore

🐛 Bug fixes

- Fixed issue on the client status detection when AiMesh is supported but no nodes assigned

🔨 Other changes

- Moved aand refactored all the parental control rules processing to be in `asusrouter.modules.parental_control` module

📚 Documentation

- Confirmed support for the new device
- `GT-AX11000 Pro` / `388.24198`
- `RT-AX88U Pro` / `388.4_0` (Merlin)
- `Zen WiFi ET8` / `388.23759`
- `Zen WiFi Pro ET12` / `388.23013`
- Confirmed support for the new FW versions which were not reported before:
- `4G-AX55U` / `380.8102`
- `GT-AX11000` / `388.4_0` (Merlin)
- `RT-AC88U` / `386.12_2`
- `RT-AX55` / `386.52041`
- `RT-AX56U` / `388.1_0` (Merlin), `388.2_2` (Merlin)
- `RT-AX58U` / `388.4_0` (Merlin)
- `RT-AX86U` / `388.4_0` (Merlin)
- `TUF-AX5400` / `388.23285`, `388.4_0` (Merlin)

<a href="https://www.buymeacoffee.com/vaskivskyi" target="_blank"><img src="https://asusrouter.vaskivskyi.com/BuyMeACoffee-badge.png" alt="Buy Me A Coffee" /></a> | [📑 Release note ](https://asusrouter.vaskivskyi.com/log/library.html#_1-5-0-💻-clients-tracking-multiple-instances-improvements) | [📖 Documentation](https://asusrouter.vaskivskyi.com/) | [⭐️ Star AsusRouter](https://github.com/Vaskivskyi/asusrouter) | [⭐️ Home Assistant Integration](https://github.com/Vaskivskyi/ha-asusrouter)

🚀 Features

- Improved client status detection

🐛 Bug fixes

- Fixed issue with data mix in cache when multiple instances are used

<a href="https://www.buymeacoffee.com/vaskivskyi" target="_blank"><img src="https://asusrouter.vaskivskyi.com/BuyMeACoffee-badge.png" alt="Buy Me A Coffee" /></a> | [📑 Release note ](https://asusrouter.vaskivskyi.com/log/library.html#_1-4-0-🚨-tests-and-updates-to-workflows) | [📖 Documentation](https://asusrouter.vaskivskyi.com/) | [⭐️ Star AsusRouter](https://github.com/Vaskivskyi/asusrouter) | [⭐️ Home Assistant Integration](https://github.com/Vaskivskyi/ha-asusrouter)

🚀 Features

- Added WLAN rename (`5ghz2 -> 6ghz`) for `RT-AXE95Q` (`ZenWiFi ET8`)

🚨 Testing

- Added tests for:
- `asusrouter.modules.endpoint.onboarding`

🐣 GitHub

- Updated code coverage CI workflow
- Bumped `actions/setup-python` to `5.0.0`
- Bumped `actions/download-artifact` to `4.0.0`, `4.1.0`
- Bumped `actions/upload-artifact` to `4.0.0`

<a href="https://www.buymeacoffee.com/vaskivskyi" target="_blank"><img src="https://asusrouter.vaskivskyi.com/BuyMeACoffee-badge.png" alt="Buy Me A Coffee" /></a> | [📑 Release note 1.3.0](https://asusrouter.vaskivskyi.com/log/library.html#) | [📖 Documentation](https://asusrouter.vaskivskyi.com/) | [⭐️ Star AsusRouter](https://github.com/Vaskivskyi/asusrouter) | [⭐️ Home Assistant Integration](https://github.com/Vaskivskyi/ha-asusrouter)

🚀 Features

- Added `get_arguments` converter
- Added support for `l2pt`, `pptp` and `surfshark` VPNs as part of `vpnc` module
- Added WLAN rename when indeces are not in the expected order (e.g. `6ghz` is present, but not `5ghz2`)
- Added `AsusBlockAll` state for the general internet access block

🐛 Bug fixes

- Switched to keyword arguments in `AsusRouter.keep_state` call

🚨 Testing

- Added tests for:
- `asusrouter.modules.client`
- `asusrouter.modules.led`
- `asusrouter.modules.openvpn`
- `asusrouter.modules.parental_control`
- `asusrouter.modules.port_forwarding`
- `asusrouter.modules.state`
- `asusrouter.modules.system`
- `asusrouter.modules.vpnc`
- `asusrouter.modules.wireguard`
- `asusrouter.modules.wlan`

🔨 Other changes

- Refactored:
- All the modules listed above in the testing section
- `AsusRouter.async_set_state` to use `kwargs`

📚 Documentation

- Added [Python Library section](https://asusrouter.vaskivskyi.com/library/) with a short manual on how to use the library

[📑 Release note 1.2.0](https://asusrouter.vaskivskyi.com/log/library.html#_1-2-0-💻-force-clients-update-services-more) | [☕️ Support the development](https://www.buymeacoffee.com/vaskivskyi) | [📖 Documentation](https://asusrouter.vaskivskyi.com/) | [⭐️ Star AsusRouter](https://github.com/Vaskivskyi/asusrouter) | [⭐️ Home Assistant Integration](https://github.com/Vaskivskyi/ha-asusrouter)

🚀 Features

- Added `AsusSystem.UPDATE_CLIENTS` state and compatible service
- Added `force_clients` possibility on each `AsusData.CLIENTS` queue
- Added runtime-available `set_force_clients()` method for setting both state and wait time of the feature
- Added new `AsusSystem` states: `RESTART_CHPASS`, `RESTART_DNSMASQ`, `RESTART_LEDS`, `RESTART_OPENVPND`, `RESTART_SAMBA`, `RESTART_TIME`, `RESTART_USB_IDLE`, `RESTART_VPNC`, `RESTART_WGS`, `STOP_OPENVPND`, `STOP_VPNC`
- Added new `.tools.converters`: `safe_timestamp_to_utc`, `safe_utc_to_timestamp`, `safe_utc_to_timestamp_milli`
- Added `AsusData.SPEEDTEST` and `AsusData.SPEEDTEST_RESULT`

🚨 Testing

- Added tests for `asusrouter.modules.service`

🔨 Other changes

- Improved exceptions messages

🐣 GitHub

- Updated CI workflow to be more modular and allow parallel unit- and device-testing
- Added testing with `Python 3.12`

[📑 Release note 1.1.2](https://asusrouter.vaskivskyi.com/log/library.html#_1-1-2-🩹) | [☕️ Support the development](https://www.buymeacoffee.com/vaskivskyi) | [📖 Documentation](https://asusrouter.vaskivskyi.com/) | [⭐️ Star AsusRouter](https://github.com/Vaskivskyi/asusrouter) | [⭐️ Home Assistant Integration](https://github.com/Vaskivskyi/ha-asusrouter)


🐛 Bug fixes

- Fixed reboot flag not being reset
- Fixed connection type code

🚨 Testing

- Added tests for the connection module

📚 Documentation

- Updated supported devices