# GoodWe

> L’intégration du Smart Energy Controller GoodWe SEC3000C dans notre EMS

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

Notre EMS prend en charge le Smart Energy Controller **GoodWe SEC3000C** pour le scénario de stockage commercial **ESA125K / ESA261 (261 kWh)** de GoodWe.

Le SEC3000C n’est pas un onduleur en soi mais une **passerelle EMS tout-en-un** : il agrège tout un site, le stockage par batteries, le PV et un compteur de raccordement intégré, derrière un seul point d’accès Modbus TCP. Comme tout passe par une seule connexion, notre EMS présente le site comme plusieurs appareils logiques (batterie, PV, compteur de raccordement) tous servis par la même intégration.

> **Remarque**
>
> Seule la **variante C** (SEC3000**C**) est prise en charge. C’est la seule qui permette le raccordement et le pilotage en parallèle des onduleurs réseau et hybrides de GoodWe. Le SEC3000 simple est uniquement en lecture et n’est pas pris en charge.

### Appareils pris en charge

| Modèle | Rôle | Scénario |
| --- | --- | --- |
| SEC3000C | Smart Energy Controller | ESA125K / ESA261 |

L’intégration communique en **Modbus TCP** (port `502` par défaut). Le SEC3000C lui-même est adressé comme appareil logique `0` ; le compteur intelligent **GM330** intégré est adressé sur sa propre adresse RS485.

## Comment l’intégration fonctionne

Un SEC3000C est modélisé dans notre EMS comme un appareil parent avec jusqu’à trois appareils enfants, tous pilotés depuis la même connexion Modbus :

-   **PCS (onduleur de batterie)** : l’appareil parent. Il reçoit les commandes de charge et de décharge et rapporte la puissance active et réactive du stockage.
-   **BMS** : il rapporte l’état de charge (SOC), l’état de santé (SOH) et l’état de charge/décharge de la batterie.
-   **PV** : il rapporte la production PV combinée, la puissance PV disponible et la puissance PV nominale.
-   **Compteur de raccordement** : le compteur intelligent **GM330** intégré, présenté comme compteur d’énergie du raccordement. Facultatif : actif uniquement quand l’adresse RS485 du compteur est configurée.

La capacité de la batterie et l’état de charge minimal et maximal se configurent sur l’appareil enfant BMS ; la puissance nominale se configure sur le PCS. La puissance PV nominale et le SOC de la batterie sont relus sur l’appareil. Il n’y a pas de câblage distinct ni d’appareil Modbus supplémentaire à ajouter : les enfants sont créés automatiquement à partir du parent.

### Approche de pilotage

Nous pilotons le système via l’**interface de commande à distance** du SEC3000C. Le contrôleur est maintenu en **Remote Control Mode** (affirmé en continu) pour qu’il suive les consignes de l’EMS, et à chaque cycle de régulation (≈1 s) nous (ré)affirmons les commandes demandées :

-   **Consigne batterie (ESS)** : une consigne directe de puissance de charge et de décharge, bridée à la puissance nominale du stockage et aux limites de charge et de décharge maximales de l’appareil en temps réel.
-   **Écrêtage PV** : une limite explicite de puissance active PV, utilisée quand la production doit être plafonnée.

### Ce qui est relu

-   Batterie : SOC, SOH, puissance active et réactive, statut en réseau ou en site isolé, puissance maximale de charge et de décharge en temps réel.
-   PV : production réelle, puissance actuellement disponible et puissance nominale.
-   Système : puissance active totale PV + stockage et puissance pilotable minimale et maximale.
-   Compteur de raccordement (s’il est configuré) : tensions et courants par phase, puissance active, réactive et apparente totale, facteur de puissance, fréquence et énergie cumulée prélevée et injectée.

## Ce qui est possible avec quelle configuration

Le **compteur de raccordement GM330** intégré est facultatif. Sa configuration détermine si de vraies mesures réseau sont disponibles.

| Fonction | Avec le compteur GM330 | Sans le compteur GM330 |
| --- | --- | --- |
| Suivi de la batterie (SOC / SOH) | ✅ | ✅ |
| Suivi du PV | ✅ | ✅ |
| Suivi du prélèvement et de l’injection | ✅ | ❌ |
| Charge et décharge sur consigne | ✅ | ✅ |
| Écrêtage PV | ✅ | ✅ |
| Limite réseau (prélèvement et injection) | ✅ | ❌ |

> **À retenir :** le pilotage de la batterie et du PV fonctionne sans le compteur. Le GM330 est nécessaire pour les mesures réseau et pour la limitation du prélèvement et de l’injection.

## Paramètres de configuration

Au-delà des paramètres de batterie habituels (capacité, état de charge minimal et maximal), le PCS SEC3000C expose :

-   **Puissance nominale (kW)** : la puissance AC nominale du système de stockage.

La puissance PV nominale est lue sur l’appareil et préremplit la capacité de production de l’enfant PV. Le compteur de raccordement GM330, quand il est utilisé, est ajouté comme appareil enfant compteur d’énergie du raccordement ; son adresse RS485 est transmise au PCS pour que le compteur puisse être lu sur la connexion partagée.

## État de validation

L’intégration est réalisée d’après la **SEC3000C MODBUS Interface Definition Description (v06)**. D’autres fonctions pourront s’ajouter au fil du temps, à mesure que l’intégration évolue.