# JinkoSolar

> Appareils pris en charge : armoires de batteries JinkoSolar SunGiga G1 215 kWh (JKS-215KLAA-100PLAA) derrière la SCU du système, via Modbus TCP sur le port 2404.

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

Notre EMS suit et pilote les armoires de batteries tout-en-un **SunGiga G1 215 kWh** de JinkoSolar via **Modbus TCP**. Toutes les armoires d’un système se trouvent derrière une seule unité de contrôle du système (SCU). Dans la plateforme, chaque armoire est un onduleur de batterie à part entière, avec sa propre batterie : l’EMS équilibre ainsi les armoires selon leur propre état de charge.

> **Remarque**
>
> La SunGiga G1 est disponible à partir de la version **0.0.337** du contrôleur EMS.

## Appareils pris en charge

| Modèle | Puissance et capacité | Rôle |
| --- | --- | --- |
| SunGiga G1 215kWh (JKS-215KLAA-100PLAA) | 100 kW / 215 kWh par armoire | Armoire de batteries tout-en-un, derrière la SCU du système |

## Comment l’intégration fonctionne

-   **Pilotage par armoire** : chaque armoire reçoit sa propre consigne de puissance active et réactive. Tant que l’EMS pilote une armoire, il en reprend le contrôle à la commande locale du système, et le lui rend quand il s’arrête.
-   **Valeurs de la batterie** : l’état de charge, l’énergie chargeable et déchargeable, la tension, le courant et la puissance de charge et de décharge autorisée proviennent du cluster de batteries de chaque armoire.
-   **Démarrage** : une armoire arrêtée sans défaut est démarrée par l’EMS. Les défauts ne sont jamais réinitialisés automatiquement.
-   **Incidents** : chaque alarme de batterie apparaît sur la batterie de l’armoire, chaque défaut du convertisseur sur son onduleur de batterie. Une **Alarme du détecteur de chaleur dans l’armoire de batteries** envoie aussi une notification d’urgence. Un convertisseur qui ne suit pas le mode de puissance réglé par l’EMS lève l’incident **Convertisseur hors du mode de fonctionnement réglé par l’EMS, consigne ignorée**.

> **Avertissement**
>
> La SCU n’a pas de repli propre. Si la connexion avec l’EMS tombe, une armoire garde sa dernière consigne jusqu’à ce que l’EMS reprenne le pilotage.

## Mise en place

1. **Réseau**
   
   Raccordez la SCU au même réseau que le contrôleur Voltmasters, donnez-lui une adresse IP fixe et vérifiez que le contrôleur l’atteint sur le port `2404`.
2. **Ajoutez la première armoire**
   
   Ajoutez un appareil de type **système de batteries (PCS)**, marque **JinkoSolar**, modèle **SunGiga G1 215kWh (JKS-215KLAA-100PLAA)**. Saisissez l’adresse IP de la SCU et vérifiez le port prérempli `2404` et l’**ID esclave** `1`. L’ID esclave est le numéro de l’armoire (1, 2, 3 et ainsi de suite), pas un identifiant d’unité Modbus. La puissance nominale est préremplie à 100 kW.
3. **Ajoutez les autres armoires par la détection**
   
   À partir de l’armoire 1, la détection des appareils propose chaque autre armoire du système comme son propre onduleur de batterie avec sa propre batterie, y compris la capacité de cette batterie. Laissez-les sélectionnées et enregistrez : tout le système est alors ajouté en une fois.
4. **Vérifiez**
   
   Vérifiez sur la page de chaque armoire que l’état de charge et la puissance arrivent, et que l’armoire suit une consigne.