Die Vorlage SVC ist eine generische Modbus-TCP-Integration für eine reversible Luft-Wasser-Wärmepumpe, die Sensoren, Modusauswahl und drei Thermostate (Raumheizung, Raumkühlung und Warmwasser) über das lokale Netzwerk bereitstellt. TapHome verbindet sich direkt mit der Ethernet-Schnittstelle der Wärmepumpe — es wird keine RS-485-Verkabelung und kein Gateway benötigt.

Die Herstelleridentität ist nicht bestätigt. Die Zeichenfolge SVC stammt aus dem <Producer>-Feld der ursprünglichen TapHome-XML-Vorlage und ist mit hoher Wahrscheinlichkeit eine generische/Whitelabel-Bezeichnung und keine Verbrauchermarke. Überprüfen Sie vor dem Import dieser Vorlage, dass Ihr Regler genau die unten dokumentierte Registerkarte verwendet (Holding-Register H:0–H:34, Modus bei H:30 mit Werten 0–6, Wasseraustrittstemperatur bei H:8, Sollwerte von Heiz-/Kühlthermostat bei H:31/H:32 mit ×1-Skalierung, Sollwert des Speicherthermostats bei H:33 mit ×10-Skalierung). Falls ein Register nicht übereinstimmt, wird diese Vorlage das Gerät fehlerhaft lesen oder konfigurieren.

Die Registerkarte, Modus-Aufzählung und Skalierung auf dieser Seite stammen direkt aus der kanonischen TapHome-XML. Es liegt kein Herstellerhandbuch vor.

Hardware-Anschluss#

Der SVC-Regler verwendet das CCU-Modell ModbusTcpCCU, d. h. TapHome kommuniziert über Modbus TCP direkt mit der LAN-Schnittstelle der Wärmepumpe.

• Protokoll: Modbus TCP
• Port: 502 (Standard)
• Registertyp: alle Holding-Register (H)
• Datentyp: alle Register sind Int16, Big-Endian
• Byte-Reihenfolge: Standard-Modbus (High-Byte zuerst)
• Registerbereich: H:0 – H:34 (Register 9–14, 17–19, 21–23 und 27–29 werden von der Vorlage nicht verwendet; es sollte nicht angenommen werden, dass sie auf dem Regler vorhanden sind)

Netzwerkanforderungen

1. Schließen Sie den Ethernet-/LAN-Port der Wärmepumpe an dasselbe lokale Netzwerk wie das TapHome Core an.
2. Weisen Sie der Wärmepumpe eine stabile IP-Adresse zu — entweder konfigurieren Sie eine statische IP auf dem Regler oder fügen Sie eine DHCP-Reservierung im Router anhand der MAC-Adresse hinzu. Die Standardadresse der Vorlage 192.168.0.1 ist lediglich ein Platzhalter.
3. Stellen Sie sicher, dass keine Firewall zwischen TapHome Core und der Wärmepumpe den TCP-Port 502 blockiert.

Die Vorlage verwendet keine mDNS-/Zeroconf-Discovery — die IP-Adresse der Wärmepumpe muss beim Import manuell eingegeben werden.

Konfiguration#

Aktivieren der Modbus-Kommunikation

Da der Hersteller dieses Reglers unbekannt ist, ist hier kein herstellerspezifisches Verfahren dokumentiert. Der allgemeine Ansatz für diese Klasse von Wärmepumpenreglern lautet:

1. Rufen Sie das Service-/Installateurmenü am verdrahteten Bedienteil der Wärmepumpe oder am integrierten Display auf (üblicherweise PIN-geschützt).
2. Suchen Sie den Abschnitt Kommunikation oder Netzwerkeinstellungen.
3. Aktivieren Sie Modbus TCP, falls es nicht standardmäßig aktiv ist.
4. Stellen Sie die IP-Adresse (statisch empfohlen) und gegebenenfalls Subnetzmaske und Gateway ein.
5. Bestätigen oder setzen Sie die Modbus-Slave- (Unit-)ID — der Vorlagenstandard ist 1.
6. Speichern Sie die Einstellungen und starten Sie den Regler bei Bedarf neu.

Den genauen Menüpfad entnehmen Sie dem mit dem Gerät gelieferten Service-Handbuch. Wenn Modbus TCP im Menü des Reglers nicht verfügbar ist, kann diese Vorlage nicht verwendet werden.

Importparameter

Beim Import der Vorlage in TapHome anzugeben:

Überprüfen Sie vor dem Import die Konnektivität vom TapHome-Core-Host durch Ping auf die IP-Adresse der Wärmepumpe und — falls möglich — durch Prüfen des TCP-Ports 502 mit einem Tool wie nc oder einem Modbus-Client. So werden Netzwerkprobleme erkannt, bevor sie als Fehler auf Vorlagenebene in Erscheinung treten.

Registerkarte#

Die Vorlage stellt die folgenden Holding-Register bereit. Alle Register sind Int16. Die Temperaturskalierung /10 bedeutet, dass der ganzzahlige Rohwert durch 10 geteilt wird, um Grad Celsius zu erhalten (z. B. Rohwert 235 → 23,5 °C).

Asymmetrische Thermostat-Skalierung — leicht zu übersehen. Der Warmwasser-Speicherthermostat (H:33) verwendet die Skalierung ×10, während der Heizthermostat (H:31) und der Kühlthermostat (H:32) die Skalierung ×1 verwenden. Das bedeutet, der Warmwasser-Sollwert unterstützt Dezimalstellen (z. B. 48,5 °C), die Heiz-/Kühl-Sollwerte jedoch nur ganze Grad. Diese Asymmetrie stammt aus der Firmware des Reglers, nicht von TapHome.

Die XML setzt IsReadOnly=False auf den Registern H:15, H:16, H:20, H:24, H:25 und H:26, aber für keines davon ist eine WriteState-Formel hinterlegt. Diese Register sind daher über die Vorlage faktisch schreibgeschützt.

Gerätefunktionen#

Die Vorlage stellt 20 Geräte bereit, die Sensoren, einen Modusselektor, drei Thermostate und einen Neustart-Differenzparameter abdecken.

Temperatursensoren

Neun nur lesbare Temperatursensoren decken den Kältekreislauf, den Hydraulikkreislauf und die Umgebungsbedingungen ab:

• Außentemperatur (H:0) — Temperatur der Außenluft am Außengerät.
• Temperatur Außenregister (H:1) — Kältemittelregister außen (Verdampfer beim Heizen, Verflüssiger beim Kühlen).
• Temperatur Innenregister (H:6) — Kältemittelregister innen (Verflüssiger beim Heizen, Verdampfer beim Kühlen).
• Verdichter-Heißgastemperatur (H:2) — Heißseitiges Kältemittel am Verdichteraustritt.
• Verdichter-Sauggastemperatur (H:3) — Kaltseitiges Kältemittel am Verdichtereingang.
• Innenraumtemperatur (reversed) (H:4) — Raumluftsensor auf der Innenseite. Der Zusatz (reversed) wurde wörtlich aus dem XML übernommen; ohne Herstellerdokumentation ist seine genaue Bedeutung nicht zu bestätigen — er kann auf eine umgekehrte Sensorpolarität oder eine nach innen gerichtete Platzierung am Außengerät hinweisen.
• Warmwasserspeichertemperatur (H:5) — Pufferspeicher für Brauchwasser. Dieses Register dient auch als Ist-Temperaturquelle für den Warmwasserthermostat.
• Wassereintrittstemperatur (H:7) — Wasser, das aus dem Hydraulikkreislauf in den Wärmetauscher zurückströmt.
• Wasseraustrittstemperatur (H:8) — Wasser, das den Wärmetauscher verlässt. Dieses Register dient auch als Ist-Temperaturquelle für beide Thermostate — Heizen und Kühlen.

Gemeinsame Ist-Temperaturquelle. Die Register H:5 (Speichertemperatur) und H:8 (Wasseraustrittstemperatur) werden jeweils zweifach verwendet — einmal als eigenständiger Sensor und einmal als Ist-Temperaturquelle für einen Thermostat. Heiz- und Kühlthermostat lesen beide H:8, sodass die Vorlage keine separate ‘Zonen-Ist-Temperatur’ für Heizen gegenüber Kühlen unterscheiden kann. Der Regler stellt schlicht keine unabhängigen Zonensensoren bereit.

Betriebsmodus

Der Betriebsmodus-Selektor (H:30, Read/Write) wird als Multi-Value-Switch mit folgenden Werten bereitgestellt:

Die Werte 71, 72 und 73 erscheinen im XML als Platzhalter-Slots mit rohen Ziffernnamen ("7", "8", "9") — sie sind in der Firmware reserviert und sollten nicht verwendet werden.

Thermostate

Drei Thermostate werden als jeweils eigenes TapHome-Gerät bereitgestellt, jeweils mit eigenem Sollwert und einer geteilten Ist-Temperaturquelle:

• Heizthermostat (H:31, Read/Write, ×1-Skalierung) — ganzzahliger Sollwert für die Raumheizung. Die Ist-Temperatur wird aus H:8 (Wasseraustritt) gelesen.
• Kühlthermostat (H:32, Read/Write, ×1-Skalierung) — ganzzahliger Sollwert für die Raumkühlung. Die Ist-Temperatur wird ebenfalls aus H:8 gelesen.
• Warmwasser-Speicherthermostat (H:33, Read/Write, ×10-Skalierung) — Sollwert für den Warmwasserspeicher mit Dezimalauflösung. Die Ist-Temperatur wird aus H:5 (Speicher) gelesen. Eine Ventilrückmeldung ist nicht verfügbar (ReadValveState ist fest auf 0 gesetzt).

Die interne Logik der Wärmepumpe entscheidet anhand des in H:30 gewählten Betriebsmodus, ob der Heiz- oder Kühlsollwert aktiv ist. Das Beschreiben eines Sollwertregisters allein schaltet die Einheit nicht zwischen Heizen und Kühlen um — ändern Sie zuerst den Modus und passen Sie dann den entsprechenden Sollwert an.

Leistung und Kältemitteldrücke

• Elektrische Leistung (H:24) — momentane Leistungsaufnahme der Wärmepumpe in Watt (W). Da das Register Int16 ist, begrenzt der Wert bei ±32767 W; große Industrieeinheiten können diesen Bereich überschreiten.
• Niederdruck (H:25) — Kältemitteldruck auf der Saugseite in Kilopascal (kPa). Typische R410A-/R32-Niederdruckwerte liegen im Bereich ~100–700 kPa.
• Hochdruck (H:26) — Kältemitteldruck auf der Druckseite in Kilopascal (kPa). Typische R410A-/R32-Hochdruckwerte liegen im Bereich ~1500–4500 kPa.

Statusvariablen (roh)

Drei Statusregister werden als rohe Int16-Werte bereitgestellt, da der Reglerhersteller weder eine Bitmaske noch eine Aufzählung dafür dokumentiert hat:

• Output Status (H:15)
• Run Status (H:16)
• Hauptventilstatus (H:20) — wahrscheinlich der Zustand des Vier-Wege-Umschaltventils (Kältemittelpfad für Heizen vs. Kühlen), diese Interpretation ist jedoch nicht bestätigt.

Diese Werte können zur Änderungserkennung überwacht werden, lassen sich ohne Herstellerdokumentation jedoch nicht in benutzerfreundliche Beschriftungen übersetzen.

Serviceparameter

• Neustart-Temperaturdifferenz (H:34, Read/Write, rohe Ganzzahl in °C) — Hysteresewert, der angibt, um wie viele Grad unter dem aktiven Sollwert die Temperatur fallen muss, bevor der Verdichter neu startet. Typische Regler dieser Klasse verwenden Werte zwischen 1 und 15 °C, doch der gültige Bereich für dieses konkrete Gerät ist nicht verifiziert.

Fehlersuche#

Keine Modbus-Kommunikation

1. Prüfen Sie, ob der Ethernet-Port der Wärmepumpe physisch verbunden ist und eine Verbindung aufweist (kontrollieren Sie die Netzwerkstatus-LED am Regler, falls vorhanden).
2. Überprüfen Sie die IP-Adresse — prüfen Sie das Netzwerkeinstellungs-Menü des Reglers oder die DHCP-Lease-Tabelle des Routers.
3. Stellen Sie sicher, dass TapHome Core und die Wärmepumpe im selben Subnetz sind oder dass das Routing zwischen Subnetzen den TCP-Port 502 zulässt.
4. Prüfen Sie, ob keine Firewall- oder VLAN-Regel den Port 502 blockiert.
5. Bestätigen Sie, dass Modbus TCP im Servicemenü des Reglers tatsächlich aktiviert ist (einige Regler werden deaktiviert ausgeliefert).

Werte wirken offensichtlich falsch (verzerrte Temperaturen, unmögliche Zahlen)

Wenn Temperaturen als tausende Grad, Drücke als winzige Zahlen oder der Modus-Selektor unbekannte Werte anzeigt, verwendet Ihre Wärmepumpe wahrscheinlich eine andere Registerkarte als die, die diese Vorlage erwartet. Die Bezeichnung SVC umfasst einen nicht identifizierten OEM-Regler — andere OEM-Wärmepumpen (SPRSUN/Carel, Fairland, Gree Versati, Midea/Clivet/Kaisai, LG Therma V, Aermec, Sibotherm) verwenden unterschiedliche Registerlayouts. Lassen Sie die Vorlage nicht gegen ein nicht übereinstimmendes Gerät laufen, da Schreibvorgänge auf Modus- und Thermostatregistern unzusammenhängende Einstellungen verändern könnten.

Sollwertänderungen erscheinen ‘halbiert’ oder ‘verzehnfacht’

Dies ist fast immer eine Skalierungs-Diskrepanz. Der Warmwasserthermostat (H:33) verwendet ×10-Skalierung, während der Heiz- (H:31) und Kühlthermostat (H:32) die ×1-Skalierung verwenden. Wenn ein Sollwert 10× größer oder kleiner angewendet wird als erwartet, bestätigen Sie, dass Sie auf den richtigen Thermostat schreiben — die Vorlage wendet die korrekte Skalierung pro Gerät bereits an, sodass die wahrscheinlichste Ursache ist, dass die Firmware des Reglers von der angenommenen Karte abweicht.

Heiz- und Kühlthermostat zeigen dieselbe aktuelle Temperatur

Dies ist das erwartete Verhalten. Sowohl Heiz- als auch Kühlthermostat lesen die Ist-Temperatur aus dem Register H:8 (Wasseraustrittstemperatur). Die Vorlage kann ‘aktuelle Heizzonentemperatur’ nicht von ‘aktueller Kühlzonentemperatur’ trennen, weil der Regler nur einen einzigen Austrittssensor bereitstellt. Wenn Sie separate Zonensensoren benötigen, fügen Sie zusätzliche TapHome-Temperatursensoren hinzu (direkt an TapHome-IO angeschlossen).

Leistungsmesswert hängt bei 32767 oder –32768

Das Register H:24 für die Leistung ist eine vorzeichenbehaftete 16-Bit-Ganzzahl, sodass eine momentane Aufnahme über 32 767 W (32,77 kW) überläuft. Dies betrifft nur große Industrieeinheiten — Wohnanlagen bleiben in der Regel deutlich unter dieser Grenze.