# AlphaESS

> L’intégration du système de batteries tout-en-un AlphaESS STORION-LC-TB125(-EX) dans notre EMS

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

Notre EMS prend en charge l’**AlphaESS STORION-LC-TB125(-EX)**, un système de stockage commercial tout-en-un construit autour du contrôleur **AlphaESS EMS 5.0**.

Le STORION-LC-TB125 ne s’adresse pas armoire par armoire. Une seule connexion **Modbus TCP** vers l’EMS pilote tout le système, y compris jusqu’à **25 unités PCS et batterie en parallèle**. Comme tout passe par cette unique connexion, notre EMS présente l’installation comme un appareil parent avec plusieurs appareils enfants logiques.

> **Avertissement**
>
> L’EMS doit être basculé en **dispatch à distance** avant que notre EMS puisse piloter le système. C’est un réglage de l’interface AlphaESS, qui ne peut pas être activé en Modbus. Voir le guide de mise en place ci-dessous.

### Appareils pris en charge

| Modèle | Puissance nominale | Rôle |
| --- | --- | --- |
| STORION-LC-TB125 | 125 kW | Système de batteries tout-en-un |
| STORION-LC-TB125-EX | 125 kW | Système de batteries tout-en-un |

L’intégration communique en **Modbus TCP** (port `502` par défaut).

## Comment l’intégration fonctionne

Un STORION-LC-TB125 est modélisé comme un seul appareil parent avec trois appareils enfants, tous servis par la même connexion Modbus :

-   **PCS (onduleur de batterie)** : l’appareil parent. Il reçoit les consignes de charge et de décharge et rapporte la puissance active et réactive du système.
-   **BMS** : il rapporte l’état de charge (SOC) agrégé, l’état de santé (SOH), l’énergie chargeable et déchargeable, les tensions et températures de cellules, et les autorisations de charge et de décharge.
-   **PV** : il rapporte la production et le rendement PV combinés. Le PV est couplé en DC et uniquement agrégé.
-   **Compteur de raccordement** : le compteur de tête du système, agrégé par l’EMS dans son propre bloc de registres et lu sur la même connexion.

Il n’y a pas de câblage supplémentaire ni d’appareil Modbus en plus à ajouter : les appareils enfants sont créés automatiquement à partir du parent lors de l’ajout.

### Approche de pilotage

Nous pilotons le système via l’interface de dispatch de l’EMS. À chaque cycle de régulation, les consignes demandées sont réécrites, de sorte que le système continue de suivre notre EMS tant que la connexion est vivante :

-   **Consigne batterie** : une consigne directe de puissance de charge et de décharge, bridée à la puissance nominale du système et aux puissances maximales de charge et de décharge rapportées en temps réel par l’appareil.
-   **Consigne de puissance réactive** : une commande de puissance réactive distincte.
-   **Délai de dispatch** : le système revient à son propre comportement quand notre EMS cesse d’écrire, de sorte qu’une connexion perdue ne laisse jamais la batterie sur une ancienne consigne.

> **Remarque**
>
> Le PV de ce produit est couplé en DC et uniquement agrégé. L’interface de dispatch n’expose aucun registre d’écrêtage PV : l’appareil enfant PV est donc **uniquement en lecture** et n’est jamais écrêté par notre EMS.

### Ce qui est relu

-   **Batterie** : l’état de charge, l’état de santé, l’énergie chargeable et déchargeable, la puissance maximale de charge et de décharge, l’énergie totale chargée et déchargée, la tension et la température de cellule maximales et minimales, les autorisations de charge et de décharge, et la demande de charge forcée en sous-tension.
-   **PCS** : l’état marche/arrêt, l’état de défaut, la tension, le courant et la puissance DC, la puissance active et apparente, le facteur de puissance, la fréquence réseau et la température ambiante.
-   **PV** : la production réelle, la production totale et la capacité installée.
-   **Compteur de raccordement** : les tensions et courants par phase, la puissance active, réactive et apparente totale, le facteur de puissance, et l’énergie cumulée prélevée et injectée.
-   **Système** : le mode de fonctionnement en réseau ou en site isolé, et l’état de fonctionnement normal, avertissement ou défaut.

Les défauts rapportés par le PCS et par le système de gestion de batterie sont générés comme incidents sur l’appareil.

## Mise en place

1. **Préparez le réseau**
   
   Donnez à l’EMS une adresse IP fixe dans le même sous-réseau que le contrôleur Voltmasters, et assurez-vous que le port `502` est joignable entre les deux.
   
   > **Avertissement**
   >
   > N’utilisez **pas** `192.168.1.x` ni `192.168.2.x` pour le réseau de dispatch. Ces plages sont déjà utilisées à l’intérieur du système : `192.168.1.x` par le bus interne PCS et BMS sur ETH1, et `192.168.2.x` par le point d’accès Wi-Fi intégré. Les utiliser rend la connexion de dispatch peu fiable, voire impossible.
2. **Activez le dispatch à distance sur l’EMS**
   
   Dans l’interface AlphaESS, allez dans **Control Strategy → Basic Settings** et réglez :
   
   -   **Operation Mode** : `Remote Control Mode`
   -   **Local/Remote** : `Remote`
   -   **Dispatch Protocol** : `MODBUS-TCP`
   
   > **Avertissement**
   >
   > Sur l’EMS 5.0, c’est un réglage d’interface uniquement. Il ne peut pas être basculé en Modbus, et le registre System Mode continue d’indiquer `Local_auto` même pendant que le dispatch est actif. Vérifiez le réglage à l’écran, pas dans le registre.
3. **Ajoutez l’appareil dans Voltmasters**
   
   Ajoutez un nouvel appareil de type **système de batteries (PCS)**, marque **AlphaESS**, modèle **STORION-LC-TB125(-EX)**, et complétez l’adresse IP, le port et l’ID esclave de l’EMS.
   
   Le système de gestion de batterie, le PV et le compteur de raccordement sont ajoutés automatiquement comme appareils enfants. Réglez la capacité de la batterie et l’état de charge minimal et maximal sur l’appareil enfant batterie ; la puissance nominale vaut 125 kW par défaut sur le PCS.
4. **Vérifiez**
   
   Contrôlez sur la page de l’appareil que l’état de charge, la production PV et les valeurs du compteur de raccordement arrivent, et que le système suit une consigne manuelle de charge ou de décharge.

## État de validation

L’intégration est réalisée d’après l’**Alpha EMS ModbusTCP Protocol Point Table V1.6.0** et le **manuel de dispatch AlphaESS C&I Modbus TCP V2.0**. D’autres fonctions pourront s’ajouter au fil du temps, à mesure que l’intégration évolue.
