FHEM-Tado
FHEM Modul für tado Heizungssteuerung.
Für Fragen / Anliegen bin ich im FHEM-Forum (https://forum.fhem.de/index.php/topic,116764) erreichbar.
Was wird unterstützt?
- Übersicht aller Tado Zonen
- Temperatur & Luftfeuchtigkeit
- Batteriestatus
- aktuelle Heizleistung
- Wunschtemperatur
- Overlays (static & timer)
- ChildLock Status (nur Reading)
Installation
- Wechsle mit der Console (SSH) in dein FHEM Installationsverzeichnis (Pfad ggf. anpassen):
cd /opt/fhem/FHEM/
- Lade die aktuellste Modulversion auf dein FHEM herunter:
wget https://git.wolfmajer.at/Public/FHEM-Tado/raw/branch/master/98_TadoAPI.pm
- Zur Sicherheit noch die Berechtigungen anpassen:
sudo chown fhem:dialout 98_TadoAPI.pm
sudo chmod 644 98_TadoAPI.pm
- FHEM neu starten.
sudo systemctl restart fhem.service
- Fertig, weiter geht´s in FHEM mit der Definition
Definition & Funktion
In FHEM wird das Modul mit folgenden Schritten definiert:
Wenn man noch keinen device_code hat
define <name> TadoAPI
sonst kann man ihn gleich mitgeben mit:
define <name> TadoAPI [<device_code>] [<homeID>]
Wichtig: Device einrichten
Danach muss man das FHEM Device bei tado registrieren. ->
- Dazu get
getDeviceCodeoder per Befehl (z.B. get myTado getDeviceCode) ausführen. - Kurz warten, dann sollte sich ein Pop-Up (siehe Bild unten) mit dem Link und dem
device_codeöffnen - sonst im Log nachschauen ;-) - Mit dem Link bei tado anmelden - Erfolgsmeldung mit "Gerät registriert" oder ähnlich abwarten.
device_codebeim DEF in FHEM einfügen- Fertig
Standardmäßig aktualisiert das Modul alle 5 Minuten die folgenden Werte:
- Zonen Temperatur
- Zonen Luftfeuchtigkeit
- aktuelle Wunschtemperatur einer Zone
- Geolocation aller eingerichteten Smartphones
- API-Status (siehe Bild Modulübersicht)
- Batteriestatus aller Tado Geräte
- Overlays (manuell eingestellte Wunschtemperatur die den Intelligenten Zeitplan überschreibt)
- Timed Overlays (manuell eingestellte Wunschtemperatur, die den Intelligenten Zeitplan für die angegebene Zeitdauer (Sec) überschreibt)
Sämtliche externen Aufrufe sind nonblocking ausgeführt.
Overlay für Zone setzen
set <name> setZoneOverlay <zonenID> <Wunschtemperatur> [Dauer des Overlay in Sekunden]
INFO: unterstützte Werte der Wunschtemperatur: remove=delete overlay; 0=heating power off; 1<=desired temperature (overlay)
Info für Overlay mit Timer
Kann entweder mit wie oben beschrieben oder, für Widgets von Tablet UI interessant, mit set <name> timedZoneOverlay <zonenID> <Dauer des Overlay in Sekunden> <Wunschtemperatur> gesetzt werden.
Bei einem Timer Overlay erscheint in den tado Readings ein neuer Wert Zone<ID>Lock. Zusätzlich ist in den Internals noch ein Helper mit der Info welche Zone gesperrt ist. Das kann man in FHEM dann in eigenen Scripts weiterverarbeiten. (z.B. Anwesenheitserkennung soll Overlay nicht überschreiben wenn Timer...)
Overlay für alle Zonen setzen
set <name> setAllOverlays <Wunschtemperatur> [Dauer des Overlay in Sekunden]
INFO: unterstützte Werte der Wunschtemperatur: remove=delete overlay; 0=heating power off; 1<=desired temperature (overlay)
Tado Geräte anzeigen (z.B. Battery State)
get <name> getZoneDevices
Screenshots
Modulübersicht
Verwendung in FHEM
FHEM Tablet-UI
Im Tablet UI lassen sich alle Readings des tado FHEM Modul anzeigen:
Auch lassen sich im Tablet UI mit einem Thermostat Widget alle Zonen steuern:
Code Snippet für einen Thermostat Widget:
<div data-type="thermostat" data-height="250" data-width="285" data-temp="Temperatur_Heizung" data-min="15" data-max="24" data-device="mytd" data-set="timedZoneOverlay 1 7200" data-get="DesiredTemp_Heizung"></div>
Tado mit Anwesenheit verknüpfen
In Kombination mit dem Presence (bzw. Residents) Modul kann man tado automatisch zwischen HOME und AWAY umschalten lassen und die Temperatur mittels FHEM absenken lassen.
Beispiel dafür:
+*00:03:00 {
if (Value("Bewohner") eq "absent" && ReadingsVal("mytd","OverlayType_<zonenName>",0) ne "MANUAL")
{
fhem("set mytd setZoneOverlay <zonenID> 16; set mytd setGeo <Mobile ID> on");
Log 3, "TadoAPI: Keiner mehr zu Hause - Overlay und Geolocation wird aktiviert.";
}elsif (Value("Bewohner") eq "home" && ReadingsVal("mytd","OverlayType_Heizung",0) eq "MANUAL")
{
# jemand zu hause
fhem("set mytd setZoneOverlay <zonenID> remove; set mytd setGeo <Mobile ID> off");
Log 3, "TadoAPI: Bewohner anwesend - Overlay wird deaktiviert.";
}
}
...
GPlot-Beispiel:
# Created by FHEM/98_SVG.pm, 2019-10-20 03:52:15
set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set title 'Schafzimmer <TL> <L1>'
set ytics
set y2tics
set grid ytics
set ylabel "Temperatur"
set y2label "Heizleistung"
set yrange [18:26]
set y2range [0:100]
#Log_tadoAPI 4:mytd.Temperatur_Schlafzimmer\x3a::
#Log_tadoAPI 4:mytd.OverlayType_Schlafzimmer\x3a:1:$fld[3]&&$fld[3]=~"MANUAL"?20:0
#Log_tadoAPI 4:mytd.Luftfeuchtigkeit_Schlafzimmer\x3a::
#Log_tadoAPI 4:mytd.Heizleistung_Schlafzimmer\x3a::
#Log_tadoAPI 4:mytd.DesiredTemp_Schlafzimmer\x3a::
plot "<IN>" using 1:2 axes x1y1 title 'Temperatur' ls l1fill lw 1 with lines,\
"<IN>" using 1:2 axes x1y2 title 'Abwesenheit' ls l0fill_stripe lw 0.5 with histeps,\
"<IN>" using 1:2 axes x1y2 title 'Feuchte' ls l2 lw 1 with lines,\
"<IN>" using 1:2 axes x1y2 title 'Heizleistung' ls l5dot lw 1.5 with lines,\
"<IN>" using 1:2 axes x1y1 title 'Desired' ls l5 lw 0.5 with lines
Technische Information
OAuth2 Token Authentifizierung
Alle Anfragen an das API sind über oauth2 realisiert. Zuerst wird ein Token (device code grant flow) von tado angefordert der ca. 10 Minuten gültig ist. Alle folgenden Aufrufe werden nur mehr über den Token realisiert. Das Modul prüft den Token auf Gültigkeit und erneuert ihn bevor er abläuft.
Pfad des Token ist im Modul fix eingestellt /fhem-root/FHEM/FhemUtils/TadoAPI_token_<fhem-devicename>
Credits
Thx to:
https://support.tado.com/en/articles/8565472-how-do-i-authenticate-to-access-the-rest-api
https://shkspr.mobi/blog/2019/02/tado-api-guide-updated-for-2019/