Hoe integreer je een Fronius omvormer in je smart home via de Solar.web API
Stel je voor: je zonnepanelen produceren stroom, je Fronius omvormer draait op volle toeren, maar je weet pas echt wat er gebeurt als je het live in je woonkamer kunt zien.
Je slimme thermostaat reageert automatisch op zonne-energie, je laadpaal laadt je auto op het moment dat de zon het hardst schijnt en je hele huis wordt één slim energienetwerk. Dat klinkt complex, maar met de Solar.web API is het een fluitje van een cent. In deze handleiding leiden we je stap voor stap door het proces, zonder ingewikkelde technische taal, maar wel met concrete cijfers en tips.
Wat heb je nodig?
Voordat je begint, check even of je de juiste spullen in huis hebt. Zonder de juiste materialen kom je halverwege stil te staan, en dat is zonde van je tijd.
We houden het simpel en praktisch, zonder onnodige poespas. De Fronius omvormer moet verbonden zijn met je netwerk.
- Een Fronius omvormer (bijvoorbeeld de Fronius Primo 5.0-1 of de Symo 8.2-3)
- Een werkende internetverbinding via ethernet of Wi-Fi
- Een account op Solar.web (gratis aan te maken)
- Een slimme hub of home-assistant (zoals Home Assistant, Domoticz of een Hubitat)
- Een API-sleutel van Solar.web (die activeer je in je account)
- Een paar basisvaardigheden met je slimme hub (je hoeft geen programmeerwonder te zijn)
Dat is essentiel voor de API-toegang. Als je al een Solar.web account hebt, ben je al half klaar. Heb je die nog niet?
Maak er dan eerst een aan. Het duurt maar een paar minuten.
Stap 1: Maak een Solar.web account aan en activeer de API
Open je browser en ga naar de Solar.web website. Klik op "Registreren" en vul je gegevens in. Je hoeft geen betaald abonnement te hebben; de gratis versie biedt genoeg functionaliteit voor deze integratie.
Zodra je account actief is, ga je naar de instellingen. Zoek naar "API-toegang" of "Developer Settings".
Tip: De API-sleutel is je toegangspoort tot alle data van je Fronius omvormer. Zonder deze sleutel kun je niets uitlezen.
Hier activeer je de API en krijg je een unieke sleutel. Kopieer deze sleutel meteen en bewaar hem op een veilige plek, bijvoorbeeld in een wachtwoordmanager of een notitie.
Deze stap duurt ongeveer 5 minuten. Controleer of je de sleutel correct hebt gekopieerd, want een verkeerde sleutel levert straks foutmeldingen op. Veelgemaakte fout: vergeten om de API te activeren. Dan krijg je geen data te zien.
Stap 2: Verbind je Fronius omvormer met Solar.web
Je Fronius omvormer moet verbonden zijn met het internet. Sluit de omvormer aan op je router via een ethernetkabel of Wi-Fi.
Volg de handleiding van Fronius voor de netwerkinstellingen; meestal kun je dit rechtstreeks op het display van de omvormer instellen. Log in op je Solar.web account en voeg je omvormer toe.
Je hebt de serienummer nodig, dat vind je op de sticker aan de zijkant van de omvormer. Vul dit in en de verbinding wordt automatisch gelegd. Binnen een paar minuten zie je de eerste data verschijnen. Controleer of de omvormer correct is toegevoegd.
Ga naar het dashboard en check of de opgewekte stroom, spanning en stroomsterkte worden weergegeven.
Als je niets ziet, controleer dan de netwerkverbinding en de serienummer. Veelgemaakte fouten: verkeerd serienummer invoeren of een verkeerde tijdzone instellen. Dit levert onnauwkeurige data op. Duur: 10-15 minuten.
Stap 3: Koppel Solar.web API aan je slimme hub
Open je slimme hub (bijvoorbeeld Home Assistant) en ga naar de integraties. Zoek naar een Solar.web integratie.
Als die niet standaard beschikbaar is, kun je een custom component toevoegen via HACS (Home Assistant Community Store).
Vul je API-sleutel in en geef de hub toegang tot je Solar.web account. De hub gaat nu automatisch data ophalen van je Fronius omvormer. Test de verbinding door een paar parameters te bekijken, zoals de opgewekte stroom (in watt) en de spanning (in volt).
Stel een refresh-interval in. Een interval van 5 seconden is realistisch voor live data.
Te snel kan je netwerk belasten, te langzaam mis je piekmomenten. Controleer of de data klopt met wat je op het Solar.web dashboard ziet. Veelgemaakte fouten: verkeerde API-sleutel invoeren of een verkeerd endpoint instellen. Duur: 15-20 minuten.
Stap 4: Automatiseer je slimme apparaten op basis van zonne-energie
Je slimme thermostaat, laadpaal en verlichting kun je nu automatiseren op basis van de zonne-energie. Stel bijvoorbeeld in dat je thermostaat warmer gaat staken als de zon volop schijnt en de opgewekte stroom hoog is. Bij een laadpaal kun je een script maken dat alleen laadt als de zonnestroom boven een bepaalde drempel komt, bijvoorbeeld 2000 watt.
Zo laad je je auto gratis op met eigen zonne-energie. Gebruik hiervoor de data uit de Solar.web API, zoals de opgewekte stroom (in watt) en de spanning (in volt).
Test je automatiseringen eerst met een paar simpele regels. Bijvoorbeeld: als de opgewekte stroom boven 3000 watt komt, schakel dan de keukenverlichting in.
Pas de drempelwaarden aan op basis van je eigen verbruik en productie. Gebruik specifieke getallen: een drempel van 2500 watt voor de laadpaal en 1500 watt voor de thermostaat. Veelgemaakte fouten: te hoge of te lage drempelwaarden instellen, waardoor apparaten niet op het juiste moment reageren. Duur: 20-30 minuten.
Stap 5: Monitor en optimaliseer je energiebeheer
Zodra alles draait, monitor je de data regelmatig. Gebruik dashboards in je slimme hub om de opgewekte stroom, verbruik en reststroom in één oogopslag te zien.
Stel notificaties in voor pieken en dalen, zodat je direct weet wat er gebeurt.
Optimaliseer je instellingen op basis van de data. Als je merkt dat je laadpaal te veel stroom trekt tijdens een piek, verlaag dan de drempelwaarde. Of verhoog de drempel voor de thermostaat als je te veel stroom verliest.
Gebruik de Solar.web app om je data ook onderweg te bekijken. Zo ben je altijd op de hoogte van je energieproductie en verbruik.
Stel een wekelijkse check in om je instellingen bij te schaven. Veelgemaakte fouten: vergeten om dashboards bij te werken of geen notificaties instellen. Duur: 10 minuten per week.
Verificatie-checklist
- Is je Fronius omvormer verbonden met het internet?
- Heb je een Solar.web account en een actieve API-sleutel?
- Zie je live data in je slimme hub?
- Werken je automatiseringen zoals verwacht?
- Staan de drempelwaarden op de juiste waarden (bijv. 2500 watt voor laadpaal)?
- Krijg je notificaties bij pieken en dalen?
Als je alle punten kunt afvinken, ben je klaar. Je huis is nu een slim energienetwerk dat reageert op je zonne-energie. Geniet van de besparingen en het gemak!