FoxESS FoxESS Avocado (battery) Modbus TCP template

FoxESS Avocado (battery)

De FoxESS Avocado is een compacte all-in-one thuisaccu die een LiFePO4-batterij, een bidirectionele omvormer en vier MPPT-ingangen combineert, bedoeld voor balkonkraftwerken en kleine PV-installaties. Deze Modbus TCP-template leest het actuele batterijvermogen, de gecumuleerde energiedoorvoer en de laadtoestand, en biedt schrijfregisters waarmee de bedrijfsmodus, time-out en vermogensinstelpunt op afstand worden ingesteld. Door de FoxESS Avocado via de ModbusCloud Gateway aan het portaal te koppelen heb je real-time inzicht in laad- en ontlaadcycli en kun je op afstand stuurcommando's geven.

Protocol
Modbus TCP
Aansluiting
Ethernet, Modbus TCP
Registers
8, lezen en schrijven
Merk
FoxESS
Ondersteunde modellen
Avocado · MQ2200 · ONE · Avocado Pro
Laatst bijgewerkt

Registers (8)

3 lezen, 5 schrijven

NaamEenheidToegangAdres (Verborgen tot je je e-mailadres invult)Functie (verborgen)Type (verborgen)
powerWLezen
energyWhLezen
soc%Lezen
batterymode_aSchrijven
batterymode_bSchrijven
batterymode_cSchrijven
batterymode_esSchrijven
batterymode_fWSchrijven

Registers laden…

Stuur jouw apparatenlijst

Staat een apparaat niet in de bibliotheek, dan maken we de template gratis zodra we de registers hebben.

Aantal installaties (optioneel)

Gebruikstoepassingen

  • Bewaak het actuele batterijvermogen om te controleren of de Avocado correct oplaadt tijdens PV-productiepieken.
  • Volg de laadtoestand over tijd om capaciteitsverlies over meerdere seizoenen tijdig te signaleren.
  • Stel een alert in als de laadtoestand onder een drempelwaarde zakt om diepontlading bij langdurig bewolkt weer te voorkomen.
  • Rapporteer de gecumuleerde energiedoorvoer per kwartaal om de round-trip-efficiëntie van de accu te berekenen.
  • Schrijf een vermogenscommando via batterymode_f om ontlading automatisch te verplaatsen naar uren met een hoog elektriciteittarief.

Installatie

  1. Verbind de Avocado via LAN of WLAN met het lokale netwerk en controleer of poort 502 bereikbaar is door een TCP-verbinding naar dat adres te testen voordat je verdergaat.

  2. Sluit de ModbusCloud Gateway aan op hetzelfde netwerksegment als de Avocado en zorg dat geen firewall of VLAN poort 502 blokkeert tussen de Gateway en het apparaat.

  3. Voeg in het ModbusCloud-portaal een nieuw apparaat toe, importeer de FoxESS Avocado (battery)-template en wijs Unit ID 1 toe, de standaard fabrieksinstellling van dit apparaat.

  4. Controleer het soc-register op adres 39424 in de live registerweergave om te bevestigen dat een plausibele waarde tussen 0 en 100 wordt teruggegeven voordat je schrijfregisters activeert.

Veelvoorkomende aandachtspunten

Waarom geeft het vermogen- of energieregister nul of onzinnige waarden terug?

Het vermogensregister op adres 39237 is gedefinieerd als int32 en beslaat twee opeenvolgende 16-bits holdingregisters. Als je polling-tool slechts één register uitleest of het decodeert als int16, krijg je altijd nul of onzin. Zorg dat de template een int32-lezing over twee registers uitvoert. Controleer ook de firmwareversie, want FoxESS past registeradressen aan bij updates.

De Gateway maakt verbinding op poort 502, maar er verschijnen geen waarden. Wat nu?

De Avocado krijgt zijn IP-adres via DHCP, dus dit kan na een herstart van je router gewijzigd zijn. Controleer het huidige adres in de DHCP-leaseoverzicht van je router en werk het apparaatadres bij in het ModbusCloud-portaal. Als de TCP-verbinding wordt geweigerd, controleer dan of een andere Modbus-master (zoals een domoticacontroller) al een exclusieve verbinding op poort 502 heeft, want het apparaat kan extra clients weigeren.

Register 46001 is beschreven, maar de batterijmodus is niet veranderd.

Register 46001 is een bitfield waarbij bit 0 op 1 moet staan om afstandsbediening in te schakelen, bit 1 de vermogensrichting bepaalt en bit 2 het aangestuurde doel selecteert. Een schrijfactie zonder het enable-bit heeft geen effect. Controleer ook of register 46002 (time-out) op een waarde groter dan nul is ingesteld, anders verloopt het commando direct.

Is het veilig om vermogensinstelpunten te schrijven via batterymode_f tijdens normaal gebruik?

Gebruik schrijfregisters met zorg. Het sturen van een actief-vermogenscommando via batterymode_f (adres 46003, int32, watt) overschrijft de ingebouwde laad- en ontlaadlogica van het apparaat. Waarden buiten het nominale vermogensbereik kunnen beveiligingsreacties of thermische begrenzingen activeren. Test altijd met kleine stapsgewijze waarden, stel een passende time-out in via batterymode_e zodat het apparaat automatisch terugvalt, en raadpleeg je garantievoorwaarden voordat je continue afstandsbesturing inschakelt.

Elektricien aan het werk in een open verdeelkast