You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<p>Owntracks can also be used with other device trackers, such as <ahref="/components/device_tracker.nmap_scanner/">Nmap</a> or <ahref="/components/device_tracker.netgear/">Netgear</a>. To do this, fill in the <codeclass="highlighter-rouge">mac</code> field to the Owntracks entry in <codeclass="highlighter-rouge">known_devices.yaml</code> with the MAC address of the device you want to track. This way the state of the device will be determined by the source that reported last. The naming convention for known device list is <codeclass="highlighter-rouge"><username>_<device-id></code> and could be set in app configuration. More details about this config can found in <ahref="/components/device_tracker/">device tracker</a>.</p>
127
127
128
128
<h3><aclass="title-link" name="using-owntracks-regions" href="#using-owntracks-regions"></a> Using Owntracks regions</h3>
129
-
<p>Owntracks can track regions, and send region entry and exit information to Home Assistant(HA). You set up a region in the Owntracks app which you should name the same as your HA Zone, and then make sure to turn on the <codeclass="highlighter-rouge">share</code> option for the region in the owntracks app. Please see the <ahref="http://owntracks.org/booklet/guide/waypoints/">owntracks documentation</a></p>
129
+
<p>Owntracks can track regions, and send region entry and exit information to Home Assistant(HA). You set up a region in the Owntracks app which you should name the same as your HA Zone, and then make sure to turn on the <codeclass="highlighter-rouge">share</code> option for the region in the owntracks app. Please see the <ahref="http://owntracks.org/booklet/guide/waypoints/">owntracks documentation</a>.</p>
130
130
131
131
<p>Home Assistant will use the enter and leave messages to set your zone location. Your location will be set to the center of zone when you enter. Location updates from OwnTracks will be ignored while you are inside a zone.</p>
132
132
133
133
<p>When you exit a zone, Home Assistant will start using location updates to track you again. To make sure that Home Assistant correctly exits a zone (which it calculates based on your GPS co-ordinates), you may want to set your Zone radius in HA to be slightly smaller that the Owntracks region radius.</p>
134
134
135
135
<h3><aclass="title-link" name="using-owntracks-regions---forcing-owntracks-to-update-using" href="#using-owntracks-regions---forcing-owntracks-to-update-using"></a> Using Owntracks regions - forcing Owntracks to update using iBeacons</h3>
136
-
<p>When run in the usual <codeclass="highlighter-rouge">significant changes mode</code> (which is kind to your phone battery), Owntracks sometimes doesn’t update your location as quickly as you’d like when you arrive at a zone. This can be annoying if you want to trigger an automation when you get home. You can improve the situation using iBeacons.</p>
136
+
<p>When run in the usual <em>significant changes mode</em> (which is kind to your phone battery), Owntracks sometimes doesn’t update your location as quickly as you’d like when you arrive at a zone. This can be annoying if you want to trigger an automation when you get home. You can improve the situation using iBeacons.</p>
137
137
138
-
<p>iBeacons are simple bluetooth devices that send out an “I’m here” message. They are supported by IOS and some Android devices. Owntracks explain more <ahref="http://owntracks.org/booklet/guide/beacons/">here</a></p>
138
+
<p>iBeacons are simple bluetooth devices that send out an “I’m here” message. They are supported by IOS and some Android devices. Owntracks explain more <ahref="http://owntracks.org/booklet/guide/beacons/">here</a>.</p>
139
139
140
140
<p>When you enter an iBeacon region, Owntracks will send a <codeclass="highlighter-rouge">region enter</code> message to HA as described above. So if you want to have an event triggered when you arrive home, you can put an iBeacon outside your front door. If you set up an OwnTracks iBeacon region called <codeclass="highlighter-rouge">home</code> then getting close to the beacon will trigger an update to HA that will set your zone to be <codeclass="highlighter-rouge">home</code>.</p>
<p>To use mobile iBeacons with HA, you just set up a region that doesn’t match your Zone names. If HA sees an entry event for a iBeacon region that doesn’t match a Zone name (say <codeclass="highlighter-rouge">keys</code>) - it will start tracking it, calling the device <codeclass="highlighter-rouge">device_tracker.beacon_keys</code>).</p>
152
152
153
-
<p>This allows you to write zone automations for devices that can’t track themselves (for example <codeclass="highlighter-rouge">alert me if I leave the house and my keys are still at home</code>). Another example would be <codeclass="highlighter-rouge">open the gates if my car arrives home</code>.</p>
153
+
<p>This allows you to write zone automations for devices that can’t track themselves (for example <em>alert me if I leave the house and my keys are still at home</em>). Another example would be <em>open the gates if my car arrives home</em>.</p>
154
154
155
155
<h3><aclass="title-link" name="using-mobile-and-fixed-ibeacons-together" href="#using-mobile-and-fixed-ibeacons-together"></a> Using mobile and fixed iBeacons together</h3>
156
156
<p>You can use iBeacons of both types together, so if you have a Zone <codeclass="highlighter-rouge">drive</code> with an iBeacon region called <codeclass="highlighter-rouge">-drive</code> and you arrive home with a mobile iBeacon called <codeclass="highlighter-rouge">-car</code>, then <codeclass="highlighter-rouge">device_tracker.beacon_car</code> will be set to a state of <codeclass="highlighter-rouge">drive</code>.</p>
157
157
158
158
<h3><aclass="title-link" name="importing-owntracks-waypoints-as-zones" href="#importing-owntracks-waypoints-as-zones"></a> Importing Owntracks waypoints as zones</h3>
159
-
<p>By default, any Owntracks user connected to Home Assistant can export their waypoint definitions (from the <codeclass="highlighter-rouge">Export - Export to Endpoint</code> menu item) which will then be translated to zone definitions in Home Assistant. The zones will be named <codeclass="highlighter-rouge"><user>-<device> - <waypoint name></code>. This functionality can be controlled in 2 ways:</p>
159
+
<p>By default, any Owntracks user connected to Home Assistant can export their waypoint definitions (from the <em>Export - Export to Endpoint</em> menu item) which will then be translated to zone definitions in Home Assistant. The zones will be named <codeclass="highlighter-rouge"><user>-<device> - <waypoint name></code>. This functionality can be controlled in 2 ways:</p>
160
160
161
161
<ol>
162
162
<li>The configuration variable <codeclass="highlighter-rouge">waypoints</code> can be set to <codeclass="highlighter-rouge">False</code> which will disable importing waypoints for all users.</li>
0 commit comments