FlexiO Gebruiker

FlexiO API (Generic Load Controller) handleiding

Generic Load Controller

Lees eerst de uitleg en de handleiding over de FlexiO API in het vorige artikel. Ook hier geldt: alleen bedoeld voor technische FlexiO-gebruikers, en FlexiO geeft er geen ondersteuning op.

Eenheden voor de laststuring

Meting

Eenheid

Wat het je zegt

Endpoint

Methode

powerSetpointGeneric

kW

Vermogen dat beschikbaar is om een generieke last aan te sturen

/api/ems/load_control

GET

genericLoadMaximumElectricityPrice

€/kWh

Maximale prijs waarbij de laststuring werkt

/api/ems/load_control

GET / PUT

genericLoadMaximumElectricityPrice is de enige waarde die je kan schrijven. Met een PUT stel je een nieuwe prijsdrempel in. Zo bepaal je bij welke elektriciteitsprijs je generieke last mag draaien.

Zo werkt het

FlexiO doet meer dan je energie opvolgen. Via de endpoints hierboven publiceert FlexiO een stuursignaal. Dat signaal zegt aan externe toestellen wanneer het een goed moment is om energie te verbruiken, en wanneer niet.

Het idee: heb je een dynamisch tarief (of een dag- en nachttarief), dan verandert de elektriciteitsprijs in de loop van de dag. FlexiO volgt die prijzen en berekent een waarde powerSetpointGeneric (in kW). Die geeft aan hoeveel vermogen er op dit moment beschikbaar is voor een externe last. Combineer dat met de drempel genericLoadMaximumElectricityPrice en je hebt een eenvoudige beslissingsregel: laat de last draaien als de prijzen laag zijn, zet ze stil als ze hoog zijn.

Toepassingen

  • Warmtepompen en boilers: laat je verwarming draaien wanneer energie het goedkoopst is, op basis van je echte tarief in plaats van een vaste timer.

  • Elke stuurbare last: kan je ze aan- en uitschakelen met een relais of een slimme stekker, dan koppel je ze aan het signaal van FlexiO.

Zo stel je het in

  1. Lees powerSetpointGeneric uit via /api/ems/load_control. Zo weet je hoeveel vermogen FlexiO op dit moment aanraadt voor je externe last.

  1. Stel je prijsdrempel in door met een PUT naar genericLoadMaximumElectricityPrice te schrijven. Daarmee zeg je bij welke elektriciteitsprijs (in €/kWh) de last nog mag draaien.

  1. Bouw je eigen logica, bijvoorbeeld in Home Assistant, Node-RED of een eenvoudig script. Die haalt de waarden op en schakelt je toestel aan of uit.

FlexiO stuurt externe toestellen niet zelf aan. FlexiO levert het signaal; jij of je integratieplatform doet er iets mee. Een aantal van onze integratiepartners bieden hier kant-en-klare oplossingen voor. Ben je een technische FlexiO-gebruiker, dan geeft de API je alles om het zelf te bouwen.

Handleiding voor Shelly-producten

Generic_Setpoint_Manual_with_Shelly.pdf