jeena/home-assistant.github.io
1
0
Fork 0
Code Issues Pull requests Projects Packages Wiki Activity Actions

Site updated at 2016-10-22 22:37:41 UTC

Browse source
This commit is contained in:
Travis CI 2016-10-22 22:37:41 +00:00
parent ab857e95a7
commit 860912100c
408 changed files with 11332 additions and 1691 deletions
Download patch file Download diff file Expand all files Collapse all files

23
components/device_tracker.snmp/index.html
View file

@ -107,9 +107,9 @@ This device tracker needs SNMP to be enabled on the router.
<li>TPLink: <code class="highlighter-rouge">1.3.6.1.2.1.3.1.1.2.19.1</code> (Archer VR2600v, need to enable SNMP service)</li>
</ul>
<p>To use the SNMP platform in your installation, add the following to your <code class="highlighter-rouge">configuration.yaml</code> file:</p>
<p>To use the SNMP version 1 platform in your installation, add the following to your <code class="highlighter-rouge">configuration.yaml</code> file:</p>
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="c1"># Example configuration.yaml entry</span>
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="c1"># Example configuration.yaml entry for SNMP version 1</span>
<span class="s">device_tracker</span><span class="pi">:</span>
<span class="pi">-</span> <span class="s">platform</span><span class="pi">:</span> <span class="s">snmp</span>
<span class="s">host</span><span class="pi">:</span> <span class="s">192.168.1.1</span>
@ -117,12 +117,28 @@ This device tracker needs SNMP to be enabled on the router.
<span class="s">baseoid</span><span class="pi">:</span> <span class="s">1.3.6.1.4.1.14988.1.1.1.2.1.1</span>
</code></pre>
</div>
<p>If you want to use encryption, you must enable SNMP version 3 by adding <code class="highlighter-rouge">authkey</code> and <code class="highlighter-rouge">privkey</code> variables and enabling SNMP version 3 on your router. Currently only SHA1 is supported for authentication and AES for encryption. Example of SNMPv3 configuration:</p>
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="c1"># Example configuration.yaml entry for SNMP version 3</span>
<span class="s">device_tracker</span><span class="pi">:</span>
<span class="pi">-</span> <span class="s">platform</span><span class="pi">:</span> <span class="s">snmp</span>
<span class="s">host</span><span class="pi">:</span> <span class="s">192.168.1.1</span>
<span class="s">community</span><span class="pi">:</span> <span class="s">username</span>
<span class="s">authkey</span><span class="pi">:</span> <span class="s">authpass</span>
<span class="s">privkey</span><span class="pi">:</span> <span class="s">privpass</span>
<span class="s">baseoid</span><span class="pi">:</span> <span class="s">1.3.6.1.4.1.14988.1.1.1.2.1.1</span>
</code></pre>
</div>
<p>Configuration variables:</p>
<ul>
<li><strong>host</strong> (<em>Required</em>): The IP address of the router, eg. 192.168.1.1.</li>
<li><strong>community</strong> (<em>Required</em>): The SNMP community which is set for the device. Most devices have a default community set to to <code class="highlighter-rouge">public</code> with read-only permission (which is sufficient).</li>
<li><strong>baseoid</strong> (<em>Required</em>): 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.</li>
<li><strong>authkey</strong> (<em>Inclusive</em>): Authentication key for SNMPv3. Variable privkey must also be set.</li>
<li><strong>privkey</strong> (<em>Inclusive</em>): Privacy key SNMPv3. Variable authkey must also be set.</li>
</ul>
<p>See the <a href="/components/device_tracker/">device tracker component page</a> for instructions how to configure the people to be tracked.</p>
@ -176,6 +192,9 @@ This device tracker needs SNMP to be enabled on the router.
<li>
<a href='/components/device_tracker.bt_home_hub_5/'>BT Home Hub 5</a>
</li>
<li>
<a href='/components/device_tracker.bbox/'>Bbox</a>
</li>
<li>
<a href='/components/device_tracker.bluetooth_le_tracker/'>Bluetooth LE Tracker</a>
</li>