Handleiding: je Solis omvormer slim limiteren met modbus en Home Assistant
Heb je een Solis omvormer en wil je de teruglevering aan het net beperken of zelfs volledig stoppen? Bijvoorbeeld bij negatieve dynamische energieprijzen, wanneer je letterlijk betaalt om stroom terug te leveren? Dan is er goed nieuws: met de SolaX Modbus integratie voor Home Assistant kun je je Solis omvormer via Modbus aansturen en de teruglevering limiteren — lokaal, zonder cloud, en volledig automatiseerbaar. In deze handleiding leggen we stap voor stap uit hoe je deze integratie installeert en configureert voor je Solis omvormer, en hoe je vervolgens de teruglevering kunt beperken.
Wat kun je met deze oplossing?
- Teruglevering limiteren: stel een maximaal vermogen in dat je omvormer aan het net mag terugleveren (via de
export_control_user_limitentity) - Teruglevering volledig stoppen: zet de export limit op 0 Watt
- Automatiseren: koppel dit aan dynamische energieprijzen zodat je omvormer automatisch stopt met terugleveren bij negatieve prijzen
- Batterijmodi instellen: schakel tussen Self-Use, Timed Charge/Discharge, Backup en meer (bij hybride modellen)
- Monitoring: lees real-time data uit van je omvormer, zoals opwek, batterijstatus en temperatuur
Ondersteunde Solis modellen
De integratie ondersteunt de volgende Solis hybride omvormers:
- RHI-nK-48ES-5G — Single Phase (de ‘n’ staat voor het vermogen, bijv. 6kW)
- RHI-3PnK-HVES-5G — Three Phase (de ‘n’ staat voor het vermogen, bijv. 10kW)
Met dank aan Jan Willem voor de tip
Inhoudsopgave
- Stap 1: De Modbus-verbinding voorbereiden
- Stap 2: De integratie installeren in Home Assistant
- Stap 3: Je Solis omvormer toevoegen
- Stap 4: De teruglevering limiteren
- Stap 5: Automatiseren met dynamische energieprijzen
- Veelgestelde vragen en aandachtspunten
Stap 1: De Modbus-verbinding voorbereiden
Voordat je de integratie in Home Assistant kunt installeren, moet je eerst een fysieke verbinding maken met de RS485 Modbus-poort van je Solis omvormer.
Er zijn drie manieren om je Solis omvormer via Modbus aan Home Assistant te koppelen:
Optie A: Waveshare RS485 naar Ethernet (aanbevolen)
De aanbevolen methode is een Waveshare RS485 to ETH (B) adapter. Deze sluit je aan op de RS485-poort van je omvormer en verbindt via een ethernetkabel met je netwerk.
Benodigdheden
- Waveshare RS485 to ETH (B) adapter (ca. €35)
- Exceedconn EC04681-2023-BF female connector — dit is de speciale connector die past op de datalogger-poort van Solis omvormers
- Een stuk Cat5/Cat6 ethernetkabel (voor de RS485-bedrading)
- Een ethernetkabel (voor de netwerkverbinding van de Waveshare naar je router/switch)
RS485 bedrading
De RS485-poort van Solis omvormers gebruikt een RJ45-achtige connector. De pinout is:
| Pin | Functie |
|---|---|
| Pin 4 | RS485 A |
| Pin 5 | RS485 B |
| Overige pins | Niet gebruikt |
Gebruik het blauwe paar van een standaard Cat5/Cat6 kabel: het blauwe draadje (pin 4) op A van de Waveshare, en het wit-blauwe draadje (pin 5) op B. De polariteit is belangrijk — als je het omkeert, werkt de communicatie niet.
Tip: RS485 kabels kunnen vrij lang zijn (25 meter of meer), dus afstand tussen je omvormer en je Waveshare adapter is geen probleem.
Gebruik de VirCom tool (Windows) om de Waveshare adapter te configureren:
- Stel het IP-adres in (statisch aanbevolen) of laat DHCP gebruiken
- Zet de werkmode op TCP Server
- Stel het protocol in op Modbus TCP to RTU
- Stel de poort in op 502
- Stel de baudrate in op 9600 — dit is de standaard voor Solis omvormers
- Stel de Modbus Gateway Type in op Simple Modbus to TCP/IP mode
Optie B: Via een compatibele Solis datalogger
Als je al een Solis datalogger hebt, kun je deze mogelijk gebruiken. Let op de compatibiliteit:
Optie C: Solis Cloud én Home Assistant tegelijk (gecombineerd)
Wil je zowel je Solis Cloud behouden als lokaal met Home Assistant werken? Dan is er een geavanceerdere oplossing met twee Waveshare adapters. Eén fungeert als gateway voor Home Assistant, de ander als tussenstuk voor je bestaande datalogger. Dit wordt uitvoerig beschreven in het solis-ha-modbus-cloud project op GitHub. De totale kosten liggen tussen de €93 en €148,50, afhankelijk van je opzet.
Meer info over deze oplossing lees je hier.
Belangrijk: Het loskoppelen van Solis Cloud betekent dat Solis-engineers en je installateur je installatie niet meer op afstand kunnen monitoren of ondersteunen.
Stap 2: De integratie installeren in Home Assistant
Nu de hardware klaar is, installeren we de SolaX Modbus integratie in Home Assistant. De makkelijkste manier om de integratie te installeren is via HACS (Home Assistant Community Store) via:
of via deze stappen:
- Open HACS in Home Assistant
- Ga naar Integraties
- Zoek naar SolaX Inverter Modbus
- Klik op Downloaden
- Herstart Home Assistant
Het kan ook handmatig:
- Download de nieuwste release als zip/tar.gz van de GitHub releases-pagina
- Pak het archief uit
- Kopieer de map
custom_components/solax_modbusnaar je Home Assistantconfig/custom_components/map - Herstart Home Assistant Core
Stap 3: Je Solis omvormer toevoegen
Na het herstarten van Home Assistant configureer je de integratie:
- Ga naar Instellingen → Apparaten & diensten
- Klik op Integratie toevoegen
- Zoek naar SolaX Inverter Modbus
- Configureer de verbinding:
Configuratie-instellingen
Let op het Modbus-adres: Controleer het Modbus-adres op het LCD-scherm van je omvormer, in het menu onder Modbus-instellingen.
Na het toevoegen verschijnt de integratie onder Apparaten & diensten en wordt je omvormer gepolled (standaard elke 15 seconden). Klik op de integratie om te zien hoeveel entities er beschikbaar zijn.
Stap 4: De teruglevering limiteren
Nu de integratie draait, kun je de teruglevering van je Solis omvormer beperken. Dit doe je met de Export Control User Limit entity.
De Export Control User Limit entity
De entity number.solax_export_control_user_limit bepaalt het maximale vermogen (in Watt) dat je omvormer aan het net mag terugleveren:
- Waarde op 0 W: geen teruglevering aan het net
- Waarde op bijv. 2000 W: maximaal 2000 Watt teruglevering
- Waarde op het maximum: volledige teruglevering (afhankelijk van je omvormer-vermogen)
Je kunt deze waarde instellen via:
- De slider in het Home Assistant dashboard
- Een service call in een automatisering
- Via Developer Tools → Services
Voorbeeld service call
Om de export limit op 0 Watt te zetten (geen teruglevering):
service: number.set_value
target:
entity_id: number.solax_export_control_user_limit
data:
value: 0
Om de export limit weer op maximaal te zetten (bijv. 5000 Watt):
service: number.set_value
target:
entity_id: number.solax_export_control_user_limit
data:
value: 5000
Belangrijk — EEPROM: De export_control_user_limit wordt naar het EEPROM-geheugen van de omvormer geschreven. Dit betekent dat het geheugen een beperkt aantal schrijfcycli heeft. Schrijf deze waarde dus niet elke paar seconden of minuten, maar alleen wanneer nodig (bijv. bij verandering van energieprijzen). Een paar keer per dag is geen probleem.
Aanvullende entities voor Solis hybride omvormers
Naast de export limit biedt de integratie voor Solis hybride omvormers ook de mogelijkheid om batterij- en operationele modi in te stellen:
Solis operationele modi
De Energy Storage Control Switch kent verschillende modi:
| Waarde | Modus | Beschrijving |
|---|---|---|
| 35 | Self-Use | Meest gebruikte modus. Prioriteit: zon → batterij → net |
| 3 | Timed Charge/Discharge (No Grid Charge) | Laden/ontladen op vaste tijden, alleen van zonne-energie |
| 51 | Backup/Reserve | Houdt de batterij gevuld als noodstroom |
| 98 | Feed-in Priority | Geeft prioriteit aan teruglevering boven batterij laden |
| 37 | Off-Grid Mode | Omvormer werkt als eilandsysteem |
In de Self-Use modus (waarde 35) wordt overtollige zonne-energie eerst naar de batterij gestuurd. Is de batterij vol, dan gaat het overschot naar het net — tenzij je de export_control_user_limit hebt ingesteld om dit te beperken.
Stap 5: Automatiseren met dynamische energieprijzen
De kracht van deze oplossing zit in de automatisering. Hieronder twee voorbeelden om de teruglevering automatisch te stoppen bij negatieve energieprijzen en weer te starten bij positieve prijzen.
Automatisering 1: Teruglevering stoppen bij negatieve prijzen
alias: "Omvormer - Stop teruglevering bij negatieve prijs"
description: "Zet export limit op 0 als de energieprijs negatief is"
trigger:
- platform: numeric_state
entity_id: sensor.energieprijs_huidige_uur # Pas aan naar jouw prijssensor
below: 0
action:
- service: number.set_value
target:
entity_id: number.solax_export_control_user_limit
data:
value: 0
- service: notify.mobile_app_jouw_telefoon # Optioneel: notificatie
data:
message: "⚡ Negatieve energieprijs! Teruglevering gestopt."
mode: single
Automatisering 2: Teruglevering hervatten bij positieve prijzen
alias: "Omvormer - Hervat teruglevering bij positieve prijs"
description: "Zet export limit terug op maximum als de prijs positief is"
trigger:
- platform: numeric_state
entity_id: sensor.energieprijs_huidige_uur # Pas aan naar jouw prijssensor
above: 0
action:
- service: number.set_value
target:
entity_id: number.solax_export_control_user_limit
data:
value: 5000 # Pas aan naar het vermogen van je omvormer
- service: notify.mobile_app_jouw_telefoon # Optioneel: notificatie
data:
message: "☀️ Positieve energieprijs! Teruglevering hervat."
mode: single
Tip: Pas de entity_id van de prijssensor aan naar de sensor die jij gebruikt, bijvoorbeeld van Tibber, ENTSO-E of een andere dynamische prijsprovider. In het Dossier Zonnepanelen Uitzetten vind je ook handleidingen voor het instellen van dynamische energieprijzen in Home Assistant.
Veelgestelde vragen en aandachtspunten
Verlies ik mijn Solis Cloud-verbinding?
Dat hangt af van je verbindingsmethode:
- Met Waveshare adapter (zonder datalogger): Ja, er is geen Solis Cloud meer beschikbaar.
- Met S2-WL-ST datalogger: Ja, de cloudverbinding stopt zodra de integratie gaat pollen.
- Met de gecombineerde methode (twee Waveshares): Nee, je behoudt Solis Cloud én hebt lokale controle.
Hoe vaak kan ik de export limit aanpassen?
De export_control_user_limit schrijft naar EEPROM, wat een beperkt aantal schrijfcycli heeft. Een paar keer per dag is prima. Vermijd het om deze waarde elke paar seconden te wijzigen. Voor de meeste scenario’s (negatieve energieprijzen) is het voldoende om bij elke uurwisseling (wanneer de prijs verandert) een wijziging door te voeren.
Mijn entiteitsnaam wijkt af, hoe kan dat?
De entity-namen beginnen standaard met solax_ gevolgd door de entity-naam. Heb je bij de installatie een ander prefix ingesteld (bijv. Solis), dan worden je entities number.solis_export_control_user_limit in plaats van number.solax_export_control_user_limit.
Moet ik de omvormer unlocken?
Sommige instellingen vereisen dat je de omvormer eerst “unlockt” via de unlock_inverter of unlock_inverter_advanced button-entity. Als je wijzigingen niet worden opgeslagen, probeer dan eerst te unlocken. Dit werkt alleen als de omvormer niet in idle-modus staat (dus overdag, wanneer er opwek is).
Wat als mijn omvormer niet herkend wordt?
De integratie detecteert automatisch het type omvormer op basis van het serienummer. Als je de melding krijgt “unrecognized solis inverter type”, controleer dan of:
- Je de nieuwste versie van de integratie hebt geïnstalleerd
- Het Modbus-adres correct is ingesteld
- De baudrate overeenkomt (9600 voor Solis)
- De RS485-bedrading correct is aangesloten (A op A, B op B)
Werkt dit ook voor Solis string-omvormers (zonder batterij)?
De integratie richt zich primair op de Solis hybride modellen (RHI-serie). Voor string-omvormers zoals de S5-serie zijn de mogelijkheden beperkter. Er zijn wel entities beschikbaar voor het uitlezen van data, maar de schrijfmogelijkheden voor power limiting zijn minder uitgebreid.
Kan ik meerdere omvormers aansluiten?
Ja, je kunt meerdere instanties van de integratie draaien met elk een eigen prefix. Als je meerdere omvormers op dezelfde RS485-bus aansluit, moeten ze verschillende Modbus-adressen hebben. Vergeet niet om 120 Ohm terminating resistors te plaatsen aan beide uiteinden van de RS485-bus.
1 Comment