Test Adapter netatmo-energy v2.7.0 GitHub/Latest

[ioKlausi]

Aktuelle Test Version	2.7.0
Stabile Version	2.5.8
----	----
Veröffentlichungsdatum	20.12.2020
Github Link	https://github.com/Homemade-Disaster/ioBroker.netatmo-energy

Hallo Community,

ich möchte für den Test meinen neuen Adapter abgeben: netatmo-energy

Der Adapter holt sich die Informationen aus der Netatmo Energy API und legt diese als Datenpunkte an.
Die Anbindung wird durch eine eigene APP in der Netatmo API realisiert. Die notwendigen Logondaten werden in dieser APP bereitgestellt.

Im Device "APPRequests" (im Adapter-Root) werden die unterstützen API Requests bzw. die Trigger als Buttons angeboten.

• "homesdata" holt die gesamte Struktur der Netatmo Energy Installation (dabei wird der Parameter NAPlug verwendet). Sie können alle weiteren Parameter für manuelle Requests selbst auswählen.

• "homestatus" holt den Status aller Ventile bzw. des Thermostats und mischt die Informationen in die Objekte der "homesdata" Struktur ein (in rooms). Zusätzlich wird ein Ordner "settings" in jedem Raum angelegt, welcher das manuelle Einstellen der Temperaturen ermöglicht.
  Der Parameter "sofort aktualisieren" in den Adapter Einstellungen bewirkt, dass die Änderungen an den Temperatureinstellungen sofort an die API übermittelt werden, oder erst beim Auslösen des Triggers "applychanges" im Ordner "trigger" durchgeführt wird. Dafür wird der API Request "setroomthermpoint" mit Parameter "manual" ausgeführt.

• getroommeasure ... Hiermit erhalten sie historische Daten ihrer Räume. Das Ergebnis wird in das "response" Feld eingetragen.

• getmeasure ... Hiermit erhalten sie die historischen Daten ihres Boilers. Das Ergebnis wird in das "response" Feld eingetragen.

• "switchhomeschedule" ändert den schedule mode der API. Alle möglichen Modes sind als Requestsverfügbar

• "setthermmode" ändert den Modus der Netatmo Energy.
  Es werden folgende Modi unterstützt:

  • away (nicht zu Hause)
  • hg (Frostwächter)
  • schedule (Betrieb lt. Plan)

• synchomeschedule ... Setzt die Heizpläne deiner Netatmo Energy APP. Um einen spezifischen Heizplan zu ändern, geben sie eine an. Andernfalls wird der aktuell eingestellte abgeändert. Bitte tragen Sie die notwendigen Parameter im Please specify the parameters in the channel "parameters" ein (schedule_id ist optional) und lösen sie den synchomeschedule Request aus.

• createnewhomeschedule ... Erstellt einen neuen Heizplan für deine Netatmo Energy APP. Bitte tragen Sie die notwendigen Parameter ein und lösen sie den "createnewhomeschedule" Request aus.

• Der Button "set_mode_to_home" im channel "setting" setzt den Ventil-mode "set_mode_to_home" auf "home".

Nach Änderungen der Temperaturen bzw. dies Modus kann mit dem Request "homestatus" der aktuelle Status neu abgeholt werden.

Wenn ein API Request Parameter benötigt, können sie diese im korrespondierenden Request Channel im Channel "parameters" finden.

Adaptereinstellungen (Allgemeine Einstellungen):

• Temperaturänderung sofort übertragen ... Nach Änderung der Temperatur im channel "settings" wird sofort der API Requests ausgelöst
• API-Zustände nach Änderung sofort lesen ... Nach Änderung der Status mittels API Request wird der API Request "homestatus" automatisch ausgelöst, um die aktuellen Werte aus der API auszulesen
• Aktualisierung der API-States alle x Sekunden ... automatische homestatus Request alle x Sekunden auslösen

Eigenes Widget für Thermostat erstellt

Die Issues bitte ich auf github erstellen: https://github.com/Homemade-Disaster/ioBroker.netatmo-energy/issues

Ab sofort ist die Version 1.3.1 freigegeben. Die Adaptierung für js-controller 4.x und Node>=12 wurde durchgeführt.
Das Erzeugen der "states" wurde aufgrund der Warnungen vom js-controller 4.x angepasst. Übersetzungen wurden hinzugefügt. Kompaktmodus wurde getestet. Integration von "release-script" durchgeführt und "abort-controller" wurde implementiert.

Die Version 2.3.1 wurde freigegeben, um den Nachrichtendienst Signal zu bedienen und neue Nachrichten zu etablieren.

Neue Version 1.0.0 freigegeben: Einige Fehlersituationen wurden überarbeitet
Neue Version 1.0.3 freigegeben: UI Interface überarbeitet
Neue Version 1.1.0 freigegeben: Trigger für Ventilmodus eingerichtet
Neue Version 1.2.3 freigegeben: Admin Tab zur Visualisierung and Pflege der Ventile
Neue Version 1.3.0 freigegeben: API Requests auf Admin Tab Cards mittels Dropdown Menü aufrufbar
Neue Version 1.3.1 freigegeben: Zusätzliche Attribute auf Thermostat Karte verfügbar
Neue Version 2.0.2 freigegeben: OAuth2 Authentifizierung etabliert (node >=14)
Neue Version 2.0.3 freigegeben: Signal als Nachrichtentyp hinzugefügt
Neue Version 2.1.0 freigegeben: Neuen API-Request createnewhomeschedule hinzugefügt
Neue Version 2.2.0 freigegeben: Timer für token refresh hinzugefügt
Neue Version 2.3.0 freigegeben: Nachrichten hinzugefügt
Neue Version 2.4.0 freigegeben: Externe und interne Sensoren zur Heizungssteuerung hinzugefügt
Neue Version 2.4.1 freigegeben: Coding / Dokumentation überarbeitet
Neue Version 2.4.5 freigegeben: Sensor Verzögerung und Aktionsabbruch während Verzögerung
Neue Version 2.5.0 freigegeben: Jeder Bool-Sensor möglich
Neue Version 2.5.1 freigegeben: Testnachricht in config ermöglicht
Neue Version 2.5.2 freigegeben: Admin config überarbeitet
Neue Version 2.5.3 freigegeben: Datenpunkt für Nachricht hinzugefügt
Neue Version 2.5.8 freigegeben: Sentry errors korrigiert und neue Funktionen in Admin Tab
Neue Version 2.6.0 freigegeben: Ermöglichen / Deaktivieren von Sensoraktionen
Neue Version 2.6.4 freigegeben: Nur ändern, wenn Änderungen erkannt werden
Neue Version 2.6.5 freigegeben: Neue Optionen in der Adapterkonfiguration zur Aktualisierung von Datenpunkten
Neue Version 2.7.0 freigegeben: Standardwerte füe Paramaeter anpassen

netatmo-energy adapter for ioBroker

Get and set data using Netatmo-Energy API. This adapter uses the fetch command to execute http requests to Netatmo Energy API. The official documentation of this API: https://dev.netatmo.com/apidocumentation/energy.

It also creates a device called "energyAPP" including channels "APIRequests" and "trigger".

API Requests

• homesdata ... get the whole structure of your Netatmo energy environment (using NAPlug-Parameter as default). You can set specific parameters.
• homestatus ... get the status and the technical informations of your valves assigned in your rooms. If you want to get informations of a specific device type, you can choose specific parameters.
• getroommeasure ... Retrieve data history of a room. The response of this request will be stored in the response field.
• getmeasure ... Retrieve boiler historycal data. The response of this request will be stored in the response field.
• setthermmode_schedule ... set the mode of your Netatmo Energy to schedule (default).
• setthermmode_hq ... set the mode of your Netatmo Energy to hq (freeze mode)
• setthermmode_away ... set the mode of your Netatmo Energy to away (from home)
• switchhomeschedule ... set the schedule mode of all available schedule types. All possible combinations of the API request an its parameters are listed in channel switchhomeschedule as separate API requests.
• synchomeschedule ... set the thermostat schedule of a home. To edit a particular schedule, you need to enter the schedule_id, if you don't specify one, the modification will be applied to the current schedule. Please specify the necessary parameters and send the request using synchomeschedule.
• createnewhomeschedule ... creates a new thermostat schedule for a home. Please specify the necessary parameters and send the request using "createnewhomeschedule".

If an API request need parameters you can find these in the channel "parameters" in the corresponding API request channel.

Trigger

• applychanges ... transfer all manually changes of your valves to Netatmo Energy

Update requests

• setroomthermpoint ... depending on the "setting" channel it sets the temperature of each room (immediately or by using the trigger "applychanges"). In the channel "setting" you can use the button "set_mode_to_home" to set "home"-Mode for the valve.

Messages

• message_text ... all messages are transferred to this datapoint

Status

• running ... here you can see if API Requests are running right now

Build structure

If you start the adapter, it will be generating the actual "homes"-environment of your Netatmo Energy APP.
It will automatically be built up the whole homes-structure, and also the actual status of your valves.
Depending on the adapter settings it will refresh theses data after sending an API setthermmode request or an API setroomthermpoint request.

Sensorik

In the table, you can react to the "window_open" attribute per room. The status of the respective window sensors can trigger an action when changing, which is to be entered here. It is possible to select all sensors, which are boolean. This means that external sensors can also be integrated.

The following actions can be triggered:

• Set temperature
• Set Home-Mode
• Set heating mode
  • Frost guardian
  • Away from home
  • Normal
• Activate heating plan
  • you can take each existing heating plan from your Netatmo-Energy App

The temperature of a valve can thus be set when opening or closing a window/door. By entering a delay time (in seconds), the stored action is executed with a delay. If the triggering sensor is changed again within the delay time, the pending actions are not carried out.

Widget

Widget for VIS to show a complete valve. You have only to define the "SetTemp" - datapoint. The widget will get all other information's dynamically out of the "rooms"-structure.

Version 1.3.1 has been released now. The adaptation for js-controller 4.x and Node>=12 was done.
The creation of the "states" has been adjusted due to the warnings from js-controller 4.x. Translations have been added. Compact mode has been tested. Integration of "release-script" done and "abort-controller" was implemented.

New Version 1.0.0 released: Some error handlings were redesigned
New Version 1.0.3 released: UI Interface redesigned
New Version 1.1.0 released: Trigger for valve-mode implemented
New Version 1.2.3 released: Admin Tab to visualize and maintain the valves
New Version 1.3.0 released: API Requests useable on Admin Tab Cards (Dropdown menu)
New Version 1.3.1 released: Additional attributes on thermostat cards available
New Version 2.0.2 released: OAuth2 authentication established (node >=14)
New Version 2.0.3 released: Added Signal as a new message type
New Version 2.1.0 released: Added new API request 'createnewhomeschedule'
New Version 2.2.0 released: Timer for token refresh added
New Version 2.3.0 released: Additional notifications added
New Version 2.4.0 released: Implementation of internal / external sensors to steer the heating system
New Version 2.4.1 released: Revice Coding / Documentation
New Version 2.4.5 released: Sensor delay time & abort functionality
New Version 2.5.0 released: Sensor changed to object ID type boolean
New Version 2.5.1 released: Test message in config added
New Version 2.5.2 released: Adjustments in the admin config
New Version 2.5.3 released: Added data point for messages
New Version 2.5.8 released: Correction if some Sentry errors and nuw function in Admin Tab
New Version 2.6.0 released: Enable / Disable sensor actions
New Version 2.6.4 released: Change value only if changes are detected
New Version 2.6.5 released: New options in the adapter configuration for updating datapoints
New Version 2.7.0 released: Adjust default value for parameters

kind regards
ioKlausi

[FPmediaFlorian]

Hi ioKlausi!

Danke für den Adapter!
Installation lief reibungslos, anbindung an Netatmo funktioniert auch.
Vollständiges Review, folgt.

Schönen Sonntag & LG Florian

[gramar]

Hi!

Super! Vielen Dank für die tolle Arbeit!

[ioKlausi]

@gramar Danke für dein Interesse.
In der Zwischenzeit gibt es bereits einige Updates. Zusätzlich zur obigen Beschreibung wurde nun auch ein Benachrichtigungsassistent eingebaut, welcher Informationen, Warnungen und Fehler sendet. Viel Spaß damit.

[Finnenzauber]

Sorry falscher Alarm. Die Home-ID war falsch und jetzt funktioniert es wunderbar. Klasse Arbeit und vielen Dank dafür!!!

[ioKlausi]

Neue Version verfügbar. Es wurde ein eigenes Widget für VIS hinzugefügt. Viel Spaß damit.

[Finnenzauber]

Hallo ioKlausi,

die Temperatur nur einzelner Thermostate kann man nicht ändern? Möchte gerne, dass nur eine Heizung auf 7 Grad gesetzt wird, wenn die Terassentür auf geht. Alle anderen Thermostate sollen unverändert bleiben.

Vielen Dank im Voraus

Finnenzauber

[ioKlausi]

@Finnenzauber Der Datenpunkte SetTemp im Channel settings ist dafür vorgesehen. Bin derzeit leider nur am Handy. Sollte aber funktionieren. Prüfe bitte auch die Adapterkonfiguration. Da kann man einstellen ob ein Eintrag in diesem Datenpunkt sofort an die API übertragen wird (Temperaturänderungen sofort übertragen) oder erst nach dem Setzen des Triggers - eigener Request in energyAPP - trigger - applychanges. Die API lässt nur Änderungen pro Raum zu - setroomthermpoint. (https://dev.netatmo.com/apidocumentation/energy). Wenn du ein einzelnes Thermostat steuern möchtest muss es in einem separaten Raum sein.

[Finnenzauber]

@ioKlausi said in Test Adapter netatmo-energy v0.1.x GitHub/Latest:

einzelnes T

Jetzt bin ich mehr als Glücklich und läuft wie ich das sinnvoll verwenden kann.

RESPEKT UND ANERKENNUNG FÜR DEINE ARBEIT! Vielen vielen Dank!

[ioKlausi]

@Finnenzauber Freut mich dass es passt. Es gibt wieder eine neue Version 0.1.19
Da habe ich das Widget um diverse Warnungen (z.B. "Offenes Fenster anzeigen") erweitert und für den Trigger gibt es einen bugfix. Zusätzlich wurde ein neuer Status eingeführt, der anzeigt ob gerade ein API Request läuft. Zusätzlich gibt es nun auch ein wiki (https://github.com/Homemade-Disaster/ioBroker.netatmo-energy/wiki).

[Finnenzauber]

@ioKlausi Kurze Frage: Das Update einfach drüber büggeln mit Download von Github oder lieber komplett neu installieren nach Deinstallation? Es wir keine Aktualisierung in der Adapterliste angezeigt

Vielen Dank und viele Grüsse

[ioKlausi]

@Finnenzauber an und für sich sollte das drüber installieren von npm reichen. Vielleicht adapter stoppen und starten. Bei mir hat das gereicht. Sonst bitte deinstallieren. Bitte um kurze Info ob stoppen/starten reicht. Version sollte 0.1.19 sein.

[Finnenzauber]

Hallo @ioKlausi,

hat wunderbar funktioniert. Adapter auf Pause gesetzt, 1.19 installiert aus Github und wieder gestartet - ohne Fehlermeldung.

Vielen Dank für deine Mühe!

Finnenzauber

[Tommy 0]

@ioklausi Adapter funktioniert astrein. Das war das letzte noch manuell gesteuerte Gerät. Vielen Dank für Deine Mühe!!

[Newpicsel]

Moin, ewig hab ich auf einen Adapter gewartet, mir jetzt ein "Adapter" in Blockly gebastelt und nun sehe ich, dass ein Adapter erstellt wurde!
naja was soll's werde den bei gelegenheit testen.

[Xenon]

das muss ich auch direkt ausprobieren !

[Xenon]

erstes kurzes feedback:

• während der Adapter verbindet würde ich definitiv die Instanz gelb leuchten lassen
• mehr screenshots in die readme aufnehmen, da verzweifeln die User sonst dran
• Da sind schon sehr viele Ordner. Würde es nicht Sinn machen anstatt "0","1" usw die Raumnamen anzuzeigen?

Was auch auffällt ist, dass bei jeder Änderung alles kurz hängt. Muss es denn sein, dass man bei jeder Temperaturänderung alle states neu holt? Das gleiche Problem beim automatischen aktualisieren der Werte alle 60 Sekunden. Sogar der Admin steigt kurzzeitig aus. Gibt die API das nicht anders her?

Und muss es denn sein, dass jede API Anfrage im Log unter Info steht? Besser wäre doch Log-Stufe Debug hier ...

[bubus]

Ich nutze an meiner Gas-Heizung Netatmo.
Wenn ich mir ein paar z.B. Aqara Fenstersensoren kaufen würde, würde es klappen (mit entsprechendem Blockly und eurer Hilfe ), dass die Heizung runtergeregelt wird, wenn ein Fenster geöffnet wird?

[Xenon]

@bubus sagte in Test Adapter netatmo-energy v0.1.x GitHub/Latest:

Ich nutze an meiner Gas-Heizung Netatmo.
Wenn ich mir ein paar z.B. Aqara Fenstersensoren kaufen würde, würde es klappen (mit entsprechendem Blockly und eurer Hilfe ), dass die Heizung runtergeregelt wird, wenn ein Fenster geöffnet wird?

ja das funktioniert

[Airmaxchen]

Vielen Dank auch für den Adapter. Er ist grün und die Daten meines Thermostats erscheinen in den Objekten.
Ich habe nur das Problem, dass keine Änderungen weitergegeben werden.
Wenn ich z.B. etwas am Thermostat ändere kommt das nicht zu den Objekten durch und auch umgekehrt nicht.

Ich habe testweise die Aktualisierung auf 20 Sekunden gestellt und es wird auch alle 20 Sekunden der API running status kurz auf true gestellt. Auch diverse Objekte leuchten kurz grün auf aber es wird leider nichts übernommen.

Habe ich da eine Einstellung übersehen?