Hoe verbind je een GoodWe omvormer met een slimme hub via de SEMS API
Je zonnepanelen produceren stroom, maar je weet niet precies wat er gebeurt.
Je wilt weten hoeveel energie je opwekt, verbruikt en teruglevert. De GoodWe omvormer is een prima apparaat, maar de standaard app is niet altijd genoeg voor een echte smart home ervaring.
Je wilt alles centraal zien, samen met je slimme thermostaat en laadpaal. Dat is waar de SEMS API in het spel komt. Deze koppeling geeft je de kracht om jouw GoodWe omvormer te verbinden met een slimme hub zoals Home Assistant, waardoor je volledig inzicht en controle krijgt over je energiebeheer. Deze handleiding neemt je stap voor stap mee.
We gaan aan de slag met de SEMS Portal en je lokale hub.
Je hebt geen ingewikkelde programmeerkennis nodig, maar wel wat geduld en een laptop. Binnen een uurtje ben je klaar en heb je een schat aan data tot je beschikking. Laten we beginnen met de voorbereiding.
Wat je nodig hebt voordat je start
Voordat je de eerste stap zet, moeten de benodigdheden op een rijtje staan.
Zonder de juiste materialen kom je niet verder. Dit is de basis voor een stabiele verbinding. Je hebt een GoodWe omvormer nodig die geschikt is voor de SEMS Portal.
De meeste modellen van de afgelopen jaren, zoals de GoodWe ET, EM of BT series, ondersteunen dit. Je omvormer moet online zijn en verbonden met je thuisnetwerk via Wi-Fi of een netwerkkabel.
Zorg dat je de GoodWe app al hebt geïnstalleerd en dat de omvormer correct is aangemeld.
Een tweede essentieel onderdeel is een SEMS account. Dit is het cloudplatform van GoodWe waarop je omvormer al zijn data naartoe stuurt. Als je nog geen account hebt, maak je die gratis aan via de GoodWe app of website. Je hebt je omvormer-ID nodig, wat je vindt in de app onder de instellingen van je specifieke omvormer.
Noteer dit nummer even. Je hebt een slimme hub nodig.
In de wereld van energiebesparing en zonnepanelen is Home Assistant veruit de meest populaire keuze. Je kunt ook andere hubs gebruiken, maar de integratie is het soepelst met Home Assistant. Zorg dat je hub al draait en dat je toegang hebt tot het dashboard.
Een Raspberry Pi of een oude laptop is vaak al voldoende. Tot slot heb je een stabiele internetverbinding nodig en ongeveer 30 tot 60 minuten tijd.
Wees geduldig, want soms duurt het even voordat de API-token binnenkomt. Zorg dat je laptop en de hub op hetzelfde netwerk zitten als je omvormer.
Stap 1: Activeer de SEMS API in je account
De GoodWe omvormer stuurt data naar de cloud, maar je hebt toestemming nodig om die data uit te lezen. Die toestemming regel je via de SEMS Portal.
- Log in op de SEMS Portal via je webbrowser. Gebruik de inloggegevens van je GoodWe account.
- Na het inloggen klik je rechtsboven op je accountnaam en kies je voor ‘API-beheer’ of ‘API Management’.
- Je ziet nu een scherm waar je een nieuwe API-key kunt aanvragen. Klik op ‘Nieuwe API-key genereren’.
- Vul een naam in voor je key, bijvoorbeeld ‘Home Assistant’ of ‘Mijn Hub’. Dit helpt je later om te herkennen welke key bij welk apparaat hoort.
- De portal toont nu een unieke API-key. Kopieer deze direct en sla hem op in een veilig bestand op je computer. De key is maar één keer zichtbaar.
- Je hebt ook je systeem-ID nodig. Deze staat meestal op hetzelfde scherm of in de instellingen van je omvormer in de app. Noteer deze ook.
Dit is een eenmalige actie. Veelgemaakte fout: Je vergeet de API-key op te slaan.
Zodra je het scherm verlaat, kun je de key niet meer terugzien. Maak een screenshot of sla het op in een wachtwoordmanager. Een andere fout is het verkeerde account gebruiken.
Zorg dat je inlogt met het account waarop je omvormer is geregistreerd. Deze stap duurt ongeveer 5 minuten. Als het lukt, heb je de digitale sleutel in handen om je omvormer te ontsluiten.
Stap 2: Installeer de SEMS-integratie in Home Assistant
Nu de API-key binnen is, is het tijd om de koppeling te maken in je slimme hub. We gaan ervan uit dat je Home Assistant gebruikt, de meest krachtige hub voor energiebeheer.
- Open je Home Assistant dashboard in je browser. Log in met je gebruikersnaam en wachtwoord.
- Klik links op ‘Instellingen’ en dan op ‘Apparaten en services’. Rechts onderin klik je op ‘Integraties toevoegen’.
- Zoek in het zoekveld naar ‘SEMS’ of ‘GoodWe’. De integratie heet officieel ‘GoodWe SEMS Portal’.
- Klik op de integratie en vul je SEMS e-mailadres en wachtwoord in. Je kunt ook je API-key invullen als je die hebt gekozen. Gebruik je API-key voor de meest stabiele verbinding.
- Vul ook je systeem-ID in. Dit is het nummer van je omvormer dat je eerder hebt genoteerd.
- Klik op ‘Opslaan’ of ‘Submit’. Home Assistant probeert nu verbinding te maken met de SEMS cloud.
Deze stap duurt ongeveer 10 tot 15 minuten. Als de verbinding slaagt, zie je een melding dat de integratie is toegevoegd. Je ziet nu nieuwe sensors in je dashboard, zoals ‘Current Power’, ‘Daily Energy’ en ‘Total Energy’.
Veelgemaakte fouten: Een verkeerd wachtwoord of een typefout in de API-key. Controleer dit dubbel.
Een andere fout is het vergeten van de systeem-ID. Zonder dit nummer weet Home Assistant niet welke omvormer hij moet uitlezen. Als de verbinding mislukt, wacht dan 5 minuten en probeer het opnieuw. Soms is de SEMS server even traag.
Stap 3: Verbind de data met je slimme apparaten
Nu je omvormer is gekoppeld, kun je de data gebruiken voor je smart home ecosystemen. Dit is waar het echt interessant wordt voor energiebesparing.
Je kunt de opgewekte stroom automatisch laten reageren op je slimme thermostaat.
Stel je hebt een Nest of Tado. Je kunt een automatisering maken die de verwarming uitzet als je zonnepanelen weinig produceren. In Home Assistant ga je naar ‘Automatiseringen’ en maak je een nieuwe regel.
Gebruik de sensor ‘Current Power’ als trigger. Als de productie onder de 500 watt zakt, schakel dan de thermostaat over op een lagere temperatuur.
Je kunt ook je laadpaal slim aansturen. Stel je hebt een laadpaal vanEasee of Zappi. Je maakt een automatisering die het laadvermogen verhoogt als je overschot aan zonne-energie hebt. Bijvoorbeeld: als de opwek boven de 3000 watt komt, start de laadpaal met laden op vol vermogen.
Dit voorkomt dat je stroom teruglevert aan het net en maximaliseert je eigen verbruik.
Je kunt een energiedashboard maken in Home Assistant. Voeg de sensors toe aan een nieuw dashboard. Je ziet nu realtime je opwek, verbruik en teruglevering.
Dit helpt je om je verbruik aan te passen. Was de vaatwasser aanzetten als de zon schijnt?
Dat zie je direct. Veelgemaakte fouten: Te complexe automatiseringen beginnen. Start simpel. Test eerst één regel, zoals het uitschakelen van de verlichting bij lage opwek.
Een andere fout is het negeren van vertragingen. De SEMS API heeft een kleine vertraging van 5 tot 10 minuten. Pas je automatiseringen hierop aan.
Stap 4: Optimaliseer en onderhoud je verbinding
Je hebt nu een werkende koppeling, maar je wilt dat het soepel blijft draaien.
Regelmatig onderhoud voorkomt problemen. Controleer wekelijks of de data klopt. Vergelijk de cijfers in Home Assistant met die in de GoodWe app.
Als er een groot verschil is, kan de API-key verlopen zijn of is er een netwerkprobleem. Vernieuw de key dan in Home Assistant.
Update je Home Assistant regelmatig. De SEMS-integratie wordt af en toe bijgewerkt.
Een update zorgt voor betere stabiliteit en nieuwe functies. Ga naar ‘Settings’ > ‘System’ > ‘Updates’ en controleer op updates. Gebruik de data voor energiebesparing. Stel een doel: verbruik 70% van je eigen opgewekte stroom.
Gebruik het dashboard om je gedrag aan te passen. Zet de wasmachine aan als de zon op zijn hoogst is. Dit kan je tientallen euros per jaar besparen.
Veelgemaakte fouten: Vergeten om te controleren. Een kapotte verbinding leidt tot verkeerde automatiseringen. Een andere fout is het negeren van de vertraging. Als je een automatisering instelt op basis van realtime data, mislukt