M-TEC M-TEC Energy Butler GEN3 (battery) Modbus TCP template

M-TEC Energy Butler GEN3 (battery)

De M-TEC Energy Butler GEN3 is een modulair hybride accusysteem met geintegreerde omvormer, geschikt voor woning- en kleinzakelijke PV-installaties. Deze template communiceert via Modbus TCP met RTU-framing over de ingebouwde netwerkinterface van het apparaat. Je leest het batterijvermogen (positief bij ontladen, negatief bij laden) en de laadtoestand, en je kunt via een schrijfregister de bedrijfsmodus aanpassen vanuit het portaal. Door de Energy Butler GEN3 te koppelen aan ModbusCloud hebben installateurs en beheerders live accutelemetrie en modusbesturing direct in hun dashboard beschikbaar.

Protocol
Modbus TCP
Aansluiting
Ethernet, Modbus TCP
Registers
3, lezen en schrijven
Merk
M-TEC
Laatst bijgewerkt

Registers (3)

2 lezen, 1 schrijven

NaamEenheidToegangAdres (Verborgen tot je je e-mailadres invult)Functie (verborgen)Type (verborgen)
powerWLezen
soc%Lezen
batterymodeSchrijven

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

  • Volg de laadtoestand continu om capaciteitsafname over meerdere seizoenen te signaleren.
  • Controleer het teken van het vermogensregister om te verifiëren of de accu laadt vanuit PV-overschot of ontlaadt naar het verbruik.
  • Stel een melding in wanneer de laadtoestand daalt onder een ingestelde drempel tijdens langere perioden met weinig zon.
  • Schrijf de bedrijfsmodus via het portaal om de accu tijdens goedkope tariefuren automatisch bij te laden.
  • Vergelijk dagelijkse laad- en ontlaadcycli met verwachte waarden om afwijkend accugedrag vroegtijdig te signaleren.

Installatie

  1. Verbind de ModbusCloud Gateway met hetzelfde LAN-segment als de Energy Butler GEN3. Het apparaat biedt een ingebouwde Modbus TCP-server via zijn netwerkinterface; er is geen RS485-adapter nodig. Noteer het IP-adres van het apparaat.

  2. Voeg in het ModbusCloud-portaal een nieuw apparaat toe, kies het TCP-protocol, vul het IP-adres van de Energy Butler GEN3 in en stel de Modbus-poort in. De standaardpoort is 5743 bij oudere firmware; apparaten met firmware V27.52.4.0 of nieuwer gebruiken poort 502. Stel het slave-ID in op 252.

  3. Importeer de M-TEC Energy Butler GEN3 (battery) template uit de bibliotheek met een klik en koppel deze aan de aangemaakte Gateway-entry. Controleer dat functiecode 3 voor lezen en functiecode 16 voor schrijven zijn ingesteld.

  4. Controleer het soc-register (adres 33000) in de live registerweergave van je portaal en bevestig dat de waarde overeenkomt met de laadtoestand op het display van het apparaat of in de app voordat je schrijfbewerkingen inschakelt.

Veelvoorkomende aandachtspunten

De gateway verbindt maar alle registerwaarden zijn nul of time-out.

De Energy Butler GEN3 biedt Modbus aan via zijn ingebouwde Wi-Fi- of LAN-interface met RTU-framing ingepakt in TCP. Controleer of je RTU-over-TCP-framing gebruikt en niet gewone Modbus TCP. Controleer ook of het slave-ID op 252 staat en de juiste poort is ingesteld (5743 voor firmware onder V27.52.4.0, of 502 voor V27.52.4.0 en nieuwer).

Waarom toont het vermogensregister op adres 30258 onverwacht grote waarden?

Adres 30258 valt in het GEN3-invoerregisterbereik (30000-reeks) en wordt gedecodeerd als een signed int32 over twee opeenvolgende 16-bit registers. Zorg dat je Modbus-client twee registers leest vanaf adres 30258 en deze als een int32 decodeert. Een verkeerd aantal registers of een afwijkende byte-volgorde levert ongeldige waarden op. Positieve waarden staan voor ontladen, negatieve voor laden.

Het soc-register leest een grote integer in plaats van een percentage.

Register 33000 geeft een uint16 terug. Uit ervaringen van gebruikers blijkt dat M-TEC in sommige firmware-versies een schaalfactor van 0,01 toepast op de ruwe SOC-waarde. Een ruwe waarde van 9000 staat dan voor 90%. Vergelijk met het lokale display en pas de schaalfactor aan in je kanaalconfiguratie als de waarde buiten het bereik 0-100 valt.

Is het veilig om tijdens normale werking naar het batterymode-register te schrijven?

Wees voorzichtig bij schrijven naar register 50000 (batterymode). Een niet-ondersteunde moduswaarde of te snelle wisseling kan de omvormer in een beveiligingsmodus brengen of leiden tot onverwacht gedrag. Verifieer altijd de geldige moduswaarden in de M-TEC-documentatie voor jouw firmwareversie voordat je geautomatiseerde schrijfbewerkingen inschakelt, en test eerst handmatig.

Elektricien aan het werk in een open verdeelkast