Zum Hauptinhalt springen

tado° Smart-Home-Integration, kostenlos und Open Source

tado°-Integration für Gladys Assistant

Unofficial connector: tado° thermostats, hot water, home presence, open windows, scenes and widgets.

Info

Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.

Unofficial connector, not affiliated with tado. It brings your tado° heating into Gladys: the thermostats and radiator valves of the V3+, V3 and V2 generations, hot water, air conditioning, and the rooms of tado X. tado is a trademark of tado GmbH.

What you get​

SurfaceContent
One device per homeat home (presence sensor), presence mode (automatic / home / away), outside temperature, solar intensity, weather
One device per heating zonesetpoint, mode (off / manual / schedule), heating state and heating power, temperature, humidity, open window detected, low battery
One device per hot water zoneon/off, mode, setpoint when the system supports it
One device per air conditioning zoneon/off, mode (auto, cool, heat, dry, fan), setpoint, temperature, humidity
Optional: one device per phone with geofencingat home / away
Scene triggerspresence changed, open window detected, zone started / stopped heating, low battery
Scene actionsset a temperature (until the next block, for a duration, or until changed), back to the schedule, set the presence, read a zone
Dashboard widgetstado° home (presence, outside, every zone, Home / Away / Auto buttons) and tado° zone (temperature, humidity, setpoint, heating gauge, mode, +/− 0.5 °C, schedule, off)

Setup​

  1. Install the integration and open its Configuration screen.
  2. Click Link my tado° account: a tado sign-in page opens in a new tab. Sign in and approve the access. No password is stored in Gladys: tado gives the integration a session that it renews by itself.
  3. Back in Gladys, the status turns green within a few seconds and the homes and zones appear in Discovery: add the devices you want.
  4. Put the widgets on a dashboard, pick the home or the zone.

The session stays valid as long as the integration runs at least once a month. After a long stop, the status asks you to link the account again.

Setpoints​

A setpoint sent from Gladys (the thermostat widget, a scene, the zone widget) is a manual setting in tado, like one made on the device. The option A manual setpoint lasts decides when it ends: at the next block of the tado schedule (default), after a fixed duration, or when it is changed again. The scene action set a temperature can override it per scene.

Setting the mode to Schedule ends the manual setting (tado resumes its program); Off turns the zone off (frost protection stays on tado's side).

Scenes​

  • Presence changed: the home went Home → Away or Away → Home, by geofencing or by a manual change. Lower the lights, arm the alarm.
  • Open window detected: tado paused the heating of a zone because a window is open. Send a notification.
  • Zone started / stopped heating: the heating power went above zero or back to zero. Switch a pump, count the heating hours.
  • Low battery: a thermostat or valve of the zone reports a low battery.

The actions set a temperature and back to the schedule return the zone's values; read a zone gives them for a condition that follows ({{temperature}}, {{heating}}, {{open_window}}...).

Privacy​

The integration talks only to tado's servers (login.tado.com, my.tado.com, hops.tado.com). The phone presence sensors are off by default: they expose where the household members are.

Troubleshooting​

  • "tado° refused the saved session": the session expired (30 days without use) or was revoked in the tado app. Click Link my tado° account again.
  • The status says "waiting for your approval": finish the sign-in in the tab that opened; the link is valid 5 minutes.
  • Values move slowly: tado is read every 2 minutes by default (option Refresh interval). A command refreshes its home right away.
  • A hot water zone has no setpoint: your installation only supports on/off (tado reports it).
  • tado X: built from the public documentation of the hops API without the hardware; please report what does not match in the forum thread.

Konfigurationseinstellungen​

Diese Einstellungen fragt tado° in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
tado° accountsectionNeinUnofficial connector, not affiliated with tado. Click "Link my tado° account": a tado sign-in page opens, approve the access, and the integration discovers your homes and zones (V3+, V3, V2 thermostats and valves, hot water, air conditioning, and tado X rooms). The link stays valid as long as the integration runs at least once a month; otherwise link the account again. tado is a trademark of tado GmbH.
Link my tado° accountaccount_linkNeinOpens the tado sign-in page in a new tab. Come back here once approved: the status below turns green within a few seconds.
OptionssectionNeinHow a manual setpoint sent from Gladys ends, and how often tado is read. tado answers every home from the cloud: reading faster than every minute brings nothing.
A manual setpoint lastsselectNein
Fixed duration (minutes)numberNein
Refresh interval (s)numberNein
One presence sensor per phone with geofencingbooleanNeinCreates a device per phone whose tado geofencing is on, with an "at home" sensor. Off by default: it is personal location data.

So installierst du tado° in Gladys​

  1. Öffne in Gladys Integrationen: tado° erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/lm1lc3n7/gladys-tado:0.1.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/LM1LC3N7/gladys-tado.

tado° benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

tado° ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von LM1LC3N7 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂