Vaillant X6 Schnittstelle

Auf der mit X6 beschrifteten Buchse liegt ein RS232-Signal mit TTL-Pegeln an. Die Geräte kommunizieren mit 9600 Baud (8N1, keine Flusskontrolle). Normalerweise wird über diese Buchse ein PC angeschlossen, auf dem das Programm vrDIALOG ausgeführt wird, oder ein Kommunikationsmodul für das vrNetDIALOG-System.

Eine Beta-Version des Programms vrDIALOG findet man mit Google (Stand 06.01.10). Die Kommunikation des Programms mit dem Heizgerät lässt sich mit entsprechenden Tools beobachten.

Solange es kein spezielles Modul für das Ethersex-System gibt, kann YPort verwendet werden. Das Heizgerät kann dann von eigener Software aus oder mit Hilfe eines gemappten COM-Ports auch von vrDIALOG aus angesprochen werden.

Belegung

       +---------+
    6  ---       |
GND 5  ---       +--+
TXD 4  ---          |
RXD 3  ---          |
    2  ---       +--+
    1  ---       |
       +---------+

Blick auf die Buchse (!)

Protokoll

Die Kommunikation scheint immer vom angeschlossenen PC (oder Ethersex?) auszugehen. Die Nachrichten in beide Richtungen haben ein ähnliches Format:

Es gibt kein Zeilenende wie CR oder CR+LF.

Aufbau der Nachrichten

Alle Nachrichten haben ein gemeinsames Format:

Bytes
  1     2     3 ... n-1   n
+-----+-----+----    ---+-----+
| Len | ?   | Data      | Chk |
+-----+-----+----    ---+-----+

Byte 1  Gesamtlänge der Nachricht ("n" Bytes, Längenbyte, Nachrichtentyp und Prüfsumme
        sind dabei mitgezählt)

Byte 2  Evtl. sowas wie ein Nachrichtentyp oder eine Zieladresse:
        0x00 Normale Nachrichten
        0x01 Fehlermeldung Checksum-Fehler?
        0x02 ? - Verwendet bei der Abfrage der Version des Heizgeräts
        0x03 Fehlermeldung?
        0x0a ? - Verwendet bei der Abfrage der Version des Reglers

Byte 3  Daten, beinhalten die eigentliche Anforderung an das Gerät, die angeforderten
.. n-1  Werte, oder sonstige Informationen.

Byte n  Prüfsumme

Prüfsumme

Zur Berechnung der Checksum werden die Bytes nacheinander XOR-verknüpft und das Zwischenergebnis dann jeweils um 1 bit nach links verschoben:

sub checksum
  {
  my $string = $_[0];
  my $checksum; 

  for (my $i = 0; $i < length($string); $i++)
    {
    if ($checksum & 0x80)
       {
       $checksum = ($checksum << 1 | 1) & 0xFF;
       # ???
       $checksum = $checksum ^ 0x18;
       }
    else
       {
       $checksum = $checksum << 1;
       }
    $checksum = $checksum ^ ord(substr($string, $i, 1));
    }
  return $checksum;
  }

Den Quelltext darf gerne mal jemand in C konvertieren ;-) ...

Beim Finden des Algorithmus waren kurze Nachrichten wie 03 03 05 und 03 01 07 nützlich. Es fiel dann aber auf, dass die Berechnung immer dann zu einem anderen Ergebnis führt, wenn das Zwischenergebnis im Verlauf der Berechnung größer als FFh (127) wird. In der Nachricht 07 00 00 00 98 05 CC ist dies erst beim letzten Datenbyte der Fall. Von dort konnte man also zurückrechnen, was man am Zwischenergebnis ändern muss, um letztendlich auf die gleiche Prüfsumme zu kommen wie das Gerät. Diese Änderung ist genau ein XOR mit 18h. Siehe auch [1] und [2].

Befehle

Die bekannten Befehlsnachrichten sind 7 Byte lang und haben einen einheitlichen Aufbau. Dem 1 Byte langen Befehl werden zwei Null-Bytes vorangestellt, dann folgt ein Byte, das die Länge der erwarteten Daten angibt:

00 00 98 05

Der resultierende String wird nach dem oben geschilderten Aufbau von Nachrichten verpackt. Dabei ist das noch unbekannte Byte 2 ebenfalls "00h". Es ergibt sich:

07 00 00 00 98 05 CC

Was das Byte angeht, das die Datenlänge angibt, bin ich noch nicht ganz sicher. Mein Gerät scheint es nicht allzu ernst zu nehmen. Verändert man das entsprechende Byte in der Anfrage, sendet weiterhin die ursprüngliche Anzahl von Bytes und somit eine andere Zahl von Bytes als angefordert:

07 00 00 00 98 03 CA
08 00 02 2A FD D5 00 37

Liste der Befehle

Befehl	Funktion	Datenbytes	Typ
01h	Sollwert Brauchwassertemperatur	2	Ein Analogwert (2 byte)
03h	Unbekannter Statuswert	1	Status (F0h/0Fh)
04h	Sollwert Speicher	2	Ein Analogwert (2 byte)
05h	Flammsignal	1	Status (F0h/0Fh)
08h	Sommer/Winter-Schalter	1	Status (Sommer/Winter)
0Eh	Status Raumthermostat	1	Status (00h/01h)
17h	Speichertemperatur	3	Ein Analogwert (2 byte) + ein Sensorstatus
18h	Vorlauftemperatur	3	Ein Analogwert (2 byte) + ein Sensorstatus
1Fh	Anzahl GFA Störungen	1	Ein Analogwert (1 byte)
20h	Anzahl STB Abschaltungen	1	Ein Analogwert (1 byte)
24h	Drehzahlsollwert	2	Ein Analogwert (2 byte)
25h	Sollwert Vorlauf Ext. Regler 7-8-9	2	Ein Analogwert (2 byte)
38h	Verbleibende Brennersperrzeit	1	Ein Analogwert (1 byte)
39h	Sollwert Vorlauftemperatur	2	Ein Analogwert (2 byte)
3Fh	Status externe Heizungspumpe	1	Status (00h/01h)
42h	Stellung VUV	1	Status (?)
44h	Status interne Heizungspumpe	1	Status (00h/01h)
48h	Status Gasmagnetventil	1	Status (F0h/0Fh)
49h	Status Zünder	1	Status (F0h/0Fh)
53h	Status Unbekannt	1	Status (F0h/0Fh)
58h	Anforderung Warmwasser C1/C2	1	Status (00h/01h)
63h	Wasserpumpennachlaufzeit nach Speicherladung	1	Ein Analogwert (1 byte)
65h	Korrekturwert Aussentemperatur	1	Ein Analogwert (1 byte)
66h	Speicherladezeit	1	Ein Analogwert (1 byte)
6Ah	Aussentemperatur	3	Ein Analogwert (2 byte) + ein Sensorstatus
6Bh	Ext. Vor-/Rücklauftemperatur	3	Ein Analogwert (2 byte) + ein Sensorstatus
6Ch	Heizungsteillast	1	Ein Analogwert (1 byte)
6Fh	Zähler 3 Zündversuche	1	Ein Analogwert (1 byte)
71h	Status Speicherfreigabe Schaltuhr	1	Status (00h/01h)
83h	Drehzahlistwert	2	Ein Analogwert (2 byte)
98h	Rücklauftemperatur	5	Zwei Analogwerte (2 x 2 byte) + ein Sensorstatus
9Ah	Unbekannter Temperaturwert	5	Zwei Analogwerte (2 x 2 byte) + ein Sensorstatus
9Dh	Offset Warmstartsollwert	1	Ein Analogwert (1 byte)
9Eh	Status Speicherladepumpe	1	Status (00h/01h)
A1h	Sollwert interne Heizungspumpe	1	Status (00h/01h)
A5h	Max. Vorlauftemperatur	1	Ein Analogwert (1 byte)
A9h	Unbekannter Wert	1	Ein Analogwert (1 byte)
AFh	Status Zirkulationspumpe	1	Status (00h/01h)
B3h	Status Rücklaufregelung	1	Status (00h/01h)
C3h	Hyterese Solarpumpe	1	Ein Analogwert (1 byte)

Andere Befehle

Nicht alle Befehle passen in das genannte Schema.

07 02 00 00 00 04 C4

Fragt nach angeschlossenen Geräten? In meinem Fall meldet das Gerät anscheinend seine Versionsnummer, die von vrDIALOG als "0153_07.00" angezeigt wird:

07 02 00 00 00 04 C4
08 00 00 99 07 00 14 96

Bei diesem Befehl ist die Anzahl der zurückgelieferten Bytes nicht gleich dem als viertem Bytes gesendeten Wert "04". Weiterhin hat das unbekannte Byte 2 den Wert "02h".

Anworten des Geräts

Das Gerät anwortet mit Nachrichten, die den oben angegebenen Aufbau haben. Dabei das unbekannte Byte 2 anzugeben, ob es sich um eine "normale" Antwort ("00h") oder um eine andere Antwort handelt.

Normale Antworten

Bei normalen Antworten hat Byte 2 den Wert "00h". Ab Byte 3 folgenden dann die angeforderten Daten. Hierbei werden verschiedene Kodierungen verwendet. Analogwerte werden in einem oder zwei Bytes kodiert, je nach Befehl werden ein oder zwei derart kodierte Analogwerte zurückgegeben. Für Statusmeldungen scheint es verschiedene Kodierungen zu geben, die jeweils ein Byte verwenden.

Andere Antworten

Nachricht	Bedeutung
03 01 07	Checksummenfehler?
03 03 05	Nicht unterstützt, nicht vorhanden?

Kodierung von Werten

In den Antworten des Heizgeräts sind verschiedene Informationen kodiert. Vermutlich ist das Format der zurückgelieferten Daten eindeutig mit dem anfordernden Befehl verbunden.

Temperaturen

Es scheint zwei Möglichkeiten zu geben, Temperaturen zu kodieren. Sollwerte (Grenzwerte?) sind teilweise in einem Byte kodiert, während andere Sollwerte und Messwerte in zwei Bytes kodiert sind: Das zuerst gesendete Byte ist das höherwertige Byte. Der erhaltene Zahlenwert entspricht der Temperatur in 1/16°C. Negative Werte werden in Zweikomplement-Darstellung übertragen.

Beispiel

52h   =   82d =>  82 °C
0230h =  560d =>  560/16 °C =  35,00 °C
FF21h = -223d => -223/16 °C = -13,94 °C

Sensorstatus

00 = kein Fehler
55 = Kurzschluss
AA = Unterbrechung

Schaltzustand

F0 = Inaktiv
0F = Aktiv

oder

00 = Inktiv
01 = Aktiv