Dieses Plugin ermöglicht es Daten von einer Netatmo Wetterstation an die Miniserver über UDP zu senden. Der Vorteil ist, dass die normale Netatmo ReST API verwendet wird und lediglich der Benutzername und das Passwort benötigt werden und kein Developer-Account.
Das Plugin unterstützt auch mehrere Wetterstationen innerhalb eines Netatmo Accounts. Jeder Messwert (Sensor) wird als einzelnes UDP Paket an den Miniserver gesendet. Das Paket hat immer folgende Aufbau:
[Stationsname].[Modulname].[Sensorname]=[Wert]
zum Beispiel: Zuhause.Wohnzimmer.Temperature=30 Zuhause.Wohnzimmer.Humidity=56
Die UDP Pakete werden wie im Screenshot ersichtlich einzeln an den Miniserver gesendet:
Hierzu kann ein virtueller UDP Befehl angelegt werden mit folgender Befehlserkennung:
Der Batterie-Level wird ab Version 0.13 in [Stationsname].[Modulname].battery_percent als Prozentwert übermittelt.
Die WiFi-Signalstärke wird ab Version 0.10. in [Stationsname].[Modulname].wifi_status übermittelt. Es handelt sich um einen Zahlenwert, welchen ihr mit folgender Tabelle umwandeln könnt:
- 86 = bad
- 71 = average
- 56 = good
Die Funk-Signalstärke zwischen der Basisstation und den Modulen wird ab Version 0.6. in [Stationsname].[Modulname].rf_status übermittelt. Es handelt sich um einen Zahlenwert, welchen ihr mit folgender Tabelle umwandeln könnt:
- 90 = low
- 80 = medium
- 70 = high
- 60 = full
Der Temperatur- und Luftdrucktrend wird bis zur Version 0.15 als String mit den Werten "up", "down" und "stable" übermittelt. Um die Auswertung am Loxone Miniserver zu vereinfachen, wird ab der Version 0.16 der Trend als Zahlenwert übermittelt ([Stationsname].[Modulname].pressure_trend und [Stationsname].[Modulname].temp_trend). Es handelt sich um einen Zahlenwert, welchen ihr mit folgender Tabelle umwandeln könnt:
- -1 = down
- 0 = stable
- 1 = up
Ab der Version 0.18 wird übermittelt ob die Station aus Sicht der Netatmo API erreichbar ist ([Stationsname].[Modulname].reachabl) Es handelt sich um einen Zahlenwert, welchen ihr mit folgender Tabelle umwandeln könnt:
- 0 = nicht erreichbar (offline)
- 1 = erreichbar (online)
Durch diese Option kann gesteuert werden, ob alle Datums- und Zeitangaben in UTC (Option aus) oder in der jeweiligen lokalen Zeitzone an den Miniserver übertragen werden.
Da das Plugin jedesmal eine neue / frische Anmeldung bei Netatmo durchführt, führ dies jedes mal zu einer E-Mail benachrichtigung. Diese kann im Netatmo Konto in den Einstellungen deaktiviert werden:
Sollte das Plugin nicht funktionieren oder nicht die gewünschten Daten an den Loxone Miniserver senden, kann für das Troubleshooting eine SSH-Verbindung (Eine SSH-Verbindung mit putty aufbauen / Shell-Zugriff) auf den Loxberry aufgebaut werden und folgende Befehle ausgeführt werden um den Fehler einzugrenzen:
python3 /opt/loxberry/data/plugins/netatmo-weather/netatmo.py --logfile=$LBPLOG/netatmo-weather/netatmo-weather.log --configfile=$LBPCONFIG/netatmo-weather/netatmo.cfg
Steht in der Ausgabe sinngemäß etwas von "HTTPSConnectionPool(host='auth.netatmo.com', p ort=443): Max retries exceeded" ist euer Account wegen zu vielen Fehlversuchen gesperrt. Dann einfach über den Web-Browser bei Netatmo anmelden und den Account entsperren.
Erscheint eine Meldung sinngemäß "KeyError: 'battery_percent'" (kann auch etwas anderes als battery_percent) sein, klappt die Verbindung zur Netatmo API, aber in der Antwort fehlen gewisse Werte. Dann mit folgendem Befehl weitermachen:
python3 /opt/loxberry/data/plugins/netatmo-weather/netatmo_APIBody.py | jq
Dieser zeigt 1:1 die Daten, welche Netatmo liefert als JSON Struktur an. Prüft dann hier, ob der Wert der als 'KeyError' gemeldet wurde, hierin enthalten ist (vermutlich nicht). Dann bitte die Ausgabe im Forum posten. Details dazu im Abschnitt "Feedback und Diskussion".
Das PlugIn wird von mir noch weiterentwickelt und ich freue mich über Anregungen und Feedback. Hierzu habe ich im Loxforum einen Thread eröffnet:
https://www.loxforum.com/forum/projektforen/loxberry/plugins/86373-loxberry-netatmo-weather-plugin
- 2021-12-29 Release 2.0.5 - PRE-RELEASE: added next-hop URL after authentication for stability issues, if account has also Netatmo Welcome Cameras enabled
- 2020-12-27 Release 2.0.4 - RELEASE: Various bug fixings, beginning of general.json, implemented logging to log file
- 2020-12-24 Release 2.0.3 - Fixed bug causing configuration-loss during upgrade, implemented auto-update
- 2020-12-23 Release 2.0.2 - Changed from station_name to home_name because of API change by Netatmo
- 2019-12-30 Release 2.0.1 - Support für Loxberry 2.0 (getestet auf 2.0.0.4)
- 2019-05-08 Release 0.18 - Offline Module und Stationen werden ignoriert
- 2019-03-08 Release 0.17 - Netatmo Login Prozess angepasst
- 2018-06-24 Release 0.16 - temp_trend und pressure_trend als Zahlenwert
- 2018-06-20 Release 0.15 - Netatmo API URL angepasst
- 2018-02-18 Release 0.14 - Datums- und Zeitwerte können nun über einen Parameter in die lokale Zeitzone konvertiert werden.
- 2018-02-12 Release 0.13 - Datum- und Zeitwerte werden nun korrekt übertragen, Update auf Loxberry 1.0, Batteriestatus in Prozent
- 2018-01-28 Release 0.12 - Anpassungen für Loxberry 0.3, neue Verzeichnisstruktur, Datumsformat auf Nullzeit-Delta angepasst
- 2017-06-14 Release 0.10 - wifi_status hinzugefügt, Umlaute-Problem behoben, JSON in Webfrontend entfernt, User-Agent eingebaut
- 2017-04-01 Release 0.9 - weitere Timestamp Werte angepasst - Bugfixing
- 2017-03-30 Release 0.8 - time_utc, date_min_temp, date_max_temp in normalem Timestamp Format dd.mm.YYYY HH:MM:SS Format
- 2017-03-25 Release 0.7 - Bug-Fix für dynamische Pfade in Webfrontend CGI und Umbennenung nach Netatmo-Weather
- 2017-03-12 Release 0.6 - dynamische Pfade im Script und Cron-Job, Config-Datei bleibt beim Update erhalten, wechsel auf GetStationsData API
- 2017-03-02 Fix in cron-job if-Abfrage
- 2017-03-01 Anpassung UDP - für jeden Sensor wird ein eigenes UDP Paket gesendet
- 2017-03-01 Anpassung cron-job und netatmo.py auf statische Pfade da Variablen nicht korrekt aufgelöst werden (Workaround)
- 2017-02-26 Erstellung PlugIn v 0.1
- none
| Base Station |
|---|
| {Station Name}.{Base Name}.wifi_status=20 |
| {Station Name}.{Base Name}.reachable=1, 0 |
| {Station Name}.{Base Name}.date_min_temp=287640458 |
| {Station Name}.{Base Name}.Temperature=22.3 |
| {Station Name}.{Base Name}.time_utc=287699122 |
| {Station Name}.{Base Name}.Noise=38 |
| {Station Name}.{Base Name}.AbsolutePressure=995.1 |
| {Station Name}.{Base Name}.CO2=848 |
| {Station Name}.{Base Name}.temp_trend=-1, 0, 1 |
| {Station Name}.{Base Name}.pressure_trend=-1, 0, 1 |
| {Station Name}.{Base Name}.max_temp=22.6 |
| {Station Name}.{Base Name}.date_max_temp=287694609 |
| {Station Name}.{Base Name}.min_temp=20.8 |
| {Station Name}.{Base Name}.Pressure=1018.5 |
| {Station Name}.{Base Name}.Humidity=55 |
| Outdoor Unit |
|---|
| {Station Name}.{Module Name}.battery_percent=27 |
| {Station Name}.{Module Name}.rf_status=65 |
| {Station Name}.{Module Name}.reachable=1, 0 |
| {Station Name}.{Module Name}.Temperature=-1.4 |
| {Station Name}.{Module Name}.date_min_temp=287354902 |
| {Station Name}.{Module Name}.time_utc=287354902 |
| {Station Name}.{Module Name}.max_temp=-1.4 |
| {Station Name}.{Module Name}.date_max_temp=287354902 |
| {Station Name}.{Module Name}.min_temp=-1.4 |
| {Station Name}.{Module Name}.Humidity=85 |
| Indoor Unit |
|---|
| {Station Name}.{Module Name}.battery_percent=3 |
| {Station Name}.{Module Name}.rf_status=64 |
| {Station Name}.{Module Name}.reachable=1, 0 |
| {Station Name}.{Module Name}.Temperature=20.6 |
| {Station Name}.{Module Name}.CO2=1040 |
| {Station Name}.{Module Name}.date_min_temp=279849458 |
| {Station Name}.{Module Name}.time_utc=279850739 |
| {Station Name}.{Module Name}.max_temp=20.8 |
| {Station Name}.{Module Name}.date_max_temp=279846125 |
| {Station Name}.{Module Name}.min_temp=20.6 |
| {Station Name}.{Module Name}.Humidity=57 |
| Rain Gauge |
|---|
| {Station Name}.{Module Name}.battery_percent=72 |
| {Station Name}.{Module Name}.rf_status=57 |
| {Station Name}.{Module Name}.reachable=1, 0 |
| {Station Name}.{Module Name}.sum_rain_1=0 |
| {Station Name}.{Module Name}.sum_rain_24=1.616 |
| {Station Name}.{Module Name}.Rain=0 |
| {Station Name}.{Module Name}.time_utc=287699120 |
| Wind Gauge |
|---|
| {Station Name}.{Module Name}battery_percent=66 |
| {Station Name}.{Module Name}rf_status=67 |
| {Station Name}.{Module Name}.reachable=1, 0 |
| {Station Name}.{Module Name}WindHistoric=[] |
| {Station Name}.{Module Name}GustStrength=6 |
| {Station Name}.{Module Name}max_wind_angle=185 |
| {Station Name}.{Module Name}time_utc=287699120 |
| {Station Name}.{Module Name}max_wind_str=26 |
| {Station Name}.{Module Name}max_temp=0 |
| {Station Name}.{Module Name}WindAngle=225 |
| {Station Name}.{Module Name}WindStrength=3 |
| {Station Name}.{Module Name}date_max_temp=287622255 |
| {Station Name}.{Module Name}date_min_temp=287622255 |
| {Station Name}.{Module Name}date_max_wind_str=287685251 |
| {Station Name}.{Module Name}GustAngle=190 |
| {Station Name}.{Module Name}min_temp=0 |