Hoe integreer je een Alfen laadpaal in je Home Assistant dashboard?
Je Alfen laadpaal aan je Home Assistant dashboard koppelen voelt als het sluitstuk van je slimme huis. Je ziet in één oogopslag hoeveel stroom je auto vreet, of je zonnepanelen genoeg opwekken en of je batterij nog ruimte heeft voor goedkope nachtstroom.
Geen gezoek meer in losse apps, alles op één plek. Dat is pas echt energiebeheer.
Wat je nodig hebt voor de integratie
Voordat je begint, check even of je de juiste spullen in huis hebt.
- Een Alfen laadpaal (bijvoorbeeld de Alfen Eve Double, Pro Line of Home Line). Zorg dat de laadpaal is aangesloten op je thuisnetwerk via wifi of een ethernetkabel.
- Home Assistant draaiend. Dat kan op een Raspberry Pi, een NUC of in een Virtual Machine. Zorg dat je versie up-to-date is, bij voorkeur 2024.x of nieuwer.
- Een account bij Alfen. Je hebt toegang nodig tot de Alfen Backoffice of de Alfen Installer App om de API-sleutel te activeren.
- Een API-sleutel (token) van Alfen. Die haal je uit de backoffice of de installer app. Bewaar deze sleutel veilig.
- Een computer of laptop om de configuratie te doen. Je kunt ook de Home Assistant app op je telefoon gebruiken.
- Optioneel: een energieverbruiksmanager zoals een Shelly EM of een P1-meter voor je zonnepanelen. Handig voor slim laden op basis van overschot.
Een halfslachtige poging levert alleen frustratie op. Zorg dat je de volgende dingen paraat hebt. Reken op een uurtje voor de basisintegratie. Als je ook energiebalans en automatiseringen instelt, tel er gerust nog een half uur bij op.
Stap 1: Haal je API-sleutel bij Alfen
De Alfen laadpaal heeft een cloud-API. Je moet dus eerst toegang krijgen via de Alfen Backoffice of de Installer App.
- Meld je aan met je Alfen-account. Heb je die niet? Maak er één aan via de Alfen Backoffice (kies voor 'eigenaar' of 'installateur').
- Zoek je laadpaal in de lijst. Klik op de laadpaal en ga naar 'Instellingen' of 'API-toegang'.
- Schakel de API-toegang in. Soms heet dit 'Cloud API' of 'Remote Access'. Accepteer de voorwaarden.
- Genereer een API-token (API-sleutel). Dit is een lange reeks letters en cijfers. Kopieer de sleutel meteen naar een veilige plek, bijvoorbeeld een wachtwoordmanager.
- Controleer of de laadpaal online is. Als je laadpaal offline staat, werkt de API niet. Check de netwerkverbinding.
Open de app of log in op de website van Alfen. Veelgemaakte fout: vergeten om de API-toegang aan te zetten.
Tip: bewaar je API-sleutel nooit openbaar. Deel hem niet in forums en zet hem niet in een openbaar GitHub-bestand.
Dan krijg je bij de integratie een foutmelding dat de sleutel niet werkt. Check dit dus eerst. Reken op 5 tot 10 minuten voor deze stap. Als je al een account had, ben je sneller klaar.
Stap 2: Voeg de Alfen-integratie toe in Home Assistant
Home Assistant heeft een standaardintegratie voor Alfen. Die werkt via de cloud.
- Open Home Assistant in je browser of app. Ga naar 'Instellingen' en dan 'Apparaten en services'.
- Klik rechtsonder op 'Integratie toevoegen'. Zoek naar 'Alfen'. Kies de officiële Alfen-integratie.
- Vul je Alfen-gebruikersnaam en wachtwoord in. De integratie vraagt ook om je API-token. Plak de sleutel die je net hebt gekopieerd.
- Klik op 'Doorgaan' en wacht tot Home Assistant je laadpaal vindt. Dit duurt meestal 1 tot 2 minuten.
- Als je meerdere Alfen-laadpalen hebt, herhaal je deze stap voor elke paal. Geef ze een logische naam, bijvoorbeeld 'Alfen Garage' of 'Alfen Oprit'.
Je hoeft niets te installeren, alleen in te loggen. Veelgemaakte fout: verkeerde credentials invullen. Let op hoofd- en kleine letters.
Als je wachtwoord onlangs is gewijzigd, update dit dan ook in Home Assistant. Als de integratie slaagt, zie je een nieuwe kaart met je laadpaal. De status is nu beschikbaar in Home Assistant.
Stap 3: Voeg de laadpaal toe aan je dashboard
Nu je laadpaal is geïntegreerd, wil je hem zien. Je kunt een eigen kaart maken of een bestaande dashboardsectie uitbreiden. Je kunt ook een 'Energy' kaart gebruiken om het laadvermogen en verbruik te tonen.
- Open 'Dashboard' in Home Assistant. Kies een pagina, bijvoorbeeld 'Energie' of 'Woonkamer'.
- Klik op de drie puntjes rechtsboven en kies 'Bewerken' of voeg een nieuwe sectie toe.
- Kies 'Kaart toevoegen' en selecteer 'Entity'. Zoek je laadpaal-entity. Kies voor een 'Toggle' of 'Gauge' om de status te tonen.
- Geef de kaart een duidelijke naam, bijvoorbeeld 'Alfen Laadpaal'. Je kunt ook een icoon kiezen, zoals een laadpaal-icoon.
- Sla de wijzigingen op. De kaart verschijnt nu op je dashboard.
- Installeer de integratie voor je zonnepanelen (bijvoorbeeld via SolarEdge, Fronius, of een P1-meter). Ga naar 'Apparaten en services' en voeg de juiste integratie toe.
- Voeg een energieverbruiksmanager toe, zoals Shelly EM. Meet het totale verbruik en de opbrengst van je zonnepanelen.
- Maak een energie-entity die het netto overschot berekent: opbrengst minus verbruik. Gebruik hiervoor een template-sensor in Home Assistant.
- Koppel de overschot-sensor aan je laadpaal. Gebruik een automatisering of een slimme laadmodus. Bijvoorbeeld: start laden als het overschot boven 2000 watt ligt.
- Test de automatisering. Zet de laadpaal op 'auto' en kijk of hij start bij voldoende zonnestroom.
- Open 'Automatiseringen' en klik op 'Nieuwe automatisering'. Kies een trigger, bijvoorbeeld 'Tijd' voor nachtlaad of 'Energie overschot' voor zonnestroom.
- Stel de actie in: start laden of zet de laadpaal in een specifieke modus. Gebruik de entity 'switch.alfen_laadpaal' of een laadstroom-entity.
- Voeg een voorwaarde toe: bijvoorbeeld 'als de batterij荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷荷
Koppel de laadpaal-entity aan de energiekaart voor een overzichtelijke weergave. Veelgemaakte fout: een te druk dashboard. Houd het overzichtelijk.
Zet alleen de belangrijkste info op de hoofdpagina en verberg details achter een klik. Reken op 5 minuten om de kaart te plaatsen en te testen. Als je meerdere kamers hebt, verdelen over pagina's geeft rust.
Stap 4: Koppel energiebronnen voor slim laden
Wil je je laadpaal slim aansturen op basis van zonnepanelen of een energiebatterij? Koppel dan je energiebronnen.
Zo laad je alleen bij overschot. Veelgemaakte fout: een te lage drempelwaarde instellen. Als je onder de 1000 watt start, schakelt je laadpaal te vaak in en uit.
Kies een stabiele drempel, bijvoorbeeld 2000 watt. Reken op 15 tot 30 minuten om de energiebronnen te koppelen en te testen.
Dit hangt af van hoeveel bronnen je hebt.
Stap 5: Maak slimme automatiseringen
Automatiseringen zorgen dat je laadpaal slim reageert op je huis. Denk aan laden tijdens goedkope nachtstroom of stoppen als de batterij vol is.