Open API: koppelen met Home Assistant en Homey

Met de Open API stuur je je Planetpod zelf aan, met Homey, Home Assistant of een ander systeem. Daarvoor gebruik je een token: een beveiligingssleutel die je privé houdt. Je maakt het aan in de Planetpod-app: ga naar het tabblad Pod, tik op de knop Batterijmodus, kies Open-modus en daarna Homey of Home Assistant, en loop de stappen door. Maak je een nieuw token aan, dan vervalt het oude.

Uitlezen of aansturen?

Allebei, in de Open-modus. Daarin schakelt Planetpod de eigen logica uit: jouw systeem leest je Pod uit én bepaalt wanneer er geladen of ontladen wordt. Wil je dat de Pod weer zelf beslist, kies dan in de app een andere batterijmodus.

Welke gegevens kun je uitlezen?

• laadniveau (SoC, in %)
• laad- en ontlaadvermogen (kW)
• P1-import en -export
• netspanning en frequentie
• status en foutcodes

Waarmee koppelt het?

Planetpod werkt samen met Home Assistant en Homey. Ook andere energiemanagementsystemen of energieleveranciers kunnen Planetpod aansturen, mits zij communiceren via de gedocumenteerde Open API. Je gebruikt één systeem tegelijk.

Voor Homey hebben we aparte artikelen:

• Planetpod koppelen aan Homey
• Planetpod in Homey: apparaten en Flow-kaarten
• Homey of Balans: zo stuur je je Planetpod met Homey
• Wat kun je met Homey en je Planetpod?
• Veelgestelde vragen over Homey en Planetpod

Wat heb je nodig?

• een Energy Pulse: die is in Open-modus je P1-meter. Een andere P1-meter wordt niet ondersteund, ook niet als die in Homey of Home Assistant staat. Ook Balans in Homey werkt alleen met de Energy Pulse;
• een token, aangemaakt in de Planetpod-app (zie hierboven).

Met Homey heb je verder alleen een Homey nodig: lees Planetpod koppelen aan Homey. Met Home Assistant of een ander systeem heb je ook nodig:

• kennis van Home Assistant of een vergelijkbaar systeem;
• een lokale computer, zoals een Raspberry Pi of een laptop.

Wat als de verbinding wegvalt?

Ontvangt de Pod in Open-modus gedurende een ingestelde tijd geen commando's meer (heartbeat timeout), dan valt het systeem uit veiligheid automatisch terug naar Solar Pure. Je staat dus nooit zonder sturing.

De hardwarematige beveiligingen blijven in alle gevallen actief.

Documentatie

De documentatie voor implementatie en de beschikbare gegevens vind je via github.com/Planetpod/home-assistant-planetpod.

Bij vragen kun je contact opnemen met support.