--- title: "my-PV AC-THOR and AC-THOR 9s" description: "my-PV AC-THOR und AC-THOR 9s über Modbus TCP: PV-Überschuss als Heizleistung vorgeben, Warmwassertemperatur, Heizleistung und Gerätestatus lesen." url: "https://taphome.com/de/compatibility/my-pv-ac-thor-modbus-tcp/" language: de lastmod: 2026-11-10 generator: hugo ai: topics: ["modbus-tcp","energy","photovoltaic","pv-surplus","hot-water","ethernet"] questions: ["Wie integriere ich den my-PV AC-THOR in TapHome?","Was steuert und liest die TapHome-Vorlage für den my-PV AC-THOR?","Wie verbinde ich den my-PV AC-THOR über Modbus TCP mit TapHome?","Wie stelle ich den Ansteuerungstyp des AC-THOR auf Modbus TCP ein?","Warum reagiert der AC-THOR nicht auf Leistungsbefehle von TapHome?","Kann TapHome den PV-Überschuss an den AC-THOR senden, um Warmwasser zu erhitzen?"] --- # my-PV AC-THOR and AC-THOR 9s Kommunikation: Modbus TCP > Netzwerkadresse > > TapHome erreicht dieses Gerät unter der beim Import eingegebenen Adresse. Geben Sie dem Gerät eine feste Adresse — eine IP-Reservierung im Router oder seinen mDNS-Namen, falls es einen unterstützt —, sonst funktioniert die Integration nicht mehr, sobald der Router die Adresse ändert. > > [Netzwerkvorbereitung](https://taphome.com/de/docs/setup/network-preparation/) ## Integrationsanleitung Der my-PV AC•THOR und der AC•THOR 9s sind Photovoltaik-Power-Manager, die überschüssigen Solarstrom in Warmwasser oder Raumwärme umwandeln, indem sie ohmsche Verbraucher wie Heizstäbe stufenlos regeln. Der AC•THOR regelt im Betriebsmodus M1 bis zu 3.000 W (6.000 W in M3 mit dem Relaisausgang); der AC•THOR 9s hat drei Ausgänge und regelt in M1 bis zu 9.000 W (18.000 W in M3, ab Firmware a0020500). TapHome kommuniziert mit dem Gerät über Modbus TCP auf Port 502 und schreibt die Heizleistung direkt, sodass eine TapHome-Automatisierung den gemessenen PV-Überschuss in den Warmwasserspeicher leiten kann, statt ihn ins Netz einzuspeisen. Die Vorlage stellt den Leistungsbefehl als beschreibbares Gerät bereit, die Warmwassertemperatur und die aktuelle Heizleistung (mit Solar- und Netzanteil) als Messwerte sowie den Gerätestatus zusammen mit elektrischen Werten als Servicediagnose. ## Hardwareanschluss Die Installation des AC•THOR muss von einer zugelassenen Fachkraft gemäß der Montageanleitung des Herstellers durchgeführt werden. Es dürfen nur rein ohmsche Verbraucher angeschlossen werden (Heizstäbe, Boiler, Konvektoren, Heizmatten, Infrarotpaneele) — niemals Geräte mit elektronischem Netzteil oder elektronischem Thermostat. Für die Wassererwärmung dürfen nur Heizstäbe mit integriertem Sicherheitstemperaturbegrenzer angeschlossen werden. Der AC•THOR empfängt externe Steuersignale über das IP-Protokoll an seinem **Ethernet RJ45**-Anschluss. Verbinden Sie ihn mit einem Standard-Netzwerkkabel (CAT5 oder CAT7) mit demselben Router oder Switch wie die Steuereinheit Core von TapHome. Die Übersicht unten zeigt den Anschlussbereich des AC•THOR 9s (Beschriftungen: *Verbraucheranschlüsse* OUT-1 bis OUT-3, *Ethernet RJ45*, *SD Card Slot*, *4 Temp. Sensoren*, *Schaltkontakt 16A*, *Netzanschluss 3 × 230 V*). Der Anschlussbereich des AC•THOR mit einem Ausgang ist anders aufgebaut. ![Anschlussbereich des AC•THOR 9s: Verbraucherklemmen, Ethernet RJ45, SD-Kartensteckplatz, Temperatursensoren und 16-A-Schaltkontakt (Montageanleitung AC•THOR 9s, 2019)](https://taphome.com/images/compatibility/my-pv-ac-thor-modbus-tcp/terminals-overview_hu_8c99e2a8a61f2ec8.jpg) ### Netzwerkverbindung Im Schaltbild des Herstellers für die Ansteuerung durch ein Energiemanagementsystem ist der AC•THOR über seinen RJ45-Anschluss mit dem Router verbunden, und das Energiemanagementsystem — hier die Steuereinheit Core von TapHome — ist am selben Router angeschlossen. TapHome sendet die Zielleistung dann über dieses Netzwerk an den AC•THOR. ![Schaltbild des AC•THOR 9s für die Ansteuerung durch ein Energiemanagementsystem über das Ethernet-Netzwerk: AC•THOR über RJ45 und CAT5/CAT7-Kabel gemeinsam mit dem Energiemanagementsystem am Router angeschlossen (Montageanleitung AC•THOR 9s, 2019)](https://taphome.com/images/compatibility/my-pv-ac-thor-modbus-tcp/wiring-ethernet-ems_hu_73f78152bd607dfc.jpg) ### Warmwasser und Temperatursensor Das Gerät **Hot Water Temperature** liest den Temperatursensor 1 des AC•THOR. Der digitale Temperatursensor von my-PV liegt dem Gerät bei; montieren Sie ihn in einer Tauchhülse — tauchen Sie ihn niemals direkt ins Wasser — und klären Sie seine Position mit dem Speicherhersteller ab. Am AC•THOR 9s lassen sich bis zu vier digitale Sensoren anschließen. Das Beispiel unten zeigt den Betriebsmodus M1 (Warmwasser) mit einem dreiphasigen Heizstab bis 9 kW am AC•THOR 9s. ![Schaltbild des AC•THOR 9s für Betriebsmodus M1 Warmwasser bis 9 kW mit dreiphasigem Heizstab, Temperatursensor und Netzanschluss (Montageanleitung AC•THOR 9s, 2019)](https://taphome.com/images/compatibility/my-pv-ac-thor-modbus-tcp/wiring-hot-water-m1_hu_33ba751255211184.jpg) > [!WARNING] > Wird kein Temperatursensor von my-PV verwendet, ist am Heizstab ein Bimetall-Thermostat erforderlich. Der Neutralleiter darf nicht über einen Schalter geführt werden. Der AC•THOR 9s benötigt 3 × 230 V mit Neutralleiter, abgesichert mit höchstens 16 A pro Phase (Auslösecharakteristik B oder C). ## Konfiguration ### Netzwerk und IP-Adresse DHCP ist standardmäßig aktiv, sodass der AC•THOR seine IP-Adresse vom Router erhält. Die aktuelle Adresse wird auf dem Display des Geräts in den Statusinformationen (**IP**) und in der DHCP-Liste des Routers angezeigt. Da sich TapHome mit einer festen Adresse verbindet, vergeben Sie in den allgemeinen Einstellungen des Geräts eine **statische IP-Adresse** (**IP DHCP/static**, dann IP-Adresse, Subnetzmaske, Gateway und DNS-Server) oder legen Sie im Router eine DHCP-Reservierung an. Die statischen Einstellungen müssen zum Netzwerk des Routers passen, sonst ist das Gerät im Netzwerk nicht mehr sichtbar. ### Weboberfläche öffnen Ab Ethernet-Firmware a0020000 ist die Weboberfläche eine externe HTML-Datei: 1. Geben Sie die IP-Adresse des AC•THOR in einen Webbrowser ein. Die Seite zeigt einen Download-Link für die Datei der Weboberfläche. 2. Speichern Sie die Datei lokal und öffnen Sie sie — oder öffnen Sie die Weboberfläche direkt über den Link auf dieser Seite. 3. Laden Sie die HTML-Datei in Installationen ohne Internetzugang vorab herunter. Alternativ findet das Programm **my-PV Scanner** (Teil des AC•THOR-Softwarepakets auf der Website von my-PV) die Geräte im Netzwerk; ein Doppelklick auf das Suchergebnis öffnet die Weboberfläche. Sind mehrere Geräte von my-PV vorhanden, identifizieren Sie das Gerät anhand der Seriennummer auf dem Typenschild. Die Suche nutzt den UDP-Port 16124, den eine Firewall oder eine Router-Einstellung blockieren kann. > [!WARNING] > my-PV rät davon ab, den AC•THOR über eine Portweiterleitung aus dem Internet erreichbar zu machen. TapHome benötigt nur Zugriff im lokalen Netzwerk. ### Modbus-TCP-Ansteuerung aktivieren 1. Öffnen Sie in der Weboberfläche **Control Settings** und wählen Sie den Ansteuerungstyp **Modbus TCP**. Der Ansteuerungstyp lässt sich auch bei der Inbetriebnahme am Display oder in den Einstellungen unter **Control** wählen. 2. Der Ansteuerungstyp kann nur an einem Gerät mit der Gerätenummer **1** gewählt werden (Werkseinstellung, der Master). Hat das Gerät eine andere Nummer, setzen Sie sie zuerst auf 1 zurück. 3. Wählen Sie den Betriebsmodus für die Anwendung — zum Beispiel **M1 Hot water** — und den Temperatursensor für diesen Modus. 4. Passen Sie bei Bedarf den **Power timeout** in den Geräteeinstellungen an (10–600 s). Er legt fest, wie lange der letzte Leistungsbefehl gültig bleibt, wenn kein neuer Befehl eintrifft. > [!WARNING] > Ohne den Ansteuerungstyp **Modbus TCP** nimmt der AC•THOR keine Leistungsbefehle an, die in Register 1000 geschrieben werden. Bei Firmware bis a0010103 kann das Ändern der Kommunikations- und Ansteuerungseinstellungen am Display eine höhere, passwortgeschützte Zugriffsebene erfordern; siehe die Bedienungsanleitung von my-PV. ### Kommunikationsparameter | Parameter | Wert | |---|---| | Protokoll | Modbus TCP | | Port | 502 | | Modbus Slave ID (Standardwert der Vorlage) | 1 | | Registertyp | Holding-Register (Lesen 0x03, Schreiben 0x06 / 0x10) | | Datenformat | 16-Bit-Ganzzahlen (vorzeichenlos; die Zählerleistung in Register 1069 ist vorzeichenbehaftet) | | Registeradressen | „Reale“ Adressen gemäß Dokumentation von my-PV | Die vollständige Registerliste stellt my-PV auf Anfrage zur Verfügung. > [!WARNING] > my-PV erlaubt, jedes beschreibbare Register höchstens einmal pro Tag zu beschreiben, um die Lebensdauer des nichtflüchtigen Speichers zu schützen. Der Leistungsbefehl (Register 1000) ist von dieser Grenze ausgenommen, ebenso einige weitere Register (Uhrzeit, Boost-Aktivierung und die erweiterten Leistungsregister). Die Vorlage schreibt deshalb **nur** den Leistungsbefehl — Sollwerte, Boost, Legionellenschutz und Zeiteinstellungen gehören auf das Display des Geräts oder in die Weboberfläche. Fügen Sie in TapHome eine Modbus-TCP-Schnittstelle hinzu, importieren Sie die Vorlage und geben Sie die IP-Adresse des AC•THOR ein. ## Gerätefunktionen ### Regelung der Überschussleistung - **Power Target** — die vorgegebene Heizleistung in Watt (H:1000). Eine TapHome-Automatisierung berechnet typischerweise den verfügbaren PV-Überschuss aus einem Stromzähler und schreibt ihn in dieses Gerät; der AC•THOR wandelt ihn stufenlos in Wärme um. Der Wertebereich beträgt 0–3.000 W (AC•THOR, M1) oder 0–9.000 W (AC•THOR 9s, M1). Der Befehl läuft nach dem Power timeout des Geräts ab, daher sendet die Vorlage ihn regelmäßig erneut. ### Temperatur- und Leistungsüberwachung - **Hot Water Temperature** — vom Sensor 1 gemessene Wassertemperatur, in einer Auflösung von 0,1 °C (H:1001). - **Heating Power** — elektrische Leistung, die dieser AC•THOR aktuell an seine Verbraucher abgibt (H:1082, angezeigt in kW). Die Service-Attribute **Solar part of heating power** (H:1083) und **Grid part of heating power** (H:1084) teilen sie in den PV- und den Netzanteil in W auf. Diese Register sind ab Firmware a0020303 verfügbar. ### Diagnose Die Service-Attribute am Modul zeigen: | Attribut | Register | Bedeutung | |---|---|---| | Operating status | H:1003 | Betriebszustand: Off (0, aus), Starting up (Anlauf), Operation (9, Betrieb), Power stage error (Fehler des Leistungsteils, ab 200) | | Voltage L1 | H:1061 | Netzspannung an L1 in V | | Current L1 | H:1062 | Strom an L1 in A (Auflösung 0,1 A) | | Grid frequency | H:1064 | Netzfrequenz in Hz | | Grid meter power | H:1069 | Leistung am Zählpunkt in W, negative Werte bedeuten Einspeisung | | Maximum power currently possible | H:1071 | Maximale Leistung, die das Gerät momentan aufnehmen kann, in W, einschließlich Slaves | Ein Fehler des Leistungsteils (Statuscode ab 200) wird in TapHome zusätzlich als Modulfehler gemeldet. ## Fehlerbehebung - **Das Gerät reagiert nicht auf Leistungsbefehle** — prüfen Sie, ob der Ansteuerungstyp auf **Modbus TCP** eingestellt ist. Jeder andere Ansteuerungstyp ignoriert Register 1000. Lässt sich der Ansteuerungstyp nicht ändern, prüfen Sie, ob die Gerätenummer 1 ist. - **Keine externe Ansteuerung im Betriebsmodus M3** — in M3 lässt sich ein AC•THOR ohne verfügbaren Verbraucher am regelbaren Ausgang nicht extern über Modbus TCP ansteuern. Prüfen Sie den Verbraucher sowie dessen Thermostat oder Sicherheitstemperaturbegrenzer. - **Das Heizen stoppt nach kurzer Zeit, obwohl Überschuss vorhanden ist** — der Leistungsbefehl läuft nach dem Power timeout (10–600 s) ab. Stellen Sie sicher, dass die Verbindung zu TapHome aktiv ist, damit der Befehl erneuert wird, oder erhöhen Sie den Power timeout am Gerät. - **Registeradressen scheinen um eins verschoben** — my-PV dokumentiert „reale“ Registeradressen. Manche Modbus-Clients addieren 1 zur Adresse (zum Beispiel 1001 statt 1000); wirken die Messwerte verschoben, prüfen Sie den Adress-Offset des Clients. - **Heating Power oder deren Solar- und Netzanteil zeigen keine Werte** — die Register 1082–1084 gibt es ab Firmware a0020303. Prüfen Sie die Firmware-Version in den Statusinformationen am Display und aktualisieren Sie das Gerät. - **Hot Water Temperature zeigt 0 °C oder 85 °C** — der Hersteller verwendet 0 ° für einen defekten Fühler und 85 ° für eine Datenstörung des Temperatursensors. Prüfen Sie Sensor 1 und seine Verkabelung. - **Der Status zeigt „Power stage error“** — Statuscodes ab 200 kennzeichnen einen Fehlerzustand des Leistungsteils. Fehlermeldungen erscheinen nur auf dem Startbildschirm des Gerätedisplays, nicht in der Weboberfläche. - **Der AC•THOR ist im Netzwerk nicht auffindbar** — lesen Sie die IP-Adresse am Display oder in der DHCP-Liste des Routers ab; eine Firewall kann den my-PV Scanner auf dem UDP-Port 16124 blockieren. Prüfen Sie nach dem Wechsel auf eine statische IP, ob Adresse, Subnetzmaske und Gateway zum Router passen. ## Verfügbare Geräte 3 Diese Geräte erscheinen nach dem Import in TapHome. AC•THOR Modul Serviceattribute | | |----------------------------------| | Operating status | | Voltage L1 | | Current L1 | | Grid frequency | | Grid meter power | | Maximum power currently possible | Lesen (Modul) ```taphome VAR Code := MODBUSR(H, 1003, UInt16); IF(Code >= 200) ADDERROR(0, "Power stage error (status code " + TOSTRING(Code) + ")"); END ``` Serviceattribute Operating status ```taphome IF(MODBUSR(H, 1003, UInt16) >= 200, "Power stage error", IF(MODBUSR(H, 1003, UInt16) = 0, "Off", IF(MODBUSR(H, 1003, UInt16) = 9, "Operation", "Starting up"))) ``` Voltage L1 ```taphome MODBUSR(H, 1061, UInt16) + " V" ``` Current L1 ```taphome MODBUSR(H, 1062, UInt16) / 10 + " A" ``` Grid frequency ```taphome TOSTRING(MODBUSR(H, 1064, UInt16) / 1000, "F2") + " Hz" ``` Grid meter power ```taphome MODBUSR(H, 1069, Int16) + " W" ``` Maximum power currently possible ```taphome MODBUSR(H, 1071, UInt16) + " W" ``` Power Target Variable Lesen ```taphome MODBUSR(H, 1000, UInt16) ``` Schreiben ```taphome MODBUSW(H, 1000, UInt16, Va) ``` Hot Water Temperature Temperatursensor Temperatur lesen ```taphome MODBUSR(H, 1001, UInt16) / 10 ``` Heating Power Stromzähler Serviceattribute | | |-----------------------------| | Solar part of heating power | | Grid part of heating power | Bedarf lesen ```taphome MODBUSR(H, 1082, UInt16) / 1000 ``` Serviceattribute Solar part of heating power ```taphome MODBUSR(H, 1083, UInt16) + " W" ``` Grid part of heating power ```taphome MODBUSR(H, 1084, UInt16) + " W" ``` **Verbindung:** Modbus TCP • Slave ID: $\[SlaveId] ## Importparameter Diese Werte geben Sie beim Import des XML ein. | In der App abgefragt | Standard | |----------------------|-----------------| | IP Address | `192.168.1.100` | | Modbus Slave ID | `1` | ## Verwandte Dokumentation - [Modbus Integration](https://taphome.com/de/compatibility/modbus-guide/) - [Modbus](https://taphome.com/de/docs/integration/modbus/) - [Einfache Konfiguration mit Vorlagen](https://taphome.com/de/docs/integration/modbus/templates/) - [Modbus-Skripte und Prefetch](https://taphome.com/de/docs/script/modbus-scripts/) - [Modbus-Funktionen](https://taphome.com/de/docs/script/modbus/) - [Modbus-Datentypen](https://taphome.com/de/docs/script/modbus-data-types/)