home-assistant.io/source/components/device_tracker.snmp.markdown

layout, title, description, date, sidebar, comments, sharing, footer

layout	title	description	date	sidebar	comments	sharing	footer
page	Generic SNMP support	Instructions how to integrate SNMP into Home Assistant.	2015-10-08 12:00	false	false	true	true

Most wifi-accesspoints (WAP) and wifi-routers (WRT) support the Simple Network Management Protocol (SNMP). This is a standardized method for monitoring/manageing network connected devices. SNMP uses a tree-like hierarchy where each node is an object. Many of these objects contain (live) lists of insances and metrics, like network interfaces, disks, and wifi registrations.

This component uses python-pysnmp.

# Example configuration.yaml entry
device_tracker:
  platform: snmp
  hosts: 192.168.1.1
  community: public
  baseoid: 1.3.6.1.4.1.14988.1.1.1.2.1.1

community is the SNMP community which is configured in the WAP/WRT. Most devices have a default community set to to public with read-only permission (which is sufficient). This parameter is mandatory

baseoid is the OID prefix where wireless client registrations can be found, usually vendor specific. It's advised to use the numerical notation. To find this base OID, check vendor documentation or check the MIB file for your device.

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