Beispiel zur Einbindung von Netatmo-Geräten (Wetterstation) über die REST API. Eine ScadaComp kann hier heruntergeladen werden.
Netatmo bietet eine OAuth2 Anbindung. Die Dokumentation hierzu findet man unter https://dev.netatmo.com/apidocumentation.
In den Verbindungseinstellungen muss die Base URL eingetragen werden, sowie alle Felder für die "OAuth2_AuthCodeGrant" Authentifizierung.
|
|
Die Scopes können individuell angepasst werden. Hierüber werden die Datenzugriffe eingeschränkt. Es muss mindesten ein Scope eingetragen werden. Sie werden durch Leerzeichen getrennt.
Es gibt aktuell 9 Scopes: read_station read_thermostat write_thermostat read_camera write_camera access_camera read_presence access_presence read_smokedetector read_homecoach
Die Client ID und den Client Secret erhält man über den Login bei https://dev.netatmo.com/ --> My Apps --> create.
Den Access/Refresh Token wird abgefragt durch den Button "Token abfragen". Es erscheint ein neues Fenster zur Autorisierung.
Nun muss in einem Web-Browser die URL (schon in der Zwischenablage) eingefügt werden (Strg + v). Danach muss man sich an der Homepage anmelden und dem Zugriff über die REST Schnittstelle zustimmen. Der EisBaer erhält dann den Zugriff auf die Geräte.
Für die Abfrage von z.B. Temperatur Sensoren kann ein Profil erstellt werden:
Im Kanaleditor kann das Antwort-Profil ausgelesen werden. Dazu muss der Abfrage-Pfad angegeben werden. Im Fall von Netatmo ist das Format "Application_url_encoded" auszuwählen. Bei Parameter wird das oben eingerichtete Profil ausgewählt.
Jetzt kann über "Endpunkt abfragen" eine Abfrage des Endpunktes ausgeführt werden. Zur Anpassung der Parameter vor der Abfrage, wird ein Fenster geöffnet, um Werte ändern zu können. Sind alle Parameter vorhanden, erscheint die Antwort als JSON String. Bei Profil Name kann ein sprechender Name für die Abfrage eingetragen werden. Über OK werden alle Datenpunkte automatisch als Antwort-Profil angelegt. Entsprechend dem Antwort-Profil werden auch die Datenpunkte angelegt.
