{"id":1868,"date":"2023-01-16T15:01:58","date_gmt":"2023-01-16T14:01:58","guid":{"rendered":"https:\/\/www.rustimation.eu\/?p=1868"},"modified":"2025-09-18T08:44:13","modified_gmt":"2025-09-18T06:44:13","slug":"a-viessmann-api-und-node-red","status":"publish","type":"post","link":"https:\/\/www.rustimation.eu\/index.php\/a-viessmann-api-und-node-red\/","title":{"rendered":"Viessmann API und Node-Red – Teil 1"},"content":{"rendered":"

Dies ist eine eigene Serie in meinem Blog, die sich an Besitzer von Viessmann W\u00e4rmeerzeugern und sonstigen Ger\u00e4ten dieses Herstellers richtet, welche mit dem Internet verbunden sind.<\/strong><\/p>\n

\u00dcberblick<\/span><\/h1>\n

Prinzipiell sind alle neueren Viessmann Steuerungen mit E3 Plattform oder\u00a0 Vitotronic\u00a0 (au\u00dfer Vitotronic 100) daf\u00fcr ausgelegt, mit dem Internet verbunden zu werden.<\/p>\n

<\/p>\n

Die Variantenvielfalt der Viessmann Ger\u00e4te ist schier unendlich. Die meisten Hinweise in diesem Blog gelten trotzdem f\u00fcr alle Arten von ViCare bzw. Viessmann API Implementationen. Auf einzelne Modelle einzugehen, w\u00fcrde zu weit f\u00fchren, zumal ich mich prim\u00e4r nur mit meiner eigenen Heizanlage auskenne.<\/p>\n

Die Verbindung ins Internet geschieht bei den sogenannten Legacy Ger\u00e4ten \u00fcber eine optische Schnittstelle namens Optolink – ein Stecker steckt im Viessmann \"V\" an der Vorderseite des Ger\u00e4ts und ist mit dem Vitoconnect K\u00e4stchen verbunden. Bei den neueren One Base (E3) Ger\u00e4ten\u00a0 erfolgt die Internetverbindung direkt mit der integrierten\u00a0 WiFi Connectivity des Ger\u00e4ts – z.B. bei Gasheizger\u00e4ten ab\u00a0 Baujahren ab ca. 2020. Kompatibilit\u00e4tsliste siehe hier <\/a>(bei unterst\u00fctzte Regelungen<\/em>).<\/p>\n

Otto Normalverwender wird derartige Anlagen meist \u00fcber die ViCare App auf dem Handy kontrollieren und steuern. Das funktioniert, indem die Anlage \u00fcber das Vitoconnect- oder integrierte Interface eine Internetverbindung zu den Viessmann Servern aufbaut und diese dann\u00a0 mit ViCare App auf dem Mobiltelefon kommmunizieren. Kommunikation \"\u00fcber Bande\" sozusagen.<\/p>\n

\"\"<\/a><\/p>\n

Viessmann ist hier also immer \"the man in the middle\".\u00a0 Das hat dann auch den Vorteil, dass die eigene Heizung von \u00fcberall auf der Welt angefunkt werden kann, ohne dass man irgendwelche Ports am Router freischalten muss. Bei den millionenfach verbauten IP \u00dcberwachungskameras, Rasenm\u00e4h- und Putzrobotern funktioniert das genauso.<\/p>\n

Manche sehen das auch kritisch, weil Viessmann so eine Menge \u00fcber unser Heiz- und K\u00fchlverhalten lernt. Ich habe allerdings den Eindruck, dass sich besonders diejenigen dar\u00fcber aufregen, welche bedenkenlos Whatsapp, Facebook, Tiktok \ud83d\ude16, Google Search und Maps oder Youtube verwenden. Immerhin stehen die Server nicht in China.<\/p>\n

Die kommerzielle Seite, n\u00e4mlich, dass man unter Umst\u00e4nden f\u00fcr das Beziehen seiner eigenen Daten Geld bezahlen muss, sehe ich allerdings auch ausgsprochen kritisch.<\/p>\n

Update<\/strong>: mit der ab September 2025 geltenden Gesetze bzgl. der Hoheit \u00fcber die eigenen Daten d\u00fcrfte das Thema kostenpflichtige \"Premium-Daten\" inzwischen Geschichte sein.<\/p>\n

Gro\u00dfartige Sorgen um die Sicherheit der Daten mache ich mir weniger. Der Zugang zu den Viessmann Servern ist ziemlich vernagelt und wohl nur schwer zu knacken – aber wer wei\u00df…<\/p>\n

Viessmann API<\/h2>\n

Irgendwann ist man bei Viessmann wohl auf die Idee gekommen, das Application Program Interface<\/em> (API) \u00f6ffentlich zug\u00e4nglich zu machen, um allen, die sich intensiver mit Internet of Things besch\u00e4ftigen, eine M\u00f6glichkeit zur Integration zu bieten. Hierf\u00fcr gibt es auch eine Reihe von Schnittstellen zu Hausautomatisierungsl\u00f6sungen wie FHEM, Open Hab, Home Assistant, Homematic und so weiter.<\/p>\n

Das Ganze funktioniert wieder \u00e4hnlich wie bei der ViCare App. Die IoT L\u00f6sung zuhause funkt den oder die Viessmann Server an, holt sich Daten, verarbeitet diese und stellt sie dar. Ebenso k\u00f6nnen die Parameter der Anlage (Temperaturen oder Betriebsmodi) eingestellt werden. Auch hier also wieder der \"Viessmann in the middle\" .<\/p>\n

Die kostenfreien Basisfunktionen der API reichen f\u00fcr die meisten Anwendungsf\u00e4lle aus, weitergehende Abfragen und Funktionen k\u00f6nnen kostenpflichtig (ViCare+) hinzubestellt werden.<\/p>\n

Alternative lokale Anbindungen<\/h2>\n

Rein lokale, inoffizielle\u00a0 L\u00f6sungen unter Umgehung der Viessmann Server gibt es\u00a0 auch, viele sind meiner Meinung nach nicht so ausgereift und generell von der Umsetzung her sehr viel anspruchsvoller. Zwei L\u00f6sungen m\u00f6chte ich dennoch erw\u00e4hnen:<\/p>\n

Optolink Splitter<\/h3>\n

Der Viessman User HerrP hat im April 2024 seinen Optolink Splitter in der Viessmann Community<\/a> ver\u00f6ffentlicht, mit dem er eine sehr interessante L\u00f6sung zur Offline-Verarbeitung der Viessmann Daten aufzeigt – und das ohne auf VitoConnect zu verzichten.
\nLeider funktioniert diese L\u00f6sung nur f\u00fcr die \u00e4lteren Viessmann Ger\u00e4te mit Optolink Schnittstelle.
\nDas Ganze ist ziemlich genial: Ein Raspberry Pi (o.\u00e4.) wird anstatt des VitoConnect K\u00e4stchens an die Optolink Schnittstelle angesteckt und das VitoConnect mit einem USB2TTL Converter an die serielle Schnittstelle des Raspi angeschlossen.
\nEin Python Skript auf dem Pi zieht die Daten aus dem Ger\u00e4t und reicht sie an VitoConnect und\/oder per MQTT oder TCP\/IP an die Hausautomatisierung weiter.
\nDie Parametrisierung, d.h. die Adressen der Viessmann Datenpunkte und deren Abfrage bzw. Manipulation ist nicht trivial aber f\u00fcr ambitionierte IoT Bastler l\u00f6sbar.
\nEine umfassende Beschreibung findet sich in Github<\/a>. Ein Youtube Video<\/a> gibt's auch.
\nIch habe mein Node-Red Dashboard inzwischen komplett auf den Optolink-Splitter umgestellt und habe meine Erfahrungen hier ver\u00f6ffentlicht<\/a>.<\/p>\n

open3e<\/h3>\n

Hier werden die neueren E3 Ger\u00e4te \u00fcber den CAN Bus angesprochen. Informationen gibt's bei der Viessmann Community<\/a> und\/oder Github.<\/a><\/p>\n

Node-Red<\/h2>\n

Ich pers\u00f6nlich finde die fertigen Haus Automatisierungssysteme etwas zu komplex und m\u00e4chtig f\u00fcr meine kleinen Smart Home Anwendungen. Au\u00dferdem sind die Smart Home Systeme oft nur mit propriet\u00e4ren Protokollen und Aktoren (Schaltern, Sensoren etc.) und extra Gateway verwendbar und so bei kleinen IoT Installationen auch relativ teuer.<\/p>\n

Meine Anspr\u00fcche sind deutlich geringer. Mein IoT Zoo enth\u00e4lt neben den \u00fcblichen Basteleien mit Shelly Schaltern (\u00fcber WiFi), selbstgel\u00f6teten WiFi Sensoren<\/a> auf Basis ESP8266, MQTT als Datenprotokoll, einen Raspberry Pi als \"Gehirn\" mit Node-Red<\/strong> als universeller und leicht erlernbarer Programmierplattform. So bleibt alles unter meiner Kontrolle. Zus\u00e4tzlich zur Vitodens 200-W B2HB Therme mit VitoConnect Opto2 habe ich noch drei Viessmann Solarthermie Panels, einen Hoxter Heizkamin und einen Viessmann (Italia) Solarcell HSK 1000 Liter Kombispeicher.<\/p>\n

Node-Red ist ein graphisches Entwicklungstool zum Programmieren von Abl\u00e4ufen. Es ist wunderbar auf einem Raspberry Pi (ab Pi Zero) lauff\u00e4hig, wobei ich komplexere Anwendungen eher auf einem Pi 3B+ oder Pi 4B laufen lassen w\u00fcrde.<\/p>\n

Ferner empfehle ich, dass der Raspberry Pi mit einer SSD Festplatte versehen wird, wenn man einmal \u00fcber das Experimentierstadium hinaus ist. Allermindestens sollte eine 32GB\u00a0 oder besser eine 64GB SD Karte in \"Industrial Quality\" oder \"Max Endurance\" verwendet werden (z.B. diese hier<\/a>). Unsere Software Komponenten schreiben jede Menge Logs auf die \"Platte\". Auch wenn diese Logs nach einiger Zeit gel\u00f6scht werden, eine SD Karte vertr\u00e4gt\u00a0 nur eine begrenzte Anzahl von L\u00f6sch-\/Schreibzyklen. Bei einer gro\u00dfen Kapazit\u00e4t sorgt das Disk Management f\u00fcr eine bessere Verteilung. Statt einer SSD Festplatte kann man notfalls auch\u00a0 einen USB Stick mit entsprechender Kapazit\u00e4t verwenden. Wie Datentr\u00e4ger am USB Port eingerichtet werden, steht vielfach beschrieben im Internet.<\/span><\/p>\n

Die Ablauflogik wird \u00fcber Drag & Drop von sogenannten Nodes (Knoten) realisiert, komplexere Operationen werden in Javascript Funktionsbl\u00f6cken implementiert. Allgemeine Programmierkenntnisse (z.B. Python oder BASIC) braucht man schon, Javascript ist dem sehr \u00e4hnlich und man kommt relativ schnell damit zurecht. Zudem unterst\u00fctzt der Editor beim Erstellen von Funktionen, indem er auf Fehler hinweist. Gew\u00f6hnungsbed\u00fcrftig ist, dass Zeilen in der Regel mit einem Semikolon abgeschlossen werden m\u00fcssen. Ferner m\u00fcssen Variablen immer vorher mit var<\/em> oder let<\/em> definiert werden. Daf\u00fcr ist Javascript ausgesprochen tolerant bei Variablentypen wie String oder Float.<\/p>\n

Das Sch\u00f6ne ist, dass es bei Node-Red bereits existierende Verkn\u00fcpfungen (Interface-Nodes) mit dem Raspberry Pi (GPIO), dem MQTT Protokoll, One Wire Sensoren, Datenbanken und externen Diensten (Wetter,\u00a0 Astronomie etc.) gibt. Die selbst entwickelten Logiken bzw. Abl\u00e4ufe lassen sich \u00fcber ein Dashboard visualisieren. Auch einfache Diagramme zur Wertedarstellung sind m\u00f6glich. Wenn man etwas tiefer einsteigt, sind wirklich sehr h\u00fcbsche und funktionale Panels realisierbar.<\/p>\n

Der erste Schritt ist die Installation von Node-Red auf dem Raspberry Pi. Das Ganze ist hier sehr gut (auf englisch) beschrieben: https:\/\/nodered.org\/docs\/getting-started\/raspberrypi<\/a><\/p>\n

Weiterf\u00fchrende Tutorials gibt es tonnenweie (meist auf englisch) im Internet.<\/p>\n

\"\"<\/a>
Mein Energie-Dashboard mit Heizkreis-Temperatureinstellung<\/figcaption><\/figure>\n

Geplant bzw. verf\u00fcgbar sind in diesem Blog folgende Artikel:<\/p>\n