VBus-Decoder

Aus Hobbyelektronik.org
Das Corpus Delicti

Bei der Solaranlage meiner Eltern übernimmt ein Viessmann Vitosolic 200 die Regelung. Nach kurzer Recherche stellte sich heraus, dass es sich um eine etwas angepasste Version des RESOL DeltaSol® M handelt.

Statt der RS-232-Schnittstelle hat das Teil einen Anschluss für den Viessmann-eigenen KM-Bus, zu dem mir keinerlei Informationen bekannt sind.

Beim VBus sieht es deutlich besser aus. In der Diskussion auf Mikrocontroller.net bin ich auf den Beitrag von Daniel Wippermann gestoßen, woraufhin ich an die angegebene Adresse eine E-Mail geschickt habe.

Keine zweieinhalb Stunden später habe ich die Dokumentation (inklusive der Erlaubnis zur Veröffentlichung, siehe Download) zum Protokoll erhalten.

Irgendwann nach der Erstveröffentlichung dieses Artikels entstand eine deutlich erweiterte Dokumentation auf den Github-Seiten von Daniel Wippermann. Nicht nur das, sondern auch eine Implementierung des Protokolls in Javascript.

Hardware-Schnittstelle

Wo Rx und Tx ist, muss erraten werden ;)

Bei dem VBus handelt es sich um eine bidirektionale halbduplex Zweidrahtschnittstelle, die - entgegen mancher Meinungen - überhaupt keine Ähnlichkeiten mit RS-485 hat.

Bei ein paar Reglern scheint Resol eine RS-485-Schnittstelle mit VBus-Protokoll zu verwenden, die mit den hier vorgestellten Schaltungen nicht kompatibel ist. Bitte vor dem Nachbau der Hardware prüfen, um welches System es sich handelt. Dies kann entweder mit Hilfe des Handbuchs in Erfahrung gebracht werden (Angabe der Spannung und Strom, bei RS-485 ist üblicherweise keine Stromversorgung vorhanden) oder durch Messung ermittelt werden: An den VBus-Klemmen sollte eine (zappelnde) Spannung von ca. 8 V anliegen.

Der Master (Regel-Einheit) versorgt den Bus mit etwa 8,2 V und 35 mA (S. 4 in der Doku). Die Daten werden durch Spannungsabsenkung auf dem Bus übertragen. Mit der Schaltung auf Seite 5 des PDFs kann auf dem Bus sowohl gelesen, als auch geschrieben werden. Im Bild rechts meine Interpretation der Schaltung (in der noch die Abblockkondensatoren fehlen).

Über die Buchse links kann man sich mit UART (nicht RS-232!) mit 9600 Baud, 8 Datenbits, 1 Stoppbit ohne Parität mit dem Master unterhalten.

Der in meiner Schaltung verwendete FET für die bidirektionale Kommunikation ist übrigens ein BS170; wobei der Typ nicht kritisch ist, solange er den Bus kurzschließen kann, ohne dabei in Rauch aufzugehen.

Protokoll

Das Protokoll des VBus ist in seiner Version 1.0 ziemlich gut handzuhaben.

Folgendes Daten habe ich zum Testen verwendet:

0xAA, 0x10, 0x00, 0x21, 0x73, 0x10, 0x00, 0x01, 0x12, 0x38,
0x5E, 0x04, 0x5E, 0x01, 0x05, 0x39,
0x45, 0x01, 0x38, 0x22, 0x04, 0x5B,
0x38, 0x22, 0x38, 0x22, 0x05, 0x46,
0x6C, 0x01, 0x38, 0x22, 0x05, 0x33,
0x38, 0x22, 0x38, 0x22, 0x05, 0x46,
0x38, 0x22, 0x38, 0x22, 0x05, 0x46,
0x00, 0x00, 0x00, 0x00, 0x00, 0x7F,
0x00, 0x00, 0x00, 0x00, 0x00, 0x7F,
0x00, 0x00, 0x00, 0x00, 0x00, 0x7F,
0x38, 0x0F, 0x00, 0x00, 0x01, 0x37,
0x47, 0x00, 0x00, 0x00, 0x00, 0x38,
0x64, 0x64, 0x00, 0x00, 0x00, 0x37,
0x00, 0x00, 0x00, 0x00, 0x00, 0x7F,
0x00, 0x00, 0x00, 0x00, 0x00, 0x7F,
0x00, 0x00, 0x43, 0x00, 0x00, 0x3C,
0x00, 0x00, 0x02, 0x00, 0x00, 0x7D,
0x01, 0x03, 0x60, 0x02, 0x04, 0x15,
0x02, 0x00, 0x00, 0x00, 0x00, 0x7D,

Zu allererst wird ein 10 Byte langer Kopf gesendet, der mit einem eindeutigen Sync-Wort (0xAA) beginnt. Eindeutig heißt: An keiner anderen Stelle im Protokoll wird dieses Zeichen verwendet (bzw. das MSB belegt). Man kann sich also zu jedem beliebigen Zeitpunkt in den Bus einklinken!

Gefolgt vom Sync-Wort kommen Ziel- und Quelladresse (0x0010 <= 0x7321), die Protokollversion (0x10), der ausgeführte Befehl (0x0100) und die Anzahl der danach folgenden Nutzdatenframes (0x12). Abschließend wird eine Prüfsumme (0x38) der zuvor gesendeten Daten übertragen.

Im Anschluss an den Header wird die im Header angegebene Anzahl an Datenframes mit je 6 Byte Länge geschickt (Auszug von oben):

0x5E, 0x04, 0x5E, 0x01, 0x05, 0x39,

Die ersten 4 enthalten Nutzdaten, im 5. wird ein Septett geschickt und abschließend erfolgt wieder eine Prüfsumme.

Das Septett ist eine Ergänzung der zuvor gesendeten Nutzdaten. Da, wie oben erwähnt, das MSB nur im Sync-Wort vorkommen darf, ist es für die folgende Daten kein verboten - dieses findet sich jeweils in diesem zusätzlichen Byte.

Die Prüfsumme der einzelnen Nachrichtenteile wird mittels CRC8 berechnet.

Das ist auch schon das Gröbste. Mit Protokollversion 2.0 und 3.0 habe ich mich noch nicht auseinandergesetzt, da diese zum Erfassen der Messwerte nicht benötigt werden.

Adressen

Wie in vielen Bussystemen verwendet auch der VBus Pakete für die Nachrichten. Zu den Informationen in der PDF-Spezifikation sei an der Stelle auch auf die Paketbeschreibung verwiesen.

Die für den bei uns eingesetzten Regler lautet die Adresse 0x7321 (Vitosolic 200 [Regler]), die für das Logging relevanten Daten gehen an 0x0010 und werden in der Dokumentation lediglich als DFA beschrieben. Dabei handelt es sich nicht um eine komische Umschreibung für einen Broadcast, sondern um die Daten für ein zusätzliches Gerät - der Datenfernanzeige.

An diese sendet der Regler alle von ihm gemessenen Werte. Neben der Regler-Identität hat der Vitosolic 200 noch die Identitäten WMZ1 und WM2 (Wärmemengenzähler).

Hardware

Im Laufe der Zeit haben sich mehrere Schaltungen ergeben. Um diesen Artikel übersichtlich zu halten, wurden die verschiedenen Varianten auf Unterseiten aufgeteilt:

(Die Links zu den Unterseiten sind befinden sich jeweils in den Überschriften)

Adapter für RS-232

Wenn man noch einen PC oder Adapter hat der RS-232 spricht, kann sich dieser Hardware bedienen.

Der Zugriff ist nur lesend möglich und es gibt keine galvanische Trennung zwischen Bus und DTE.

Adapter Nano

Die vermutlich universellste Variante - schön klein, galvanische Trennung und funktioniert auf der Empfängerseite ab 3,3 V.

Adapter für den Raspberry Pi

Wer Geräte ins Netzwerk bringen will, hat meistens auch einen Einplatinencomputer der Raspberry Pi Foudation auf der Liste.

Versionen

Adapter für den ESP8266

Noch etwas kleiner als für den Raspberry Pi: Ein Adapter mit ESP8266-Modulen.

Troubleshooting

Für die Schaltung des Adapter Nano gibt es eine Troubleshooting-Anleitung, die in Teilen auch für die 5 V-Version der Raspberry-Pi-Variante gültig ist.

FAQ

(bitte auf die Überschrift klicken)

Software

AVR8

Zur Datenauswertung und für einfache, zusätzliche, Regelaufgaben (wie zum Beispiel Deaktivieren der Heizung, wenn die Solaranlage den Speicher belädt) - oder um die Anlage ins Internet of Things zu bekommen sind Mikrocontroller sehr geeignete Komponenten.

Eine Implementierung für die AVR8-Plattform findet sich auf der entsprechenden Unterseite.

Python

Nicki hat sich die Arbeit gemacht und einen Code zum Auswerten der Nachrichten in Python portiert. Ich hatte selbst noch keine gute Gelegenheit, ihn zu testen - daher ohne Garantie, Gewährleistung oder Support:

Oliver hat basierend auf dem Code von Nicki eine Schnittstelle zur Volkszähler-Middleware gebaut:

Der Code nutzt die Resol-Decoder-Lib von Nicki, die ist auch mit dabei.
In der config.py stellt man die Adresse der Middleware in seinem Netzwerk, 
sowie die UUID der Kanäle ein, damit man die Daten referenzieren kann.
(Zum Test kann man auch simulierte Daten nutzen, oder die Ausgabe in ein File schreiben lassen)

Protokoll-Analysator

Da es mehrere Anfragen zur Untersuchung des Protokolls gab, habe ich vor einer Weile einen kleinen Protokollanalysator zusammengestrickt. Dieser unterstützt aktuell Protokollversion 1.0 und ist als "gefährliche Beta" anzusehen: Resol Protocol Analyzer

Downloads

An dieser Stelle noch einmal vielen Dank an Resol für die Bereitstellung der Informationen und die Erlaubnis, diese hier weiter zu verteilen!

Weblinks