Saltar al contenido principal

Integración domótica tado°, gratuita y de código abierto

Integración tado° para Gladys Assistant

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

info

La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.

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.

Parámetros de configuración​

Estos son los parámetros que tado° te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
tado° accountsectionNoUnofficial 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_linkNoOpens the tado sign-in page in a new tab. Come back here once approved: the status below turns green within a few seconds.
OptionssectionNoHow 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 lastsselectNo
Fixed duration (minutes)numberNo
Refresh interval (s)numberNo
One presence sensor per phone with geofencingbooleanNoCreates a device per phone whose tado geofencing is on, with an "at home" sensor. Off by default: it is personal location data.

Cómo instalar tado° en Gladys​

  1. En Gladys, abre Integraciones: tado° aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/lm1lc3n7/gladys-tado:0.1.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/LM1LC3N7/gladys-tado.

tado° requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.

¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.

Sobre las integraciones externas​

tado° es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene LM1LC3N7, no el equipo principal de Gladys.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂