jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-28 19:57:12 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update Tado device tracker documentation to include home_id

Browse Source
This commit is contained in:
Mark Oude Veldhuis 2017-02-08 20:48:36 +01:00
parent 4b6358c12b
commit a0219553b1
No known key found for this signature in database
GPG Key ID: 10B729440FC9990F
1 changed files with 16 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
source/_components/device_tracker.tado.markdown
View File

@ -15,6 +15,7 @@ ha_release: 0.37
The `tado` device tracker is using the [Tado Smart Thermostat](https://www.tado.com/) and it's support for person presence detection based on smartphone location by geofencing.
This tracker uses the Tado API to determine if a mobile device is at home.
It tracks all devices in your home that Tado knows about.
To use the Tado platform in your installation, add the following to your `configuration.yaml` file:
@ -24,14 +25,27 @@ device_tracker:
- platform: tado
username: YOUR_USERNAME
password: YOUR_PASSWORD
home_id: YOUR_HOME_ID
```
Configuration variables:
- **username** (*Required*): The username for your Tado account.
- **password** (*Required*): The password for your Tado account.
- **home_id** (*Required*): The id of your home of which you want to track devices. See below how to find it.
After configuration, your device has to be at home at least once before showing up as 'home' or 'away'.
Polling Tado API for presence information will occure at most once every 30 seconds.
After configuration, your device has to be at home at least once before showing up as *home* or *away*.
Polling Tado API for presence information will happen at most once every 30 seconds.
See the [device tracker component page](/components/device_tracker/) for instructions how to configure the people to be tracked.
### {% linkable_title Finding your `home_id` %}
Find your `home_id` by browsing to `https://my.tado.com/api/v2/me?username=YOUR_USERNAME&password=YOUR_PASSWORD`. There you'll see something like the following:
```json
{"name":"Mark","email":"your@email.tld","username":"your@email.tld",
"homes":[{"id":12345,"name":"Home Sweet Home"}],"locale":"en_US",
"mobileDevices":[]}
```
In this example `12345` is the `home_id` you'll need to configure.