# Victron

> Victron dans le Voltmasters EMS : tout onduleur de batterie ou hybride joignable via le service VE.Bus d’un appareil GX sous Venus OS.

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

Notre EMS prend en charge les systèmes de batteries de Victron.

Victron développe des solutions de stockage compactes et modulaires pour les applications résidentielles et de petit commercial.

### Appareils pris en charge

Nous prenons en charge tous les onduleurs de batterie ou hybrides Victron qui s’exposent via le service VE.Bus d’un appareil GX sous Venus OS (Cerbo GX, CCGX, Venus GX, MultiPlus-II GX, etc.) :

-   **Victron MultiPlus** : solution compacte pour un stockage efficace et un cyclage quotidien de la batterie
-   **Victron MultiPlus-II** : onduleur-chargeur hybride amélioré pour une gestion d’énergie avancée
-   **Victron Quattro** : solution souple à double entrée pour les systèmes en site isolé et de secours
-   **Victron Quattro-II** : onduleur-chargeur à double entrée de nouvelle génération pour les installations exigeantes
-   **Victron EasySolar-II** : onduleur-chargeur tout-en-un avec chargeur solaire MPPT intégré

## Topologie du système

L’intégration communique en **Modbus TCP avec l’appareil GX**, et non directement avec les onduleurs. L’appareil GX expose chaque composant Victron raccordé sous un unit ID Modbus distinct :

| Composant | Unit ID Modbus |
| --- | --- |
| Service système / réglages | `100` (fixe) |
| Onduleur-chargeur VE.Bus | L’unit ID du service VE.Bus (par exemple `227`, `229`, etc.) |
| Batterie gérée par le GX (BMS) | `225` |
| Chargeurs solaires MPPT couplés en DC | L’instance d’appareil (VE.Can : `1` et plus, ports VE.Direct : `223` à `247`) |
| Onduleurs PV couplés en AC (Fronius, ABB, etc.) | `20` à `29` |
| Compteurs d’énergie Victron | `30` à `34` |

Vérifiez les unit ID sur l’appareil GX sous **Settings → Integrations → Modbus TCP server → Available services**. L’EMS scanne ces plages à l’ajout de l’appareil et crée automatiquement les appareils enfants (BMS, chargeurs solaires MPPT, onduleurs PV, compteur de raccordement).

L’EMS modélise le système comme un appareil **PCS** parent (l’onduleur-chargeur VE.Bus) avec des appareils enfants :

-   **PCS (onduleur de batterie)** : il reçoit les consignes de charge et de décharge et rapporte la puissance, la tension et le courant de la batterie ainsi que l’état VE.Bus.
-   **BMS (batterie gérée par le GX)** : il rapporte l’état de charge, la puissance de charge et de décharge autorisée et l’état de santé de la batterie gérée par le GX (DVCC).
-   **PV (chargeurs solaires MPPT couplés en DC)** : un appareil enfant par MPPT, rapportant la puissance et le rendement PV.
-   **PV (onduleurs PV couplés en AC)** : les onduleurs PV que le GX surveille sur l’entrée ou la sortie AC.
-   **Compteur de raccordement** : un compteur d’énergie Victron configuré comme compteur de raccordement, s’il est présent.

## Approche de pilotage

### Pilotage externe avec compensation de consigne

L’EMS met l’ESS Victron en **pilotage externe** (mode ESS 3) et écrit des consignes de puissance AC par phase vers le service VE.Bus à chaque cycle de régulation (≈1 s).

Une particularité Victron importante : la consigne de puissance ESS pilote la puissance à l’**entrée AC** de l’onduleur, et non la puissance de la batterie. Deux autres flux font bouger la batterie en plus de la consigne :

-   Les **charges sur la sortie AC** sont alimentées par l’onduleur par-dessus la consigne. Sans correction, une consigne batterie de 0 kW déchargerait quand même la batterie dans les charges de la sortie AC.
-   Les **chargeurs solaires MPPT couplés en DC** (et d’autres sources ou charges DC) chargent directement la batterie. Sans correction, le PV du matin chargerait la batterie même quand l’EMS demande 0 kW.

L’EMS mesure donc en continu la puissance de sortie AC de l’onduleur (les charges nettes sur la sortie AC, y compris un éventuel PV couplé en AC sur la sortie), la puissance PV couplée en DC, la puissance des chargeurs DC et la puissance du système DC sur le GX, et compense la consigne écrite pour que la **batterie** se retrouve à la puissance de charge ou de décharge demandée :

```
consigne AC = puissance batterie demandee
            + puissance de sortie AC (charges nettes sur la sortie AC)
            − PV couple en DC − puissance des chargeurs DC
            + puissance du systeme DC
```

La consigne est répartie sur les phases réellement présentes (le nombre de phases est lu sur le système VE.Bus), de sorte que les systèmes monophasés comme triphasés reçoivent toute la puissance demandée.

La puissance batterie suit la convention EMS : **positif = charge, négatif = décharge**.

### Mode autoconsommation

Quand un **compteur d’énergie Victron** est raccordé au GX et que le mode de pilotage de l’EMS le permet, l’EMS peut confier l’équilibrage local à la logique d’autoconsommation propre à l’ESS Victron (mode ESS 1) au lieu d’écrire des consignes explicites. Sans compteur Victron, l’onduleur ne peut pas mesurer lui-même la puissance réseau : l’EMS pilote alors toujours des consignes explicites.

### PV couplé en DC et puissance de l’onduleur

Les chargeurs solaires MPPT couplés en DC alimentent le même bus DC que la batterie : toute puissance solaire que l’EMS ne veut pas stocker doit donc sortir par le raccordement AC de l’onduleur. La batterie ne suit donc précisément la consigne de l’EMS que tant que l’onduleur peut physiquement la délivrer.

Quand le PV couplé en DC dépasse ce que l’onduleur peut évacuer en AC (borné par sa puissance AC nominale, et réduit encore par toute charge qu’il alimente déjà sur la sortie AC), le surplus ne peut pas sortir par l’AC et charge la batterie à la place. Dans cette situation, l’EMS ne peut pas maintenir la batterie à zéro ni la décharger tant qu’il y a autant de soleil, et une fois la batterie pleine les MPPT s’écrêtent d’eux-mêmes. Pour un pilotage complet de la batterie par l’EMS en plein soleil, dimensionnez la puissance AC de l’onduleur au moins au niveau du pic PV couplé en DC.

### Écrêtage PV

-   Les **chargeurs solaires MPPT couplés en DC** peuvent être entièrement allumés ou éteints, mais les MPPT Victron n’exposent aucune limite de puissance variable en Modbus : un écrêtage partiel n’est donc pas possible. Un surplus PV couplé en DC est plutôt absorbé par la batterie, ou écrêté par les MPPT eux-mêmes une fois la batterie pleine.
-   Les **onduleurs PV couplés en AC** sont pilotés via leur propre intégration d’onduleur PV, pas via le GX Victron. Laissez-les en mode non géré quand l’EMS ne doit que les suivre.

## Ce qui est relu

| Grandeur | Source |
| --- | --- |
| **Puissance, tension et courant de la batterie** | Le service système du GX (la batterie telle que gérée par DVCC) |
| **État de charge** | Le service système du GX ou la batterie gérée par le GX |
| **Puissance PV couplée en DC** | Le service système du GX plus les services de chaque chargeur solaire MPPT |
| **Puissance de sortie AC (charges de la sortie AC)** | Le service VE.Bus |
| **État, erreurs et alarmes VE.Bus** | Le service VE.Bus (bulk, absorption, float, pilotage externe, etc.) |
| **Fréquence réseau** | L’entrée AC du VE.Bus |

Les compteurs d’énergie du service VE.Bus sont volatils (ils se remettent à zéro au redémarrage du GX ou de l’onduleur) : l’EMS accumule donc l’énergie à partir des mesures de puissance.

## Configurer Victron dans notre EMS

1. **Activez le Modbus TCP**
   
   Sur l’appareil GX, ouvrez **Settings → Integrations → Modbus TCP server** et activez-le. Notez les unit ID listés sous **Available services**.
2. **Configurez l’ESS**
   
   Installez l’assistant ESS sur l’onduleur et configurez l’ESS sur l’appareil GX. L’EMS pilote lui-même le mode ESS ; aucun mode ESS particulier ne doit être présélectionné.
3. **Désactivez la charge programmée**
   
   Désactivez la charge programmée avant de raccorder l’appareil à l’EMS, pour que le GX ne prenne pas le pas sur les consignes de l’EMS.
4. **Ajoutez l’appareil dans la plateforme**
   
   Ajoutez le PCS Victron avec l’adresse IP du GX et l’**unit ID VE.Bus** comme ID esclave. L’EMS découvre automatiquement la batterie, les chargeurs solaires MPPT, les onduleurs PV et le compteur de raccordement.

> **Avertissement**
>
> Si ces étapes ne sont pas suivies, le système ne fonctionnera pas.

![Logo Victron Energy avec la signature blue power.](https://voltmasters.io/assets/docs/image-69.webp)