Neues TIN-Protokoll

Übersicht

Das Neues TIN-Protokoll wird von modernen Truma-Heizgeräten verwendet (TIN 4.0, ab Mitte 2018). Im Gegensatz zum Legacy TIN-Protokoll mit separaten Befehls-Frames verfügt Neues TIN über eine einheitliche Befehlsstruktur, bei der alle Heizungsparameter in einem einzigen Frame gesendet werden.

Dieses Protokoll wird verwendet von:

• Modernen Truma Combi-Heizgeräten (ab 2018)
• InetX-Bedienfeldern
• iNet X Connect-Fernsteuerungsmodulen
• Modernen Aventa-Klimaanlagen

Signal-Frame-Typen

Heater Command (0x20)

Der einheitliche Befehls-Frame zur Steuerung aller Heizungsfunktionen.

Frame-Struktur

Byte 0: Raumtemperatur-Code

Die Temperatur wird über folgende Formel codiert:

code = (220 + (temp - 5) * 10) % 256
temp = ((code - 220) % 256) / 10 + 5

Sonderfall: 0xAA = Aus

Temperaturbereich: 5-30°C (in 1°C-Schritten)

Byte 1: Steuerflags

Gängige Werte:

• 0x2A (0010 1010): Boiler AN, Heizung AUS
• 0x2B (0010 1011): Boiler AN, Heizung AN
• 0xAA (1010 1010): Boiler AUS, Heizung AUS
• 0xAB (1010 1011): Boiler AUS, Heizung AN

Byte 2: Wassertemperaturstufe

Byte 3: Kraftstoff-Steuerung

Byte 4: Elektro-Leistungsstufe

Byte 5: Lüftung + Energie-Bitmap

Oberes Nibble (Bits 4-7): Lüftungsstufe

Unteres Nibble (Bits 0-3): Energie-Bitmap

Gängige Muster:

• 0xB0 = Comfort-Modus, keine Energie
• 0xB1 = Comfort-Modus, nur Kraftstoff
• 0xB2 = Comfort-Modus, nur Elektro
• 0xB3 = Comfort-Modus, Kraftstoff + Elektro (Mix)

Bytes 6-7: Feste Werte

• Byte 6: Immer 0xE0
• Byte 7: Immer 0x0F

Beispiel-Frames

Alles aus:

[0xAA] [0xAA] [0xAA] [0x00] [0x00] [0x00] [0xE0] [0x0F]

Raum auf 22°C heizen, Wasser Eco, nur Kraftstoff, Comfort-Lüfter:

[0x86] [0x2B] [0xC3] [0xFA] [0x00] [0xB1] [0xE0] [0x0F]
 │      │      │      │      │      │
 │      │      │      │      │      └─ Comfort-Modus (0xB), Kraftstoff-Bit gesetzt (0x1)
 │      │      │      │      └─ Elektro aus
 │      │      │      └─ Kraftstoff aktiviert
 │      │      └─ Wasser Eco (40°C)
 │      └─ Boiler an (Bit 7=0), Heizung an (Bit 0=1), Muster 0x2A
 └─ Raum 22°C

Raum auf 28°C heizen, Wasser Hot, Mix-Modus (Kraftstoff + 900W), Boost-Lüfter:

[0xC2] [0x2B] [0xD0] [0xFA] [0x09] [0xD3] [0xE0] [0x0F]
 │      │      │      │      │      │
 │      │      │      │      │      └─ Boost-Modus (0xD), Kraftstoff + Elektro-Bits (0x3)
 │      │      │      │      └─ Elektro 900W
 │      │      │      └─ Kraftstoff aktiviert
 │      │      └─ Wasser Hot (60°C)
 │      └─ Boiler an, Heizung an
 └─ Raum 28°C

Nur Wasserheizung (keine Raumheizung), Hot-Wasser, Kraftstoff:

[0xAA] [0x2A] [0xD0] [0xFA] [0x00] [0x01] [0xE0] [0x0F]
 │      │      │      │      │      │
 │      │      │      │      │      └─ Lüfter aus, Kraftstoff-Bit gesetzt
 │      │      │      │      └─ Elektro aus
 │      │      │      └─ Kraftstoff aktiviert
 │      │      └─ Wasser Hot
 │      └─ Boiler an, Heizung aus
 └─ Raumheizung aus

Manuelle Lüftungsstufe 5, keine Heizung:

[0xAA] [0xAA] [0xAA] [0x00] [0x00] [0x50] [0xE0] [0x0F]
                                     │
                                     └─ Stufe 5 (0x5), keine Energie

Heater Info 1 (0x21)

Meldet aktuelle Raum- und Wassertemperaturen.

Frame-Struktur

Temperatur-Codierung

Temperaturen werden als 12-Bit-Werte codiert, die Kelvin × 10 darstellen, gepackt in 3 Bytes.

Raumtemperatur:

raum_codiert = (byte1 & 0x0F) << 8 | byte0
raum_celsius = (raum_codiert / 10.0) - 273.0

Wassertemperatur:

wasser_codiert = byte2 << 4 | (byte1 & 0xF0) >> 4
wasser_celsius = (wasser_codiert / 10.0) - 273.0

Beispiel-Frame

Raum bei 22,5°C, Wasser bei 45,3°C:

Schritt 1: Temperaturen codieren

raum_kelvin_x10 = (22,5 + 273,0) × 10 = 2955
wasser_kelvin_x10 = (45,3 + 273,0) × 10 = 3183

Schritt 2: In Bytes packen

raum_codiert = 2955 = 0x0B8B (12-Bit)
  byte0 = 0x8B (untere 8 Bits)
  byte1_low = 0x0B (obere 4 Bits)

wasser_codiert = 3183 = 0xC6F (12-Bit)
  byte2 = 0xC6 (obere 8 Bits)
  byte1_high = 0x0F (untere 4 Bits)

byte1 = (0x0F << 4) | 0x0B = 0xFB

Frame:

[0x8B] [0xFB] [0xC6] [0x00] [0x00] [0x00] [0x00] [0x00]
 │      │      │
 │      │      └─ Wasser obere 8 Bits (0xC6)
 │      └─ Raum obere 4 Bits (0x0B) + Wasser untere 4 Bits (0x0F)
 └─ Raum untere 8 Bits (0x8B)

Decodierungs-Beispiel

Gegebener Frame: [0x9F] [0xBB] [0xB7] [0x28] [0x12] [0x02] [0xF0] [0x0F]

Raumtemperatur:

raum_codiert = ((0xBB & 0x0F) << 8) | 0x9F
             = (0x0B << 8) | 0x9F
             = 0x0B9F = 2975
raum_celsius = 2975 / 10.0 - 273.0 = 24,5°C

Wassertemperatur:

wasser_codiert = (0xB7 << 4) | ((0xBB & 0xF0) >> 4)
               = (0xB7 << 4) | 0x0B
               = 0xB7B = 2939
wasser_celsius = 2939 / 10.0 - 273.0 = 20,9°C

Heater Info 2 (0x22)

Meldet Stromversorgungsstatus und Boilerzustand.

Frame-Struktur

Byte 0: Spannung

Codierung: Spannung × 100mV

Beispiel:

• 0x84 = 132 → 13,2V
• 0x85 = 133 → 13,3V
• 0x77 = 119 → 11,9V

Byte 1: System-Flags

Gängige Werte:

• 0x20: 230V vorhanden, Pumpe aus
• 0x60: 230V vorhanden, zusätzliches Flag gesetzt
• 0x70: 230V vorhanden, Pumpe läuft
• 0x30: 230V vorhanden, anderer Status

Byte 2: Boiler-Zustand

Beispiel-Frames

13,2V, 230V vorhanden, Eco-Temperatur erreicht:

[0x84] [0x60] [0x10] [0x05] [0xFF] [0xFF] [0xFF] [0xFF]

11,9V, 230V vorhanden, Pumpe läuft, Hot-Wasser aktiv:

[0x77] [0x70] [0x31] [0x05] [0xFF] [0xFF] [0xFF] [0xFF]

13,3V, 230V vorhanden, Heizung inaktiv:

[0x85] [0x20] [0x10] [0x05] [0xFF] [0xFF] [0xFF] [0xFF]

Aircon Command (0x17)

Steuert Klimaanlagen am TIN-Bus.

Frame-Struktur

Hinweis: Das genaue Format für die AC-Steuerung erfordert weitere Analyse. Das Signal wird für Truma Aventa- und Saphir-Klimaanlagen verwendet.

Vollständiges Steuersequenz-Beispiel

Szenario: Kalter Morgenstart

Schritt 1: Master sendet Heater Command (0x20)

Ziel: Raum 22°C, Wasser Eco, nur Kraftstoff, Comfort-Lüfter
[0x86] [0x2B] [0xC3] [0xFA] [0x00] [0xB1] [0xE0] [0x0F]

Schritt 2: Heizgerät antwortet mit Info 1 (0x21)

Aktuell: Raum 15,5°C, Wasser 12,0°C (Kaltstart)
[0x5A] [0xAB] [0xBC] [0x3C] [0x12] [0x01] [0xF0] [0x0F]

Schritt 3: Heizgerät antwortet mit Info 2 (0x22)

Spannung: 13,2V, 230V vorhanden, Eco-Heizung aktiv
[0x84] [0x60] [0x11] [0x05] [0xFF] [0xFF] [0xFF] [0xFF]

Schritt 4: Nach 30 Minuten, Info 1-Aktualisierung

Aktuell: Raum 21,5°C, Wasser 39,5°C (nähert sich Ziel)
[0x7A] [0xBB] [0xC3] [0x3C] [0x12] [0x01] [0xF0] [0x0F]

Schritt 5: Ziel erreicht, Info 2-Aktualisierung

Spannung: 13,2V, 230V vorhanden, Eco-Temperatur erreicht
[0x84] [0x60] [0x10] [0x05] [0xFF] [0xFF] [0xFF] [0xFF]

Implementierungshinweise

Temperaturcodierung

Raumtemperatur (Byte 0): Verwendet die Formel (220 + (temp - 5) * 10) % 256, wobei temp in Celsius (5-30°C) ist. Sonderfall: 0xAA = Aus.

Telemetrie-Temperaturen (Frame 0x21): Codiert als 12-Bit-Werte, die Kelvin × 10 darstellen, gepackt in Bytes.

Vorteile gegenüber Legacy TIN

1. Einzelner Frame: Alle Parameter in einem Frame (0x20) vs. 5 separate Frames
2. Effizient: Reduzierter Bus-Verkehr und einfachere Zustandsverwaltung
3. Atomare Updates: Alle Parameter werden gleichzeitig aktualisiert
4. Moderne Funktionen: Bessere Unterstützung für Mix-Modus, detaillierte Statusmeldungen

Migration von Legacy TIN

Bei Unterstützung beider Protokolle:

1. Erkennung: Produktidentifikation zur Bestimmung der Gerätegeneration verwenden

   • Funktions-ID 0x0301 oder 0x0310 → Legacy TIN
   • Funktions-ID 0x0340 oder 0x0320 → Neues TIN

2. Abstraktionsschicht: Einheitliche API erstellen, die auf entsprechendes Protokoll abbildet:

   trait HeaterControl {
       fn set_room_temp(&mut self, celsius: u8);
       fn set_water_temp(&mut self, level: WaterLevel);
       fn set_fuel_enabled(&mut self, enabled: bool);
       fn set_electro_power(&mut self, watts: u16);
       fn set_fan_level(&mut self, level: FanLevel);
   }
   

3. Frame-Generierung: High-Level-Befehle in protokollspezifische Frames konvertieren

Referenzen

• TIN-Protokollübersicht - Allgemeine TIN-Protokollinformationen
• Legacy TIN-Protokoll - Legacy Protokollspezifikation
• Implementierung: womonet-drivers/src/tin/protocol/tinnew/
• Testdaten: truma-driver/logs_new.md