Meter and power price
Connecting the meter with Homey
Connect your smart meter through Homey Pro: your consent, the connection key, the Thuisbord app for Homey and the Flow with the Thuisbord cards.
Good to know
The Thuisbord app for Homey is not in the Homey App Store yet: it is still in testing. So install the test version, as described in step 4.
With this connection, your Homey sends your smart meter's values to Thuisbord, so every screen at home can show them live. Thuisbord gets no access to Homey and never controls a device.
What you need
- A Homey Pro with your smart meter (P1) already in it as a device.
- 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.
Good to know
You paste the connection key into the settings of the Thuisbord app on Homey. On Homey Cloud, apps may not have such a settings page, so this connection only works on Homey Pro.
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 Homey 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 Homey knows them
- A water meter: its total and how much water is flowing right now, when Homey knows them
- A car charger: the power the car is charging with right now and the charger’s energy total, when Homey knows them
Only power is needed. Homey sends at most one reading every 10 seconds. 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 the P1 meter’s power: Thuisbord does not count it twice. There is more about this in What Thuisbord receives.
How to connect Homey
-
Choose Homey. In the Thuisbord app, open Settings › Meter connection › Connect meter and choose Homey. If you are just setting up Thuisbord, you reach Connect your meter on your own.
-
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.
-
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 Homey. 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.
-
Install the test version of the Thuisbord app. Open this address in your browser, choose Install App and install the app on your Homey Pro:
https://homey.app/en-nl/app/app.thuisbord/Thuisbord/test/ -
Paste the key. In Homey, open the settings of the Thuisbord app, paste the connection key and tap Save key. A connection key starts with
thb_. If the key does not have the right shape, for example because a piece is missing, you see that at once. Once the key is saved, it says Waiting for the first reading. -
Create a Flow in the Homey app, with the Thuisbord cards. In the example below you see the cards as Homey shows them.
- Under When: your P1 meter's card that fires when its power changes.
- Under Then, at the top: Send power to Thuisbord. In the Power field, tap the tag symbol and choose your P1 meter's power. Under Power unit, choose W or kW: the unit your meter gives power in. Usually that is W; if the tag shows something like 0.7 instead of 700, choose kW.
- Below it, if your meter gives them: Send meter totals per tariff to Thuisbord or Send combined meter totals to Thuisbord, and Send gas total to Thuisbord. Fill in their fields with the tags of the same P1 meter.
- If you have a home battery, also put Send home battery to Thuisbord in this Flow, below the power card, with the battery's tags, as described below under Home battery.
- If your water meter is in Homey, also put Send water meter to Thuisbord in this Flow, below the power card, as described below under Water meter.
- If your car charger is in Homey, also put Send car charger to Thuisbord in this Flow, below the power card, as described below under Car charger.
- If you have solar panels, create a second Flow with Send solar production to Thuisbord, as described below under Solar panels.
-
Turn the Flow on. If you also created a Flow for the solar panels, turn that one on too.
-
Wait for the first reading. In the Thuisbord app, tap Next. You see Waiting for the first reading… until Homey sends the first reading.
Lost the key before it is in Homey? 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 Homey, tap Keep the current key. Otherwise tap Make a new key; the old one then stops working at once.


Example with two Flows
One Flow for the meter, and one for the solar panels if you have them. The pictures show the cards as Homey shows them.
Flow 1: the meter. Under When: your P1 meter's card that fires when its power changes. What that card is called differs per P1 app. Under Then, in this order:
-
Send power to Thuisbord: the power right now. This is the card that sends the reading. Under Power, choose the tag with the P1 meter's power, and under Power unit W.

Fill in Power, or both Power import and Power export. Power unit may stay empty; then it is W. -
Send meter totals per tariff to Thuisbord: the meter totals in kWh. With them, Thuisbord works out exactly what you use and send back in a day. Choose the P1 meter's four meter totals, and under Active tariff the tariff if the meter gives it.

All four meter totals are needed. Active tariff may stay empty. Does your meter give no totals per tariff? Then use Send combined meter totals to Thuisbord, with both tariffs together.

Import total and Export total are both needed. -
Send gas total to Thuisbord: the P1 meter's gas total, in m³.

One field: Gas total, in m³. -
Send home battery to Thuisbord, if you have a home battery: its charge level and power, with the battery's tags. How to fill in that card is under Home battery.
Flow 2: the solar panels. Under When: your inverter's card that fires when its solar power changes. Under Then: Send solar production to Thuisbord, with the inverter's solar power. How to fill in that card is under Solar panels.
The cards
| Card | Fill in | When |
|---|---|---|
| Send power to Thuisbord | Power: the power right now (in W, or choose kW under Power unit), negative when you send power back. Or leave Power empty and fill in both Power import and Power export | always: this card makes the reading |
| Send meter totals per tariff to Thuisbord | Import tariff 1 and 2 and Export tariff 1 and 2 (in kWh), all four; Active tariff (1 or 2) may stay empty | if your meter gives totals per tariff |
| Send combined meter totals to Thuisbord | Import total and Export total (in kWh), both tariffs together, both | if your meter gives no totals per tariff |
| Send solar production to Thuisbord | Solar power: what your solar panels produce right now (in W, or choose kW under Solar power unit); Solar total (in kWh) may stay empty | if Homey knows what your solar panels produce |
| Send gas total to Thuisbord | Gas total (in m³) | if your smart meter measures gas |
| Send home battery to Thuisbord | Charge level (in %) and Battery power (in W, or choose kW under Battery power unit); Positive means (charging or discharging), Charge level limit (in %) and Capacity (in kWh) may stay empty | if Homey knows your home battery |
| Send water meter to Thuisbord | Water total (in m³) and Water flow (in L/min); one of the two may stay empty | if your water meter is in Homey |
| Send car charger to Thuisbord | Charging power (in W) and Charger total (in kWh); one of the two may stay empty | if your car charger is in Homey |
Only Send power to Thuisbord makes a reading, at most one every 10 seconds. The other cards send nothing themselves: the Thuisbord app on Homey remembers their latest values and adds them to the next readings, while they are fresh. Meter totals go along while they are at most 5 minutes old, solar panels, the home battery, the water meter and the car charger 20 minutes and the gas total 2 hours. That is why the order of the cards does not matter; at the top is simply the clearest.
If you fill in Power import and Power export, the Thuisbord app on Homey turns them into one power value. Only that one number goes to Thuisbord.
If you use both the card with totals per tariff and the one with combined totals, both go along; Thuisbord then uses the totals per tariff.
Does your meter report every second? No problem: the Thuisbord app on Homey passes on at most one reading every 10 seconds.
Your meter does not give everything?
That is fine. Thuisbord fills in what is missing:
- No totals per tariff? Then use Send combined meter totals to Thuisbord. 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? Leave Active tariff empty. 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.
Why separate cards?
Each card stands on its own. If a tag on a card has no value, for example because your inverter is offline, only that card fails, and the Flow says which field. As long as Send power to Thuisbord runs, the readings go on as usual, without the values that are missing. So put on each card only tags of the device that card is about: on the power card and the meter totals, only tags of the P1 meter.
Solar panels
A smart meter only measures what goes in and out of the grid through your connection. If Homey also knows what your solar panels produce, the screen shows the sun, the home and the grid separately. Without that value the app says Homey does not send solar production. The screen then shows only what goes from and to the grid.
Solar power comes from another device than the meter, for example your inverter, and that device is sometimes offline. So use the card Send solar production to Thuisbord for it, in one of these two ways.
In a Flow of its own (the safest). Create a second Flow:
-
Under When: your inverter's card that fires when its solar power changes.
-
Under Then: Send solar production to Thuisbord, for what your solar panels produce right now. Under Solar power, choose the inverter's tag, and under Solar power unit W or kW, as that tag gives it.

Solar power is needed. Solar power unit and Solar total may stay empty. -
If the inverter also gives its total production, fill in Solar total. Otherwise leave it empty; Thuisbord then works out the production from solar power.
-
Turn the Flow on.
Whatever happens to the inverter, the P1 meter's Flow does not notice. At night solar power does not change, so this Flow does not run. After 20 minutes Solar panels then shows out of date in the settings of the Thuisbord app on Homey, and solar power no longer goes along. The screen then shows the sun with the last known value, as Sun, about. That is fine: as soon as the sun comes up, solar power goes along again.
In the P1 meter's Flow. Put Send solar production to Thuisbord under Then, below Send power to Thuisbord, and fill it in as above. Then 0 W goes along at night. If the inverter is offline, only the solar card fails and the power card goes on as usual. If you want to be quite sure of that, choose a Flow of its own.
Do you use Advanced Flow? Then connect each Thuisbord card straight to the card under When, and never put Send power to Thuisbord behind Send solar production to Thuisbord: a card that fails does not go on to the card behind it.
Home battery
Thuisbord shows your home battery on the screen: whether it charges or discharges, with how much power, and how full it is. Thuisbord never controls the battery: it does not charge or discharge it and changes none of its settings.
Use the card Send home battery to Thuisbord. Put it in the P1 meter's Flow, under Then, below Send power to Thuisbord:
- Under Charge level, choose the battery's tag with its charge level, in %.
- Under Battery power, choose the tag with the battery's power, and under Battery power unit W or kW, as that tag gives it. Battery power unit may stay empty; then it is W.
- Homey gives a home battery's power as positive while it charges and negative while it discharges. Some battery apps give it the other way round. Check it once: while the battery charges, the tag should show a positive number. If it shows a negative one, choose discharging under Positive means. Positive means may stay empty; then it is charging.
- If Homey knows them, fill in Charge level limit, the limit set in the battery, usually the reserve it keeps, in %, and Capacity, its usable capacity in kWh. You may also type the capacity as a number. Both may stay empty. If one of them has a wrong value, only that one is left out: the Flow names the field, and the battery's other values still go along.
Why in the P1 meter's Flow? A battery that is idle, for example full in the afternoon or at its reserve at night, does not change, so a Flow started by the battery's own card does not run. The P1 meter's Flow keeps running, and then the battery card passes on the battery's values with every reading. In a Flow of its own, the battery no longer goes along after 20 minutes without a change, and the settings of the Thuisbord app on Homey say Home battery: out of date, not sent until it changes again.
If the battery is offline, only the battery card fails and the readings go on as usual; after 20 minutes the battery no longer goes along. In Advanced Flow, connect Send home battery to Thuisbord straight to the card under When, like the other cards.
Water meter
Thuisbord shows your water meter on the screen: how much water is flowing right now, in litres a minute, and how many litres you used today. Thuisbord puts no price on water and controls nothing.
Use the card Send water meter to Thuisbord. Put it in the P1 meter's Flow, under Then, below Send power to Thuisbord:
- Under Water total, choose the water meter's tag with its total, in m³.
- Under Water flow, choose the tag with how much water is flowing now, in L/min.
- If your water meter gives only one of the two, leave the other empty. If one of them has a wrong value, only that one is left out: the Flow names the field, and the other value still goes along.
Why in the P1 meter's Flow? While no water flows, the water meter does not change, so a Flow that starts with the water meter's own card does not run. The P1 meter's Flow keeps running, and then the water meter goes along with every reading. In a Flow of its own, the water meter no longer goes along after 20 minutes without a change, and the settings of the Thuisbord app on Homey show Water meter: out of date, not sent until water flows again.
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 on the screen 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.
If the water meter is offline, only the water card fails and the readings go on as usual; after 20 minutes the water meter no longer goes along. In Advanced Flow, connect Send water meter to Thuisbord straight to the card under When, like the other cards.
Car charger
Thuisbord shows your car charger on the screen: how much power the car is getting right now and, on the day card, how many kWh were charged today and what that cost. The charger sits behind the meter, so its power is already part of the P1 meter’s power: Thuisbord does not count it twice and shows the rest as the home’s use. Thuisbord never controls the charger and shows no charge level of the car.
Use the card Send car charger to Thuisbord. Put it in the P1 meter's Flow, under Then, below Send power to Thuisbord:
- Under Charging power, choose the charger's tag with the power the car is charging with now, in W. While the charger stands still, that is 0.
- Under Charger total, choose the tag with the total energy the charger has delivered, in kWh.
- If your charger gives only one of the two, leave the other empty. If one of them has a wrong value, only that one is left out: the Flow names the field, and the other value still goes along. A negative charging power counts as wrong too: it never goes along.
Why in the P1 meter's Flow? While the charger stands still, it does not change, so a Flow that starts with the charger's own card does not run. The P1 meter's Flow keeps running, and then the charger goes along with every reading. In a Flow of its own, the charger no longer goes along after 20 minutes without a change, and the settings of the Thuisbord app on Homey show Car charger: out of date, not sent until it changes again.
If the charger is offline, only the charger card fails and the readings go on as usual; after 20 minutes the charger no longer goes along. In Advanced Flow, connect Send car charger to Thuisbord straight to the card under When, like the other cards.
Does it work?
As soon as Homey sends the first reading, the Thuisbord app shows First reading received, with Via Homey 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 Homey, with the time of the last reading and who gave consent when. The screen on the wall shows Live via Homey at the top right. At the top of the settings of the Thuisbord app on Homey it says Waiting for the first reading until Send power to Thuisbord runs for the first time, and then Connected, with the time of the last reading.
Below that, under Values from the Flow, the other seven cards show how old their values are: Meter totals per tariff, Combined meter totals, Solar panels, Gas total, Home battery, Water meter and Car charger. For example Solar panels: updated 3 minutes ago. If it says Solar panels: out of date, not sent, that card has not run for longer than its values may go along: check that the Flow is on and that the device of its tags is online. Solar panels: not received yet means the card has not run since the key was saved. If your Flow does not use a card, its line stays at not received yet; that is fine.
Nothing arrives? Then open the settings of the Thuisbord app in Homey. They say what is wrong. If a Thuisbord card fails, the Flow itself says which field.
Readings stopped arriving while the Flow runs? Check that your P1 meter is online in Homey: without power, Send power to Thuisbord makes no reading. In the settings of the Thuisbord app on Homey, the time of the last reading then stops moving on.

Messages in the Flow
| You see | What it means | What to do |
|---|---|---|
| The field … on the Thuisbord card has no value | The field is empty, or its tag has no value right now, for example because the device is offline. Only this card fails. | Choose a tag for the field, or check that the device of that tag is online. |
| The field … on the Thuisbord card is not a number | The tag gives something other than a number. | Choose the right tag. |
| The field … on the Thuisbord card has a value Thuisbord does not accept | For example a total in Wh where kWh belongs, or 850 W with kW chosen: that is 850 kW. | Choose the right tag, and for a power check Power unit, Solar power unit or Battery power unit. |
| The field … on the Thuisbord card has a value Thuisbord does not accept and is left out | Charge level limit or Capacity on Send home battery to Thuisbord, or Water total or Water flow on Send water meter to Thuisbord, has a wrong value, for example a capacity in Wh where kWh belongs, or a total in litres where m³ belongs. The same goes for Charging power or Charger total on Send car charger to Thuisbord, for example a negative charging power or a total in Wh where kWh belongs. Only that value is left out; that card's other values still go along. | Choose the right tag, or leave the field empty. |
| On the Thuisbord card, fill in Charging power or Charger total, or both | Send car charger to Thuisbord has no value at all, for example because the charger is offline. Only this card fails. | Choose a tag for at least one of the two fields, or check that the charger is online. |
| On the Thuisbord card, fill in Water total or Water flow, or both | Send water meter to Thuisbord has no value at all, for example because the water meter is offline. Only this card fails. | Choose a tag for at least one of the two fields, or check that the water meter is online. |
| On the Thuisbord card, fill in Power, or both Power import and Power export | Send power to Thuisbord has no power. No reading goes. | Fill in Power, or both Power import and Power export. |
Messages in the Thuisbord app on Homey
| You see | What it means | What to do |
|---|---|---|
| Unknown key (code 401) | Thuisbord does not know the pasted key. | Paste the key again. If you no longer have it, make a new one in the app. |
Key renewed (code 403 key_revoked) |
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. |
No consent yet (code 403 consent_not_recorded) |
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 Homey and tap I agree. If you see There's already a connection key, tap Keep the current key. Then tap Try again in the settings of the Thuisbord app on Homey. |
Not a connection key (code 403 token_not_allowed) |
Another key is in the settings. | Paste the connection key from the Thuisbord app. If you no longer have it, make a new one. |
| Key refused (code 403) | Thuisbord refuses this key. | Make a new one in the app, with Make a new key, and paste it. |
| Wrong value (code 422) | A field on a Thuisbord card has the wrong tag. | Check the fields it names on the Thuisbord cards. |
| Wrong time (code 422) | Homey's clock is off. | Check Homey's date and time. |
| Thuisbord cannot be reached, Thuisbord has a problem or Waiting a moment | Thuisbord or your internet is briefly away, or Thuisbord asks the app to wait a moment. | Nothing: the app keeps the readings for a while and sends them later. |
| Power seems to be in kW | Power unit says W, but power seems to be in kW, for example 0.7 instead of 700. The app still sends the readings. | Open the Flow and on Send power to Thuisbord choose kW under Power unit. |
| Solar power seems to be in kW | Solar power unit says W, but solar power seems to be in kW, for example 2.4 instead of 2400. | Open the Flow and on Send solar production to Thuisbord choose kW under Solar power unit. |
| Battery power seems to be in kW | Battery power unit says W, but battery power seems to be in kW, for example 1.5 instead of 1500. | Open the Flow and on Send home battery to Thuisbord choose kW under Battery power unit. |
| Solar panels: out of date, not sent | That card has not run for longer than its values may go along. The readings go on, without those values. | Check that the Flow is on and that the device of the tags on that card is online. For solar panels in a Flow of their own, this is normal at night. |
| Solar panels: not received yet | That card has not run since the key was saved. | Nothing, if your Flow does not use that card. Otherwise: check that the Flow is on. |
With Unknown key, Key renewed, No consent yet, Not a connection key and Key refused the app stops sending until you save a key or tap Try again. If Thuisbord still refuses the key, the same message comes back.
From the old card to the new ones
Since version 2.0.0 the Thuisbord app on Homey has five cards instead of one. The old card Send meter reading to Thuisbord has been replaced: a Flow with that card no longer works after the update. Create your Flow again with the new cards, as in step 6 and the example above. Your key stays where it is.
Version 2.1.0 adds a sixth card, Send home battery to Thuisbord. Your Flows keep working; add the card to the P1 meter's Flow if you have a home battery, as described under Home battery.
Version 2.2.0 adds a seventh card, Send water meter to Thuisbord. Your Flows keep working; add the card to the P1 meter's Flow if your water meter is in Homey, as described under Water meter.
Version 2.3.0 adds an eighth card, Send car charger to Thuisbord. Your Flows keep working; add the card to the P1 meter's Flow if your car charger is in Homey, as described under Car charger.
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 and paste it into the settings of the Thuisbord app on Homey. The old one stops working at once. Your consent stays in place. See also Renewing the connection key.
When you save or remove a key, the Thuisbord app on Homey forgets the values it remembered from the cards. The cards pass them on again the next time they run.
Stop sending
- Pause: turn the Flow off, or tap Remove key in the settings of the Thuisbord app on Homey.
- 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 Flows, and the Thuisbord app from Homey if you like. If you connect again later, the app asks for your consent again and you get a new key.