Netatmo Weather

Autor
Logo

Status

STABLE

Version2.0.3
Min. LB Version

LB 1.0LB 2.0

Downloadhttps://github.com/michaelmiklis/loxberry-plugin-netatmo-weather/archive/2.0.3.zip
ZweckNetatmo Wetterdaten per UDP an Miniserver übermitteln
LanguagesEN
Diskussionhttps://www.loxforum.com/forum/projektforen/loxberry/plugins/86373-loxberry-netatmo-weather-plugin
 Version History...
  • 2019-12-30 Release 2.0.3 - Fixed bug causing configuration-loss during upgrade, implemented auto-update
  • 2019-12-30 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 - Option um Datums- und Zeitwerte in der lokalen Zeitzone übertragen zu lassen
  • 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


Inhalt



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

Beispiel

Die UDP Pakete werden wie im Screenshot ersichtlich einzeln an den Miniserver gesendet:

Hierzu kann ein virtueller UDP Befehl angelegt werden mit folgender Befehlserkennung:

Batterie-Level

Der Batterie-Level wird ab Version 0.13 in [Stationsname].[Modulname].battery_percent als Prozentwert übermittelt.

WiFi Signalstärke

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

Funk Signalstärke

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

Temperatur- und Luftdrucktrend

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


Offline Erkennung (reachable)

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)

Local Time / Lokale Zeitzone

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.

E-Mail Benachrichtigung durch Netatmo deaktivieren

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:

     

Troubleshooting

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

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".


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

Known-Issues

  • Logging erfolgt nicht in die Log-Datei

Sensor-Werte

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}.reachable=1, 0
{Station Name}.{Module Name}.rf_status=65
{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}.reachable=1, 0
{Station Name}.{Module Name}.rf_status=64
{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}.reachable=1, 0
{Station Name}.{Module Name}.rf_status=57
{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}.reachable=1, 0
{Station Name}.{Module Name}rf_status=67
{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