home-assistant.io/source/_components/device_tracker.asuswrt.markdown
2018-10-03 12:42:57 +02:00

2.2 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release
layout title description date sidebar comments sharing footer logo ha_category ha_release
page ASUSWRT Instructions on how to integrate ASUSWRT based routers into Home Assistant. 2015-08-06 19:00 true false true true asus.png Presence Detection pre 0.7

The asuswrt platform offers presence detection by looking at connected devices to a ASUSWRT based router.

This platform is **NOT** available for [Microsoft Windows installations](http://pexpect.readthedocs.io/en/stable/overview.html#pexpect-on-windows).

{% linkable_title Configuration %}

To use an ASUSWRT router in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
device_tracker:
  - platform: asuswrt
    host: YOUR_ROUTER_IP
    username: YOUR_ADMIN_USERNAME

{% configuration %} host: description: "The IP address of your router, eg. 192.168.1.1." required: true type: string username: description: "The username of an user with administrative privileges, usually admin." required: true type: string password: description: "The password for your given admin account (use this if no SSH key is given)." required: false type: string protocol: description: "The protocol (ssh or telnet) to use." required: false type: string default: ssh port: description: SSH port to use. required: false type: integer default: 22 mode: description: "The operating mode of the router (router or ap)." required: false type: string default: router ssh_key: description: The path to your SSH private key file associated with your given admin account (instead of password). required: false type: string require_ip: description: If the router is in access point mode. required: false type: boolean default: true {% endconfiguration %}

You need to [enable telnet](https://www.asus.com/support/faq/1005449/) on your router if you choose to use `protocol: telnet`.

See the device tracker component page for instructions how to configure the people to be tracked.