Public
/
FHEM-Tado
1
0
Fork 0
Code Issues Pull Requests Releases 9 Activity

„README.md“ ändern

This commit is contained in:
Philipp Wo 2019-10-17 11:12:09 +00:00
parent e9db253651
commit 49ed453f3c
1 changed files with 32 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
README.md
View File

@ -9,11 +9,40 @@ In FHEM wird das Modul folgendermaßen definiert:
`define <name> TadoAPI <username> <password> [<homeID>] [<mobileID>]`
Standardmäßig versucht das Modul alle 5 Minuten
Standardmäßig aktualisiert das Modul alle 5 Minuten die Werte *tado mode; Zone 1 Temperatur; Geolocation für die angegebene mobID und den API-Status*. (siehe Bild Modulübersicht)
Sämtliche externen Aufrufe sind *nonblocking* ausgeführt.
<img src="https://home.wolfmajer.at/wolfgit/Public/FHEM-Tado/raw/branch/master/doc/Modul1.PNG" width="200" height="400" />
## OAuth2 Token Authentifizierung
Alle Anfragen an das API sind über *oauth2* realisiert.
Zuerst wird ein Token (mit Username und Passwort) 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/temp/TadoAPItoken_module_<fhem-name>`
## Verwendung
![Modulübersicht](https://home.wolfmajer.at/wolfgit/Public/FHEM-Tado/raw/branch/master/doc/Modul1.PNG)
In Kombination mit dem Presence Modul kann man *tado* automatisch zwischen HOME und AWAY umschalten lassen.
Beispiel dafür:
![SVG-Plot Beispiel](https://home.wolfmajer.at/wolfgit/Public/FHEM-Tado/raw/branch/master/doc/Modul2-SVG.PNG)
```
...
if (Value("Anwesenheit") eq "falsch" && ReadingsVal("<TADO-MODULNAME>","HomeMode",0) ne "AWAY")
{
fhem("get mytd getHomeMode; set mytd setGeo on");
Log 3, "TadoAPI: Away";
}elsif (Value("Anwesenheit") eq "wahr" && ReadingsVal("<TADO-MODULNAME>","HomeMode",0) eq "AWAY"){
# somebody at home
fhem("set mytd setGeo off");
Log 3, "TadoAPI: Home";
}
...
```
<img src="https://home.wolfmajer.at/wolfgit/Public/FHEM-Tado/raw/branch/master/doc/Modul2-SVG.PNG" width="200" height="400" />