Je Hoymiles micro-omvormers slim uitzetten via web, modbus of Home Assistant

Met Hoymiles micro-omvormers zijn de opties om je zonnepanelen uit te zetten of terug te regelen beperkt. Naast de universele mogelijkheden kun je via de web interface de teruglevering beperken tot alleen je eigen verbruik. Maar als groene nerd wil je dit natuurlijk kunnen automatiseren, zodat bij negatieve energieprijzen automatisch de teruglevering wordt gestopt. Gelukkig ondersteunt Hoymiles modbus en kun je via die route je de teruglevering van je zonnepanelen stoppen. Op deze pagina beschrijven we diverse methoden en integraties die je helpen dit voor elkaar te krijgen in Home Assistant.

Universele methoden om je omvormer uit te schakelen

In dit artikel focussen we ons op de manieren om specifiek een Huawei omvormer te laten stoppen met het produceren van zonne-energie. Er zijn ook nog een aantal universele methoden die je kunt toepassen om je omvormer uit te schakelen. Meer over deze universele methoden lees je in het dossier zonnepanelen uitzetten.

De teruglevering handmatig limiteren of stoppen via web

Hoymiles is een bekende fabrikant van micro-omvormers. Een typisch Hoymiles systeem bestaat uit de micro-omvormers zelf (bijvoorbeeld de oudere HM-serie of de nieuwere HMS-serie), een Data Transfer Unit (DTU) die als gateway fungeert, en het S-Miles Cloud monitoring platform.  

Er zijn verschillende typen DTU’s, zoals de DTU-Lite-S, DTU-Pro, DTU-Pro-S en DTU-Wlite/S, elk met hun eigen specifieke functionaliteiten en communicatiemogelijkheden (Wi-Fi, Ethernet, 4G). De DTU verzamelt data van de micro-omvormers en stuurt deze naar de S-Miles Cloud, waar gebruikers de prestaties van hun systeem kunnen inzien. Recentere ontwikkelingen omvatten de HMS-serie micro-omvormers met geïntegreerde Wi-Fi. Deze modellen kunnen in sommige gevallen de noodzaak voor een aparte DTU verminderen voor basis monitoring en bepaalde directe controlefuncties, doordat ze direct met een smartphone of het lokale netwerk kunnen communiceren.

A. Power adjustment functie

In de S-Miles Cloud app bestaat de manier om de teruglevering van de omvormers aan te passen. Je doet dit als volgt:

1. Log in op de S-Miles Cloud app of de cloudomgeving.
2. Zoek en selecteer je installatie (onder Plants).
3. Navigeer naar de instellingenpagina (in de cloud klik je op O&M).
4. Kies de optie ‘Power Adjustment’.
5. Bevestig de huidige vermogensinstelling.
6. Pas het uitgangspercentage aan (instelbaar tussen 2% en 100%). Bijvoorbeeld, om een 800W systeem te beperken tot 600W, voert men 75% in.
7. Pas de instellingen toe en wacht op bevestiging.  

Bovenstaande visual is van de app, hieronder zie je de video “How to Adjust Active Power for DTU-Lite/S and DTU-Wlite/S on S-Miles Cloud” die laat zien hoe het in de cloudomgeving werkt.

B. Export Management Functie (voor geavanceerde controle)

Er is ook nog de “Export Management” functie. Deze lijkt te beschikbaar te zijn voor DTU-Pro en DTS-Pro-S. Ga naar jouw installatie en dan instellingen.

Limit mode: Hier stel je in of je de teruglevering wil beperken op het aantal watt of als percentage van het totale vermogen

Export Power: Geef het aantal watt of het percentage in.

De teruglevering slim limiteren of stoppen via de cloud API en Home Assistant

Stap 1: Installatie van de integratie

1. Open HACS: Ga in Home Assistant naar HACS.
2. Integraties: Klik op “Integraties”.
3. Aangepaste repositories: Klik op de drie puntjes rechtsboven en selecteer “Aangepaste repositories”.
4. Repository toevoegen:
   • In het veld “Repository”, vul de URL in: https://github.com/wil-lem/ha-hoymiles-s-cloud
   • Bij “Categorie”, selecteer “Integratie”.
   • Klik op “Toevoegen”.
5. Integratie zoeken en installeren:
   • Nadat de custom repository is toegevoegd, zoek je in HACS naar “Hoymiles S-Cloud”.
   • Klik op de integratie.
   • Klik op “Download”. Volg de instructies van HACS.
6. Herstart Home Assistant: Na de installatie via HACS, herstart Home Assistant (via Ontwikkelaarsstools -> Serverbeheer -> Herstarten, of via Instellingen -> Systeem -> Herstarten).

Stap 2: Configuratie van de integratie in Home Assistant  

1. Ga naar Apparaten & Diensten: Na het herstarten, ga in Home Assistant naar “Instellingen” -> “Apparaten & diensten”.
2. Integratie toevoegen: Klik rechtsonder op de knop “+ Integratie toevoegen”.
3. Zoek de integratie: Zoek naar “Hoymiles S-Cloud” en selecteer deze.
4. Configureer:
   • Voer je Hoymiles S-Cloud (Hoymiles portal) gebruikersnaam en wachtwoord in.
   • De basis URL is standaard https://neapi.hoymiles.com/. Pas deze alleen aan als je weet dat jouw regio een andere URL gebruikt.

Als de ingevoerde gegevens correct zijn en de verbinding met de Hoymiles S-Cloud API succesvol tot stand kan worden gebracht, zal Home Assistant proberen de bij jouw S-Cloud account geregistreerde installatie(s), inclusief de bijbehorende DTU en micro-omvormers, te detecteren. Vervolgens zal de integratie de relevante apparaten en entiteiten (sensoren, schakelaars, etc.) aanmaken binnen Home Assistant. Dit proces kan enige tijd in beslag nemen.

Je krijgt de beschikking over deze sensoren:

• Actueel opgewekt vermogen (in W)
• Energieproductie vandaag (in kWh)

En deze input:

• Maximale vermogen om terug te leveren (als % van de totale capaciteit)

De automatisering

Om de teruglevering van zonnestroom te laten stoppen in het geval van negatieve energieprijzen, kun je deze automatisering gebruiken. De automatisering maakt hierbij gebruik van de Nord Pool integratie voor het uitlezen dan dynamische energieprijzen. Het device ID dien je aan te passen naar jouw situatie.

description: "Do not feed to grid when power price becomes negative"
mode: single
trigger:
  - platform: numeric_state
    entity_id: sensor.nordpool_kwh_be_eur_3_10_0
    below: 0
action:
  - device_id: e80et33931eeefle19794095338bbbdd
    mode:single
    entity_id: 31teca7a46849t1t347a353194
    type: set_value
    metadata:
      secondary: false
    value: 5 
Code language: JavaScript (javascript)

Zijn de energieprijzen weer positief, dan zet deze automatisering de teruglevering automatisch weer aan:

description: "Allow inverter to export electricity to grid when price becomes positive"
mode: single
trigger:
  - platform: numeric_state
    entity_id: sensor.nordpool_kwh_be_eur_3_10_0
    above: 0
condition: []
action:
  - device_id: e80et33931eeefle19794095338bbbdd
    mode:single
    entity_id: 31teca7a46849t1t347a353194
    type: set_value
    metadata:
      secondary: false
    value: 100 
Code language: CSS (css)

De teruglevering slim limiteren of stoppen via de wifi en Home Assistant

Zeer belangrijke waarschuwing vooraf: Risico op EEPROM Slijtage! Deze integratie biedt de mogelijkheid om de vermogenslimiet van je omvormer aan te passen. De ontwikkelaar waarschuwt echter expliciet: “Please refrain from using the current power limitation feature for zero feed-in, as it may lead to damaging the inverter due to excessive writes to the EEPROM.” Dit betekent dat het frequent (bijvoorbeeld meerdere keren per uur) aanpassen van de vermogenslimiet de EEPROM (een type geheugenchip) van je omvormer permanent kan beschadigen, wat kan leiden tot storingen of het volledig uitvallen van de omvormer. Gebruik de functie voor het aanpassen van de vermogenslimiet met extreme voorzichtigheid en zo min mogelijk.

Om dit te kunnen maken we gebruik van de Hoymiles Wifi integratie van suaveolent.

Vereisten:

1. Compatibele Hoymiles apparatuur:
   • Micro-omvormers met geïntegreerde Wi-Fi: Hoymiles HMS-xxxxW serie (bijv. HMS-400W-1T, HMS-800W-2T, HMS-2000DW-4T).
   • Externe DTU’s (Data Transfer Units) met Wi-Fi: Hoymiles DTU-WLite, DTU-Pro (S).
   • De integratie is ontwikkeld en primair getest met de HMS-800W-2T.
2. Netwerkverbinding: Zowel je Home Assistant instance als de Hoymiles omvormer/DTU moeten verbonden zijn met hetzelfde lokale Wi-Fi netwerk.
3. IP-adres Omvormer/DTU: Je hebt het vaste (statische) IP-adres van je Hoymiles omvormer of DTU nodig op je lokale netwerk. Dit kun je meestal vinden in de interface van je router of via netwerk-scantools zoals Fing of Angry IP Scanner.  
4. Home Assistant: Een werkende Home Assistant installatie met HACS.

Stap 1: Installatie van de integratie

1. Open HACS: Ga in Home Assistant naar HACS.
2. Integraties: Klik op “Integraties”.
3. Aangepaste repositories: Klik op de drie puntjes rechtsboven en selecteer “Aangepaste repositories”.
4. Repository toevoegen:
   • In het veld “Repository”, vul de URL in: https://github.com/suaveolent/ha-hoymiles-wifi
   • Bij “Categorie”, selecteer “Integratie”.
   • Klik op “Toevoegen”.
5. Integratie zoeken en installeren:
   • Nadat de custom repository is toegevoegd, zoek je in HACS naar “Hoymiles” of “Hoymiles Wifi”.
   • Klik op de integratie (waarschijnlijk simpelweg “Hoymiles” genaamd).
   • Klik op “Download”. Volg de instructies van HACS.
6. Herstart Home Assistant: Na de installatie via HACS, herstart Home Assistant (via Ontwikkelaarsstools -> Serverbeheer -> Herstarten, of via Instellingen -> Systeem -> Herstarten).

Stap 2: Configuratie van de integratie in Home Assistant  

1. Ga naar Apparaten & Diensten: Na het herstarten, ga in Home Assistant naar “Instellingen” -> “Apparaten & diensten”.
2. Integratie toevoegen: Klik rechtsonder op de knop “+ Integratie toevoegen”.
3. Zoek de integratie: Zoek naar “Hoymiles” en selecteer deze.
4. Configureer:
   • Host: Voer het IP-adres (of hostname) van je Hoymiles omvormer of DTU in.
   • (Optioneel) Update interval (seconds): Standaard is dit waarschijnlijk ingesteld. Een interval lager dan circa 32 seconden kan de communicatie met de Hoymiles cloud verstoren. De firmware van de omvormer kan ook een wachttijd van ~30 seconden tussen verzoeken afdwingen, wat de effectieve updatefrequentie kan beperken.  
   • Klik op “Verzenden”.

Als de configuratie succesvol is, zouden er nieuwe entiteiten moeten verschijnen in Home Assistant die gerelateerd zijn aan je Hoymiles systeem. Dit omvat sensoren voor real-time data (huidig vermogen, etc.) en mogelijk services of controls voor aansturing.  

Stap 3: Gebruik en Automatisering

O.a. de volgende functies zijn beschikbaar:

• async_get_real_data_new(): Real-time data ophalen.
• async_set_power_limit(power_limit): Hiermee kan de vermogenslimiet van de omvormer ingesteld worden als een percentage (0-100%).
• async_turn_on_inverter(): Omvormer aanzetten.
• async_turn_off_inverter(): Omvormer uitzetten.

Je kunt nu Home Assistant automatiseringen maken. Bijvoorbeeld:

• De omvormer uitzetten (async_turn_off_inverter) bij negatieve energieprijzen.
• Indien je het risico accepteert: De vermogenslimiet aanpassen (async_set_power_limit) op basis van dynamische energieprijzen

De teruglevering slim stoppen of beperken via modbus en Home Assistant

Maar we zijn niet voor een gat te vangen. Wanneer je beschikt over installateursrechten, zijn er meer opties beschikbaar om de teruglevering te beperken of te stoppen. Met een installateursaccount kun je namelijk bij een ‘zero-export’ en ‘vermogensbegrenzing’ functie.

Modbus-registers en exacte instellingen kunnen verschillen per SMA omvormermodel en firmwareversie. Deze instructies zijn gebaseerd op gedeelde gebruikerservaringen en dienen als leidraad.

In dit nieuwe project maak ik direct verbinding tussen de zonnepanelen en Home Assistant via wifi. Dit levert een aantal grote voordelen op:

Voordelen van lokale aansturing

• Bijna realtime inzicht in opbrengst
  De installatie stuurt vrijwel direct gegevens door, zodat je steeds een actueel beeld hebt van je energieopbrengst.
• Directe controle over opbrengst
  Je kunt automatisch het percentage opbrengst instellen tussen 5% en 100%, waardoor je veel preciezer kunt sturen op netbelasting of batterijstatus.
• Slimme logica via Home Assistant
  Door de koppeling met Home Assistant kun je allerlei automatiseringen instellen, zoals:
  • Zonnepanelen (deels) uitschakelen bij een volle thuisbatterij
  • Verminderen van opbrengst bij negatieve stroomprijzen
  • Apparaten zoals wasmachines of boilers automatisch inschakelen bij hoge opbrengst
• Uitbreidbare software
  De software is open en uitbreidbaar, bijvoorbeeld om extra data zoals netspanning of temperatuur van je systeem mee te nemen.

Aandachtspunten

• Nog steeds afhankelijk van een internetverbinding
  De Hoymiles-hardware blijft eisen dat er een actieve internetverbinding is, zelfs bij lokaal gebruik. Waarom dat een probleem is, lees je hier.

Stap 1: Voorbereiding

1. Controleer DTU Model en verbinding: Verifieer dat je een DTU-Pro of DTU-Pro-S hebt en dat deze met een ethernetkabel is aangesloten op je netwerk.
2. Noteer IP-adres: Zoek het IP-adres van je DTU op en zorg er bij voorkeur voor dat dit een statisch IP-adres is (via DHCP-reservering in je router).
3. Controleer DTU Instellingen: Open de Hoymiles (Installer) app, ga naar de “Toolkit” en controleer onder “DTU Information” bij de RS485-poortconfiguratie of Modbus TCP is ingeschakeld (mogelijk via een optie als “Remote Control” in plaats van “Export Control”).
4. Cruciaal: Het kan nodig zijn om een specifieke instelling in je DTU aan te passen om Modbus TCP communicatie mogelijk te maken. Een vergelijkbare integratie (ArekKubacki/Hoymiles-Plant-DTU-Pro) vermeldt: “For 22 Version, if you choose “Export control”, it prohibits MODBUS TCP. But “Remote control” still supports it. So you have to go to “Toolkit” in APP and then choose “Remote Control” from RS-485 Port Config under DTU Information.”. Controleer of een dergelijke instelling voor jouw DTU en firmwareversie van toepassing is via de Hoymiles (Installer) app.
5. Je hebt Home Assistant geïnstalleerd en je hebt de Home Assistant Community Store (HACS) geïnstalleerd. Klik hier voor instructies voor het installeren van HACS.

Stap 2: Integratie installeren

1. Ga in Home Assistant naar HACS.
2. Integraties: Klik op “Integraties”.
3. Aangepaste repositories: Klik op de drie puntjes rechtsboven en selecteer “Custom repositories”.
4. Repository toevoegen:
   • In het veld “Repository”, vul de URL in: https://github.com/wil-lem/ha-hoymiles-modbus-tcp
   • Bij “Categorie”, selecteer “Integraties”.
   • Klik op “Toevoegen”.
     
5. Integratie zoeken en installeren:
   • Nadat de aangepaste repository is toegevoegd, zoek je in HACS naar “Hoymiles Modbus TCP” (of een vergelijkbare naam die de ontwikkelaar gebruikt).
   • Klik op de integratie en vervolgens op “Installeren” of “Download”. Volg de instructies van HACS.
6. Herstart Home Assistant: Na de installatie via HACS, herstart Home Assistant (via Ontwikkelaarsstools -> Serverbeheer -> Herstarten, of via Instellingen -> Systeem -> Herstarten).

Stap 3: Configuratie van de integratie

1. Ga naar Apparaten & Diensten: Na het herstarten, ga in Home Assistant naar “Instellingen” -> “Apparaten & diensten”.
2. Integratie toevoegen: Klik rechtsonder op de knop “+ Integratie toevoegen”.
3. Zoek de Integratie: Zoek naar “Hoymiles Modbus TCP”
4. Configureer:
   • Er wordt gevraagd om het IP-adres (Host) van je DTU.  
   • En naar de Modbus TCP-poort (standaard 502) en de Modbus Unit ID (standaard 1).
   • Volg de verdere instructies op het scherm.
5. Voltooien: Klik op “Verzenden” of “Voltooien”.

Stap 4: Gebruik en automatisering

Als de configuratie succesvol is, zouden er nieuwe entiteiten moeten verschijnen in Home Assistant die gerelateerd zijn aan je Hoymiles omvormers:

Sensoren:

• Current Power: Real-time power output in watts (W)
• Daily Energy: Today’s total energy production (in kWh)

Controls

• Power Level: Adjustable slider to set production level (5-100%)

De automatisering

Voor in de automatisering kun je gebruik maken van slides ‘Power Level’. Je kunt een automatisering aanmaken om de teruglevering te stoppen bij negatieve energieprijzen. Dan stel je het vermogen bij naar 5%.

Om de teruglevering van zonnestroom te laten stoppen in het geval van negatieve energieprijzen, kun je deze automatisering gebruiken. De automatisering maakt hierbij gebruik van de Nord Pool integratie voor het uitlezen dan dynamische energieprijzen. Het device ID dien je aan te passen naar jouw situatie.

description: "Do not feed to grid when power price becomes negative"
mode: single
trigger:
  - platform: numeric_state
    entity_id: sensor.nordpool_kwh_be_eur_3_10_0
    below: 0
action:
  - device_id: e80et33931eeefle19794095338bbbdd
    mode:single
    entity_id: 31teca7a46849t1t347a353194
    type: set_value
    metadata:
      secondary: false
    value: 5 
Code language: JavaScript (javascript)

Zijn de energieprijzen weer positief, dan zet deze automatisering de teruglevering automatisch weer aan:

description: "Allow inverter to export electricity to grid when price becomes positive"
mode: single
trigger:
  - platform: numeric_state
    entity_id: sensor.nordpool_kwh_be_eur_3_10_0
    above: 0
condition: []
action:
  - device_id: e80et33931eeefle19794095338bbbdd
    mode:single
    entity_id: 31teca7a46849t1t347a353194
    type: set_value
    metadata:
      secondary: false
    value: 100 
Code language: CSS (css)