Skip to content

Commit 238a7f8

Browse files
DubhAdfrenck
DubhAd
authored and
frenck
committed
Rewording, adding links (home-assistant#5001)
* Rewording, adding links The current doc is written as if the listed options are the only options, no Bluetooth, iOS app, etc. It also pushes people quite hard at OwnTracks over MQTT. While this won't solve the iOS app problem (it's not a component for some reason), it should hopefully help people realise that OwnTracks isn't the only option ;) * ✏️ Tweaks
1 parent 92be517 commit 238a7f8

File tree

1 file changed

+17
-8
lines changed

1 file changed

+17
-8
lines changed

‎source/getting-started/presence-detection.markdown

Lines changed: 17 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -25,31 +25,40 @@ Screenshot of Home Assistant showing a school, work and home zone and two people
2525

2626
### {% linkable_title Setting it up %}
2727

28-
The device tracker component offers presence detection for Home Assistant. It supports two different methods for presence detection: scan for connected devices on the local network and connect to third party service.
28+
The device tracker component offers presence detection for Home Assistant. It supports three different methods for presence detection: scan for connected devices on the local network, scan for Bluetooth devices within range, and connect to third-party service.
2929

30-
Scanning for connected devices is easy to setup. See the instructions for our [supported routers][routers] or [scan the network using nmap][nmap]. This approach does have its limitations, however: it will only be able to detect if a device is at home, and iPhones may show as not home inaccurately (as iPhones disconnect from WiFi if idle).
30+
Scanning for connected devices is easy to setup; options include [supported routers][routers] and [scanning the network using nmap][nmap]. This approach does have its limitations, however: it will only be able to detect if a device is at home, and modern smartphones may show as not home inaccurately (as they disconnect from WiFi if idle).
3131

32-
Home Assistant currently supports multiple third-party services for presence detection: [OwnTracks][ha-owntracks], [GPSLogger][ha-gpslogger] and [Locative][ha-locative]. OwnTracks is an app that you install on your iPhone or Android phone that allows you to push the location of your device to Home Assistant using an MQTT broker. An MQTT broker is an Internet of Things communication platform that you can [freely host yourself][mqtt-self] or get [a private instance for free in the cloud](/components/mqtt/#run-your-own).
32+
You can scan for [Bluetooth][ha-bluetooth] and [Bluetooth LE][ha-bluetooth-le] devices. Unlike with WiFi, modern smartphones don't turn off Bluetooth automatically, though the range is lower.
3333

34-
<p class='note'>
35-
OwnTracks communicates directly with your MQTT broker; no data will pass through their servers.
36-
</p>
34+
Home Assistant currently supports multiple third-party services for presence detection, such as [OwnTracks over MQTT][ha-owntracks-mqtt], [OwnTracks over HTTP][ha-owntracks-http] [GPSLogger][ha-gpslogger] and [Locative][ha-locative].
35+
36+
There are a wide [range of options][ha-presence] available, both for scanning your local network and third-party services.
3737

3838
### {% linkable_title Zones %}
3939

4040
<img src='/images/screenshots/badges-zone.png' style='float: right; margin-left: 8px; height: 100px;'>
4141

42-
Home Assistant will know the location of your device if you are using OwnTracks. By [setting up zones][zone] you will be able to add names to the locations of your devices. This way you can easily spot on the state page where the people in your house are and use it as [triggers][trigger] and [conditions][condition] for automation.
42+
Home Assistant will know the location of your device if you are using a device tracker that reports a GPS location (such as OwnTracks, GPS Logger, the iOS app, and others). By [setting up zones][zone] you will be able to add names to the locations of your devices. This way you can easily spot on the state page where the people in your house are and use it as [triggers][trigger] and [conditions][condition] for automation.
43+
44+
<p class='note'>
45+
If you're looking at the [map view][ha-map] then any devices in your Home zone won't be visible, this is by design.
46+
</p>
4347

4448
[routers]: /components/#presence-detection
4549
[nmap]: /components/device_tracker.nmap_tracker/
46-
[ha-owntracks]: /components/device_tracker.owntracks/
50+
[ha-bluetooth]: /components/device_tracker.bluetooth_tracker/
51+
[ha-bluetooth-le]: /components/device_tracker.bluetooth_le_tracker/
52+
[ha-owntracks-mqtt]: /components/device_tracker.owntracks/
53+
[ha-owntracks-http]: /components/device_tracker.owntracks_http/
4754
[ha-locative]: /components/device_tracker.locative/
4855
[ha-gpslogger]: /components/device_tracker.gpslogger/
56+
[ha-presence]: /components/#presence-detection
4957
[mqtt-self]: /components/mqtt/#run-your-own
5058
[mqtt-cloud]: /components/mqtt/#cloudmqtt
5159
[zone]: /components/zone/
5260
[trigger]: /getting-started/automation-trigger/#zone-trigger
5361
[condition]: /getting-started/automation-condition/#zone-condition
62+
[ha-map]: /components/map/
5463

5564
### [Next step: Use Home Assistant &raquo;](/getting-started/use/)

0 commit comments

Comments
 (0)