# GoodWe

> De integratie van de GoodWe SEC3000C Smart Energy Controller in ons EMS

Source: https://voltmasters.io/nl/docs/device-integrations/battery-systems/goodwe/

Ons EMS ondersteunt de **GoodWe SEC3000C** Smart Energy Controller voor het commerciële opslagscenario **ESA125K en ESA261 (261 kWh)** van GoodWe.

De SEC3000C is zelf geen omvormer maar een **alles-in-een EMS-gateway**: hij bundelt een hele site, met batterijopslag, PV en een ingebouwde netmeter, achter één Modbus TCP-endpoint. Omdat alles via die ene verbinding loopt, toont ons EMS de site als een aantal logische toestellen (batterij, PV, netmeter) die allemaal door dezelfde integratie bediend worden.

> **Opmerking**
>
> Enkel de **C-variant** (SEC3000**C**) wordt ondersteund. Dat is de enige variant die de on-grid- en hybride omvormers van GoodWe parallel kan aansluiten en aansturen. De gewone SEC3000 kan enkel opvolgen en wordt niet ondersteund.

### Ondersteunde toestellen

| Model | Rol | Scenario |
| --- | --- | --- |
| SEC3000C | Smart Energy Controller | ESA125K en ESA261 |

De integratie praat over **Modbus TCP** (standaardpoort `502`). De SEC3000C zelf wordt aangesproken als logisch toestel-ID `0`; de ingebouwde **GM330**\-slimme meter op zijn eigen RS485-adres.

## Hoe de integratie werkt

Eén SEC3000C verschijnt in ons EMS als één bovenliggend toestel met tot drie onderliggende toestellen, allemaal vanuit dezelfde Modbus-verbinding aangestuurd:

-   **PCS (batterijomvormer)**: het bovenliggende toestel. Het krijgt de laad- en ontlaadcommando's en geeft het actief en reactief vermogen van de opslag door.
-   **BMS**: geeft de laadtoestand (SoC), de gezondheidstoestand (SoH) en de laad- of ontlaadtoestand van de batterij door.
-   **PV**: geeft de samengetelde PV-productie, het beschikbare PV-vermogen en het nominaal PV-vermogen door.
-   **Netmeter**: de ingebouwde **GM330**\-slimme meter, aangeboden als energiemeter op het net. Optioneel: enkel actief wanneer het RS485-adres van de meter ingesteld staat.

De batterijcapaciteit en de minimale en maximale laadtoestand stel je in op het onderliggende BMS-toestel; het nominaal vermogen op de PCS. Het nominaal PV-vermogen en de SoC van de batterij worden uit het toestel gelezen. Er is geen aparte bekabeling en geen bijkomend Modbus-toestel nodig: de onderliggende toestellen worden automatisch vanuit het bovenliggende aangemaakt.

### Aanpak van de aansturing

Wij sturen het systeem aan via de **remote control-interface** van de SEC3000C. De controller wordt in **Remote Control Mode** gehouden, voortdurend opnieuw bevestigd, zodat hij de setpoints van het EMS volgt, en elke regelcyclus (ongeveer 1 s) schrijven we de gevraagde commando's opnieuw weg:

-   **Batterijsetpoint (ESS)**: een rechtstreeks setpoint voor het laad- en ontlaadvermogen, begrensd door het nominaal vermogen van de opslag en door de maximale laad- en ontlaadgrenzen die het toestel op dat moment doorgeeft.
-   **PV afregelen**: een uitdrukkelijke grens op het actief PV-vermogen, gebruikt wanneer de productie begrensd moet worden.

### Wat er teruggelezen wordt

-   Batterij: SoC, SoH, actief en reactief vermogen, de status on-grid of off-grid, en het maximale laad- en ontlaadvermogen op dat moment.
-   PV: de actuele productie, het op dat moment beschikbare vermogen en het nominaal vermogen.
-   Systeem: het totale actief vermogen van PV en opslag samen, en het minimale en maximale aanstuurbare vermogen.
-   Netmeter (wanneer ingesteld): spanningen en stromen per fase, het totale actief, reactief en schijnbaar vermogen, de arbeidsfactor, de frequentie en de cumulatief afgenomen en geïnjecteerde energie.

## Wat kan met welke opstelling

De ingebouwde **GM330-netmeter** is optioneel. Of hij ingesteld staat, bepaalt of er echte netmetingen beschikbaar zijn.

| Mogelijkheid | Met GM330-meter | Zonder GM330-meter |
| --- | --- | --- |
| De batterij opvolgen (SoC en SoH) | ✅ | ✅ |
| De PV opvolgen | ✅ | ✅ |
| Afname en injectie op het net opvolgen | ✅ | ❌ |
| Laden en ontladen op setpoint | ✅ | ✅ |
| PV afregelen | ✅ | ✅ |
| Netgrens (afname en injectie) | ✅ | ❌ |

> **Kort samengevat:** de aansturing van de batterij en de PV werkt zonder de meter. De GM330 heb je nodig voor netmetingen en om de afname en de injectie op het net te begrenzen.

## Configuratieparameters

Naast de gewone batterijparameters (capaciteit, minimale en maximale laadtoestand) biedt de PCS van de SEC3000C:

-   **Nominaal vermogen (kW)**: het nominale AC-vermogen van het opslagsysteem.

Het nominaal PV-vermogen wordt uit het toestel gelezen en vult het productievermogen van het onderliggende PV-toestel al in. Gebruik je de GM330-netmeter, dan komt die er als onderliggende energiemeter voor het net bij; zijn RS485-adres gaat door naar de PCS, zodat de meter over de gedeelde verbinding uitgelezen kan worden.

## Validation status

De integratie is gebouwd tegen de **SEC3000C MODBUS Interface Definition Description (v06)**. Er kan later functionaliteit bijkomen naarmate de integratie uitbreidt.