TapHome
Community Beta Energie & Messung

my-PV AC-THOR and AC-THOR 9s

Der Photovoltaik-Power-Manager my-PV AC•THOR und AC•THOR 9s in TapHome über Modbus TCP: TapHome schreibt die Heizleistung aus dem PV-Überschuss und liest die Warmwassertemperatur, die Heizleistung mit Solar- und Netzanteil, den Betriebszustand und Netzwerte.

Modbus TCP3 GeräteRevision 1.1 Zuletzt aktualisiert: 10. November 2026

Eingereicht von Martin Keller

my-PV AC-THOR and AC-THOR 9s

Import in die TapHome AppHardware › Modbus › Aus Vorlage hinzufügen

Vorlage herunterladen
Auf dieser Seite

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

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)

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)

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)

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.

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.

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

ParameterWert
ProtokollModbus TCP
Port502
Modbus Slave ID (Standardwert der Vorlage)1
RegistertypHolding-Register (Lesen 0x03, Schreiben 0x06 / 0x10)
Datenformat16-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.

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:

AttributRegisterBedeutung
Operating statusH:1003Betriebszustand: Off (0, aus), Starting up (Anlauf), Operation (9, Betrieb), Power stage error (Fehler des Leistungsteils, ab 200)
Voltage L1H:1061Netzspannung an L1 in V
Current L1H:1062Strom an L1 in A (Auflösung 0,1 A)
Grid frequencyH:1064Netzfrequenz in Hz
Grid meter powerH:1069Leistung am Zählpunkt in W, negative Werte bedeuten Einspeisung
Maximum power currently possibleH:1071Maximale 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

AC•THOR

Lesen (Modul)
VAR Code := MODBUSR(H, 1003, UInt16);
IF(Code >= 200)
  ADDERROR(0, "Power stage error (status code " + TOSTRING(Code) + ")");
END
Serviceattribute
Operating status
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
MODBUSR(H, 1061, UInt16) + " V"
Current L1
MODBUSR(H, 1062, UInt16) / 10 + " A"
Grid frequency
TOSTRING(MODBUSR(H, 1064, UInt16) / 1000, "F2") + " Hz"
Grid meter power
MODBUSR(H, 1069, Int16) + " W"
Maximum power currently possible
MODBUSR(H, 1071, UInt16) + " W"
Power Target Variable

Power Target

Lesen
MODBUSR(H, 1000, UInt16)
Schreiben
MODBUSW(H, 1000, UInt16, Va)
Hot Water Temperature Temperatursensor

Hot Water Temperature

Temperatur lesen
MODBUSR(H, 1001, UInt16) / 10
Heating Power Stromzähler
Serviceattribute
Solar part of heating power
Grid part of heating power

Heating Power

Bedarf lesen
MODBUSR(H, 1082, UInt16) / 1000
Serviceattribute
Solar part of heating power
MODBUSR(H, 1083, UInt16) + " W"
Grid part of heating power
MODBUSR(H, 1084, UInt16) + " W"
Verbindung: Modbus TCP • Slave ID: $[SlaveId]

Importparameter

Diese Werte geben Sie beim Import des XML ein.

In der App abgefragtStandard
IP Address192.168.1.100
Modbus Slave ID1

Haben Sie ein Problem mit dieser Gerätevorlage gefunden?

Sagen Sie uns, was nicht funktioniert, was fehlt oder wie sich die Vorlage verhalten sollte. Ihr Feedback hilft uns, den Katalog genau zu halten.

Vorlage · TapHome-Portal my-PV AC-THOR and AC-THOR 9s Öffne diese Vorlage im Kundenportal, um sie auf eine deiner Wohnungen anzuwenden, oder entwirf eine Anpassung und reiche sie an den Katalog ein. Modbus TCP Im TapHome-Portal ansehen