🚜 Merges/Redirect Tado component pages (#8565)

This commit is contained in:
Klaas Schoute 2019-02-14 10:20:44 +01:00 committed by Franck Nijhof
parent 846748cebf
commit 184ed3ef73
4 changed files with 74 additions and 112 deletions

View File

@ -1,21 +0,0 @@
---
layout: page
title: "Tado Thermostat"
description: "Instructions on how to integrate Tado thermostats with Home Assistant."
date: 2017-03-20 12:00
sidebar: true
comments: false
sharing: true
footer: true
logo: tado.png
ha_category: Climate
ha_release: 0.41
ha_iot_class: "Cloud Polling"
---
The `tado` climate platform is interact with your climate devices.
The requirement is that you have set up the [tado](/components/tado/) component.

View File

@ -1,69 +0,0 @@
---
layout: page
title: "Tado Device Tracker"
description: "Instructions on how to integrate Tado device tracker into Home Assistant."
date: 2017-01-17 12:00
sidebar: true
comments: false
sharing: true
footer: true
logo: tado.png
ha_category: Presence Detection
ha_release: 0.37
---
The `tado` device tracker is using the [Tado Smart Thermostat](https://www.tado.com/) and its 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:
```yaml
# Example configuration.yaml entry for Tado
device_tracker:
- platform: tado
username: YOUR_USERNAME
password: YOUR_PASSWORD
home_id: YOUR_HOME_ID
```
{% configuration %}
username:
description: The username for your Tado account.
required: true
type: string
password:
description: The password for your Tado account.
required: true
type: string
home_id:
description: The id of your home of which you want to track devices. If provided, the Tado device tracker will tack *all* devices known to Tado associated with this home. See below how to find it.
required: false
type: integer
{% endconfiguration %}
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. 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` %}
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.

View File

@ -1,20 +0,0 @@
---
layout: page
title: "Tado Sensor"
description: "Instructions on how to integrate Tado thermostats with Home Assistant."
date: 2017-03-20 12:00
sidebar: true
comments: false
sharing: true
footer: true
logo: tado.png
ha_category: Sensor
ha_release: 0.41
ha_iot_class: "Cloud Polling"
---
The `tado` sensor platform allow you to monitor your tado climate devices.
The requirement is that you have set up the [tado](/components/tado/) component.

View File

@ -8,12 +8,26 @@ comments: false
sharing: true
footer: true
logo: tado.png
ha_category: Hub
ha_category:
- Hub
- Climate
- Presence Detection
- Sensor
ha_release: 0.41
ha_iot_class: "Cloud Polling"
redirect_from:
- /components/climate.tado/
- /components/device_tracker.tado/
- /components/sensor.tado/
---
The `tado` component platform is used as an interface to the [my.tado.com](https://my.tado.com/webapp/#/account/sign-in) website. It adds climate devices for every tado zone and sensors for some additional information of the zones.
The `tado` component platform is used as an interface to the [my.tado.com](https://my.tado.com/webapp/#/account/sign-in) website.
There is currently support for the following device types within Home Assistant:
- Climate - for every tado zone.
- [Presence Detection](#presence-detection)
- Sensor - for some additional information of the zones.
## {% linkable_title Configuration %}
@ -40,3 +54,61 @@ password:
The tado thermostats are internet connected thermostats. There exists an unofficial API at [my.tado.com](https://my.tado.com/webapp/#/account/sign-in), which is used by their website and now by this component.
It currently supports presenting the current temperature, the setting temperature and the current operation mode. Switching the mode is also supported. If no user is at home anymore, the devices are showing the away-state. Switching to away-mode is not supported.
## {% linkable_title Presence Detection %}
The `tado` device tracker is using the [Tado Smart Thermostat](https://www.tado.com/) and its 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:
```yaml
# Example configuration.yaml entry for Tado
device_tracker:
- platform: tado
username: YOUR_USERNAME
password: YOUR_PASSWORD
home_id: YOUR_HOME_ID
```
{% configuration %}
username:
description: The username for your Tado account.
required: true
type: string
password:
description: The password for your Tado account.
required: true
type: string
home_id:
description: The id of your home of which you want to track devices. If provided, the Tado device tracker will tack *all* devices known to Tado associated with this home. See below how to find it.
required: false
type: integer
{% endconfiguration %}
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. 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` %}
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.