Autoterm Heizgerät Protokoll

Erkenntnisse stammen aus folgenden Community-Projekten:

• Grimoire314 — Autoterm/Planar Reverse Engineering
• schroeder-robert/autoterm-air-2d-serial-control
• prclm/AutotermHeaterController (sowie der kalutep-Fork)
• Pekaway/VAN_PI (Node-RED-Flow)
• csreades/AutothermDieselRepeater

Autoterm-Heizgeräte stellen ein einfaches binäres Anfrage/Antwort-Protokoll über eine 5V-UART-Verbindung bereit. Das Bedienteil fragt das Heizgerät zyklisch mit einer Statusanfrage und einem Heartbeat mit Paneltemperatur ab und sendet bei Bedarf Steuerungs-Frames (Start, Stopp, Einstellungen, Lüftung).

Übertragungsschicht

Zur automatischen Erkennung der Baudrate kann eine Statusanfrage bei jeder Kandidatenrate gesendet werden; die Rate, bei der eine gültige Antwort zurückkommt, ist die konfigurierte.

Rahmenformat

Alle Frames verwenden dieselbe Hülle:

Beispiel: AA 03 06 00 01 01 ... 05 CC CC
          │  │  │  │  │  └───────┘ └───┘
          │  │  │  │  │      │       │
          │  │  │  │  │      │       └── CRC-16/Modbus (Big-Endian)
          │  │  │  │  │      └────────── Payload (Länge = Byte 2)
          │  │  │  │  └───────────────── Befehls-ID
          │  │  │  └──────────────────── Reserviert (immer 0x00)
          │  │  └─────────────────────── Payload-Länge
          │  └────────────────────────── Richtung
          └───────────────────────────── Präambel (immer 0xAA)

CRC-16/Modbus-Parameter: Polynom 0xA001, Initialwert 0xFFFF, keine Spiegelung des Ergebnisses. Die CRC wird Big-Endian übertragen — das High-Byte geht zuerst über die Leitung, entgegen der bei den meisten Modbus-Implementierungen üblichen Byte-Reihenfolge.

Antworten

Jeder Bedienteil → Heizgerät-Befehl erhält eine Antwort mit Richtung = 0x04 und derselben Befehls-ID in Byte 4. Die Payload der Antwort folgt einem von drei Mustern: strukturierte Daten (0x0F Status, 0x02 Lesen), ein Payload-Echo der Anfrage (0x01, 0x02 Schreiben, 0x11, teilweise 0x23), oder leer (0x03). Die genauen Bytes finden sich beim jeweiligen Befehl.

Antwort-Payload-Inhalte abseits von 0x0F Status und 0x02 Lesen stammen aus Community-Reverse-Engineering-Aufzeichnungen und sind nicht unabhängig verifiziert.

Befehle

0x01 — Start

Startet einen neuen Heizzyklus aus dem Standby. Die 6-Byte-Payload entspricht der von Einstellungen (0x02); die Feldbelegung ist dort beschrieben.

TX  AA 03 06 00 01 01 00 04 00 00 05 <CRC>      ; Beispiel: Leistungsmodus, Stufe 5
RX  AA 04 06 00 01 01 00 04 00 00 05 <CRC>      ; Heizgerät echot die übernommenen Einstellungen

Der Zustand wechselt anschließend bei den folgenden Statusabfragen von Startphase zu Heizen.

0x02 — Einstellungen

Befehl 0x02 hat zwei Varianten:

• Schreiben (6-Byte-Payload) — aktualisiert Parameter eines laufenden Heizgeräts, ohne es neu zu starten.
• Lesen (leere Payload) — fragt die aktive Konfiguration des Heizgeräts ab. Das Heizgerät antwortet mit einer 6-Byte-Payload in derselben Feldbelegung.

AA 03 06 00 02 01 00 02 14 01 05 CC CC      ; Schreiben: useWT=1, Quelle=Panel, Soll=20°C, Wartemodus=an, Stufe=5
AA 03 00 00 02 9D BD                        ; Leseanfrage
AA 04 06 00 02 01 00 02 14 01 05 <CRC>      ; Leseantwort (gleiche Feldbelegung)

Die Leseform beim Start abzufragen, stellt nach einem Neustart des Controllers den aktiven Modus, Sollwert und die Leistungsstufe wieder her; zyklisches Abfragen erkennt Änderungen, die ein anderer Controller am Bus vorgenommen hat. OEM-Bedienteile fragen sie alle paar Sekunden ab.

0x03 — Stopp

Stoppt das Heizgerät. Der Zustand wechselt über die folgenden Abfragen von Abschalten zu Abkühlen zu Standby.

TX  AA 03 00 00 03 5D 7C
RX  AA 04 00 00 03 29 7D      ; Quittung mit leerer Payload

Keine Anfrage-Payload; die Antwort enthält ebenfalls keine Payload.

0x0F — Status

Fragt den aktuellen Zustand und die Sensorwerte des Heizgeräts ab.

Anfrage (keine Payload):

AA 03 00 00 0F 58 7C

Antwort (19-Byte-Payload):

AA 04 13 00 0F  03 00 00 0A 7F 00 84 01 B2 04 00 37 37 00 6D 00 6D 00 64  C3 0A
                │  │     │  │           └──┴── Wärmetauschertemperatur (K)
                │  │     │  └────────────────── externer Temperatursensor
                │  │     └───────────────────── interne Temperatur
                │  └─────────────────────────── Zustand Minor
                └────────────────────────────── Zustand Major

Dekodierungsbeispiel

Für den obigen Antwort-Frame:

Zustand:       Major=0x03, Minor=0x00 → Heizen
Intern:        0x0A = 10 → 10°C
Extern:        0x7F → Sensor nicht angeschlossen
Wärmetauscher: 0x01B2 = 434 → 434 − 273 = 161°C
Lüfter:        0x6D = 109 → 109 × 60 = 6540 RPM
Pumpe:         0x6D = 109 → 109 × 0.01 = 1,09 Hz

0x11 — Paneltemperatur / Heartbeat

Überträgt die Paneltemperatur an das Heizgerät und dient zugleich als verpflichtender Heartbeat. Das Bedienteil muss diesen unabhängig von der konfigurierten Temperaturquelle einmal pro Sekunde senden; das Heizgerät meldet nach etwa drei Sekunden Stille einen „Kein Panel"-Fehler. Das Heizgerät schickt denselben Frame als Bestätigung zurück.

AA 03 01 00 11 1A 76 D0      ; Anfrage: Paneltemperatur = 26°C
AA 04 01 00 11 1A B6 65      ; Echo

Im Modus Temperaturquelle = 0x02 (Panel) ist das Byte der Wert, gegen den das Heizgerät regelt. In allen anderen Modi ist das Byte weiterhin erforderlich, aber rein informativ — 0x7F ist die übliche Wahl und das, was OEM-Bedienteile senden, wenn kein Panelsensor verbaut ist.

0x23 — Lüftung

Betreibt nur den Lüfter, ohne Zündung.

TX  AA 03 04 00 23 FF FF 08 FF E1 0B      ; Lüftungsstufe 8
RX  AA 04 04 00 23 FF FF 08 43 B6 4B      ; Bytes 0–2 spiegeln die Anfrage, Byte 3 weicht ab

Feld-Referenz

Temperaturquelle

Heizgerätestatus

Wird als (Major, Minor)-Paar in der Statusantwort kodiert. Das Major-Byte beschreibt die übergeordnete Phase; das Minor-Byte einen Unterschritt.

Timing

Betriebsabläufe

Initialisierung — Heizgerätestatus ermitteln

Nachdem der Controller (neu) verbunden hat, weiß er nicht, ob das Heizgerät im Standby, mitten im Heizbetrieb oder im Abschaltvorgang ist. Zur Synchronisation:

1. 0x11 senden — stellt die Verbindung her und bestätigt die Baudrate.
2. 0x0F senden — liefert den aktuellen Betriebszustand.
3. 0x02 Lesen senden — liefert den aktiven Modus, Sollwert und die Leistungsstufe.

Ab hier wechselt der Controller in den unten beschriebenen zyklischen Abfragetakt.

Zyklische Abfrage

Im Sekundentakt:

1. Bedienteil → Heizgerät: 0x11 mit aktueller Paneltemperatur (oder 0x7F, falls kein Panelsensor)
2. Heizgerät → Bedienteil: Heartbeat-Echo
3. Bedienteil → Heizgerät: 0x0F
4. Heizgerät → Bedienteil: Statusantwort

0x02 Lesen kann alle paar Sekunden zusätzlich gesendet werden, um Einstellungsänderungen anderer Controller am Bus zu erkennen.

Heizen mit Leistungsstufe 5 starten

1. Bedienteil → Heizgerät: 0x01 mit Payload 01 00 04 00 00 05
2. Heizgerät → Bedienteil: 0x01-Antwort, die die 6-Byte-Einstellungs-Payload echot
3. Folgende Abfragen zeigen den Zustandswechsel von Startphase zu Heizen.

Leistungsstufe im laufenden Betrieb ändern

1. Bedienteil → Heizgerät: 0x02 Schreiben mit neuer Leistungsstufe in Payload-Byte 5
2. Heizgerät → Bedienteil: 0x02-Antwort, die die 6-Byte-Einstellungs-Payload echot

Stopp

1. Bedienteil → Heizgerät: 0x03
2. Heizgerät → Bedienteil: 0x03-Antwort mit leerer Payload
3. Der Zustand wechselt über die folgenden Abfragen von Abschalten zu Abkühlen zu Standby.