device_tracker: Generic SNMP

source/components/device_tracker.snmp.markdown

@@ -0,0 +1,37 @@
+---
+layout: page
+title: "Generic SNMP support"
+description: "Instructions how to integrate SNMP into Home Assistant."
+date: 2015-10-08 12:00
+sidebar: false
+comments: false
+sharing: true
+footer: true
+---
+
+<img src='/images/supported_brands/network-snmp.png' class='brand pull-right' />
+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.
+
+```yaml
+# 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](/components/device_tracker.html) for instructions how to
+configure the people to be tracked.