# Hoymiles

> De integratie van het batterijsysteem Hoymiles HoyUltra 2 (HESS-261-2h) in ons EMS

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

Ons EMS ondersteunt de **Hoymiles HoyUltra 2** (`HESS-261-2h`), een vloeistofgekoeld, commercieel alles-in-een batterijsysteem van **261 kWh** met een power conversion system van **125 kW**.

> **Opmerking**
>
> De **PV-omvormers** van Hoymiles worden apart ondersteund via de generieke [SunSpec](https://voltmasters.io/nl/docs/device-integrations/pv-inverters/sunspec/)\-integratie. Deze pagina gaat over het HoyUltra 2-batterijsysteem.

### Ondersteunde toestellen

| Model | Capaciteit | Nominaal vermogen |
| --- | --- | --- |
| HoyUltra 2 (HESS-261-2h) | 261 kWh | 125 kW |

De integratie praat over **Modbus TCP** (standaardpoort `502`).

## Hoe de integratie werkt

Eén HoyUltra 2-kast verschijnt als een bovenliggende batterijomvormer (PCS) met een batterijmanagementsysteem als onderliggend toestel, allebei bediend door dezelfde Modbus-verbinding:

-   **PCS (batterijomvormer)**: het bovenliggende toestel. Het krijgt de laad- en ontlaadsetpoints en geeft het actief en reactief vermogen van het systeem door.
-   **BMS**: geeft de totale laadtoestand en gezondheidstoestand door, en het laad- en ontlaadvermogen dat de hardware op dat moment toelaat.

De batterijcapaciteit stel je in op het onderliggende batterijtoestel; het nominaal vermogen op de PCS, waar het standaard op 125 kW staat.

### Master- en memberkasten

Kasten zijn parallel te plaatsen. Ons EMS tast elke kast af bij het verbinden en herkent of het de **master** is of een **member**:

-   De **master** draagt de registerindeling van het hele systeem en krijgt alle regelcommando's. Hij geeft de totalen van het volledige systeem door.
-   Een **member**\-kast toont enkel haar eigen PCS en batterijrack, en krijgt nooit een setpoint.

Dat gaat automatisch. Je hoeft niet in te stellen welke kast wat is.

### Aanpak van de aansturing

Wij sturen het systeem aan via de telecommando-interface van de HoyUltra 2. De kast wordt in **remote control mode** gehouden, voortdurend opnieuw bevestigd zodat ze onze setpoints blijft volgen, en elke regelcyclus worden de gevraagde commando's opnieuw weggeschreven:

-   **Batterijsetpoint**: een rechtstreeks setpoint voor het laad- en ontlaadvermogen, begrensd door het nominaal vermogen en door het maximale laad- en ontlaadvermogen dat het toestel op dat moment doorgeeft.
-   **Setpoint reactief vermogen**: een apart commando voor het reactief vermogen.
-   **Het systeem starten en stoppen**.

> **Opmerking**
>
> Bij setpoints onder 6 kW lijken de gebruikersinterface van Hoymiles en de status voor nulinjectie stil te staan. R&D van Hoymiles bevestigde dat de kast het setpoint wel degelijk volgt, dus ons EMS rondt die waarden niet weg.

### Wat er teruggelezen wordt

-   **Batterij**: de totale laadtoestand en gezondheidstoestand, het maximale laad- en ontlaadvermogen, de maximale laad- en ontlaadenergie, de totaal geladen en ontladen energie, en per rack de spanning, stroom, laadtoestand, temperatuur en het toegelaten vermogen.
-   **Systeem**: de werkmodus (on-grid of off-grid), de systeemstatus (standby, uitgeschakeld, laden of ontladen), het totale actief en reactief vermogen, de regelmodus en het foutniveau.

De volledige foutenlijst van de HoyUltra 2 wordt uitgelezen en omgezet in incidenten op het toestel, elk met zijn eigen ernst, zodat een alarm van niveau 1 niet dezelfde melding geeft als een fout van niveau 3.

## Instellen

1. **Zet het netwerk klaar**
   
   Geef de kast een vast IP-adres in hetzelfde subnet als de Voltmasters-controller, en zorg dat poort `502` tussen de twee bereikbaar is. Staan er meerdere kasten parallel, dan heeft elke kast haar eigen bereikbare adres nodig.
2. **Zet de kast op remote control**
   
   De HoyUltra 2 aanvaardt enkel setpoints in **remote control mode**. Ons EMS zet die modus zelf bij elke regelcyclus opnieuw, dus er is geen vaste instelling op het toestel nodig, maar de lokale EMS-interface van de kast moet remote control wel toelaten.
3. **Voeg het toestel toe in Voltmasters**
   
   Voeg een nieuw toestel toe van het type **Batterij/PCS**, merk **Hoymiles**, model **HoyUltra 2 (HESS-261-2h)**, en vul het IP-adres, de poort en het slave-ID van de kast in.
   
   Het batterijmanagementsysteem komt er automatisch als onderliggend toestel bij. Zet de batterijcapaciteit en de minimale en maximale laadtoestand daar; de capaciteit staat standaard op 261 kWh.
4. **Controleer**
   
   Kijk op de toestelpagina na of de laadtoestand en de systeemstatus binnenkomen, en of de kast een handmatig laad- of ontlaadsetpoint volgt.

## Validation status

De integratie is gebouwd tegen de **HoyUltra 2 Local EMS protocol REV1.3.2**. Er kan later functionaliteit bijkomen naarmate de integratie uitbreidt.