SolaX
Die SolaX X1-HYBRID und X3-HYBRID Gen 4 sind Energiespeicher-Wechselrichter mit PV und Batterie, erhältlich als einphasige (3–7,5 kW) und dreiphasige (5–15 kW) Modelle. Diese Community-Vorlage ist die offizielle TapHome-Vorlage für SolaX Gen 4, deren Messwerte anhand des SolaX-Modbus-Protokolls (V3.21 und V001.02) korrigiert wurden. Sie kommuniziert über Modbus RTU per RS-485 und liest Batterieladezustand und -temperatur, PV-String-Leistung, Netzleistungsfluss, Energiesummen, Lademodus und Nachtlade-SOC. Die Gerätenamen sind dieselben wie in der offiziellen Vorlage, sodass sich ein älterer Import Gerät für Gerät vergleichen lässt. Alle Schreibskripte bleiben wie in der offiziellen Vorlage auskommentiert, die Vorlage ist also schreibgeschützt.
Das Modul wertet außerdem den 32-Bit-Fehlercode des Wechselrichters und den 16-Bit-Manager-Fehlercode aus und meldet jeden Fehler in TapHome mit einem eigenen Fehlercode.
So erhalten Sie die Vorlage
Community-Vorlagen werden in der Vorlagenliste der TapHome-App nicht angeboten. Melden Sie sich bei portal.taphome.com an, laden Sie die XML-Datei dieser Vorlage herunter und importieren Sie sie in die Steuereinheit Core. Ein früher aus der offiziellen Vorlage SolaX Hybrid X1/X3 Gen 4 importiertes Modul aktualisiert sich nicht selbst — importieren Sie entweder diese Vorlage als neues Modul, oder korrigieren Sie die Skripte des alten Moduls, wie es die Tabelle unter „Was diese Vorlage korrigiert“ weiter unten zeigt.
Hardwareanschluss
Der SolaX Gen 4 Wechselrichter bietet an der Unterseite einen RS-485 COM-Port für die Modbus RTU-Kommunikation. Der COM-Port verwendet einen RJ45-Stecker.
Pin-Belegung des COM-Anschlusses (RJ45):
| Pin | Belegung | Beschreibung |
|---|---|---|
| 1 | Drycontact_A(in) | Systemschalter-Anschluss |
| 2 | Drycontact_B(in) | Systemschalter-Anschluss |
| 3 | +13V | — |
| 4 | 485A | RS-485 Data+ (für TapHome) |
| 5 | 485B | RS-485 Data− (für TapHome) |
| 6 | GND | Masse |
| 7 | Drycontact_A(out) | Generator-Anschluss |
| 8 | Drycontact_B(out) | Generator-Anschluss |
Verbinden Sie TapHome mit dem COM-Port des Wechselrichters:
- Pin 4 (485A) am COM-Port des Wechselrichters zu A+/D+ am TapHome RS-485
- Pin 5 (485B) am COM-Port des Wechselrichters zu B-/D- am TapHome RS-485
- Pin 6 (GND) — Anschluss empfohlen für zuverlässige Kommunikation
Das SolaX-Handbuch schreibt ein CAT5E-Netzwerkkabel vor, das in den mit dem Wechselrichter gelieferten RJ45-Stecker gecrimpt wird, sowie eine COM-Kabellänge von höchstens 30 m.
Pin 3 (+13V) und Pin 6 (GND) dürfen nicht miteinander verbunden werden. Isolieren Sie die nicht verwendeten Pins.
Der Wechselrichter selbst unterstützt Modbus TCP nicht nativ. Modbus TCP ist nur über das SolaX-Überwachungsmodul (WLAN-Dongle) verfügbar und wird von dieser Vorlage nicht verwendet.
Für Installationen, bei denen eine RS-485-Verkabelung nicht praktikabel ist, bietet die Vorlage SolaX Inverter (Cloud API) Überwachung über die SolaxCloud-Plattform per HTTPS — ohne physische Verbindung. Sie unterstützt alle SolaX-Wechselrichtertypen, nicht nur den Gen 4 Hybrid.
Lademodus und Nachtladeeinstellungen sind EEPROM-Register im Wechselrichter (von SolaX mit ★ gekennzeichnet, etwa 1 Million Schreibzyklen). Übermäßige Schreibvorgänge können irreversible Hardwareschäden verursachen — aktivieren Sie auf diesen Registern niemals einen Schreibvorgang, der periodisch läuft. In dieser Vorlage sind alle Schreibskripte deaktiviert.
Konfiguration
Modbus-Kommunikation aktivieren
Modbus RTU ist am RS-485 COM-Port des Wechselrichters standardmäßig verfügbar. Die folgenden Parameter müssen zwischen dem Wechselrichter und dem TapHome-Modul übereinstimmen:
- Slave ID – Standard ist 1, am Wechselrichter-Display konfigurierbar. Die Vorlage fragt sie als einzigen Importparameter ab, Modbus Slave ID (Standard 1)
- Baudrate – 19200 Baud, die SolaX-Werkseinstellung; auch die Vorlage verwendet 19200. Wurde der Wechselrichter auf eine andere Geschwindigkeit eingestellt (zum Beispiel 9600), ändern Sie entweder die Einstellung des Wechselrichters oder die Geschwindigkeit der TapHome-Schnittstelle, damit beide übereinstimmen
- Datenformat – 8 Datenbits, keine Parität, 1 Stoppbit
Konfiguration am Wechselrichter-Display: Menu > Setting > Advance Setting > Modbus. Stellen Sie Slave-Adresse und Baudrate ein. Für die erweiterten Einstellungen ist das Installateur-Passwort erforderlich, das Sie beim Händler erhalten. Die Baudrate lässt sich auch aus dem Holding-Register H:0x00B0 lesen und über das Register 0x00CA schreiben (Werte: 0=115200, 1=57600, 2=56000, 3=38400, 4=19200, 5=14400, 6=9600).
In TapHome wird die Vorlage anschließend an der RS-485 Modbus RTU-Schnittstelle der Steuereinheit Core importiert, die auf dieselbe Geschwindigkeit und dasselbe Datenformat eingestellt ist, mit der Slave ID des Wechselrichters.
Kommunikationstiming
Das Protokoll erfordert ein Mindestintervall von 1 Sekunde zwischen aufeinanderfolgenden Modbus-Anweisungen und einen Zeichenabstand-Timeout von mindestens 100 ms. Der Antwort-Timeout beträgt 1 Sekunde. Die Vorlage verwendet individuelle Abfrageintervalle pro Gerät (2,5 s bis 150 s), die diese Anforderungen erfüllen.
Funktion des RS-485 COM-Ports
Das Register H:0x013E (485CommFunSelect) bestimmt, ob der RS-485-Port für die Modbus-Kommunikation (Wert 0) oder für die Kommunikation mit einem EV-Ladegerät (Wert 1) verwendet wird. Stellen Sie sicher, dass es für die TapHome-Integration auf 0 (Modbus 485) eingestellt ist.
Gerätefunktionen
Batterieüberwachung
- Batterie (SOC) – liest den Batterieladezustand (A:0x001C) als Prozentwert, alle 15 Sekunden. Der Rohwert des Registers in 1-%-Schritten wird für den TapHome-Analogeingang mit dem Bereich 0–1 durch 100 geteilt (z. B. wird aus 85 % der Wert 0,85)
- Battery Temperature – liest die Batterietemperatur (A:0x0018) in Grad Celsius als vorzeichenbehafteten Wert (Int16), sodass Temperaturen unter 0 °C korrekt angezeigt werden. Abfrage alle 80 Sekunden
Solar-PV-Leistung
- PV1 – DC-Ausgangsleistung von PV-String 1 (A:0x000A), in kW angezeigt nach Umrechnung von Watt (/1000)
- PV2 – DC-Ausgangsleistung von PV-String 2 (A:0x000B), in kW angezeigt nach Umrechnung von Watt (/1000)
PV1 und PV2 sind reine Werte ohne Energietyp, sodass sie im Energy Dashboard nicht doppelt gezählt werden.
Netzleistung und Energiemessung
- Purchase/Feed to Grid – momentane Netzleistung (A:0x0046–0x0047, LittleEndianInt32) in kW, ein reiner Wert ohne Energietyp. Positive Werte bedeuten Einspeisung ins Netz, negative Werte Bezug aus dem Netz. Der Wechselrichter übernimmt diesen Wert vom angeschlossenen Zähler oder Stromwandler (CT)
- Daily/Actual Energy – der PV-Produktionszähler für das Energy Dashboard. Seine Leistung ist PV1 + PV2 (A:0x000A + A:0x000B) in kW, sein Gesamtwert ist die gesamte PV-Energie (A:0x0094–0x0095, SolarEnergyTotal, Einheit 0,1 kWh) in kWh. Trotz seines Namens wird der Gesamtwert nachts nicht zurückgesetzt
- Total Energy – kumulierte Gesamtenergie, die über die Lebensdauer am AC-Port des Wechselrichters abgegeben wurde (A:0x0052–0x0053, LittleEndianUint32, Einheit 0,1 kWh), angezeigt in kWh
Lademodus und Nachtladung
- Charger Use Mode – liest den aktiven Solarlademodus (H:0x008B): Self Use Mode (0), Feedin Priority (1), Backup Mode (2) oder Manual Mode (3). Das Schreibregister (H:0x001F) ist in der Vorlage vorhanden, aber auskommentiert, daher ist der Wert schreibgeschützt
- SelfUse Night Charge – liest den oberen SOC-Zielwert für die Nachtladung im Self-Use-Modus (H:0x0094) als Prozentwert. Das Schreibregister (H:0x0063) und das Aktivierungsregister (H:0x0062) sind beide auskommentiert, sodass sich die Nachtladekonfiguration über TapHome nicht ändern lässt
Fehlererkennung
Das Leseskript des Moduls überwacht den Betriebsmodus des Wechselrichters (A:0x0009) und zwei Fehlerregister. Jeder Fehler hat einen eigenen Fehlercode:
- Fehler des Run mode – Fehler 1, wenn der Betriebsmodus 3 (Fault) ist, Fehler 2, wenn er 4 (Permanent Fault) ist
- Fehlercode des Wechselrichters (A:0x0040–0x0041, LittleEndianUint32) – 30 einzelne Fehler mit den Codes 100–131 (100 + Bitnummer), darunter Netzspannungs- und Netzfrequenzfehler, PV-Spannungsfehler, Batteriefehler, Isolationsfehler, Übertemperatur, Überstromschutz, Relaisfehler und Kommunikationsfehler. Die Fehlernamen folgen der X3-Tabelle des SolaX-Protokolls
- Manager-Fehlercode (A:0x0043) – Codes 200–211 (200 + Bitnummer) für Leistungstyp-Fehler, EEPROM-Fehler, Probleme mit NTC-Sensoren, zu niedrige/zu hohe Batterietemperatur, Zählerfehler, Bypass-Relais- und Lüfterfehler. Port OC Warning (201) wird als Warnung gemeldet, die übrigen als Fehler
Das Service-Attribut Run mode am Modul zeigt den aktuellen Zustand des Wechselrichters als Text an: Waiting, Checking, Normal, Fault, Permanent fault, Update, Off-grid waiting, Off-grid, Self testing, Idle oder Standby.
Was diese Vorlage korrigiert
Die offizielle TapHome-Vorlage SolaX Hybrid X1/X3 Gen 4 liest mehrere Register falsch (geprüft anhand des SolaX-Modbus-Protokolls V3.21 und V001.02). Diese Vorlage korrigiert sie:
| Wo | Offizielle Vorlage | Diese Vorlage | Auswirkung des Fehlers in der offiziellen Vorlage |
|---|---|---|---|
| Modul — Leseskript | var x3 := MODBUSR(A, 0x0040, Uint32); | VAR inv := MODBUSR(A, 0x0040, LittleEndianUint32); | Die beiden Hälften des 32-Bit-Fehlercodes sind vertauscht: Ein Fehler in Bit 1 (Grid Lost Fault) wird als Bit 17 (Bat Power Low) gemeldet |
| Total Energy | MODBUSR(A, 0x52, LittleEndianInt32) / 1000 | MODBUSR(A, 0x0052, LittleEndianUint32) / 10 | Wert 100× zu klein (das Register zählt in 0,1 kWh) |
| Daily/Actual Energy — Gesamtwert | MODBUSR(A, 0x50, UInt16) /10 | MODBUSR(A, 0x0094, LittleEndianUint32) / 10 | 0x0050 ist ein Tageszähler des AC-Ports des Wechselrichters, der jede Nacht auf 0 fällt; 0x0094 ist die gesamte PV-Energie |
| Daily/Actual Energy — Leistung | MODBUSR(A,0x02, Int16)/1000 | (MODBUSR(A, 0x000A, UInt16) + MODBUSR(A, 0x000B, UInt16)) / 1000 | 0x0002 ist die Netzleistung der einphasigen X1-Modelle, nicht die PV-Produktion; auf vielen X3-Geräten liest es 0 |
| Battery Temperature | MODBUSR(A,0x0018, UInt16) | MODBUSR(A, 0x0018, Int16) | Unter 0 °C zeigt die offizielle Vorlage etwa 65535 °C |
| Schnittstellengeschwindigkeit | 9600 Baud | 19200 Baud | 19200 ist die SolaX-Werkseinstellung |
Mit den korrigierten Skripten misst der Zähler Daily/Actual Energy die PV-Produktion (PV1 + PV2), genau das, was sein Energietyp im Energy Dashboard erwartet. PV1, PV2 und Purchase/Feed to Grid tragen keinen Energietyp mehr — sie sind reine Werte. Alle Schreibvorgänge bleiben wie in der offiziellen Vorlage deaktiviert.
Fehlerbehebung
Keine Kommunikation mit dem Wechselrichter
- Überprüfen Sie die RS-485-Kabelverbindungen: A+ zu A+, B- zu B-, GND zu GND
- Prüfen Sie, ob das Register H:0x013E auf 0 eingestellt ist (Modus Modbus 485, nicht EV-Ladegerät)
- Stellen Sie sicher, dass die Baudrate zwischen Wechselrichter und TapHome übereinstimmt – die Vorlage verwendet 19200, die Standardeinstellung des Wechselrichters; bei einem auf 9600 eingestellten Wechselrichter muss eine der beiden Seiten geändert werden
- Überprüfen Sie, ob die Modbus Slave ID in TapHome mit der Einstellung des Wechselrichters übereinstimmt (Standard: 1)
- Stellen Sie sicher, dass kein anderer Modbus-Master am selben RS-485-Bus angeschlossen ist – Modbus unterstützt nur einen einzigen Master
Die Werte sehen aus wie bei der offiziellen Vorlage
Wenn Total Energy 100× zu klein ist, Daily/Actual Energy jede Nacht auf 0 fällt oder Battery Temperature bei Frost etwa 65535 °C anzeigt, führt das Modul noch die Skripte der offiziellen Vorlage aus. Ein Modul aktualisiert sich nicht selbst aus einer neueren Vorlage — importieren Sie diese Vorlage als neues Modul, oder korrigieren Sie die Skripte, wie es die Tabelle oben zeigt.
Falsche Anzeige von Batterie (SOC)
Das Register von Batterie (SOC) (A:0x001C) meldet Werte in 1-%-Schritten. Die Vorlage teilt für den TapHome-Analogeingang mit dem Bereich 0–1 durch 100. Wenn der angezeigte Wert falsch erscheint, prüfen Sie, ob das TapHome-Gerät als Analogeingang konfiguriert ist (Bereich 0–1, nicht 0–100).
Vorzeichenkonvention der Netzleistung
Purchase/Feed to Grid (A:0x0046) verwendet eine Vorzeichenkonvention, bei der positive Werte Einspeisung (Export ins Netz) und negative Werte Bezug (Entnahme aus dem Netz) bedeuten. Der Wechselrichter erhält diesen Wert von seinem Zähler oder Stromwandler (CT), daher hängt er von einem korrekt angeschlossenen Zähler oder Stromwandler ab.
Unterschiede zwischen X1 und X3
Die Vorlage liest die PV-Leistung (A:0x000A und A:0x000B) statt des X1-Netzleistungsregisters, sodass der Zähler Daily/Actual Energy bei X1- und X3-Modellen gleichermaßen funktioniert. Die Fehlernamen folgen der X3-Tabelle des SolaX-Protokolls. Bei einem X1-Wechselrichter bedeuten einige Fehlerbits andere Fehler — Bit 9 und die meisten Bits ab Bit 15 (zum Beispiel ist Bit 15 bei X1 Missed CT Fault, bei X3 jedoch Off-grid Overload).
