Meter and power price

Connecting the meter with Home Assistant

Connect your smart meter through Home Assistant: your consent, the connection key, the Thuisbord integration from HACS and your sensors.

Good to know

The Thuisbord integration for Home Assistant is not in the HACS default list yet. So you add it to HACS yourself, as described below.

With this connection, your Home Assistant sends your smart meter's values to Thuisbord, so every screen at home can show them live. The Thuisbord integration reads only the sensors you choose. Thuisbord gets no access to Home Assistant and never controls a device.

What you need

  • Home Assistant 2026.3 or newer, with your smart meter already in it, for example through the DSMR or HomeWizard integration.
  • HACS, the Home Assistant Community Store, already installed in Home Assistant. How to install HACS is in the HACS documentation.
  • The Thuisbord app on your phone, as the owner of the household. Only the owner can connect the meter; other adults see in the app that the owner does this.

The texts of the Thuisbord integration itself follow your Home Assistant's language; they are given in English below. If your Home Assistant is in Dutch, you find them in the Dutch version of this page.

What Thuisbord receives

  • The time of each reading
  • Power: how much electricity you use or send back right now
  • The meter totals for power from and to the grid, when your meter gives them
  • Which tariff applies now: normal or low, when your meter reports it
  • Solar production: the power now and the total, when Home Assistant knows it
  • The gas total, when your meter measures gas
  • A home battery: its power while it charges or discharges and its charge level, and its charge level limit and capacity, when Home Assistant knows them
  • A water meter: its total and how much water is flowing right now, when Home Assistant knows them
  • A car charger: the power the car is charging with right now and the charger’s energy total, when Home Assistant knows them

Only power is needed. Home Assistant sends at most one reading every 10 seconds, with only the values of the sensors you choose. Thuisbord shows the home battery and never controls it. Of the water meter, Thuisbord only sees how much water flows; it puts no price on it. Thuisbord shows the car charger and never controls it. The charging power is already part of your smart meter’s power: Thuisbord does not count it twice. There is more about this in What Thuisbord receives.

You see the connection key only once. If you want to paste it into Home Assistant straight away, install the integration first, as described in step 2, and then start here.

  1. Choose Home Assistant. In the Thuisbord app, open Settings › Meter connection › Connect meter and choose Home Assistant. If you are just setting up Thuisbord, you reach Connect your meter on your own.
  2. Give consent. You see What Thuisbord receives, with exactly the values above. Tap I agree. With Not now, nothing is sent and Thuisbord makes no connection key either.
  3. Copy the connection key. Thuisbord now makes your connection key and shows it under Your connection key. Tap Copy. You only see this key now: keep this screen open until the key is in Home Assistant. If you tap Next or go to another screen in the app, you will not see it again. Do not share the key with anyone else.

Lost the key before it is in Home Assistant? Then make a new one, as described under New key below.

Do you see There's already a connection key after I agree? Then your household already has a key, and Thuisbord does not show it again. If that key is already in Home Assistant, tap Keep the current key. Otherwise tap Make a new key; the old one then stops working at once.

The phone at step 2 of 3, Connect your meter, with the choices Homey, with the Thuisbord app from the Homey App Store, and Home Assistant, with the Thuisbord connection for Home Assistant.
Connect your meter: choose Home Assistant.

2. Install the integration through HACS

  1. Open HACS in Home Assistant.

  2. At the top right, choose ⋮ › Custom repositories.

  3. Paste this address into the dialog:

    text
    https://github.com/mennovanhout/thuisbord-home-assistant
    
  4. Choose the type Integration and choose Add. Then close the dialog.

  5. Search HACS for Thuisbord, open it and choose Download.

  6. Restart Home Assistant.

3. Add Thuisbord

  1. Go to Settings › Devices & services, choose Add integration and choose Thuisbord.
  2. You see Connect Thuisbord. Paste the connection key into Connection key and choose Submit. A connection key starts with thb_.
  3. Home Assistant asks Thuisbord at once whether the key works. If something is wrong, for example because a piece of the key is missing, the dialog says so at once. Then paste the whole key again. If you no longer have it, make a new one, as described under New key below.

Leave Advanced closed: you do not need to change the Server address in it. Home Assistant keeps the key only in the integration and never writes it to its log.

Do you see Key works, no consent yet? Then Thuisbord knows the key, but your household has not agreed to share meter data. In the app, under Settings › Meter connection, tap Connect meter, choose Home Assistant and tap I agree. If you see There's already a connection key, tap Keep the current key. Then choose Submit in Home Assistant.

4. Choose your sensors

Home Assistant asks How do the readings reach Thuisbord?. Choose I choose my sensors, Thuisbord reads them itself. If you would rather make your own automation, see Make your own automation below.

Under Choose your sensors, choose your meter's sensors. Only power is needed: choose the other sensors only if your meter has them, and leave the rest empty.

Field in Home Assistant DSMR HomeWizard
Net power (leave empty) Power
Import power Power consumption (leave empty)
Export power Power production (leave empty)
Import total Energy consumption (total), if your meter has it Energy import
Import tariff 1 and 2 Energy consumption (tarif 1) and (tarif 2) Energy import tariff 1 and 2
Export total Energy production (total), if your meter has it Energy export
Export tariff 1 and 2 Energy production (tarif 1) and (tarif 2) Energy export tariff 1 and 2
Active tariff Active tariff Tariff
Gas total Gas consumption the sensor of Gas meter
Water total Water consumption, if a water meter is connected to the smart meter Total water usage, of the HomeWizard water meter
Water flow (leave empty) Water usage, of the HomeWizard water meter
Charging power the charger's power, if Home Assistant knows it same
Charger total the charger's energy total, if Home Assistant knows it same
  • Power (required): choose one sensor under Net power, positive when importing and negative when exporting. If your meter gives power as two sensors, choose Import power and Export power and leave Net power empty.
  • Meter totals and tariff (optional): tariff 1 and tariff 2 belong together: choose both or neither. If your meter gives the totals per tariff and a total, you may choose them all; Thuisbord then uses the totals per tariff. If one of the two is unknown for a moment, neither tariff 1 nor 2 is sent; the total is, if you chose it. If you never send power back, leave the export fields empty.
  • Solar and gas (optional): if your solar panels have their own sensor, choose it under Solar power and Solar total. Without solar production, the screen shows only what goes from and to the grid.
  • Home battery (optional): under Charge level, choose the sensor with the battery's state of charge, in %, and under Battery power the sensor with its power, in W or kW. Thuisbord counts positive while charging. In Home Assistant's Energy dashboard a battery's power is positive while discharging by default; that is how the integration reads it too, and it turns the sign. That is why Battery power is positive when is set to Discharging, as in the Energy dashboard by default. If your sensor is positive while the battery charges, choose Charging; check this once while the battery charges. Charge level limit is the limit set in the battery, usually the reserve it keeps, in %: a sensor or a number entity, often from your battery's integration. Capacity is the usable capacity in kWh, as your battery's specifications give it; you enter it yourself. Charge level limit and Capacity may stay empty, and the capacity only goes along with one of the battery's other values. The battery works from version 0.2.0 of the integration; if you do not see this section, update the integration in HACS.
  • Water meter (optional): under Water total, choose your water meter's total, and under Water flow how much water is flowing now. One of the two may stay empty. Thuisbord shows how much water is flowing now and how many litres you used today, and puts no price on it. A water meter reader on batteries, such as HomeWizard's in battery mode, passes its data on only a few times a day; the flow and the water curve then follow those updates and are not live. A reader on mains power is live. With a reader on batteries, leave Water flow empty, so Thuisbord shows the litres from the total and never a flow from hours ago. The water meter works from version 0.3.0 of the integration; if you do not see this section, update the integration in HACS.
  • Car charger (optional): under Charging power, choose the sensor with the power the car is charging with now, in W or kW, and under Charger total the sensor with the charger's total delivered energy, in Wh, kWh or MWh. One of the two may stay empty. The charging power is already part of your smart meter's power: Thuisbord does not count it twice. A negative charging power is left out. Thuisbord shows the charger, never controls it and shows no charge level of the car. The charger works from version 0.4.0 of the integration; if you do not see this section, update the integration in HACS.

The integration converts the units itself: W and kW, Wh, kWh and MWh, and m³ or litres for gas. The battery's charge level and limit are in %. Choose Submit.

From now on the integration looks at your sensors every 10 seconds. When your meter has reported something new, it sends a reading. Does your meter report every second? No problem: at most one reading every 10 seconds goes to Thuisbord.

Want to choose other sensors later? Open Settings › Devices & services › Thuisbord and choose Configure. You see the same choices again.

Make your own automation

If you choose I make my own automation with the action, the integration reads no sensors itself. You then send readings with the action Thuisbord: Send reading in an automation of your own, for example one that runs when your power sensor changes.

  • Under Thuisbord connection, choose your household.
  • Only Power is required, in watts: positive when importing, negative when exporting.
  • The meter totals in kWh, the active tariff, solar and the gas total in m³ are optional. Here too, tariff 1 and tariff 2 go together.
  • A home battery goes along under Home battery: Battery power in watts, positive while charging and negative while discharging, Charge level and Charge level limit in %, and Capacity in kWh. All of them are optional. If your sensor gives battery power the other way round, turn the sign in the automation.
  • A water meter goes along under Water meter: Water total in m³ and Water flow in litres a minute, from 0 to 100. Both are optional.
  • A car charger goes along under Car charger: Charging power in watts, from 0 to 60000, and Charger total in kWh. Both are optional.
  • The integration skips a reading within 10 seconds of the previous one.

In YAML the action looks like this, for example. Replace sensor.p1_meter_power with your own power sensor. If you choose Thuisbord connection in the editor, Home Assistant fills in config_entry_id itself.

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

Your meter does not give everything?

That is fine. Thuisbord fills in what is missing:

  • No totals per tariff? Then Thuisbord uses the total.
  • No totals at all? Then Thuisbord works out your use from power. The screens then show Approximately with those figures; see Approximately and stale.
  • No active tariff? Then Thuisbord uses the low-tariff hours in the Thuisbord app, under Settings › Contract and tariff › When does the low tariff apply?. See Contract and tariff.

Does it work?

In the Thuisbord app, tap Next. You see Waiting for the first reading… until Home Assistant sends the first reading. The app then shows First reading received, with Via Home Assistant at and the time. If you are just setting up Thuisbord, you do not have to wait for it: with Continue meanwhile you go on, and the reading arrives later on its own.

Later you find the connection under Settings › Meter connection: Connected via Home Assistant, with the time of the last reading and who gave consent when. The screen on the wall shows Live via Home Assistant at the top right.

In Home Assistant, open Settings › Devices & services › Thuisbord. The Thuisbord service has two sensors under Diagnostic:

  • Status: what the integration is doing. When everything works, it says Sending readings.
  • Last reading sent: when Thuisbord last took readings, to the minute.

If the integration cannot use a sensor you chose for 5 minutes, Home Assistant says so under Settings › System › Repairs: Thuisbord: sensor no longer exists, Thuisbord: unit not understood, Thuisbord: impossible value or Thuisbord: tariff not understood. That value is then left out; if it is power, no reading goes to Thuisbord at all. Choose another sensor with Configure.

Tip

Thuisbord can also appear in a Home Assistant dashboard, for example on a tablet on the wall. See Show Thuisbord in Home Assistant.

What the status means

When you open the Status sensor, you also see the Code under Attributes: the reason when something is wrong.

Status What it means What to do
Waiting for a reading No reading has been sent yet, for example just after a restart. With Code no_new_reading, no new reading came for 2 minutes: your power sensor gives no value or nothing new, or your automation does not call the action. Wait a moment. With no_new_reading: check in Home Assistant that your power sensor still reports values or, with the action, that your automation still runs. Last reading sent shows when Thuisbord last took readings. With the next reading it says Sending readings again.
Sending readings Thuisbord takes the readings. Nothing.
Trying again Thuisbord has not taken the readings yet. With Code offline, Thuisbord or your internet is briefly away; with server_error, Thuisbord has a brief fault; with rate_limited, Thuisbord asks to wait. With unexpected_response, Thuisbord gave an answer this version of the integration does not know. With offline, server_error and rate_limited, nothing: Home Assistant keeps the readings in its memory, one per minute for up to 24 hours, and sends them later. Meanwhile the screen shows the last reading as stale. With unexpected_response: update the integration in HACS.
Reading refused Thuisbord did not take a reading (code 422). With Code fields, a sensor reported a value that cannot be right; with clock, Home Assistant's clock is off. Check the sensors you chose with Configure, or Home Assistant's date and time. Home Assistant keeps sending.
Stopped, new key needed Thuisbord refuses the connection key. Code says why; see below. Paste the right key where Home Assistant asks for it.

With Stopped, new key needed, Home Assistant sends nothing more and asks for the key itself: Settings › Devices & services shows that Thuisbord needs attention. Open it and paste the key into the New connection key needed dialog. That dialog also says at once what was wrong. Readings from the time the key did not work are not sent later.

Code What it means What to do
unauthenticated (401) Thuisbord does not know the key. Paste the key again. If you no longer have it, make a new one in the app.
key_revoked (403) This key no longer works: a new key was made in the app, or the meter was disconnected. Paste the new key. If the meter was disconnected, connect it again in the app and paste the key you then get.
consent_not_recorded (403) The key is right, but your household has not agreed to share meter data. In the app, under Settings › Meter connection, tap Connect meter, choose Home Assistant and tap I agree. If you see There's already a connection key, tap Keep the current key. Then paste the key into Home Assistant again.
token_not_allowed (403) Home Assistant holds another key than the connection key. Paste the connection key from the Thuisbord app. If you no longer have it, make a new one.

New key

The connection key does not expire: it works until the owner makes a new one or disconnects the meter. Lost it, or think someone else has it? Then the owner makes a new one in the app under Settings › Meter connection, with Make a new key. You also see that key only once: copy it. The old one stops working at once. Your consent stays in place.

With the next reading, Thuisbord refuses the old key and Home Assistant asks for the new one itself: paste it into the New connection key needed dialog, as described above. You can also paste the new key yourself straight away: open Settings › Devices & services › Thuisbord, choose ⋮ › Reconfigure for the entry, paste the key into the Change the connection key dialog and choose Submit.

See also Renewing the connection key.

Stop sending

  • Pause: open Settings › Devices & services › Thuisbord and choose ⋮ › Disable for the entry. With ⋮ › Enable you turn it back on later.
  • Stop for good: the owner taps Disconnect in the Thuisbord app under Settings › Meter connection. Thuisbord then receives no more readings, the connection key stops working and your consent is withdrawn. Then delete the entry in Home Assistant with ⋮ › Delete; otherwise Home Assistant keeps asking for a new key. Remove Thuisbord from HACS too, if you like. If you connect again later, the app asks for your consent again and you get a new key.

Back to help