Skip to content

Commit 6a5d926

Browse files
DubhAdfabaff
authored andcommitted
Adding details of merging trackers (home-assistant#6000)
* Adding details of merging trackers Since the merging of trackers works for more than just OwnTracks (at least GPS Logger, probably more), adding the details here at the top level. * Minor changes
1 parent bfd6b34 commit 6a5d926

File tree

1 file changed

+18
-1
lines changed

1 file changed

+18
-1
lines changed

source/_components/device_tracker.markdown

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,6 @@ device_tracker:
2929
new_device_defaults:
3030
track_new_devices: True
3131
hide_if_away: False
32-
3332
```
3433
3534
The following optional parameters can be used with any platform. However device tracker will only look for global settings under the configuration of the first configured platform:
@@ -89,6 +88,24 @@ devicename:
8988
| `hide_if_away` | False | If `yes`/`on`/`true` then the device will be hidden if it is not at home. |
9089
| `consider_home` | [uses platform setting] | Seconds to wait till marking someone as not home after not being seen. Allows you to override the global `consider_home` setting from the platform configuration on a per device level. |
9190

91+
## {% linkable_title Using GPS device trackers with local network device trackers %}
92+
93+
GPS based device trackers (like [OwnTracks](/components/device_tracker.owntracks/), [GPSLogger](/components/device_tracker.gpslogger) and others) can also be used with local network device trackers, such as [Nmap](/components/device_tracker.nmap_tracker/) or [Netgear](/components/device_tracker.netgear/). To do this, fill in the `mac` field to the entry in `known_devices.yaml` 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 `<username>_<device-id>` and could be set in the app configuration.
94+
95+
An example showing the inclusion of the `mac` field for multiple platform tracking. The `mac` field was added to the GPS based device tracker entry and will enable tracking by all platforms that track via the `mac` address.
96+
97+
```yaml
98+
USERNAME_DEVICE_ID:
99+
name: Friendly Name
100+
mac: EA:AA:55:E7:C6:94
101+
picture: https://www.home-assistant.io/images/favicon-192x192.png
102+
103+
track: yes
104+
hide_if_away: no
105+
```
106+
107+
If you want to track whether either your GPS based tracker or your local network tracker, identify you as being at home, use [a group](/components/group/) instead.
108+
92109
## {% linkable_title Device states %}
93110

94111
The state of your tracked device will be `'home'` if it is in the [home zone](/components/zone#home-zone), detected by your network or Bluetooth based presence detection. If you're using a presence detection method that includes coordinates then when it's in a zone the state will be the name of the zone (in lower case). When a device isn't at home and isn't in any zone, the state will be `'not_home'`.

0 commit comments

Comments
 (0)