Meter en stroomprijs

De meter koppelen met Home Assistant

Verbind jullie slimme meter via Home Assistant: jullie toestemming, de koppelsleutel, de Thuisbord-integratie uit HACS en jullie sensoren.

Goed om te weten

De Thuisbord-integratie voor Home Assistant staat nog niet in de standaardlijst van HACS. Je voegt haar daarom zelf aan HACS toe, zoals hieronder staat.

Met deze koppeling stuurt jullie Home Assistant de waarden van jullie slimme meter naar Thuisbord, zodat elk scherm in huis ze live kan laten zien. De Thuisbord-integratie leest alleen de sensoren die jullie kiezen. Thuisbord krijgt geen toegang tot Home Assistant en bedient nooit apparaten.

Wat je nodig hebt

  • Home Assistant 2026.3 of nieuwer, waarin jullie slimme meter al staat, bijvoorbeeld via de DSMR- of HomeWizard-integratie.
  • HACS, de Home Assistant Community Store, al geïnstalleerd in Home Assistant. Hoe je HACS installeert, staat in de documentatie van HACS.
  • De Thuisbord-app op je telefoon, als eigenaar van het huishouden. Alleen de eigenaar kan de meter koppelen; andere volwassenen zien in de app dat de eigenaar dat doet.

De menunamen van Home Assistant en HACS staan hieronder zoals de Engelstalige Home Assistant ze noemt. De teksten van de Thuisbord-integratie zelf volgen de taal van jullie Home Assistant; hieronder staan ze in het Nederlands. Staat jullie Home Assistant in het Engels, dan vind je ze in de Engelse versie van deze pagina.

Wat Thuisbord ontvangt

  • Het tijdstip van elke meting
  • Het vermogen: hoeveel stroom jullie nu gebruiken of terugleveren
  • De meterstanden van stroom van en naar het net, als jullie meter ze geeft
  • Welk tarief nu geldt: normaal of dal, als jullie meter dat meldt
  • Zonnestroom: het vermogen nu en de totale opbrengst, als Home Assistant die kent
  • De gasmeterstand, als jullie meter gas meet
  • Een thuisbatterij: het vermogen waarmee ze laadt of ontlaadt en het laadniveau, en de grens van het laadniveau en de capaciteit, als Home Assistant die kent
  • Een watermeter: de meterstand en hoeveel water er nu stroomt, als Home Assistant die kent
  • Een laadpaal voor de auto: het vermogen waarmee de auto nu laadt en de meterstand van de laadpaal, als Home Assistant die kent

Alleen het vermogen is nodig. Home Assistant stuurt hooguit één meting per 10 seconden, met alleen de waarden van de sensoren die jullie kiezen. Thuisbord laat de thuisbatterij zien en bedient haar nooit. Van de watermeter ziet Thuisbord alleen hoeveel water er gaat; het zet er geen prijs op. Thuisbord laat de laadpaal zien en bedient hem nooit. Het laadvermogen zit al in het vermogen van de slimme meter: Thuisbord telt het niet dubbel. Meer hierover lees je in Welke gegevens Thuisbord ontvangt.

1. Geef toestemming en kopieer de sleutel

Je ziet de koppelsleutel maar één keer. Wil je hem meteen in Home Assistant kunnen plakken, installeer de integratie dan eerst, zoals bij stap 2 staat, en begin daarna hier.

  1. Kies Home Assistant. Open in de Thuisbord-app Instellingen › Meterkoppeling › Meter koppelen en kies Home Assistant. Ben je Thuisbord net aan het instellen, dan kom je vanzelf bij Koppel jullie meter.
  2. Geef toestemming. Je ziet Dit ontvangt Thuisbord, met precies de waarden hierboven. Tik op Ik ga akkoord. Met Niet nu wordt er niets verstuurd en maakt Thuisbord ook geen koppelsleutel.
  3. Kopieer de koppelsleutel. Thuisbord maakt nu jullie koppelsleutel en laat hem zien bij Jullie koppelsleutel. Tik op Kopiëren. Je ziet deze sleutel alleen nu: laat dit scherm open tot hij in Home Assistant staat. Tik je op Verder of ga je naar een ander scherm in de app, dan zie je hem niet meer terug. Deel de sleutel met niemand anders.

Ben je de sleutel kwijt voordat hij in Home Assistant staat? Maak dan een nieuwe, zoals hieronder bij Nieuwe sleutel staat.

Zie je na Ik ga akkoord het scherm Er is al een koppelsleutel? Dan heeft jullie huishouden al een sleutel, en die laat Thuisbord niet nog eens zien. Staat die sleutel al in Home Assistant, tik dan op Huidige sleutel houden. Anders tik je op Nieuwe sleutel maken; de oude werkt dan meteen niet meer.

De telefoon bij stap 2 van 3, Koppel jullie meter, met de keuzes Homey, met de Thuisbord-app uit de Homey App Store, en Home Assistant, met de Thuisbord-koppeling voor Home Assistant.
Koppel jullie meter: kies Home Assistant.

2. Installeer de integratie via HACS

  1. Open HACS in Home Assistant.

  2. Kies rechtsboven ⋮ › Custom repositories.

  3. Plak dit adres in het venster:

    text
    https://github.com/mennovanhout/thuisbord-home-assistant
    
  4. Kies als type Integration en kies Add. Sluit daarna het venster.

  5. Zoek in HACS naar Thuisbord, open het en kies Download.

  6. Herstart Home Assistant.

3. Voeg Thuisbord toe

  1. Ga naar Settings › Devices & services, kies Add integration en kies Thuisbord.
  2. Je ziet Thuisbord koppelen. Plak de koppelsleutel bij Koppelsleutel en kies Submit (in een Nederlandstalige Home Assistant: Verzenden). Een koppelsleutel begint met thb_.
  3. Home Assistant vraagt Thuisbord meteen of de sleutel werkt. Klopt er iets niet, bijvoorbeeld omdat er een stukje van de sleutel mist, dan zie je dat meteen in het venster. Plak dan de hele sleutel opnieuw. Heb je hem niet meer, maak dan een nieuwe, zoals hieronder bij Nieuwe sleutel staat.

Laat Geavanceerd dicht: het Serveradres daarin hoef je niet te veranderen. Home Assistant bewaart de sleutel alleen in de integratie en schrijft hem nooit in zijn logboek.

Zie je Sleutel werkt, nog geen toestemming? Dan kent Thuisbord de sleutel, maar heeft jullie huishouden geen toestemming gegeven om metergegevens te delen. Tik in de app bij Instellingen › Meterkoppeling op Meter koppelen, kies Home Assistant en tik op Ik ga akkoord. Zie je Er is al een koppelsleutel, tik dan op Huidige sleutel houden. Kies daarna in Home Assistant Submit.

4. Kies jullie sensoren

Home Assistant vraagt Hoe gaan de meterstanden naar Thuisbord?. Kies Ik kies mijn sensoren, Thuisbord leest ze zelf. Maak je liever zelf een automatisering, lees dan hieronder bij Zelf een automatisering maken.

Bij Kies jullie sensoren kies je de sensoren van jullie meter. Alleen het vermogen is nodig: kies de andere sensoren alleen als jullie meter ze heeft, en laat de rest leeg.

Veld in Home Assistant DSMR HomeWizard
Netto vermogen (leeg laten) Power
Vermogen afname Power consumption (leeg laten)
Vermogen teruglevering Power production (leeg laten)
Afname totaal Energy consumption (total), als jullie meter die heeft Energy import
Afname tarief 1 en 2 Energy consumption (tarif 1) en (tarif 2) Energy import tariff 1 en 2
Teruglevering totaal Energy production (total), als jullie meter die heeft Energy export
Teruglevering tarief 1 en 2 Energy production (tarif 1) en (tarif 2) Energy export tariff 1 en 2
Actief tarief Active tariff Tariff
Gasmeterstand Gas consumption de sensor van Gas meter
Watermeterstand Water consumption, als er een watermeter aan de slimme meter hangt Total water usage, van de HomeWizard-watermeter
Waterdoorstroming (leeg laten) Water usage, van de HomeWizard-watermeter
Laadvermogen het vermogen van de laadpaal, als Home Assistant dat kent idem
Laadpaalstand de energiestand van de laadpaal, als Home Assistant die kent idem
  • Vermogen (nodig): kies één sensor bij Netto vermogen, positief bij afname en negatief bij teruglevering. Geeft jullie meter het vermogen in twee sensoren, kies dan Vermogen afname én Vermogen teruglevering en laat Netto vermogen leeg.
  • Meterstanden en tarief (optioneel): tarief 1 en tarief 2 horen bij elkaar: kies ze allebei of geen van beide. Geeft jullie meter de standen per tarief én een totaal, dan mag je ze allemaal kiezen; Thuisbord gebruikt dan de standen per tarief. Is een van de twee even onbekend, dan gaan tarief 1 en 2 allebei niet mee; het totaal gaat dan wel mee, als je dat koos. Leveren jullie nooit terug, laat de terugleveringsvelden dan leeg.
  • Zonnepanelen en gas (optioneel): hebben jullie zonnepanelen met een eigen sensor, kies die dan bij Zonnestroom nu en Zonnestroom totaal. Zonder zonnestroom toont het scherm alleen wat er van en naar het net gaat.
  • Thuisbatterij (optioneel): kies bij Laadniveau de sensor met de laadtoestand van de batterij, in %, en bij Batterijvermogen de sensor met haar vermogen, in W of kW. Thuisbord rekent met positief bij laden. In het Energiedashboard van Home Assistant is een batterijvermogen standaard positief bij ontladen; zo leest de integratie hem ook, en ze draait het teken om. Daarom staat bij Batterijvermogen is positief bij standaard Ontladen, zoals in het Energiedashboard. Is jullie sensor positief als de batterij laadt, kies dan Laden; kijk dat één keer na terwijl de batterij laadt. Grens laadniveau is de grens die in de batterij is ingesteld, meestal de reserve die ze vasthoudt, in %: een sensor of een getal-entiteit, vaak van de integratie van jullie batterij. Capaciteit is de bruikbare capaciteit in kWh, zoals in de gegevens van jullie batterij; die vul je zelf in. Grens laadniveau en Capaciteit mogen leeg blijven, en de capaciteit gaat alleen mee met een van de andere waarden van de batterij. De batterij kan sinds versie 0.2.0 van de integratie; zie je dit onderdeel niet, werk de integratie dan bij via HACS.
  • Watermeter (optioneel): kies bij Watermeterstand het totaal van jullie watermeter en bij Waterdoorstroming hoeveel water er nu stroomt. Een van de twee mag leeg blijven. Thuisbord laat zien hoeveel water er nu stroomt en hoeveel liter jullie vandaag gebruikten, en zet er geen prijs op. Een watermeterlezer op batterijen, zoals die van HomeWizard in batterijstand, geeft zijn gegevens maar een paar keer per dag door; dan volgen de doorstroming en de watercurve die momenten en zijn ze niet live. Een lezer op netstroom is wel live. Laat bij een lezer op batterijen Waterdoorstroming leeg, dan toont Thuisbord de liters uit de meterstand en nooit een doorstroming van uren geleden. De watermeter kan sinds versie 0.3.0 van de integratie; zie je dit onderdeel niet, werk de integratie dan bij via HACS.
  • Laadpaal (optioneel): kies bij Laadvermogen de sensor met het vermogen waarmee de auto nu laadt, in W of kW, en bij Laadpaalstand de sensor met de totale geladen energie van de laadpaal, in Wh, kWh of MWh. Een van de twee mag leeg blijven. Het laadvermogen zit al in het vermogen van de slimme meter: Thuisbord telt het niet dubbel. Een negatief laadvermogen gaat niet mee. Thuisbord laat de laadpaal zien en bedient hem nooit, en toont geen laadniveau van de auto. De laadpaal kan sinds versie 0.4.0 van de integratie; zie je dit onderdeel niet, werk de integratie dan bij via HACS.

De integratie rekent de eenheden zelf om: W en kW, Wh, kWh en MWh, en voor gas m³ of liter. Het laadniveau en de grens van de batterij zijn in %. Kies Submit.

Vanaf nu kijkt de integratie elke 10 seconden naar jullie sensoren. Heeft jullie meter iets nieuws gemeld, dan stuurt ze een meting. Meldt jullie meter elke seconde iets? Geen probleem: er gaat hooguit één meting per 10 seconden naar Thuisbord.

Wil je later andere sensoren kiezen? Open Settings › Devices & services › Thuisbord en kies Configure. Je ziet dan weer dezelfde keuzes.

Zelf een automatisering maken

Kies je Ik maak zelf een automatisering met de actie, dan leest de integratie zelf geen sensoren. Je stuurt de metingen dan met de actie Thuisbord: Meting sturen in een eigen automatisering, bijvoorbeeld een die afgaat als jullie vermogenssensor verandert.

  • Kies bij Thuisbord-koppeling jullie huishouden.
  • Alleen Vermogen is nodig, in watt: positief bij afname, negatief bij teruglevering.
  • De meterstanden in kWh, het actieve tarief, de zonnestroom en de gasmeterstand in m³ zijn optioneel. Ook hier gaan tarief 1 en tarief 2 samen.
  • Een thuisbatterij stuur je mee onder Thuisbatterij: Batterijvermogen in watt, positief bij laden en negatief bij ontladen, Laadniveau en Grens laadniveau in %, en Capaciteit in kWh. Ze zijn allemaal optioneel. Geeft jullie sensor het batterijvermogen andersom, draai het teken dan om in de automatisering.
  • Een watermeter stuur je mee onder Watermeter: Watermeterstand in m³ en Waterdoorstroming in liter per minuut, van 0 tot 100. Ze zijn allebei optioneel.
  • Een laadpaal stuur je mee onder Laadpaal: Laadvermogen in watt, van 0 tot 60000, en Laadpaalstand in kWh. Ze zijn allebei optioneel.
  • Een meting binnen 10 seconden na de vorige slaat de integratie over.

In YAML ziet de actie er bijvoorbeeld zo uit. Vervang sensor.p1_meter_power door jullie eigen vermogenssensor. Kies je Thuisbord-koppeling in de editor, dan vult Home Assistant config_entry_id zelf in.

yaml
action: thuisbord.send_reading
data:
  config_entry_id: <jullie Thuisbord-koppeling>
  active_power_w: "{{ states('sensor.p1_meter_power') }}"

Geeft jullie meter niet alles?

Dat is niet erg. Thuisbord vult aan wat ontbreekt:

  • Geen meterstanden per tarief? Dan gebruikt Thuisbord het totaal.
  • Helemaal geen meterstanden? Dan rekent Thuisbord het verbruik uit het vermogen. De schermen zetten er dan Ongeveer bij; lees Ongeveer en verouderd.
  • Geen actief tarief? Dan gebruikt Thuisbord de daluren die in de Thuisbord-app staan, bij Instellingen › Contract en tarief › Wanneer geldt het daltarief?. Lees Contract en tarief.

Werkt het?

Tik in de Thuisbord-app op Verder. Je ziet Wachten op de eerste meting… tot Home Assistant de eerste meting stuurt. Daarna toont de app Eerste meting binnen, met Via Home Assistant om en de tijd. Ben je Thuisbord net aan het instellen, dan hoef je daar niet op te wachten: met Ga alvast verder ga je door, en de meting komt later vanzelf binnen.

Later zie je de koppeling terug bij Instellingen › Meterkoppeling: Verbonden via Home Assistant, met de tijd van de laatste meting en wie wanneer toestemming gaf. Op het scherm aan de muur staat rechtsboven Live via Home Assistant.

In Home Assistant open je Settings › Devices & services › Thuisbord. De dienst Thuisbord heeft onder Diagnostic twee sensoren:

  • Status: wat de integratie doet. Werkt alles, dan staat er Stuurt meterstanden.
  • Laatste meting verstuurd: wanneer Thuisbord voor het laatst metingen aannam, op de minuut.

Kan de integratie een gekozen sensor 5 minuten lang niet gebruiken, dan meldt Home Assistant dat bij Settings › System › Repairs: Thuisbord: sensor bestaat niet meer, Thuisbord: eenheid niet herkend, Thuisbord: waarde kan niet kloppen of Thuisbord: tarief niet herkend. Die waarde gaat dan niet mee; gaat het om het vermogen, dan gaat er helemaal geen meting naar Thuisbord. Kies een andere sensor met Configure.

Tip

Thuisbord kan ook in een dashboard van Home Assistant staan, bijvoorbeeld op een tablet aan de muur. Lees Thuisbord tonen in Home Assistant.

Wat de status betekent

Open je de sensor Status, dan zie je bij Attributes ook de Code: de reden als er iets mis is.

Status Wat het betekent Wat je doet
Wacht op een meting Er is nog geen meting verstuurd, bijvoorbeeld net na een herstart. Staat bij Code no_new_reading, dan kwam er 2 minuten lang geen nieuwe meting: jullie vermogenssensor geeft geen waarde of niets nieuws, of jullie automatisering roept de actie niet aan. Even wachten. Bij no_new_reading: kijk in Home Assistant of jullie vermogenssensor nog waarden geeft, of, met de actie, of jullie automatisering nog loopt. Bij Laatste meting verstuurd zie je wanneer Thuisbord voor het laatst metingen aannam. Met de volgende meting staat er weer Stuurt meterstanden.
Stuurt meterstanden Thuisbord neemt de metingen aan. Niets.
Probeert het opnieuw Thuisbord nam de metingen nog niet aan. Bij Code offline is Thuisbord of jullie internet even weg, bij server_error heeft Thuisbord even een storing en bij rate_limited vraagt Thuisbord om te wachten. Bij unexpected_response gaf Thuisbord een antwoord dat deze versie van de integratie niet kent. Bij offline, server_error en rate_limited niets: Home Assistant bewaart de metingen in zijn geheugen, één per minuut en hooguit 24 uur, en stuurt ze later. Het scherm toont de laatste meting zolang als verouderd. Bij unexpected_response: werk de integratie bij via HACS.
Meting geweigerd Thuisbord nam een meting niet aan (code 422). Bij Code fields gaf een sensor een waarde die niet kan kloppen; bij clock loopt de klok van Home Assistant niet gelijk. Controleer de gekozen sensoren met Configure, of de datum en tijd van Home Assistant. Home Assistant blijft gewoon sturen.
Gestopt, nieuwe sleutel nodig Thuisbord weigert de koppelsleutel. Code zegt waarom; zie hieronder. Plak de juiste sleutel waar Home Assistant erom vraagt.

Bij Gestopt, nieuwe sleutel nodig stuurt Home Assistant niets meer en vraagt het zelf om de sleutel: bij Settings › Devices & services staat dat Thuisbord aandacht nodig heeft. Open dat en plak de sleutel in het venster Nieuwe koppelsleutel nodig. Dat venster zegt ook meteen wat er mis was. Metingen van de tijd dat de sleutel niet werkte, stuurt Home Assistant ook later niet meer.

Code Wat het betekent Wat je doet
unauthenticated (401) Thuisbord kent de sleutel niet. Plak de sleutel opnieuw. Heb je hem niet meer, maak dan in de app een nieuwe.
key_revoked (403) Deze sleutel werkt niet meer: in de app is een nieuwe sleutel gemaakt, of de meter is losgekoppeld. Plak de nieuwe sleutel. Is de meter losgekoppeld, koppel hem dan opnieuw in de app en plak de sleutel die je dan krijgt.
consent_not_recorded (403) De sleutel klopt, maar jullie huishouden heeft geen toestemming gegeven om metergegevens te delen. Tik in de app bij Instellingen › Meterkoppeling op Meter koppelen, kies Home Assistant en tik op Ik ga akkoord. Zie je Er is al een koppelsleutel, tik dan op Huidige sleutel houden. Plak daarna de sleutel opnieuw in Home Assistant.
token_not_allowed (403) Er staat een andere sleutel in Home Assistant dan de koppelsleutel. Plak de koppelsleutel uit de Thuisbord-app. Heb je hem niet meer, maak dan een nieuwe.

Nieuwe sleutel

De koppelsleutel verloopt niet: hij werkt tot de eigenaar een nieuwe maakt of de meter loskoppelt. Ben je hem kwijt, of denk je dat iemand anders hem heeft? Dan maakt de eigenaar in de app bij Instellingen › Meterkoppeling een nieuwe, met Nieuwe sleutel maken. Ook die sleutel zie je maar één keer: kopieer hem. De oude werkt meteen niet meer. Jullie toestemming blijft gelden.

Bij de volgende meting weigert Thuisbord de oude sleutel, en vraagt Home Assistant zelf om de nieuwe: plak hem in het venster Nieuwe koppelsleutel nodig, zoals hierboven staat. Je kunt de nieuwe sleutel ook meteen zelf plakken: open Settings › Devices & services › Thuisbord, kies bij de koppeling ⋮ › Reconfigure, plak de sleutel in het venster Koppelsleutel wijzigen en kies Submit.

Lees ook De koppelsleutel vernieuwen.

Stoppen

  • Even stoppen: open Settings › Devices & services › Thuisbord en kies bij de koppeling ⋮ › Disable. Met ⋮ › Enable zet je hem later weer aan.
  • Helemaal stoppen: de eigenaar tikt in de Thuisbord-app bij Instellingen › Meterkoppeling op Loskoppelen. Thuisbord ontvangt dan geen metingen meer, de koppelsleutel werkt niet meer en jullie toestemming vervalt. Verwijder daarna in Home Assistant de koppeling met ⋮ › Delete; anders blijft Home Assistant om een nieuwe sleutel vragen. Verwijder Thuisbord als je wilt ook uit HACS. Koppelen jullie later opnieuw, dan vraagt de app opnieuw jullie toestemming en krijg je een nieuwe sleutel.

Terug naar de hulp