Schauen wir uns zuerst einmal das JSON Objekt aus der Feature Abfrage an. Der hier dargestellte Auszug zeigt bzw. setzt die Normaltemperatur des Heizkreises 2 (Feature: heating.circuits.2.operating.programs.normal): Ein Feature f\u00e4ngt immer mit \"properties\" an und l\u00e4uft bis zur n\u00e4chsten \"properties\" Zeile.<\/p>\n
Beispiel: Normaltemperatur Heizkreis 2 einstellen<\/h3>\n {\r\n \"properties\": {\r\n \"active\": {\r\n \"value\": false,\r\n \"type\": \"boolean\"\r\n },\r\n \"demand\": {\r\n \"value\": \"unknown\",\r\n \"type\": \"string\"\r\n },\r\n \"temperature\": {\r\n \"value\": 17,\r\n \"unit\": \"celsius\",\r\n \"type\": \"number\"\r\n }\r\n },\r\n \"commands\": {\r\n \"setTemperature\": {\r\n \"uri\": \"https:\/\/api.viessmann-climatesolutions.com\/iot\/v1\/equipment\/installations\/999999\/gateways\/1234567890123456\/devices\/0\/features\/heating.circuits.2.operating.programs.normal\/commands\/setTemperature\",\r\n \"name\": \"setTemperature\",\r\n \"isExecutable\": true,\r\n \"params\": {\r\n \"targetTemperature\": {\r\n \"type\": \"number\",\r\n \"required\": true,\r\n \"constraints\": {\r\n \"min\": 3,\r\n \"max\": 37,\r\n \"stepping\": 1\r\n }\r\n }\r\n }\r\n }\r\n },\r\n \"apiVersion\": 1,\r\n \"uri\": \"https:\/\/api.viessmann-climatesolutions.com\/iot\/v1\/equipment\/installations\/999999\/gateways\/1234567890123456\/devices\/0\/features\/heating.circuits.2.operating.programs.normal\",\r\n \"gatewayId\": \"1234567890123456\",\r\n \"feature\": \"heating.circuits.2.operating.programs.normal\",\r\n \"timestamp\": \"2022-11-24T08:22:15.667Z\",\r\n \"isEnabled\": true,\r\n \"isReady\": true,\r\n \"deviceId\": \"0\"\r\n },<\/pre>\nDie eingestellte Solltemperatur betr\u00e4gt 17 Grad Celsius – wie man sie ausliest, ist im vorigen Kapitel<\/a> beschrieben.<\/p>\nJedes Feature, das bei \"commands\" einen nicht leeren Inhalt hat, kann – theoretisch – manipuliert werden. In unserem Beispiel ist das der Fall. Dort steht \"commands\": { \"setTemperature\": {…<\/span> gefolgt von einer URL und einigen Constraints (Einschr\u00e4nkungen).<\/p>\nDer Parameter\u00a0\"isExecutable\" gibt an, ob sich ein Befehl in einem Feature unter den aktuellen Gegebenheiten <\/strong>ausf\u00fchren l\u00e4sst oder nicht. Bei\u00a0\"isExecutable\" = true l\u00e4sst sich der Befehl ausf\u00fchren, ansonsten nicht. Beispiel: Du kannst das Betriebsprogramm \"Eco\" nicht einstellen, weil sich die Anlage im Standby Modus befindet.<\/p>\nWie stellen wir nun die Normaltemperatur von Heizkreis 2 ein?<\/p>\n
Straight forward<\/h4>\n
![\"\"](\"https:\/\/www.rustimation.eu\/wordpress\/wp-content\/uploads\/2023\/01\/2023-01-19-14_26_26-Node-RED-_-192.168.178.24-\u2013-Mozilla-Firefox.png\")
<\/a><\/p>\nZuerst kommt ein Dashboard Slider Node, den wir so einstellen, dass er \"Output only on release\" liefert. Der Zielwert steckt jetzt in msg.payload. Der Function Node, der den http-Reuest Header entsprechend aufbereitet, wird wie folgt programmiert:<\/p>\n
![\"\"](\"https:\/\/www.rustimation.eu\/wordpress\/wp-content\/uploads\/2023\/01\/2023-01-19-14_43_56-Node-RED-_-192.168.178.24-\u2013-Mozilla-Firefox.png\")
<\/a><\/p>\nbzw. als Javascript Snippet zum copy&paste:<\/p>\n
var atoken = flow.get('accessToken');\r\nvar setTo = msg.payload;\r\n\r\nmsg.payload = {\r\n \"targetTemperature\": setTo\r\n}\r\nmsg.headers = {};\r\nmsg.headers['content-type'] = 'application\/json';\r\nmsg.headers['Authorization'] = \"Bearer \" + atoken;\r\n\r\nmsg.installationID = flow.get('installationID');\r\nmsg.gatewaySerial = flow.get('gatewaySerial');\r\nmsg.deviceId = flow.get('deviceID');\r\n\r\nreturn msg;<\/pre>\nNoch ein HInweis: Die in msg.header steckende Information ist ziemlich \"klebrig\", was bedeutet, dass da oft\u00a0 Informationen aus vorherigen http-Requests drin stehen bleiben. Um eine saubere Basis zu haben, sollte man vor jedem Setzen des Headers diesen mit einem msg.headers = {};<\/span>\u00a0 l\u00f6schen.<\/span><\/p>\nDer http Rquest Node<\/em> \"set feature\" enth\u00e4lt die f\u00fcr die Normaltemperatur Heizkreis 2 erforderliche URI:<\/p>\nhttps:\/\/api.viessmann.com\/iot\/v2\/features\/installations\/{{installationID}}\/gateways\/{{gatewaySerial}}\/devices\/{{deviceId}}\/features\/heating.circuits.2.operating.programs.normal\/commands\/setTemperature<\/pre>\nFertig! Oder nicht?<\/p>\n
Flow Betriebssicher machen<\/h4>\n
Bedient man das Dashboard mit einem Mobilger\u00e4t, kann es schnell passieren, dass man den Slider Temperaturw\u00e4hler versehentlich verstellt. Das ist nat\u00fcrlich nicht im Sinne des Erfinders. Ich habe deshalb den Slider und den Befehl enkoppelt. Zum Abschicken der neuen Temperatur muss noch ein Best\u00e4tigungsbutton geklickt werden.<\/p>\n
Das sieht insgesamt wie folgt aus:<\/p>\n
![\"\"](\"https:\/\/www.rustimation.eu\/wordpress\/wp-content\/uploads\/2023\/01\/2023-01-19-14_52_54-Node-RED-_-192.168.178.24-\u2013-Mozilla-Firefox.png\")
<\/a><\/p>\nDie oberen drei grau unterlegten Nodes aus dem Feature Request hast du sicher schon; sie dienen lediglich der R\u00fcckkopplung des aktell in der Heizung eingestellten Werts. Da unsere Applikation ja nicht die einzige Eingabem\u00f6glichkeit ist – es gibt ja noch die ViCare App oder die Tasten am Ger\u00e4t selbst – ist die R\u00fcckkopplung sehr wichtig um immer die aktuell geltende Einstellung zu sehen.<\/p>\n
Der Function Node mit Namen \"HK Soll Temp normal\" wird einfach mit dem bereits existierenden \"Feature auslesen\" http Request<\/em> verdrahtet. Dieser Node macht nichts Anderes als sich den in der Heizanlage geltenden Wert aus dem JSON File herauszusuchen. Die Logik ist aus dem vorigen Kapitel<\/a> bekannt.<\/p>\nvar featureArray = msg.payload.data;\r\nvar idx = featureArray.findIndex((element) => element.feature === 'heating.circuits.2.operating.programs.normal');\r\nmsg.payload = msg.payload.data[idx].properties.temperature.value;\r\nflow.set(\"hkNormal\", msg.payload);\r\nreturn msg;<\/pre>\nDanach kommt der Dashboard Slider Node – Einstellung wie oben. Letzter Node in diesem Strang ist noch ein Change Node, der die Flow Variable gem\u00e4\u00df des Slider Werts zur Verwendung im n\u00e4chsten Schritt abspeichert. Wenn nun der Slider bewegt wird, passiert wie gewollt erst einmal nichts. Das geschieht erst im n\u00e4chsten Schritt, denn erst die unteren drei Nodes nehmen nach dem Ausl\u00f6sen des Dashboard Buttons die Einstellung vor.<\/p>\n
Der Dashboard Button Node wird wie unten gezeigt eingestellt – wobei ich die Darstellung des Button Icons ge\u00e4ndert habe:<\/p>\n
![\"\"](\"https:\/\/www.rustimation.eu\/wordpress\/wp-content\/uploads\/2023\/01\/2023-01-19-15_14_37-Node-RED-_-192.168.178.24-\u2013-Mozilla-Firefox.png\")
<\/a><\/p>\nDie Payload enh\u00e4lt die Flow Variable mit der eingestellten Temperatur.<\/p>\n
Der Function Node Headers & Parameter<\/em> sieht fast so aus, wie der beim \"straight forward\" Beispiel. Lediglich Zeile 2 ist unterschiedlich<\/p>\nvar atoken = flow.get('accessToken');\r\nvar setTo = flow.get('sliHN');\r\n\r\nmsg.payload = {\r\n \"targetTemperature\": setTo\r\n}\r\nmsg.headers = {};\r\nmsg.headers['content-type'] = 'application\/json';\r\nmsg.headers['Authorization'] = \"Bearer \" + atoken;\r\n\r\nmsg.installationID = flow.get('installationID');\r\nmsg.gatewaySerial = flow.get('gatewaySerial');\r\nmsg.deviceId = flow.get('deviceID');\r\n;\r\nreturn msg;<\/pre>\nDer http Requst Node \"<\/em>Set Feature\" ist identisch zum straight forward Beispiel<\/p>\nhttps:\/\/api.viessmann-climatesolutions.com\/iot\/v2\/features\/installations\/{{installationID}}\/gateways\/{{gatewaySerial}}\/devices\/{{deviceId}}\/features\/heating.circuits.2.operating.programs.normal\/commands\/setTemperature<\/pre>\nUnd hier noch die Darstellung des Dashboards mit Auswahl Betriebsart, Slider f\u00fcr normale und reduzierte Temperatur. Die gelben \"OK Haken\" l\u00f6sen aus.<\/p>\n
![\"\"](\"https:\/\/www.rustimation.eu\/wordpress\/wp-content\/uploads\/2023\/01\/2023-01-19-15_40_33-Centralina-\u2013-Mozilla-Firefox.png\")
<\/a><\/p>\n <\/p>\n
Beispiel: Betriebsart einstellen<\/h3>\n
Die eingestellte Solltemperatur betr\u00e4gt 17 Grad Celsius – wie man sie ausliest, ist im vorigen Kapitel<\/a> beschrieben.<\/p>\n Jedes Feature, das bei \"commands\" einen nicht leeren Inhalt hat, kann – theoretisch – manipuliert werden. In unserem Beispiel ist das der Fall. Dort steht \"commands\": { \"setTemperature\": {…<\/span> gefolgt von einer URL und einigen Constraints (Einschr\u00e4nkungen).<\/p>\n Der Parameter\u00a0\"isExecutable\" gibt an, ob sich ein Befehl in einem Feature unter den aktuellen Gegebenheiten <\/strong>ausf\u00fchren l\u00e4sst oder nicht. Bei\u00a0\"isExecutable\" = true l\u00e4sst sich der Befehl ausf\u00fchren, ansonsten nicht. Beispiel: Du kannst das Betriebsprogramm \"Eco\" nicht einstellen, weil sich die Anlage im Standby Modus befindet.<\/p>\n Wie stellen wir nun die Normaltemperatur von Heizkreis 2 ein?<\/p>\n Zuerst kommt ein Dashboard Slider Node, den wir so einstellen, dass er \"Output only on release\" liefert. Der Zielwert steckt jetzt in msg.payload. Der Function Node, der den http-Reuest Header entsprechend aufbereitet, wird wie folgt programmiert:<\/p>\n bzw. als Javascript Snippet zum copy&paste:<\/p>\n Noch ein HInweis: Die in msg.header steckende Information ist ziemlich \"klebrig\", was bedeutet, dass da oft\u00a0 Informationen aus vorherigen http-Requests drin stehen bleiben. Um eine saubere Basis zu haben, sollte man vor jedem Setzen des Headers diesen mit einem msg.headers = {};<\/span>\u00a0 l\u00f6schen.<\/span><\/p>\n Der http Rquest Node<\/em> \"set feature\" enth\u00e4lt die f\u00fcr die Normaltemperatur Heizkreis 2 erforderliche URI:<\/p>\n Fertig! Oder nicht?<\/p>\n Bedient man das Dashboard mit einem Mobilger\u00e4t, kann es schnell passieren, dass man den Slider Temperaturw\u00e4hler versehentlich verstellt. Das ist nat\u00fcrlich nicht im Sinne des Erfinders. Ich habe deshalb den Slider und den Befehl enkoppelt. Zum Abschicken der neuen Temperatur muss noch ein Best\u00e4tigungsbutton geklickt werden.<\/p>\n Das sieht insgesamt wie folgt aus:<\/p>\n Die oberen drei grau unterlegten Nodes aus dem Feature Request hast du sicher schon; sie dienen lediglich der R\u00fcckkopplung des aktell in der Heizung eingestellten Werts. Da unsere Applikation ja nicht die einzige Eingabem\u00f6glichkeit ist – es gibt ja noch die ViCare App oder die Tasten am Ger\u00e4t selbst – ist die R\u00fcckkopplung sehr wichtig um immer die aktuell geltende Einstellung zu sehen.<\/p>\n Der Function Node mit Namen \"HK Soll Temp normal\" wird einfach mit dem bereits existierenden \"Feature auslesen\" http Request<\/em> verdrahtet. Dieser Node macht nichts Anderes als sich den in der Heizanlage geltenden Wert aus dem JSON File herauszusuchen. Die Logik ist aus dem vorigen Kapitel<\/a> bekannt.<\/p>\n Danach kommt der Dashboard Slider Node – Einstellung wie oben. Letzter Node in diesem Strang ist noch ein Change Node, der die Flow Variable gem\u00e4\u00df des Slider Werts zur Verwendung im n\u00e4chsten Schritt abspeichert. Wenn nun der Slider bewegt wird, passiert wie gewollt erst einmal nichts. Das geschieht erst im n\u00e4chsten Schritt, denn erst die unteren drei Nodes nehmen nach dem Ausl\u00f6sen des Dashboard Buttons die Einstellung vor.<\/p>\n Der Dashboard Button Node wird wie unten gezeigt eingestellt – wobei ich die Darstellung des Button Icons ge\u00e4ndert habe:<\/p>\n Die Payload enh\u00e4lt die Flow Variable mit der eingestellten Temperatur.<\/p>\n Der Function Node Headers & Parameter<\/em> sieht fast so aus, wie der beim \"straight forward\" Beispiel. Lediglich Zeile 2 ist unterschiedlich<\/p>\n Der http Requst Node \"<\/em>Set Feature\" ist identisch zum straight forward Beispiel<\/p>\n Und hier noch die Darstellung des Dashboards mit Auswahl Betriebsart, Slider f\u00fcr normale und reduzierte Temperatur. Die gelben \"OK Haken\" l\u00f6sen aus.<\/p>\n <\/p>\nStraight forward<\/h4>\n
<\/a><\/p>\n<\/a><\/p>\nvar atoken = flow.get('accessToken');\r\nvar setTo = msg.payload;\r\n\r\nmsg.payload = {\r\n \"targetTemperature\": setTo\r\n}\r\nmsg.headers = {};\r\nmsg.headers['content-type'] = 'application\/json';\r\nmsg.headers['Authorization'] = \"Bearer \" + atoken;\r\n\r\nmsg.installationID = flow.get('installationID');\r\nmsg.gatewaySerial = flow.get('gatewaySerial');\r\nmsg.deviceId = flow.get('deviceID');\r\n\r\nreturn msg;<\/pre>\nhttps:\/\/api.viessmann.com\/iot\/v2\/features\/installations\/{{installationID}}\/gateways\/{{gatewaySerial}}\/devices\/{{deviceId}}\/features\/heating.circuits.2.operating.programs.normal\/commands\/setTemperature<\/pre>\nFlow Betriebssicher machen<\/h4>\n
<\/a><\/p>\nvar featureArray = msg.payload.data;\r\nvar idx = featureArray.findIndex((element) => element.feature === 'heating.circuits.2.operating.programs.normal');\r\nmsg.payload = msg.payload.data[idx].properties.temperature.value;\r\nflow.set(\"hkNormal\", msg.payload);\r\nreturn msg;<\/pre>\n
<\/a><\/p>\nvar atoken = flow.get('accessToken');\r\nvar setTo = flow.get('sliHN');\r\n\r\nmsg.payload = {\r\n \"targetTemperature\": setTo\r\n}\r\nmsg.headers = {};\r\nmsg.headers['content-type'] = 'application\/json';\r\nmsg.headers['Authorization'] = \"Bearer \" + atoken;\r\n\r\nmsg.installationID = flow.get('installationID');\r\nmsg.gatewaySerial = flow.get('gatewaySerial');\r\nmsg.deviceId = flow.get('deviceID');\r\n;\r\nreturn msg;<\/pre>\nhttps:\/\/api.viessmann-climatesolutions.com\/iot\/v2\/features\/installations\/{{installationID}}\/gateways\/{{gatewaySerial}}\/devices\/{{deviceId}}\/features\/heating.circuits.2.operating.programs.normal\/commands\/setTemperature<\/pre>\n<\/a><\/p>\nBeispiel: Betriebsart einstellen<\/h3>\n
![\"\"](\"https:\/\/www.rustimation.eu\/wordpress\/wp-content\/uploads\/2023\/01\/2023-01-19-15_44_44-Node-RED-_-192.168.178.24-\u2013-Mozilla-Firefox-1.png\")
<\/a><\/p>\n![\"\"](\"https:\/\/www.rustimation.eu\/wordpress\/wp-content\/uploads\/2023\/01\/2023-03-18-14_54_13-Node-RED-_-192.168.178.24-\u2013-Mozilla-Firefox.png\")
<\/p>\n![\"\"](\"https:\/\/www.rustimation.eu\/wordpress\/wp-content\/uploads\/2023\/01\/2023-03-18-15_29_48-Node-RED-_-192.168.178.24-\u2013-Mozilla-Firefox.png\")
<\/p>\n