2025.3.4
首页 ▸ Integrations ▸

ASUSWRT

The ASUSWRT integration can connect Home Assistant to a ASUS router that runs on ASUSWRT firmware.

There is currently support for the following device types within Home Assistant:

  • Presence Detection - The ASUSWRT platform offers presence detection by looking at connected devices to a ASUSWRT based router.
  • Sensor - The ASUSWRT sensors platform allows you to get information from your ASUS router within Home Assistant.

配置

要将 ASUSWRT hub 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

手动配置步骤

如果上述 My 按钮不起作用，您也可以手动执行以下步骤：

Important

You need to enable telnet on your router if you choose to use protocol: telnet.

Sensors configuration

These sensors are automatically created and associated to the router device:

  • Connected devices sensor
  • Download sensor (unit_of_measurement: Gigabyte - Daily accumulation)
  • Download Speed sensor (unit_of_measurement: Mbit/s)
  • Upload sensor (unit_of_measurement: Gigabyte - Daily accumulation)
  • Upload Speed sensor (unit_of_measurement: Mbit/s)
  • Load average sensors (1min, 5min, 15min)
  • Temperature sensors (2 GHz, 5 GHz, 6 GHz, CPU). Only temperature sensors available on your router will be created.

If the integration is configured to use the http(s) protocol, also the following sensors will be available:

  • CPU usage sensors (percentage for total and single core)
  • Memory usage sensor (percentage)
  • Free memory sensor (Megabyte)
  • Memory used sensor (Megabyte)
  • Last boot sensor (Timestamp)
  • Uptime sensor (HH:MM:SS)

Only Connected devices sensor and Last boot sensor are created in status enabled, all other sensors are created in status disabled. To use them, simply enable on the devices page.

选项

ASUSWRT 的选项可以通过用户界面设置，具体步骤如下：

  • 浏览到您的 Home Assistant 实例。
  • 转到 设置 > 设备与服务。
  • 如果配置了多个 ASUSWRT 实例，请选择您想配置的实例。
  • 选择集成，然后选择 配置。
Consider home

Number of seconds that must elapse before considering a disconnected device not at home.

Track unknown

Enable this option to track also devices that do not have a name. Name will be replaced by mac address.

Interface

The interface that you want statistics from (e.g. eth0,eth1 etc).

Dnsmasq

The location in the router of the dnsmasq.leases file.

Require IP

If devices must have IP (this option is available only for access point mode).

Note

If you don’t want to automatically track new detected device, disable the integration system option Enable new added entities

Padavan custom firmware (The rt-n56u project)

The rt-n56u project does not store dnsmasq.leases which is used to track devices at /var/lib/misc/ as asuswrt do. However this integration can still be used for the rt-n56u project by changing the dnsmasq location using the dnsmasq variable to dnsmasq: '/tmp' Also, to get the statistics for the WAN port, specify interface: 'eth3' as this is the interface used in the rt-n56u project