# Hoymiles

> L’intégration du système de batteries Hoymiles HoyUltra 2 (HESS-261-2h) dans notre EMS

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

Notre EMS prend en charge le **Hoymiles HoyUltra 2** (`HESS-261-2h`), un système de batteries commercial tout-en-un refroidi par liquide de **261 kWh** avec un système de conversion de puissance de **125 kW**.

> **Remarque**
>
> Les **onduleurs PV** Hoymiles sont pris en charge séparément via l’intégration générique [SunSpec](https://voltmasters.io/fr/docs/device-integrations/pv-inverters/sunspec/). Cette page couvre le système de batteries HoyUltra 2.

### Appareils pris en charge

| Modèle | Capacité | Puissance nominale |
| --- | --- | --- |
| HoyUltra 2 (HESS-261-2h) | 261 kWh | 125 kW |

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

## Comment l’intégration fonctionne

Une armoire HoyUltra 2 est modélisée comme un onduleur de batterie (PCS) parent avec un système de gestion de batterie en appareil enfant, tous deux 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 et l’état de santé totaux, ainsi que la puissance de charge et de décharge que le matériel autorise à cet instant.

La capacité de la batterie se configure sur l’appareil enfant batterie ; la puissance nominale se configure sur le PCS et vaut 125 kW par défaut.

### Armoires maître et membre

Les armoires peuvent être mises en parallèle. Notre EMS sonde chaque armoire à la connexion et reconnaît s’il s’agit du **maître** ou d’un **membre** :

-   Le **maître** porte la table de registres du système entier et reçoit toutes les commandes de pilotage. Il rapporte les totaux du système complet.
-   Une armoire **membre** n’expose que son propre PCS et son propre rack de batteries, et ne reçoit jamais de consigne.

Cela se fait automatiquement. Vous n’avez pas à configurer quelle armoire est laquelle.

### Approche de pilotage

Nous pilotons le système via l’interface de télécommande du HoyUltra 2. L’armoire est maintenue en **mode commande à distance**, affirmé en continu pour qu’elle continue de suivre nos consignes, et à chaque cycle de régulation les commandes demandées sont réécrites :

-   **Consigne batterie** : une consigne directe de puissance de charge et de décharge, bridée à la puissance nominale 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émarrage et arrêt du système**.

> **Remarque**
>
> Des consignes inférieures à 6 kW font paraître l’interface Hoymiles et son statut zéro injection comme inactifs. La R&D de Hoymiles a confirmé que l’armoire suit malgré tout la consigne : notre EMS ne les arrondit donc pas.

### Ce qui est relu

-   **Batterie** : l’état de charge et l’état de santé totaux, la puissance maximale de charge et de décharge, l’énergie maximale de charge et de décharge, l’énergie totale chargée et déchargée, et par rack la tension, le courant, l’état de charge, la température et la puissance autorisée.
-   **Système** : le mode de fonctionnement (en réseau ou en site isolé), le statut du système (veille, arrêt, charge ou décharge), la puissance active et réactive totale, le mode de pilotage et le niveau de défaut.

Toute la table de défauts du HoyUltra 2 est relue et traduite en incidents sur l’appareil, chacun avec sa propre gravité, pour qu’une alarme de niveau 1 ne génère pas la même alerte qu’un défaut de niveau 3.

## Mise en place

1. **Préparez le réseau**
   
   Donnez à l’armoire 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. Avec plusieurs armoires en parallèle, chaque armoire a besoin de sa propre adresse joignable.
2. **Mettez l’armoire en commande à distance**
   
   Le HoyUltra 2 n’accepte les consignes qu’en **mode commande à distance**. Notre EMS affirme ce mode lui-même à chaque cycle de régulation, aucun réglage permanent sur l’appareil n’est donc nécessaire, mais l’interface EMS locale de l’armoire doit autoriser la commande à distance.
3. **Ajoutez l’appareil dans Voltmasters**
   
   Ajoutez un nouvel appareil de type **système de batteries (PCS)**, marque **Hoymiles**, modèle **HoyUltra 2 (HESS-261-2h)**, et complétez l’adresse IP, le port et l’ID esclave de l’armoire.
   
   Le système de gestion de batterie est ajouté automatiquement comme appareil enfant. Réglez-y la capacité de la batterie et l’état de charge minimal et maximal ; la capacité vaut 261 kWh par défaut.
4. **Vérifiez**
   
   Contrôlez sur la page de l’appareil que l’état de charge et le statut du système arrivent, et que l’armoire suit une consigne manuelle de charge ou de décharge.

## État de validation

L’intégration est réalisée d’après le **HoyUltra 2 Local EMS protocol REV1.3.2**. D’autres fonctions pourront s’ajouter au fil du temps, à mesure que l’intégration évolue.