--- title: "Vaillant aroTHERM plus + sensoCOMFORT VRC 720 (eBUS, micro-ebusd)" description: "Vaillant aroTHERM plus mit VRC 720 aus TapHome über eBUS steuern — Raum- und Warmwasser-Sollwert, Betriebsarten, Leistung und Energie, ohne Cloud." url: "https://taphome.com/de/compatibility/vaillant-ebus-micro-ebusd-http/" language: de lastmod: 2026-11-04 generator: hugo ai: topics: ["http","heat-pump","ebus","rest-api","gateway","wifi","dhw"] questions: ["Gibt es eine TapHome-Vorlage für Vaillant-Wärmepumpen?","Wie lässt sich eine Vaillant-Wärmepumpe am einfachsten aus TapHome steuern?","Wie verbinde ich eine Vaillant aroTHERM plus mit sensoCOMFORT VRC 720 über eBUS mit TapHome?","Wozu dient das micro-ebusd-Token des eBUS-Adapters C6?","Welche Kreisnamen braucht die Vaillant-Vorlage?","Warum springt ein aus TapHome geschriebener Sollwert am VRC 720 auf den alten Wert zurück?"] --- # Vaillant aroTHERM plus + sensoCOMFORT VRC 720 (eBUS, micro-ebusd) Kommunikation: Packet Parser → HTTP - [Offizielle Website von Vaillant](https://www.vaillant.com) - [Produktseite Vaillant aroTHERM plus](https://www.vaillant.com/en/products/arothermplus/) - [eBUS Adapter Shield C6 und Stick C6](https://adapter.ebusd.eu/v5-c6/) Die Vorlage Vaillant aroTHERM plus verbindet TapHome mit einer Luft-Wasser-Wärmepumpe Vaillant aroTHERM plus und ihrem Systemregler sensoCOMFORT VRC 720 über einen eBUS Adapter Shield oder Stick C6 von ebusd.eu. Der Adapter sitzt am eBUS des Reglers und führt micro-ebusd aus, das die Vaillant-Nachrichten dekodiert und über eine lokale HTTP-JSON-API anbietet. TapHome spricht nur mit dem Adapter im lokalen Netzwerk; eine Cloud wird nicht verwendet. Die Vorlage liest Außen-, Raum-, Vorlauf- und Warmwassertemperatur, den Wasserdruck, Leistung und Energie der Wärmepumpe und die Fehler des Reglers. Sie stellt den Raum-Sollwert der Zone 1, den Warmwasser-Sollwert sowie die Betriebsarten der Zone 1 und des Warmwassers ein und startet eine einmalige Warmwasserladung. > [!WARNING] > **Community-Vorlage — noch nicht mit TapHome an einem echten Adapter getestet.** Die Vorlage wurde im TapHome-Portal aus der Dokumentation von micro-ebusd und den ebusd-Nachrichtendefinitionen für den VRC 720 und die aroTHERM plus erstellt. Getestet wurde sie nur mit einem simulierten Adapter auf einem lokalen TapHome Core 2025.2, nicht mit einem echten Adapter, Regler oder einer echten Wärmepumpe; Erfahrungen aus der Praxis sind willkommen. Laden Sie das XML auf dieser Seite herunter oder holen Sie es aus dem TapHome-Portal: [Vaillant aroTHERM plus + VRC 720 — Community-Vorlage](https://portal.taphome.com/portal/community/vaillant-ebus-micro-ebusd-http), und importieren Sie es als neues Modul. **[Vaillant heat pump and VRC 720 controller through the eBUS Adapter C6 with micro-ebusd (HTTP)](https://portal.taphome.com/de/portal/community/vaillant-ebus-micro-ebusd-http)** — Vaillant, HTTP. Vaillant aroTHERM plus with the sensoCOMFORT VRC 720 through the eBUS Adapter C6 running micro-ebusd: outdoor, room, flow and hot water temperatures, room setpoint as a temporary override, zone and hot water modes, hot water boost, water pressure, heat pump power and energy, controller errors. Die Vorlage ergänzt die offizielle TapHome-Vorlage [eBUS Adapter Shield C6 Stick](https://taphome.com/de/compatibility/ebus-adapter-shield-c6-stick/), die über MQTT den Zustand des Adapters selbst zeigt (Bussignal, Daemon, Temperatur); beide können nebeneinander laufen. Mit der Community-Vorlage für den Gebläsekonvektor Vaillant aroVAIR, die Modbus RTU verwendet, hat sie nichts zu tun. ## Was Sie brauchen - **Vaillant aroTHERM plus** mit dem Regler **sensoCOMFORT VRC 720** am eBUS. - **eBUS Adapter Shield C6 oder Stick C6** ([adapter.ebusd.eu](https://adapter.ebusd.eu/v5-c6/)) mit der neuesten Firmware und aktiviertem **micro-ebusd**. micro-ebusd ist eine kostenpflichtige Funktion des Adapters, die ein Token freischaltet; jeder Adapter erhält eine 30-tägige Testlizenz. - Adapter und TapHome Core im selben lokalen Netzwerk. ## Hardware-Anschluss Der Adapter wird an die beiden eBUS-Klemmen des Reglers VRC 720 angeschlossen; der eBUS ist verpolungssicher. Die aroTHERM plus kommuniziert mit dem Regler über denselben Bus, daher ist keine Leitung zur Außeneinheit nötig. Schalten Sie vor Arbeiten an den Klemmen des Reglers die Netzspannung ab. Verbinden Sie den Adapter wie in seiner Dokumentation beschrieben mit dem lokalen Netzwerk und reservieren Sie seine IP-Adresse im Router, damit TapHome ihn immer erreicht. ## Konfiguration ### micro-ebusd aktivieren 1. Aktualisieren Sie den Adapter auf die neueste Firmware ([adapter.ebusd.eu](https://adapter.ebusd.eu/v5-c6/)). 2. Holen Sie ein micro-ebusd-Token unter [token.ebusd.eu](https://token.ebusd.eu/) (eine 30-tägige Testlizenz pro Adapter, danach kostenpflichtig) und geben Sie es in der Weboberfläche des Adapters ein. 3. Nach der Aktivierung antwortet die HTTP-JSON-API unter `http:///api/v1/ebus`. ### Kreisnamen ermitteln micro-ebusd adressiert jeden Wert über Kreis und Nachrichtennamen. Öffnen Sie `http:///api/v1/ebus/list` im Browser: Die Seite listet die Kreise und Nachrichten, die der Adapter am Bus gefunden hat. Der Regler sensoCOMFORT VRC 720 erscheint je nach Version als `ctlv2`, `ctlv3` oder `720`, die Außeneinheit der aroTHERM plus als `hmu`. Der Importdialog nennt auch `700` für den VRC 700; die Vorlage wurde nach den Nachrichtendefinitionen des VRC 720 geschrieben. ### Importparameter | Parameter | Standardwert | Beschreibung | |---|---|---| | `ADAPTER_IP` | (leer) | IP-Adresse des eBUS-Adapters | | `CONTROLLER_CIRCUIT` | `ctlv2` | Kreisname des Reglers aus `/api/v1/ebus/list` | | `HEAT_SOURCE_CIRCUIT` | `hmu` | Kreisname der Außeneinheit der aroTHERM plus | Der Import legt zwei Module am selben Adapter an: **sensoCOMFORT VRC 720 (ctlv2)** mit acht Geräten und **aroTHERM plus (hmu)** mit dem Stromzähler der Wärmepumpe. ## Gerätefunktionen ### Temperaturen und Druck - **Außentemperatur** — Außentemperatur, wie sie der VRC 720 anzeigt. - **Vorlauftemperatur** — Systemvorlauftemperatur (Heizungsvorlauf). - **Wasserdruck** — Wasserdruck der Heizungsanlage in bar (nur lesbar). ### Zone 1 - **Thermostat Zone 1** — Raumtemperatur und der Sollwert, den der Regler tatsächlich verwendet. Ein in TapHome eingestellter Sollwert (5–30 °C) wird als **Quick Veto** gesendet: eine vorübergehende Änderung, das Zeitprogramm des Reglers bleibt unverändert. Nach dem Schreiben liest die Vorlage den Wert erneut vom Bus. - **Betriebsart Zone 1** — Aus, Auto (Zeitprogramm), Manuell / Tag und Nacht. Die Vorlage sendet die Namen aus der ebusd-Definition (`off`, `auto`, `day`, `night`). Am VRC 720 ist der Modus `day` der manuelle Modus, und einen Nachtmodus hat der VRC 720 nicht. ### Warmwasser - **Warmwasser-Thermostat** — Temperatur des Warmwasserspeichers und Warmwasser-Sollwert, einstellbar von 35 bis 75 °C. - **Betriebsart Warmwasser** — Aus, Auto, Tag oder Nacht. - **Warmwasser-Einmalladung** — Einschalten startet die Ladung; ist der Speicher geladen, kehrt der Regler selbst auf Auto zurück und der Schalter zeigt wieder aus. ### Strom der Wärmepumpe Das Modul **aroTHERM plus (hmu)** hat ein Gerät, **Stromzähler der Wärmepumpe**, einen Stromzähler der Außeneinheit: - **Leistung** — aktuelle elektrische Leistung der Wärmepumpe in kW. - **Gesamtverbrauch** — gesamter Stromverbrauch der Wärmepumpe in kWh. Der Zähler ist eine 16-Bit-Zahl (höchstens 65535 kWh); bei einem Gerät, das viele Jahre läuft, kann er daher schon wieder bei null begonnen haben. Außerdem zeigt es drei Serviceattribute: | Serviceattribut | Beschreibung | |---|---| | COP (Heizen) | Leistungszahl der Wärmepumpe im Heizbetrieb | | Gesamter Wärmeertrag [kWh] | Gesamter Wärmeertrag der Wärmepumpe — Wärmeenergie, kein Strom | | Betriebszustand | Zustand, den die Außeneinheit meldet: `ready`, `heating`, `cooling`, `heating_water` oder `error` | ### Fehler des Reglers Das Modul **sensoCOMFORT VRC 720 (ctlv2)** liest in jedem Zyklus die aktuellen Fehler des Reglers. Für jedes seiner fünf Fehlerfelder, das nicht null ist, zeigt das Modul einen Fehler mit der Fehlernummer, zum Beispiel `Controller error code: 1025`. ### Wie die Vorlage mit dem Adapter spricht Jeder Wert ist eine Nachricht der ebusd-Definition. Die Vorlage liest sie mit `GET /api/v1/ebus/{circuit}/{message}/get?from=1`, das aus dem Cache des Adapters antwortet oder den Bus fragt, und nimmt `data.fields.value` aus der Antwort. Ein Schreibvorgang ist `PUT /api/v1/ebus/{circuit}/{message}/set` mit dem Body `{"fields":{"value":…}}`, gefolgt von einem Lesen mit `from=2`, das immer den Bus fragt. Die Module und alle Geräte lesen alle 60 s. Keines der Geräte schreibt etwas, wenn der TapHome Core startet: Sie übernehmen ihren Zustand vom Adapter, nicht vom letzten Wert in TapHome. > [!NOTE] > **Manche Firmware-Versionen des VRC 720 bestätigen einen Schreibvorgang und führen ihn nicht aus.** Da die Vorlage den Wert nach jedem Schreiben erneut vom Bus liest, zeigt TapHome danach den Wert, den der Regler tatsächlich verwendet, nicht den eingestellten. ### Was die Vorlage nicht tut - **Installateurparameter** (Heizkurve, maximale Vorlauftemperatur) sind bewusst weggelassen — die Vorlage ändert die Installateureinstellungen des Reglers nicht. - Kühlen der Zone 1, die Zonen 2 und 3 sowie das Wochenzeitprogramm sind nicht Teil der Vorlage. - Weitere Werte der Außeneinheit (Lufteintrittstemperatur, Kompressorauslastung, aktuelle Wärmeleistung) sind am Bus verfügbar, werden aber nicht gelesen. ## Fehlerbehebung ### Überhaupt keine Werte Prüfen Sie, ob micro-ebusd aktiviert und das Token nicht abgelaufen ist: Ohne micro-ebusd antwortet der Adapter nicht auf `/api/v1/ebus`. Prüfen Sie, ob sich `http:///api/v1/ebus/list` im Browser öffnet. ### Die Geräte des Reglers zeigen keinen Wert Der Kreisname stimmt nicht. Öffnen Sie `http:///api/v1/ebus/list`, suchen Sie den Namen des Reglers (`ctlv2`, `ctlv3` oder `720`) und der Außeneinheit (`hmu`) und importieren Sie die Vorlage mit diesen Namen erneut. ### Ein Sollwert oder eine Betriebsart springt auf den alten Wert zurück Der Regler hat den Schreibvorgang nicht ausgeführt; TapHome zeigt den vom Bus zurückgelesenen Wert. Prüfen Sie die Betriebsart der Zone und die Firmware des Reglers. ### Modulfehler `Controller error code: …` Der Regler meldet einen Fehler mit dieser Nummer. Schlagen Sie ihn in der Dokumentation des Reglers oder der Wärmepumpe nach; der Modulfehler verschwindet, wenn der Regler ihn zurücksetzt. ## Verfügbare Geräte sensoCOMFORT VRC 720 (ctlv2) Modul Außentemperatur Temperatursensor Nur lesen Außentemperatur, wie sie der Regler VRC 720 anzeigt numeric Einheit: °C Thermostat Zone 1 Thermostat Raumtemperatur und aktiver Sollwert der Zone 1; ein neuer Sollwert wird als Quick Veto gesendet — eine vorübergehende Änderung, das Zeitprogramm bleibt unverändert numeric Einheit: °C Betriebsart Zone 1 Mehrwertschalter Betriebsart der Zone 1 — Aus, Auto (Zeitprogramm), Manuell / Tag oder Nacht; am VRC 720 ist der Modus day der manuelle Modus, einen Nachtmodus gibt es dort nicht enum numeric Werte / Zustände: Aus · Auto · Manuell / Tag · Nacht Warmwasser-Thermostat Thermostat Temperatur des Warmwasserspeichers und Warmwasser-Sollwert, einstellbar von 35 bis 75 °C numeric Einheit: °C Betriebsart Warmwasser Mehrwertschalter Betriebsart des Warmwasserkreises — Aus, Auto, Tag oder Nacht enum numeric Werte / Zustände: Aus · Auto · Tag · Nacht Warmwasser-Einmalladung Schalter Einmalige Warmwasserladung — Einschalten startet die Ladung, nach dem Aufladen des Speichers kehrt der Regler selbst auf Auto zurück boolean Werte / Zustände: Active · OFF Vorlauftemperatur Temperatursensor Nur lesen Systemvorlauftemperatur (Heizungsvorlauf), wie sie der Regler VRC 720 meldet numeric Einheit: °C Wasserdruck Variable Nur lesen Wasserdruck der Heizungsanlage in bar numeric Einheit: bar **Verbindung:** Packet Parser → HTTP Mögliche Verbesserungen (5) - Cooling of zone 1 — The controller definition has cooling setpoints for the zone and the heating circuit; the template covers heating only. - Installer parameters (heat curve, maximum flow temperature) — Left out on purpose — installer settings of the controller are not changed from TapHome. - Weekly time programme — Reading and editing the weekly schedule of the zone and the hot water is not part of the template. - Further heat pump values — Air intake temperature, compressor utilisation and current heat output of the outdoor unit. - Further zones — The template covers zone 1 only. ## Quellen - micro-ebusd HTTP JSON API (get, set, list, from=0/1/2, token) [token.ebusd.eu](https://token.ebusd.eu/api) 2026-11-04 - ebusd message definitions — Vaillant sensoCOMFORT VRC 720 (15.ctlv2.csv) [ebus.github.io](https://ebus.github.io/en/vaillant/15.ctlv2.csv) 2026-11-04 - ebusd message definitions — Vaillant aroTHERM plus outdoor unit (08.hmu.csv) [ebus.github.io](https://ebus.github.io/en/vaillant/08.hmu.csv) 2026-11-04 - ebusd configuration — Vaillant index [ebus.github.io](https://ebus.github.io/en/vaillant/) 2026-11-04 - micro-ebusd MQTT documentation [token.ebusd.eu](https://token.ebusd.eu/mqtt) 2026-11-04 ## Verwandte Dokumentation - [Packet-Parser-Integration](https://taphome.com/de/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/de/docs/integration/packet-parser/) - [Packet-Parser-Funktionen](https://taphome.com/de/docs/script/packet-parser/) - [Parsing-Funktionen](https://taphome.com/de/docs/script/parsing-functions/)