From 7ad9533ed8f62e2f1773cb212044ab263b352dbd Mon Sep 17 00:00:00 2001 From: Erwin Douna Date: Wed, 27 Dec 2023 15:21:52 +0100 Subject: [PATCH] Update Tado device tracker (#30522) * Update Tado device tracker * Removing unused parts * Remove stale reference to device tracker configuration * Clean up --------- Co-authored-by: Martin Hjelmare --- source/_integrations/tado.markdown | 69 +++--------------------------- 1 file changed, 5 insertions(+), 64 deletions(-) diff --git a/source/_integrations/tado.markdown b/source/_integrations/tado.markdown index 8f7b487c2a9..548103d42b8 100644 --- a/source/_integrations/tado.markdown +++ b/source/_integrations/tado.markdown @@ -46,75 +46,16 @@ It currently supports presenting the current temperature, the setting temperatur ## 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. +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. +This tracker uses the Tado API to determine if a mobile device is at home. -To use the Tado platform in your installation, add the following to your `configuration.yaml` file: +By default the Tado device tracker will track all devices known to Tado associated with your home. The Tado app needs to have the `Geolocation` permission enabled for the device to be tracked. -```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 track *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*. +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 integration page](/integrations/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. - -### 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. - -### Finding your `home_id` alternative - -If the above method returns an unauthorized error. The `home_id` can also be found using Chrome developer tools. Whilst logged into https://my.tado.com/webapp, take the following steps: - -- Select the "Network"' tab -- Filter for "home" -- Under "Name", select "users" -- Click on the "Response" tab - -The `home_id` appears in the response for users as `"id":12345` - -In this example `12345` is the `home_id` you'll need to configure. +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. ## Services