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

Site updated at 2016-10-08 18:28:01 UTC

Browse source
This commit is contained in:
Travis CI 2016-10-08 18:28:02 +00:00
parent c33649c7ed
commit 85df6d11f5
522 changed files with 7493 additions and 3477 deletions
Download patch file Download diff file Expand all files Collapse all files

28
components/device_tracker.nmap_tracker/index.html
View file

@ -91,29 +91,38 @@
<p>As an alternative to the router-based device tracking, it is possible to directly scan the network for devices by using Nmap. The IP addresses to scan can be specified in any format that Nmap understands, including the network-prefix notation (<code class="highlighter-rouge">192.168.1.1/24</code>) and the range notation (<code class="highlighter-rouge">192.168.1.1-255</code>).</p>
<p>If you’re on Debian or Ubuntu, you might have to install the packages for <code class="highlighter-rouge">arp</code> and <code class="highlighter-rouge">nmap</code>. Do so by running <code class="highlighter-rouge">apt-get install net-tools nmap</code>. On a Fedora host run <code class="highlighter-rouge">sudo dnf -y install nmap</code>.</p>
<p>If you’re on Debian or Ubuntu, you might have to install the packages for <code class="highlighter-rouge">arp</code> and <code class="highlighter-rouge">nmap</code>. Do so by running <code class="highlighter-rouge">$ sudo apt-get install net-tools nmap</code>. On a Fedora host run <code class="highlighter-rouge">$ sudo dnf -y install nmap</code>.</p>
<p>To use this device tracker 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>
<span class="s">device_tracker</span><span class="pi">:</span>
<span class="s">platform</span><span class="pi">:</span> <span class="s">nmap_tracker</span>
<span class="s">hosts</span><span class="pi">:</span> <span class="s">192.168.1.1/24</span>
<span class="s">home_interval</span><span class="pi">:</span> <span class="s">10</span>
<span class="s">exclude</span><span class="pi">:</span>
<span class="pi">-</span> <span class="s">192.168.1.12</span>
<span class="pi">-</span> <span class="s">192.168.1.13</span>
<span class="pi">-</span> <span class="s">platform</span><span class="pi">:</span> <span class="s">nmap_tracker</span>
<span class="s">hosts</span><span class="pi">:</span> <span class="s">192.168.1.1/24</span>
</code></pre>
</div>
<p>Configuration variables:</p>
<ul>
<li><strong>hosts</strong> (<em>Required</em>): The network range to scan in CIDR notation, eg. 192.168.1.1/24</li>
<li><strong>hosts</strong> (<em>Required</em>): The network range to scan in CIDR notation, eg. <code class="highlighter-rouge">192.168.1.1/24</code>.</li>
<li><strong>home_interval</strong> (<em>Optional</em>): The number of minutes nmap will not scan this device, assuming it is home, in order to preserve the device battery.</li>
<li><strong>exclude</strong> (<em>Optional</em>): Hosts not to include in nmap scanning.</li>
</ul>
<p>A full example for the <code class="highlighter-rouge">nmap</code> tracker could look like the following sample:</p>
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="c1"># Example configuration.yaml entry for nmap</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">nmap_tracker</span>
<span class="s">hosts</span><span class="pi">:</span> <span class="s">192.168.1.1/24</span>
<span class="s">home_interval</span><span class="pi">:</span> <span class="s">10</span>
<span class="s">exclude</span><span class="pi">:</span>
<span class="pi">-</span> <span class="s">192.168.1.12</span>
<span class="pi">-</span> <span class="s">192.168.1.13</span>
</code></pre>
</div>
<p>See the <a href="/components/device_tracker/">device tracker component page</a> for instructions how to configure the people to be tracked.</p>
@ -205,6 +214,9 @@
<li>
<a href='/components/device_tracker.unifi/'>Ubiquiti Unifi WAP</a>
</li>
<li>
<a href='/components/device_tracker.volvooncall/'>Volvo On Call</a>
</li>
<li>
<a href='/components/device_tracker.icloud/'>iCloud</a>
</li>