Vaillant X6 Schnittstelle: Unterschied zwischen den Versionen
Mali (Diskussion | Beiträge) |
Mali (Diskussion | Beiträge) |
||
| Zeile 338: | Zeile 338: | ||
|Nicht unterstützt, nicht vorhanden? | |Nicht unterstützt, nicht vorhanden? | ||
|} | |} | ||
| + | |||
| + | |||
===Kodierung von Werten=== | ===Kodierung von Werten=== | ||
| Zeile 368: | Zeile 370: | ||
00 = Inktiv | 00 = Inktiv | ||
01 = Aktiv | 01 = Aktiv | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | ==Links== | ||
| + | |||
| + | * http://www.hx7.net/vaillant/ - Daten auswerten, von hinten durch die Brust ins Auge ;-) | ||
Version vom 9. Jänner 2010, 17:08 Uhr
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.
Inhaltsverzeichnis
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
Links
- http://www.hx7.net/vaillant/ - Daten auswerten, von hinten durch die Brust ins Auge ;-)
