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-20 07:46:52 +00:00
Code Issues Packages Projects Releases Wiki Activity

Improve change from #3233 and update JSON output

Browse Source
This commit is contained in:
Fabian Affolter 2017-08-24 14:56:16 +02:00
parent 28d72cee6d
commit 295688b6ff
No known key found for this signature in database
GPG Key ID: DDF3D6F44AAB1336
1 changed files with 15 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -14,8 +14,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. 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. 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.
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: To use the Tado platform in your installation, add the following to your `configuration.yaml` file:
@ -37,15 +36,25 @@ Configuration variables:
After configuration, your device has to be at home at least once before showing up as *home* or *away*. 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. 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. Beware that the tado (v2) API does not provide GPS location of devices, only a bearing, therefore home assistant only uses home/not-home status. See the [device tracker component page](/components/device_tracker/) for instructions how to configure the people to be tracked. Beware that the Tado (v2) API does not provide GPS location of devices, only a bearing, therefore Home Assistant only uses `home`/`not-home` status.
### {% linkable_title Finding your `home_id` %} ### {% 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: 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 ```json
{"name":"Mark","email":"your@email.tld","username":"your@email.tld", {
"homes":[{"id":12345,"name":"Home Sweet Home"}],"locale":"en_US", "name": "Mark",
"mobileDevices":[]} "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. In this example `12345` is the `home_id` you'll need to configure.