Gebruikshandleiding
Deze handleiding behandelt praktische manieren om je WaterP1MeterKit te gebruiken in Home Assistant, inclusief Energy Dashboard setup, automatiseringsvoorbeelden en dashboard tips.
Snel Starten
Na installatie biedt je WaterP1MeterKit deze belangrijke entiteiten:
Water Entiteiten
| Entiteit | Gebruik Voor |
|---|---|
| Water Total Consumption | Liters sinds opstart — gebruik voor Energy Dashboard |
| Water Meter Initial Value | Stel je fysieke meterstand in |
| Water Meter Total | Werkelijke meterstand (Initial + Consumption) |
| Water Flow Rate | Huidige doorstroming in L/min |
Energie Entiteiten (P1)
| Entiteit | Gebruik Voor |
|---|---|
| Energy Consumed Tariff 1/2 | Laag/hoog tarief verbruik (kWh) |
| Energy Produced Tariff 1/2 | Teruglevering per tarief (kWh) |
| Power Consumed/Produced | Huidig vermogen (W) |
| Voltage L1/L2/L3 | Spanning per fase |
| Current L1/L2/L3 | Stroom per fase (A) |
| Gas Consumed | Gasverbruik (m³) |
Omgevingsentiteiten
| Entiteit | Gebruik Voor |
|---|---|
| Temperature | Temperatuur op apparaatlocatie |
| Humidity | Luchtvochtigheidsniveau |
Home Assistant Energy Dashboard
Het Energy Dashboard geeft je mooie visualisaties van je energie- en waterverbruik.
Water Verbruik Toevoegen
- Ga naar Instellingen → Dashboards → Energie
- Onder Waterverbruik, klik op Waterbron toevoegen
- Selecteer Water Total Consumption entiteit
- Klik op Opslaan
Belangrijk: Gebruik
Water Total Consumption, nietWater Meter Total. Home Assistant houdt de historie bij van deze entiteit, zelfs wanneer hij reset bij herstart.
Elektriciteitsverbruik Toevoegen
- In het Energy Dashboard, onder Elektriciteitsnet
- Klik op Verbruik toevoegen
- Voeg beide tarief entiteiten toe:
Energy Consumed Tariff 1(dal tarief)Energy Consumed Tariff 2(piek tarief)
Zonne-energie Productie Toevoegen
Als je zonnepanelen hebt:
- Onder Elektriciteitsnet, klik op Teruglevering toevoegen
- Voeg beide tarief entiteiten toe:
Energy Produced Tariff 1Energy Produced Tariff 2
Gasverbruik Toevoegen
- Onder Gasverbruik, klik op Gasbron toevoegen
- Selecteer Gas Consumed entiteit
Na ~5 minuten verschijnt je data in het Energy Dashboard!
Je Watermeterstand Instellen
Om je werkelijke meterstand te volgen (niet alleen verbruik sinds installatie):
Eerste Keer Setup
- Lees je fysieke watermeter af (bijv.
125.456 m³) - Zoek in Home Assistant het WaterP1MeterKit apparaat
- Stel Water Meter Initial Value in op
125.456 - Water Meter Total toont nu je werkelijke meterstand
Na Stroomuitval of Herstart
Je data wordt automatisch bewaard:
- Opgeslagen elke 5 minuten (als 50+ liter verbruikt)
- Opgeslagen bij elke shutdown, OTA update, of herstart
Maximaal verlies bij onverwachte stroomuitval: ~50 liter.
Automatiseringsvoorbeelden
1. Waterlek Detectie (Ongebruikelijk Verbruik)
Waarschuwing wanneer water te lang heeft gelopen:
alias: "Water - Lek detectie waarschuwing"
trigger:
- platform: numeric_state
entity_id: sensor.waterp1meterkit_water_flow_rate
above: 0.5 # Meer dan 0.5 L/min
for:
minutes: 30 # Langer dan 30 minuten
action:
- service: notify.mobile_app
data:
title: "⚠️ Mogelijk Waterlek!"
message: "Water loopt al 30+ minuten ({{ states('sensor.waterp1meterkit_water_flow_rate') }} L/min)"
data:
priority: high
tag: water-leak2. Dagelijks Water Rapport
Stuur een notificatie met je dagelijks waterverbruik:
alias: "Water - Dagelijks rapport"
trigger:
- platform: time
at: "21:00:00"
action:
- service: notify.mobile_app
data:
title: "💧 Dagelijks Water Rapport"
message: >
Waterverbruik vandaag: {{ states('sensor.waterp1meterkit_water_total_consumption_daily') }} literLet op: Je moet een utility meter helper maken voor dagelijkse tracking (zie Dashboard sectie hieronder).
3. Hoog Stroomverbruik Waarschuwing
Waarschuwing wanneer stroomverbruik ongewoon hoog is:
alias: "Energie - Hoog vermogen waarschuwing"
trigger:
- platform: numeric_state
entity_id: sensor.waterp1meterkit_power_consumed
above: 5000 # Meer dan 5kW
for:
minutes: 5
action:
- service: notify.mobile_app
data:
title: "⚡ Hoog Stroomverbruik"
message: "Huidig vermogen: {{ states('sensor.waterp1meterkit_power_consumed') }}W"4. Zonne-energie Productie Notificatie
Krijg een melding wanneer je zonnepanelen goed produceren:
alias: "Zonne-energie - Goede productie melding"
trigger:
- platform: numeric_state
entity_id: sensor.waterp1meterkit_power_produced
above: 3000 # Meer dan 3kW productie
condition:
- condition: time
after: "10:00:00"
before: "16:00:00"
action:
- service: notify.mobile_app
data:
title: "☀️ Zonne-energie!"
message: "Produceert {{ states('sensor.waterp1meterkit_power_produced') }}W - geweldige zonnedag!"5. Douche Timer / Lange Douche Waarschuwing
Detecteer wanneer iemand lang doucht:
alias: "Water - Lange douche waarschuwing"
trigger:
- platform: numeric_state
entity_id: sensor.waterp1meterkit_water_flow_rate
above: 5 # Typische douche flow
for:
minutes: 15
action:
- service: notify.mobile_app
data:
title: "🚿 Lange Douche"
message: "Douche loopt al 15+ minuten"6. Boiler Uitschakelen Bij Lage Zonne-productie
Bespaar energie door je boiler te regelen op basis van zonne-productie:
alias: "Boiler - Zonne-energie gebaseerde regeling"
trigger:
- platform: state
entity_id: sensor.waterp1meterkit_power_produced
action:
- choose:
# Hoge zonne-productie - boiler aan
- conditions:
- condition: numeric_state
entity_id: sensor.waterp1meterkit_power_produced
above: 2000
sequence:
- service: switch.turn_on
target:
entity_id: switch.boiler
# Lage zonne-productie - boiler uit
- conditions:
- condition: numeric_state
entity_id: sensor.waterp1meterkit_power_produced
below: 500
sequence:
- service: switch.turn_off
target:
entity_id: switch.boiler7. Wasmachine Klaar Detectie
Detecteer wanneer je wasmachine klaar is:
alias: "Apparaat - Wasmachine klaar"
trigger:
- platform: numeric_state
entity_id: sensor.waterp1meterkit_power_consumed
below: 50 # Zeer laag vermogen
for:
minutes: 2
condition:
- condition: state
entity_id: input_boolean.wasmachine_draait
state: "on"
action:
- service: input_boolean.turn_off
target:
entity_id: input_boolean.wasmachine_draait
- service: notify.mobile_app
data:
title: "🧺 Was Klaar!"
message: "Je wasmachine is klaar"8. Toilet Spoeling Detectie
Detecteer toilet spoelingen (typisch 6-9 liter snel waterverbruik):
alias: "Water - Toilet spoeling teller"
trigger:
- platform: numeric_state
entity_id: sensor.waterp1meterkit_water_flow_rate
above: 10 # Hoge flow rate
for:
seconds: 3
condition:
- condition: numeric_state
entity_id: sensor.waterp1meterkit_water_flow_rate
above: 10
action:
- service: counter.increment
target:
entity_id: counter.toilet_spoelingen_vandaagWaterlek Sensor Automatiseringen (Alleen V3)
De WaterP1MeterKit V3 heeft een uitbreidingspoort voor een optionele waterlek sensor. Hier zijn enkele nuttige automatiseringen:
Basis Lek Waarschuwing
Krijg direct een melding wanneer water wordt gedetecteerd:
alias: "Waterlek - Waarschuwing"
trigger:
- platform: state
entity_id: binary_sensor.waterp1meterkit_water_leak_sensor
to: "on"
action:
- service: notify.mobile_app
data:
title: "🚨 Waterlek Gedetecteerd!"
message: "Water gedetecteerd bij de WaterP1MeterKit sensor locatie!"
data:
priority: high
tag: waterlekLek Waarschuwing met Afsluitklep
Als je een slimme waterafsluitklep hebt, sluit deze automatisch wanneer een lek wordt gedetecteerd:
alias: "Waterlek - Nood Afsluiting"
trigger:
- platform: state
entity_id: binary_sensor.waterp1meterkit_water_leak_sensor
to: "on"
action:
- service: switch.turn_off
target:
entity_id: switch.water_hoofdkraan # Jouw afsluitklep entiteit
- service: notify.mobile_app
data:
title: "🚨 Waterlek - Klep Gesloten!"
message: "Waterlek gedetecteerd! Hoofdwaterkraan is automatisch afgesloten."
data:
priority: highLek Opgelost Melding
Krijg een melding wanneer de lek sensor weer droog is:
alias: "Waterlek - Opgelost"
trigger:
- platform: state
entity_id: binary_sensor.waterp1meterkit_water_leak_sensor
to: "off"
for:
minutes: 5 # Wacht 5 minuten om te bevestigen dat het droog is
action:
- service: notify.mobile_app
data:
title: "✅ Waterlek Opgelost"
message: "De waterlek sensor is nu droog."
data:
tag: waterlek # Wist de vorige waarschuwing op iOSGas MBus Configuratie
Als je gasmeter data niet toont in Home Assistant, moet het MBus ID mogelijk worden gewijzigd. De gasmeter communiceert met de slimme meter via MBus protocol, en het ID kan 1, 2, 3, of 4 zijn afhankelijk van je setup.
Hoe Het MBus ID Te Wijzigen
Adopteer de WaterP1MeterKit in ESPHome
- Ga naar Home Assistant → ESPHome addon
- Klik op je WaterP1MeterKit apparaat
- Klik Adopt als nog niet geadopteerd
Bewerk de configuratie
- Zoek de
substitutionssectie bovenaan - Wijzig
gas_mbus_idvan"1"naar"2","3", of"4":
- Zoek de
substitutions:
device_name: waterp1meterkit
friendly_name: WaterP1MeterKit
gas_mbus_id: "2" # Probeer 2, 3, of 4 als gas niet toontOpslaan en Installeren
- Klik Save dan Install
- Kies Wirelessly om over-the-air te updaten
Controleer Home Assistant
- Nadat het apparaat herstart, controleer of gas data verschijnt
- Als nog steeds geen data, probeer het volgende MBus ID (
3of4)
Waarom Verschillende MBus IDs?
Je slimme meter kan meerdere apparaten aangesloten hebben via MBus (gasmeter, watermeter, warmtemeter, etc.). Elk apparaat heeft een uniek ID (1-4). De meeste Nederlandse gasmeters gebruiken ID 1, maar Belgische en sommige andere meters kunnen andere IDs gebruiken.
Nog Steeds Geen Gas Data?
- Controleer of je gasmeter daadwerkelijk is aangesloten op je slimme meter
- Sommige oudere gasmeters verzenden geen data digitaal
- Controleer of je energieleverancier gastransmissie heeft ingeschakeld op de P1 poort
- Gas data wordt typisch elk uur bijgewerkt, dus wacht minimaal een uur na setup
Dashboard Ideeën
Utility Meters Maken
Om dagelijks, wekelijks en maandelijks verbruik te volgen, maak utility meter helpers:
- Ga naar Instellingen → Apparaten & Diensten → Helpers
- Klik Helper maken → Utility Meter
- Configureer:
- Naam:
Water Dagelijks - Invoersensor:
sensor.waterp1meterkit_water_total_consumption - Meter reset cyclus:
Dagelijks
- Naam:
- Herhaal voor wekelijks en maandelijks
Aanbevolen Dashboard Entiteiten
Water Monitoring:
sensor.waterp1meterkit_water_total_consumption— Totaal watersensor.waterp1meterkit_water_flow_rate— Huidige flowsensor.waterp1meterkit_water_meter_total— Werkelijke meterstandsensor.water_dagelijks— Dagelijks verbruik (utility meter)
Energie Monitoring:
sensor.waterp1meterkit_power_consumed— Huidig stroomverbruiksensor.waterp1meterkit_power_produced— Zonne-productiesensor.waterp1meterkit_energy_consumed_tariff_1— Dal tarief totaalsensor.waterp1meterkit_energy_consumed_tariff_2— Piek tarief totaal
Omgeving:
sensor.waterp1meterkit_temperaturesensor.waterp1meterkit_humidity
Voorbeeld Dashboard Card - Water Overzicht
type: entities
title: 💧 Water
entities:
- entity: sensor.waterp1meterkit_water_flow_rate
name: Huidige Flow
- entity: sensor.water_dagelijks
name: Verbruik Vandaag
- entity: sensor.waterp1meterkit_water_meter_total
name: MeterstandVoorbeeld Dashboard Card - Energie Overzicht
type: entities
title: ⚡ Energie
entities:
- entity: sensor.waterp1meterkit_power_consumed
name: Stroomverbruik
- entity: sensor.waterp1meterkit_power_produced
name: Zonne-productie
- entity: sensor.waterp1meterkit_voltage_l1
name: SpanningGauge Card voor Stroomverbruik
type: gauge
entity: sensor.waterp1meterkit_power_consumed
name: Huidig Vermogen
min: 0
max: 10000
severity:
green: 0
yellow: 3000
red: 6000
unit: WWater Flow Gauge
type: gauge
entity: sensor.waterp1meterkit_water_flow_rate
name: Water Flow
min: 0
max: 20
severity:
green: 0
yellow: 10
red: 15
unit: L/minHistorie Grafiek - Dagelijks Water Patroon
type: history-graph
title: Waterverbruik Vandaag
entities:
- entity: sensor.waterp1meterkit_water_flow_rate
hours_to_show: 24Statistieken Card - Verbruik Deze Week
type: statistic
entity: sensor.waterp1meterkit_water_total_consumption
period:
calendar:
period: week
stat_type: change
name: Water Deze WeekBest Practices
Water Sensor Positionering
De sensor detecteert het roterende metalen plaatje in je watermeter. Correcte positionering is cruciaal voor nauwkeurige metingen.
Hoe het werkt:
- In je watermeter zit een klein metalen plaatje dat roteert bij elke liter water
- De sensor detecteert dit metalen plaatje wanneer het passeert
- De sensor heeft een kruisje/middelpunt dat zo gepositioneerd moet zijn dat het metalen plaatje er één keer per rotatie doorheen gaat
Correcte positionering:
- Positioneer de sensor zodat deze ongeveer 50% van de roterende metalen 1-liter indicator bedekt
- Het kruisje (middelpunt) van de sensor moet zo uitgelijnd zijn dat het metalen plaatje er precies één keer per volledige rotatie doorheen gaat
- De kant met het rode LEDje moet naar BENEDEN wijzen (richting watermeter glas)
- De zwarte kant moet zichtbaar zijn (naar boven wijzend)
✅ Doe:
- Positioneer sensor om ~50% van de roterende metalen indicator te bedekken
- Lijn het kruisje uit zodat metaal één keer per rotatie passeert
- Houd rode LED kant naar beneden, zwarte kant zichtbaar
- Houd sensor stevig in de houder gedrukt
- Test door water te laten lopen — groene LED moet één keer per liter knipperen
❌ Doe niet:
- De hele roterende indicator bedekken (sensor detecteert dan geen overgangen)
- Sensor off-center positioneren van het metalen plaatje pad
- Monteren met rode LED naar boven (verkeerde oriëntatie)
- Montageschroeven te strak aandraaien
- Sensor het watermeter glas laten raken
Energie Monitoring Tips
- Controleer tarief tijden: Zorg dat je dal/piek tarief tijden overeenkomen met je energiecontract
- Monitor fasen: Als je 3-fase hebt, controleer elke fase op onbalans
- Zonne-optimalisatie: Gebruik productiedata om hoogvermogen apparaten te timen
Persistente Data
De WaterP1MeterKit slaat je waterverbruik persistent op:
| Gebeurtenis | Data Bewaard? |
|---|---|
| Herstart | ✅ Ja |
| OTA firmware update | ✅ Ja |
| Factory reset | ✅ Ja (eerst opgeslagen) |
| Stroomuitval | ⚠️ Kan tot ~50 liter verliezen |
Veelvoorkomende Toepassingen
| Scenario | Belangrijke Entiteiten | Automatisering Ideeën |
|---|---|---|
| Lek Detectie | Water Flow Rate | Waarschuwing als 30+ min loopt |
| Douche Tracking | Water Flow Rate | Timer, verbruik per douche |
| Dagelijkse Rapporten | Utility Meters | Dagelijkse/wekelijkse notificaties |
| Zonne-optimalisatie | Power Produced | Regel boiler, EV lader |
| Apparaat Detectie | Power Consumed | Wasmachine, vaatwasser meldingen |
| Kosten Tracking | Energy Consumed | Bereken kosten per tarief |
| Omgeving | Temperature, Humidity | Monitor bijkeuken klimaat |
Integratie Ideeën
Combineren met Andere SmartHomeShop Producten
| Product | Gecombineerd Gebruik |
|---|---|
| CeilSense | Correleer aanwezigheid met water/energie verbruik |
| UltimateSensor | Kamer-voor-kamer klimaat + hele-huis energie |
| WaterMeterKit | Meerdere watermeters (tuin, wasmachine) |
Third-Party Integraties
- Grafana: Maak gedetailleerde energie dashboards
- InfluxDB: Lange-termijn data opslag en analyse
- Node-RED: Complexe automatisering flows
- Google Sheets: Exporteer data voor analyse
ESPHome Configuratie
Voor gevorderde gebruikers die de WaterP1MeterKit firmware willen aanpassen.
Adopteren in ESPHome
Om je WaterP1MeterKit aan te passen:
- Ga naar Home Assistant → ESPHome addon
- Je WaterP1MeterKit zou moeten verschijnen — klik Adopt
- Eenmaal geadopteerd kun je de YAML configuratie bewerken
Belangrijke Substitutions
De firmware gebruikt substitutions voor eenvoudige aanpassingen:
substitutions:
device_name: waterp1meterkit
friendly_name: WaterP1MeterKit
project_version: "1.4"
hardware_version: "V3"
gas_mbus_id: "1" # Wijzig naar 2, 3, of 4 als gas niet toont| Substitution | Beschrijving |
|---|---|
device_name | Interne apparaatnaam (geen spaties) |
friendly_name | Weergavenaam in Home Assistant |
gas_mbus_id | MBus ID voor gasmeter (1-4) |
Sensor Kalibratie Aanpassen
De HDC1080 temperatuur- en vochtigheidssensoren hebben ingebouwde kalibratie offsets. Als je metingen onnauwkeurig zijn, kun je ze aanpassen:
sensor:
- platform: hdc1080
temperature:
filters:
offset: -4.5 # Standaard offset, pas aan indien nodig
humidity:
filters:
offset: 12 # Standaard offset, pas aan indien nodigHoe te kalibreren:
- Vergelijk WaterP1MeterKit metingen met een bekende nauwkeurige thermometer/hygrometer
- Bereken het verschil (bijv. als het 2°C te hoog meet, wijzig offset naar
-6.5) - Sla op en installeer de bijgewerkte configuratie
GitHub Packages Gebruiken
In plaats van alle YAML te kopiëren, kun je de packages functie gebruiken om van GitHub te importeren:
packages:
smarthomeshop.waterp1meterkit:
github://smarthomeshop/waterp1meterkit/waterp1meterkit-v3/waterp1meterkit-wifi.yaml@mainDit haalt automatisch de laatste configuratie op terwijl je hieronder aanpassingen kunt toevoegen.
Broncode
De volledige ESPHome configuratie is open source:
- 📁 GitHub Repository: smarthomeshop/waterp1meterkit
- 📄 V3 Base Config: waterp1meterkit-v3/base.yaml
Hulp Nodig?
- Hardware Versies — Vergelijk V1, V2 en V3
- Netwerk Configuratie — WiFi/Ethernet setup
- Probleemoplossing — Veelvoorkomende problemen
- FAQ — Veelgestelde vragen