FoxESS FoxESS Avocado (battery) Modbus TCP template

FoxESS Avocado (battery)

Der FoxESS Avocado ist ein kompakter All-in-One-Batteriespeicher, der eine LiFePO4-Batterie, einen bidirektionalen Wechselrichter und vier MPPT-Eingänge vereint und für Balkonkraftwerke sowie kleine PV-Anlagen konzipiert ist. Diese Modbus-TCP-Vorlage liest die aktuelle Batterieleistung, den kumulierten Energiedurchsatz und den Ladezustand aus und stellt Schreibregister bereit, mit denen Betriebsmodus, Timeout und Leistungssollwert ferngesteuert werden. Über das ModbusCloud Gateway verbinden Sie den FoxESS Avocado mit Ihrem Portal und erhalten so lückenlose Transparenz über Lade- und Entladezyklen.

Protokoll
Modbus TCP
Anschluss
Ethernet, Modbus TCP
Register
8, lesen und schreiben
Marke
FoxESS
Kompatible Modelle
Avocado · MQ2200 · ONE · Avocado Pro
Zuletzt aktualisiert

Register (8)

3 lesen, 5 schreiben

NameEinheitZugriffAdresse (Verborgen bis zur Eingabe Ihrer E-Mail-Adresse)Funktion (verborgen)Typ (verborgen)
powerWLesen
energyWhLesen
soc%Lesen
batterymode_aSchreiben
batterymode_bSchreiben
batterymode_cSchreiben
batterymode_esSchreiben
batterymode_fWSchreiben

Register werden geladen…

Senden Sie Ihre Geräteliste

Steht ein Gerät noch nicht in der Bibliothek, erstellen wir die Vorlage kostenlos, sobald wir die Register haben.

Anzahl Anlagen (optional)

Anwendungsfälle

  • Überwachen Sie die aktuelle Batterieleistung, um sicherzustellen, dass der Avocado während PV-Produktionsspitzen korrekt lädt.
  • Verfolgen Sie den Ladezustand langfristig, um Kapazitätsverluste über mehrere Betriebssaisonen frühzeitig zu erkennen.
  • Richten Sie eine Benachrichtigung ein, wenn der Ladezustand unter einen Schwellenwert fällt, um Tiefentladung bei längerem Bewölkungszeitraum zu vermeiden.
  • Berichten Sie den kumulierten Energiedurchsatz quartalsweise, um die Hin-und-Rück-Effizienz des Batteriespeichers auszuwerten.
  • Schreiben Sie über batterymode_f einen Leistungssollwert, um die Entladung automatisch in Hochpreiszeitfenster zu verschieben.

Installation

  1. Verbinden Sie den Avocado über LAN oder WLAN mit Ihrem lokalen Netzwerk und prüfen Sie, ob Port 502 erreichbar ist, indem Sie eine TCP-Verbindung zu diesem Port testen, bevor Sie fortfahren.

  2. Schließen Sie das ModbusCloud Gateway an dasselbe Netzwerksegment wie den Avocado an und stellen Sie sicher, dass keine Firewall oder VLAN Port 502 zwischen Gateway und Gerät blockiert.

  3. Legen Sie im ModbusCloud-Portal ein neues Gerät an, importieren Sie die Vorlage FoxESS Avocado (battery) und weisen Sie die Unit-ID 1 zu, die werkseitige Standardeinstellung dieses Geräts.

  4. Prüfen Sie das soc-Register unter Adresse 39424 in der Live-Registeransicht, um zu bestätigen, dass ein plausibler Wert zwischen 0 und 100 zurückgeliefert wird, bevor Sie Schreibregister aktivieren.

Zu beachten

Warum liefern die Leistungs- oder Energieregister Null oder unsinnige Werte?

Das Leistungsregister an Adresse 39237 ist als int32 definiert und umfasst zwei aufeinanderfolgende 16-Bit-Holding-Register. Liest Ihr Polling-Tool nur ein Register aus oder dekodiert es als int16, erhalten Sie immer null oder falsche Werte. Stellen Sie sicher, dass die Vorlage eine int32-Abfrage über zwei Register durchführt. Prüfen Sie außerdem die Firmwareversion, da FoxESS bei Updates Registeradressen und Datentypen anpassen kann.

Das Gateway verbindet sich auf Port 502, aber es erscheinen keine Messwerte.

Der Avocado bezieht seine IP-Adresse per DHCP, sodass diese nach einem Router-Neustart geändert sein kann. Prüfen Sie die aktuelle Adresse in der DHCP-Leasing-Tabelle Ihres Routers und aktualisieren Sie die Geräteadresse im ModbusCloud-Portal. Wird die TCP-Verbindung abgelehnt, prüfen Sie, ob ein anderer Modbus-Master bereits eine exklusive Verbindung auf Port 502 hält, da das Gerät zusätzliche Clients abweisen kann.

Register 46001 wurde beschrieben, aber der Batteriemodus hat sich nicht geändert.

Register 46001 ist ein Bitfield: Bit 0 muss auf 1 gesetzt werden, um die Fernsteuerung zu aktivieren, Bit 1 legt die Leistungsrichtung fest und Bit 2 wählt das Steuerziel aus. Ein Schreibvorgang ohne gesetztes Enable-Bit bleibt wirkungslos. Stellen Sie außerdem sicher, dass Register 46002 (Timeout) auf einen Wert größer als null gesetzt ist, da der Befehl sonst sofort verfällt.

Ist das Schreiben von Leistungssollwerten über batterymode_f im Betrieb sicher?

Verwenden Sie Schreibregister mit Sorgfalt. Ein Leistungssollwert über batterymode_f (Adresse 46003, int32, Watt) überschreibt die interne Lade- und Entladelogik des Geräts. Werte außerhalb des Nennleistungsbereichs können Schutzreaktionen oder thermische Begrenzungen auslösen. Testen Sie stets mit kleinen Schritten, setzen Sie über batterymode_e einen angemessenen Timeout, damit das Gerät automatisch zurückfällt, und prüfen Sie Ihre Garantiebedingungen, bevor Sie eine dauerhafte Fernsteuerung einrichten.

Weitere FoxESS-Vorlagen

Selbst sehen, wie es funktioniert?

Elektriker bei der Arbeit an einem offenen Verteilerschrank