Cisco IOS
This is a presence detection scanner for Cisco IOS
This device tracker needs SSH to be enabled on the router.
Before using this scanner it is recommended that you lower the ARP cache timeout on your router, as Cisco IOS normally comes with a 4 hour default ARP cache timeout.
For example, the following commands will lower the timeout to 2 minutes on Vlan1:
# 1. use this command to see what Vlan your devices are on
show ip arp
# 2. Go into configure mode
conf t
# 3. Use the Vlan name as you see it from step 1 above
interface Vlan1
# 4. Set a new arp cache timeout
arp timeout 120
# 5. Exit
# Press <ctrl+c> to exit configure mode
# 6. Don't forget to save the new config, so that it will survive a reboot
copy running-config startup-config
If you have a very large number of devices on your VLan (+1000), then you may want to adjust the ARP cache timeout to suit your needs. See this discussion
To use this device tracker in your installation, add the following to your configuration.yaml
The configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file.
After changing the configuration.yaml
The configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file, restart Home Assistant to apply the changes. The integration is now shown on the integrations page under Settings > Devices & services. Its entities are listed on the integration card itself and on the Entities tab.
# Example configuration.yaml entry
device_tracker:
- platform: cisco_ios
host: ROUTER_IP_ADDRESS
username: YOUR_ADMIN_USERNAME
password: YOUR_ADMIN_PASSWORD
See the device tracker integration page for instructions how to configure the people to be tracked.