Merge pull request #95 from tomduijf/dev_tracker_snmp

device_tracker: Generic SNMP
This commit is contained in:
Fabian Affolter 2015-10-08 20:16:49 +02:00
commit 99e9a77f60
4 changed files with 44 additions and 1 deletions

View File

@ -9,7 +9,7 @@ sharing: true
footer: true
---
Home Assistant can get information from your wireless router to track which devices are connected. There are three different types of supported wireless routers:
Home Assistant can get information from your wireless router to track which devices are connected. There are several brands of supported wireless routers:
- [Actiontec](/components/device_tracker.actiontec.html)
- [Aruba](/components/device_tracker.aruba.html)
@ -20,6 +20,7 @@ Home Assistant can get information from your wireless router to track which devi
- [Thomson](/components/device_tracker.thomson.html)
- [tomato](/components/device_tracker.tomato.html)
- [TP-Link](/components/device_tracker.tplink.html)
- [Generic SNMP](/components/device_tracker.snmp.html)
Alternative trackers:

View File

@ -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.

View File

@ -216,6 +216,11 @@ Entities are things that you want to observe within Home Assistant. Support for
<td><a href='/components/device_tracker.nmap_scanner.html'>NMap network scanning</a></td>
</tr>
<tr>
<td><a href='/components/device_tracker.snmp.html'><img src='/images/supported_brands/network-snmp.png' class='brand overview' /></a></td>
<td><a href='/components/device_tracker.snmp.html'>Generic SNMP</a></td>
</tr>
</table>
</div>

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.1 KiB