AsusRouter

Integration change log

0.25.0b1 🐛 Fixes

2023-12-03

→ 🐙 GitHub release ←open in new window

🐛 Bug fixes

📦 Dependencies

0.25.0b0 💻 Force clients update

2023-11-23

→ 🐙 GitHub release ←open in new window

🚀 Features

  • Added force_clients possibility, which sends a separate request to update the client list
  • Added force_clients (boolean) and force_clients_waittime (float, in seconds) settings to the config flow

🔨 Other changes

  • Improved exceptions messages

📦 Dependencies

0.24.2 🩹

2023-11-21

→ 🐙 GitHub release ←open in new window

🐛 Bug fixes

📦 Dependencies

0.24.1 🩹

2023-11-20

→ 🐙 GitHub release ←open in new window

🐛 Bug fixes

📦 Dependencies

0.24.0 🌍 VPNs, WANs and stability

2023-11-19

→ 🐙 GitHub release ←open in new window

💥 Breaking

  • Implemented changes in wan binary sensor. Refer to the Features section for details

🚀 Features

  • Added support for VPN Fusion (VPN clients, stock FW 388+)
  • Added support for WireGuard (clients + server) (stock and Merlin FW 388+) (report #594open in new window)
  • Added support for OpenVPN (clients + servers) (stock FW 388+) (report #470open in new window)
  • Added support for secondary WAN and changed WAN sensors (report #603open in new window)
    • Binary sensor wan (wan_secondary)
    • Sensors wan_ip and wan_ip_extra (wan_ip_secondary and wan_ip_secondary_extra)
  • Added internet binary sensor to show the general state of the device internet connection (and IP address as an attribute of the sensor)
  • Added dualwan binary sensor
  • Added wan_aggregation binary sensor

🐛 Bug fixes

  • Fixed error in historic data calculation
  • Other minor fixes in data processing
  • Fixed issue with blocked possibility to reload integration
  • Fixed diagnostics module
  • Fixed missing arguments on state setting (report #710open in new window)
  • Fixed network sensors interval
  • Fixed missing values for OpenVPN client
  • Fixed missing temperature sensors
  • Fixed unsafe dictionary operation

📦 Dependencies

0.24.0b3

2023-11-17

Release notes

→ 🐙 GitHub release ←open in new window

🐛 Bug fixes

📦 Dependencies

0.24.0b2

2023-11-16

Release notes

→ 🐙 GitHub release ←open in new window

🚀 Features

  • Added integration reload on sensors interval change

🐛 Bug fixes

  • Fixed network sensors interval

0.24.0b1

2023-11-13

Release notes

→ 🐙 GitHub release ←open in new window

🐛 Bug fixes

  • Fixed missing values for OpenVPN client
  • Fixed missing temperature sensors
  • Fixed unsafe dictionary operation

📦 Dependencies

0.24.0b0

2023-11-12

Release notes

→ 🐙 GitHub release ←open in new window

💥 Breaking

  • Implemented changes in wan binary sensor. Refer to the Features section for details

🚀 Features

  • Added support for VPN Fusion (VPN clients, stock FW 388+)
  • Added support for WireGuard (clients + server) (stock and Merlin FW 388+) (report #594open in new window)
  • Added support for OpenVPN (clients + servers) (stock FW 388+) (report #470open in new window)
  • Added support for secondary WAN and changed WAN sensors (report #603open in new window)
    • Binary sensor wan (wan_secondary)
    • Sensors wan_ip and wan_ip_extra (wan_ip_secondary and wan_ip_secondary_extra)
  • Added internet binary sensor to show the general state of the device internet connection (and IP address as an attribute of the sensor)
  • Added dualwan binary sensor
  • Added wan_aggregation binary sensor

🐛 Bug fixes

  • Fixed issue with blocked possibility to reload integration
  • Fixed diagnostics module

📦 Dependencies

0.23.7 🩹 Error loop fix

2023-11-09

→ 🐙 GitHub release ←open in new window

🚀 Features

  • Switched to receive a new client session for connection

0.23.6 🕐 Error loop fix

2023-11-05

→ 🐙 GitHub release ←open in new window

🐛 Bug fixes

📦 Dependencies

0.23.5 🐛 Error handling

2023-11-05

→ 🐙 GitHub release ←open in new window

🐛 Bug fixes

  • Fixed error handling on integration startup

0.23.4 🐛 More legacy bugfixes

2023-11-04

→ 🐙 GitHub release ←open in new window

🐛 Bug fixes

  • Fixed bug with 5 GHz clients for older devices

📦 Dependencies

0.23.3 🐛 380 - 384 bugfixes

2023-11-04

→ 🐙 GitHub release ←open in new window

🐛 Bug fixes

📦 Dependencies

0.23.2 🚀 Better features for older devices

2023-11-03

→ 🐙 GitHub release ←open in new window

🐛 Bug fixes

📦 Dependencies

0.23.1 🐛 Bugfix / FW 380

2023-11-02

→ 🐙 GitHub release ←open in new window

🐛 Bug fixes

📦 Dependencies

0.23.0 🔨 New backend

2023-11-01

→ 🐙 GitHub release ←open in new window

This release brings a fully-rebuild core of the library, making it faster and simpler.

🔒 Requirements

  • Minimum HA version set to 2023.10.0

💥 Breaking

  • Python 3.11+ is now required
  • Temp: Removed HA services
  • For pairs of binary_sensor/switch entities, removed binary_sensor
  • Removed option device_control in the configuration flow
  • With HA unit conversion supports, the native value for speed and traffic sensors changed, which creates a breaking change for HA history
  • Removed bytes / bits attributes of traffic / speed sensors

🚀 Features

  • Added support for HA EntityCategory
  • Added support for HA unit conversion (traffic and speed sensors)
  • Added error codes 9, 10 and 11 reported by device (another, captcha, reset required)
  • Added proper timeout when login blocked
  • Added USB WAN data recovery when interface is off
  • Added debug logging for SSDP discovery and fired events
  • Implemented 0 values for the network speed sensors on integration load. This will prevent unknown values on startup or reboot, when the actual speed cannot yet be calculated
  • Improved FW processing for different generations
  • Improved clients monitoring
  • Improved latest_connected sensor
  • Removed orphaned attributes for disconnected clients

🐛 Bug fixes

📖 Translations

📦 Dependencies

📚 Documentation

  • Confirmed support for device / firmware:
    • DSL-AC68U / 386.50117
    • RT-AC66U B1 / 386.51255
    • RT-AC86U / 386.49709
    • RT-AC88U / 386.48260, 386.5_0
    • RT-AX58U / 388.22237
    • RT-AX86U Pro / 388.23565
    • RT-AX88U / 388.24198, 388.2_0, 388.4_0
    • RT-AXE7800 / 388_22068
    • TUF-AX5400 / 388.22525
    • TUF-AX6000 / 388.32432
    • TUF-AX3000 V2 / 388.23785
    • ZenWiFi AX (XT8) / 388.23285
    • ZenWiFi XT9 / 388_23285

0.23.0b4 🔨

2023-10-31 / beta

Release notes

→ 🐙 GitHub change log ←open in new window

🚀 Features

  • Implemented 0 values for the network speed sensors on integration load. This will prevent unknown values on startup or reboot, when the actual speed cannot yet be calculated
  • Add Unicode error handling

🐛 Bug fixes

  • Removed orphaned attributes from device trackers when clients are disconnected
  • Fixed latest_connected sensor
  • Fixed bug when no parental control or port forwarding rules are set (report #651open in new window)
  • Fixed missing USB WAN sensors when interface is not connected

📦 Dependencies

0.23.0b3 🔨

2023-10-30 / beta

Release notes

→ 🐙 GitHub change log ←open in new window

🐛 Bug fixes

  • Added handling of Unicode errors in JSON

📦 Dependencies

0.23.0b2 🔨

2023-10-30 / beta

Release notes

→ 🐙 GitHub change log ←open in new window

🐛 Bug fixes

  • Fixed blocking issue when JSON cannot be parsed

🚀 Features

  • Added logging on JSON parsing errors

📦 Dependencies

0.23.0b1 🔨

2023-10-29 / beta

Release notes

→ 🐙 GitHub change log ←open in new window

🐛 Bug fixes

📚 Documentation

  • Added TUF-AX3000 V2 to the supported

0.23.0b0 🔨

2023-10-29 / beta

Release notes

→ 🐙 GitHub change log ←open in new window

💣 Known issues

  • Issue with temperature sensors (WLAN sensors not available)
  • Issue with load_avg sensors
  • Does not load on stock FW due to a bug with load_avg sensors

🔒 Requirements

  • Minimum HA version set to 2023.10.0

🚀 Features

  • Rebuilt backend
  • Improved device tracking
  • Added support for more error codes reported by the device (another, captcha, reset required)
  • Improved firmware processing for different generations
  • Added support for HA EntityCategory
  • Added support for HA unit conversion (traffic and speed sensors)

🐛 Bug fixes

💥 Breaking

  • Temp: Removed HA services
  • For pairs of binary_sensor/switch entities, removed binary_sensor
  • Removed option device_control in the configuration flow
  • With HA unit conversion supports, the native value for speed and traffic sensors changed, which creates a breaking change for HA history
  • Removed bytes / bits attributes of traffic / speed sensors

📖 Translations

📚 Documentation

  • Updated device list
  • Changed release log layout on the documentation webpage

📦 Dependencies

0.22.0 💻 On the way to a better configuration

2023-03-05

→ 🐙 GitHub change log ←open in new window

🚀 Features

  • Improved SSDP discovery:
    • Ignore devices with no serial number available
    • Discovery is now based on FW instead of the manufacturer (only discover AsusWRT-powered devices)
  • Improved configuration and options flow:
    • Block multiple setups for a single serial number
    • Configurable options are now sorted into a menu
    • Allow to set up integration with no options (integration can now be setup in 3 short steps)
    • Sorted options to be better grouped
    • When credentials are not changed, the check will be now skipped (to minimize the number of connections)

🐛 Bug fixes

📖 Translations

📚 Documentation

  • Updated supported devices

🔨 Other changes

  • Removed lan_speed and wan_speed sensors deprecated in 0.20.0. Please, use the new sensors port_status_lan and port_status_wan (more details)
  • Removed domain name from the entities’ unique ids

0.21.1 🚀 Support for HA 2023.3.x

2023-02-24

→ 🐙 GitHub change log ←open in new window

🚀 Features

  • Added support for HA 2023.3.x

📦 Dependencies

0.21.0 🔑 Network discovery

2023-02-22

→ 🐙 GitHub change log ←open in new window

🚀 Features

  • Added network discovery
  • Added detailed title for network discovery

🐛 Bug fixes

💥 Breaking

  • This release is removing direct migration from versions before 0.17.0. If you are still on an older version, please firstly update to any between 0.17.0 and 0.20.0 and only after that update to 0.21.0. The migration guidline for different versions is updated in the documentation

📚 Documentation

  • Updated supported devices

📦 Dependencies

🔨 Other changes

  • Removed name step from the configuration flow

0.20.0 🌵 Port Status

2023-02-12

→ 🐙 GitHub change log ←open in new window

⚠️ Deprecation warning

  • Sensors lan_speed and wan_speed are deprecated. They will be removed in version 0.22.0. Please, use the new sensors port_status_lan and port_status_wan

🚀 Features

  • Added new Port status sensors (LAN - port_status_lan, USB - port_status_usb, WAN - port_status_wan), reporting more information on the physical ports connections. The feature is fully supported by FW version 388.x. With older versions, new sensors might reflect fewer data (mimicking deprecated lan_speed and wan_speed sensors with the new format). More details on the new features

🐛 Bug fixes

  • Fixed bug in the backend library causing errors when device API stops reporting some information (report #C471open in new window)

📚 Documentation

  • Updated supported devices

📦 Dependencies

🔨 Other changes

  • Improved code typing
  • Sorted integration manifest to fulfil the latest HA requirements

0.19.0 🌍 Port forwarding

2023-02-05

→ 🐙 GitHub change log ←open in new window

🔒 Requirements

  • Minimum Home Assistant version bumped to 2023.2.0

🚀 Features

  • Finished code optimization to fulfil most of the HA Core requirements
  • Added Port forwarding features (feature request #136open in new window):
  • Added Media bridge mode (feature request #494open in new window):
    • The mode supports all the features of the Access point, but creates device trackers only for devices connected via wire

📚 Documentation

  • Added new Port forwarding documentation
  • Updated supported devices

📦 Dependencies

🔨 Other changes

  • Refactored all the integration code

0.18.4 🔒 Improvement for HA 2023.2.x

2023-02-03

→ 🐙 GitHub change log ←open in new window

🐛 Bug fixes

  • Fixed warning on HA 2023.2.x

0.18.3 🐛 A bugfix

2023-01-29

→ 🐙 GitHub change log ←open in new window

🐛 Bug fixes

  • Fixed bug in parental control module

📦 Dependencies

0.18.2 🐞 Improvements and fixes

2023-01-28

→ 🐙 GitHub change log ←open in new window

🚀 Features

  • Added fallback API endpoint for connected devices data on x.380.x FW builds
  • Improved data processing for LAN/WAN ports
  • Improved calculation of usage data (CPU, network, RAM and other sensors)
  • Improved device reboot handling

🐛 Bug fixes

  • Fixed LED blinking loop on device reboot
  • Fixed bug with the button module
  • Fixed bug with CPU and network sensors stucking in an unknown state in some cases
  • Fixed bug with partial parental control rules
  • Fixed behaviour on connection errors

📚 Documentation

  • Added links to GitHub release logs for all the documented releases
  • Small cosmetic changes

📦 Dependencies

0.18.1 🛠️ Better FW handling and more

2023-01-22

→ 🐙 GitHub change log ←open in new window

🚀 Features

  • Improved parsing of FW versions

🐛 Bug fixes

  • Fixed bug with VPN switches (report #C414open in new window)
  • Fixed bug with handling errors on API requests for WLAN and GWLAN data

📦 Dependencies

0.18.0 🚀 Better backend

2023-01-21

→ 🐙 GitHub change log ←open in new window

🚀 Features

  • Updated backend asusrouteropen in new window library and communication with Asus API:
    • minimized number of API requests
    • updated obtaining of connected devices data
    • updated LED features
    • updated communication with all the used API endpoints
  • Added secondary WAN info (feature request #464open in new window)
  • Added access point mode of operation (feature request #C397open in new window)
  • Removed deprecated fields and simplified configuration flow

🐛 Bug fixes

  • Fixed bug with beta FW versions (report #467open in new window)
  • Removed restart_firewall button from AiMesh node mode of operation (a node cannot control firewall in any case, so the entity was useless)

📖 Translations

  • Updated French translation (@novisys)

📚 Documentation

  • Updated compatible devices list

📦 Dependencies

0.17.4 🐛 One more

2023-01-09

→ 🐙 GitHub change log ←open in new window

🐛 Bug fixes

  • Fixed bug in the backend library bothering some users with older FW

📦 Dependencies

0.17.3 💣 A new bugfix for older devices

2023-01-09

→ 🐙 GitHub change log ←open in new window

🐛 Bug fixes

  • Fixed issue for the devices with missing label_mac value from NVRAM (some older devices with Merlin builds) preventing AsusRouter from start (report #451open in new window)

📦 Dependencies

0.17.2 🔨 Migration improvement

2023-01-09

→ 🐙 GitHub change log ←open in new window

🐛 Bug fixes

📖 Translations

  • Completed Spanish translation (@edwardtfn)
  • Completed Portuguese (Brazil) translation (@edwardtfn)

🐣 GitHub / HACS

0.17.1 🐛 A bugfix

2023-01-08

→ 🐙 GitHub change log ←open in new window

🐛 Bug fixes

📦 Dependencies

0.17.0 🚀 AiMesh support

2023-01-08

→ 🐙 GitHub change log ←open in new window

🔒 Requirements

  • Minimum Home Assistant version bumped to 2023.1.0

🚀 Features

  • Devices:
    • Added device modes (Router or AiMesh node) which can be selected during initial integration configuration or via Configure option on the Integrations page
    • Devices in Router mode support all the features of AsusRouter
    • Devices in AiMesh node mode support the following feature groups: Main, CPU, LED, Load average, Network, Ports, RAM, Temperature. Other features are disabled as unreliable / duplicating
  • Added AiMesh support (FW: 386.x+ only, details):
    • Wireless backhaul
    • Wired backhaul
    • Node status binary_sensor entities
    • Node devices
    • Node-related events: asusrouter_node_connected, asusrouter_node_disconnected, asusrouter_node_reconnected
    • via_device attribute for the node devices
    • AiMesh data is updated at the same rate as connected devices
  • Added node MAC to the connected device identity
  • Adjusted entities attributes to be sorted alphabetically in the frontend (except for some default attributes of device_tracker entities)
  • Improved generation of unique IDs
  • Network interfaces are renamed to more obvoius names (WLAN0 -> 2.4 GHz, WLAN1 -> 5 GHz and so on). entity_id will stay as they are if already in use. For new users, entity_id will have new naming

🐛 Bug fixes

  • Added new API endpoint to monitor online status - device trackers should become more reliable (FW: 386.x+ only)
  • Fixed naming of temperature sensors after bug in 0.15.0
  • Fixed Platform asusrouter does not generate unique IDs.
  • Fixed problems with unique IDs for multiple devices setup
  • Fixed events options

📖 Translations

  • A new string Device mode was added to the configuration flow (in respect to the new device modes implemented). It still requires the following translations: cs, es, fr, nl, pt-BR, sk. You can translate it on lines 18, 31 and 111 of the corresponding traslation file (marked with [NT] as Not Translated)
  • A string was updated from Device trackers update to Devices / AiMesh update to signify thew same time interval for all the devices. Requires translations: cs, es, fr, nl, pt-BR, sk. Lines 49 and 141
  • New strings added for node events. Missing cs, es, fr, nl, pt-BR, sk. Lines 175:177

📚 Documentation

  • Added scripts for automatic generation of devices and available features
  • Updated compatible devices list
  • Updated feature list to show which of features are available in which device mode

📦 Dependencies

🔨 Other changes

  • Switched to UnitOfDataRate enum (>= 2023.1.0)
  • Switched to UnitOfInformation enum (>= 2023.1.0)

0.16.1 👨‍👧‍👦 Guest WLAN bugfix

2022-12-31

→ 🐙 GitHub change log ←open in new window

🐛 Bug fixes

💥 Breaking

  • macmode attribute of Guest WLAN switches / binary sensors changed to string instead of boolean. More details on the possible values here

📦 Dependencies

🐣 GitHub / HACS

  • Updated the supported device list in GitHub Readme

0.16.0 🎁 Many small improvements

2022-12-25

→ 🐙 GitHub change log ←open in new window

🚀 Features

  • Improved hiding of protected values from the entities attributes
  • Security-protected attributes are hidden from the binary_sensor entities
  • Move all the control/no-control features from the library to the integration
  • The confirmation step is removed from the options flow as obsolete - there is no need anymore to manually reload the integration after changing its settings

🐛 Bug fixes

  • Fixed Device is connected in no-control mode. Sending commands is blocked when in no-control mode, raised by the update entity.
  • Fixed bug with missing timemaps in parental control rules (report #369open in new window)

💥 Breaking

  • Services asusrouter.adjust_wlan and asusrouter.device_internet_access are available only in control mode of the integration - which would be the correct expected behaviour.

📦 Dependencies

🔨 Other changes

  • Simplified obtaining of temperature sensors list from the backend
  • Simplified code for static entities
  • Simplified generation of the static entities
  • Improved constants usage

0.15.1 📖 Dutch translation

2022-12-18

→ 🐙 GitHub change log ←open in new window

📖 Translations

0.15.0 🌡️ More temperatures and fixes

2022-12-18

→ 🐙 GitHub change log ←open in new window

💣 Known issues

  • Updating to this version might disable your current temperature sensors and create the new ones. In this case, please remove the old entities, enable the new ones and assign them entity_id's as before.

🔒 Requirements

  • Minimum Home Assistant version bumped to 2022.11.0

🚀 New features

  • New guest_id integer attribute added to the device identities (and device_tracker entities), which shows the number of guest WLAN (e.g. 1, 2 or 3 when connected or 0 when not connected to a guest network)
  • Added support for the temperature of 5 GHz-2 and 6 GHz wireless modules (device and firmware dependant)

🐛 Bug fixes

💥 Breaking

  • Deprecated in 0.13.0 entity_id, mac and name parameters of asusrouter.device_internet_access service are removed
  • Migration from versions 0.5.1 and lower is removed - consider the new migration FAQ if you need to update from an older version

📚 Documentation

Documentation webpage

  • Search feature is added to the documentation using the Algolia DocSearch platform
  • Change log is added to the documentation
  • Credits are added to the documentation

📦 Dependencies

🐣 GitHub / HACS

  • Update build status badge
  • Update release drafter

🔨 Other changes

  • integration_type property is added to the manifest (>= 2022.11.0)
  • Switched to UnitOfTemperature enum (>= 2022.11.0)
  • Switched to SourceType enum (>= 2022.9.0)
  • Code improvements

0.14.3 📖 More translations

2022-12-14

→ 🐙 GitHub change log ←open in new window

📖 Translations

0.14.2 📖 Two new languages

2022-12-06

→ 🐙 GitHub change log ←open in new window

📖 Translations

0.14.1 📖 Updated translation

2022-12-05

→ 🐙 GitHub change log ←open in new window

📖 Translations

0.14.0 🎄Remove device trackers and more

2022-12-04

→ 🐙 GitHub change log ←open in new window

🚀 New features

  • Added support for the wireless modules temperatures on Merlin 388 builds
  • New remove_trackers service

📦 Dependencies

0.13.1 🐛 Bugfix for HA 2022-12

2022-12-02

→ 🐙 GitHub change log ←open in new window

🐛 Bug fixes

  • Fixed problems with dependencies on HomeAssistant >= 2022.12.0beta1

0.13.0 🔍 Latest connected devices tracking and improved parental control

2022-11-27

→ 🐙 GitHub change log ←open in new window

🚀 New features

  • New entities and devices parameters of the asusrouter.device_internet_access service to allow setting multiple devices state at once
  • New sensor.{device}_latest_connected sensor - details
  • Allowed setting the number of latest connected devices to show
  • New attributes for device identity - conneted - providing a datetime when device has connected

🐛 Bug fixes

  • Fixed wrong wireless entities names
  • Fixed bug with parental control rules, when no rules were set yet

💥 Deprecation warning

  • entity_id, mac and name parameters of the asusrouter.device_internet_access service are now deprecated and will be removed in version 0.15.0.

📖 Translations

  • Added a missing translations string

📦 Dependencies

🔨 Other changes

  • Code cleanup
  • Better constants usage
AsusRouter integration, library and webpage are maintained by @Vaskivskyi

-= Support development =-