home-assistant.io/source/_components/device_tracker.tado.markdown
Alok Saboo 1aca7b08cf Misc fixes: e.g. -> e.g., and proper case for Home Assistant (#4942)
* e.g. to e.g., and proper case for Home Assistant

* Instructions how to -> Instructions on how to
2018-03-17 20:20:37 +01:00

2.1 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release
layout title description date sidebar comments sharing footer logo ha_category ha_release
page Tado Instructions on how to integrate Tado into Home Assistant. 2017-01-17 12:00 true false true true tado.png Presence Detection 0.37

The tado device tracker is using the Tado Smart Thermostat 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:

# Example configuration.yaml entry for Tado
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 (Optional): 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.

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 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:

{
  "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.