Skip to content

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

EntiteitGebruik Voor
Water Total ConsumptionLiters sinds opstart — gebruik voor Energy Dashboard
Water Meter Initial ValueStel je fysieke meterstand in
Water Meter TotalWerkelijke meterstand (Initial + Consumption)
Water Flow RateHuidige doorstroming in L/min

Energie Entiteiten (P1)

EntiteitGebruik Voor
Energy Consumed Tariff 1/2Laag/hoog tarief verbruik (kWh)
Energy Produced Tariff 1/2Teruglevering per tarief (kWh)
Power Consumed/ProducedHuidig vermogen (W)
Voltage L1/L2/L3Spanning per fase
Current L1/L2/L3Stroom per fase (A)
Gas ConsumedGasverbruik (m³)

Omgevingsentiteiten

EntiteitGebruik Voor
TemperatureTemperatuur op apparaatlocatie
HumidityLuchtvochtigheidsniveau

Home Assistant Energy Dashboard

Het Energy Dashboard geeft je mooie visualisaties van je energie- en waterverbruik.

Water Verbruik Toevoegen

  1. Ga naar InstellingenDashboardsEnergie
  2. Onder Waterverbruik, klik op Waterbron toevoegen
  3. Selecteer Water Total Consumption entiteit
  4. Klik op Opslaan

Belangrijk: Gebruik Water Total Consumption, niet Water Meter Total. Home Assistant houdt de historie bij van deze entiteit, zelfs wanneer hij reset bij herstart.

Elektriciteitsverbruik Toevoegen

  1. In het Energy Dashboard, onder Elektriciteitsnet
  2. Klik op Verbruik toevoegen
  3. 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:

  1. Onder Elektriciteitsnet, klik op Teruglevering toevoegen
  2. Voeg beide tarief entiteiten toe:
    • Energy Produced Tariff 1
    • Energy Produced Tariff 2

Gasverbruik Toevoegen

  1. Onder Gasverbruik, klik op Gasbron toevoegen
  2. 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

  1. Lees je fysieke watermeter af (bijv. 125.456 m³)
  2. Zoek in Home Assistant het WaterP1MeterKit apparaat
  3. Stel Water Meter Initial Value in op 125.456
  4. 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:

yaml
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-leak

2. Dagelijks Water Rapport

Stuur een notificatie met je dagelijks waterverbruik:

yaml
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') }} liter

Let 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:

yaml
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:

yaml
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:

yaml
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:

yaml
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.boiler

7. Wasmachine Klaar Detectie

Detecteer wanneer je wasmachine klaar is:

yaml
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):

yaml
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_vandaag

Waterlek 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:

yaml
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: waterlek

Lek Waarschuwing met Afsluitklep

Als je een slimme waterafsluitklep hebt, sluit deze automatisch wanneer een lek wordt gedetecteerd:

yaml
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: high

Lek Opgelost Melding

Krijg een melding wanneer de lek sensor weer droog is:

yaml
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 iOS

Gas 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

  1. Adopteer de WaterP1MeterKit in ESPHome

    • Ga naar Home Assistant → ESPHome addon
    • Klik op je WaterP1MeterKit apparaat
    • Klik Adopt als nog niet geadopteerd
  2. Bewerk de configuratie

    • Zoek de substitutions sectie bovenaan
    • Wijzig gas_mbus_id van "1" naar "2", "3", of "4":
yaml
substitutions:
  device_name: waterp1meterkit
  friendly_name: WaterP1MeterKit
  gas_mbus_id: "2"  # Probeer 2, 3, of 4 als gas niet toont
  1. Opslaan en Installeren

    • Klik Save dan Install
    • Kies Wirelessly om over-the-air te updaten
  2. Controleer Home Assistant

    • Nadat het apparaat herstart, controleer of gas data verschijnt
    • Als nog steeds geen data, probeer het volgende MBus ID (3 of 4)

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:

  1. Ga naar InstellingenApparaten & DienstenHelpers
  2. Klik Helper makenUtility Meter
  3. Configureer:
    • Naam: Water Dagelijks
    • Invoersensor: sensor.waterp1meterkit_water_total_consumption
    • Meter reset cyclus: Dagelijks
  4. Herhaal voor wekelijks en maandelijks

Aanbevolen Dashboard Entiteiten

Water Monitoring:

  • sensor.waterp1meterkit_water_total_consumption — Totaal water
  • sensor.waterp1meterkit_water_flow_rate — Huidige flow
  • sensor.waterp1meterkit_water_meter_total — Werkelijke meterstand
  • sensor.water_dagelijks — Dagelijks verbruik (utility meter)

Energie Monitoring:

  • sensor.waterp1meterkit_power_consumed — Huidig stroomverbruik
  • sensor.waterp1meterkit_power_produced — Zonne-productie
  • sensor.waterp1meterkit_energy_consumed_tariff_1 — Dal tarief totaal
  • sensor.waterp1meterkit_energy_consumed_tariff_2 — Piek tarief totaal

Omgeving:

  • sensor.waterp1meterkit_temperature
  • sensor.waterp1meterkit_humidity

Voorbeeld Dashboard Card - Water Overzicht

yaml
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: Meterstand

Voorbeeld Dashboard Card - Energie Overzicht

yaml
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: Spanning

Gauge Card voor Stroomverbruik

yaml
type: gauge
entity: sensor.waterp1meterkit_power_consumed
name: Huidig Vermogen
min: 0
max: 10000
severity:
  green: 0
  yellow: 3000
  red: 6000
unit: W

Water Flow Gauge

yaml
type: gauge
entity: sensor.waterp1meterkit_water_flow_rate
name: Water Flow
min: 0
max: 20
severity:
  green: 0
  yellow: 10
  red: 15
unit: L/min

Historie Grafiek - Dagelijks Water Patroon

yaml
type: history-graph
title: Waterverbruik Vandaag
entities:
  - entity: sensor.waterp1meterkit_water_flow_rate
hours_to_show: 24

Statistieken Card - Verbruik Deze Week

yaml
type: statistic
entity: sensor.waterp1meterkit_water_total_consumption
period:
  calendar:
    period: week
stat_type: change
name: Water Deze Week

Best 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:

GebeurtenisData Bewaard?
Herstart✅ Ja
OTA firmware update✅ Ja
Factory reset✅ Ja (eerst opgeslagen)
Stroomuitval⚠️ Kan tot ~50 liter verliezen

Veelvoorkomende Toepassingen

ScenarioBelangrijke EntiteitenAutomatisering Ideeën
Lek DetectieWater Flow RateWaarschuwing als 30+ min loopt
Douche TrackingWater Flow RateTimer, verbruik per douche
Dagelijkse RapportenUtility MetersDagelijkse/wekelijkse notificaties
Zonne-optimalisatiePower ProducedRegel boiler, EV lader
Apparaat DetectiePower ConsumedWasmachine, vaatwasser meldingen
Kosten TrackingEnergy ConsumedBereken kosten per tarief
OmgevingTemperature, HumidityMonitor bijkeuken klimaat

Integratie Ideeën

Combineren met Andere SmartHomeShop Producten

ProductGecombineerd Gebruik
CeilSenseCorreleer aanwezigheid met water/energie verbruik
UltimateSensorKamer-voor-kamer klimaat + hele-huis energie
WaterMeterKitMeerdere 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:

  1. Ga naar Home AssistantESPHome addon
  2. Je WaterP1MeterKit zou moeten verschijnen — klik Adopt
  3. Eenmaal geadopteerd kun je de YAML configuratie bewerken

Belangrijke Substitutions

De firmware gebruikt substitutions voor eenvoudige aanpassingen:

yaml
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
SubstitutionBeschrijving
device_nameInterne apparaatnaam (geen spaties)
friendly_nameWeergavenaam in Home Assistant
gas_mbus_idMBus 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:

yaml
sensor:
  - platform: hdc1080
    temperature:
      filters:
        offset: -4.5  # Standaard offset, pas aan indien nodig
    humidity:
      filters:
        offset: 12  # Standaard offset, pas aan indien nodig

Hoe te kalibreren:

  1. Vergelijk WaterP1MeterKit metingen met een bekende nauwkeurige thermometer/hygrometer
  2. Bereken het verschil (bijv. als het 2°C te hoog meet, wijzig offset naar -6.5)
  3. 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:

yaml
packages:
  smarthomeshop.waterp1meterkit: 
    github://smarthomeshop/waterp1meterkit/waterp1meterkit-v3/waterp1meterkit-wifi.yaml@main

Dit haalt automatisch de laatste configuratie op terwijl je hieronder aanpassingen kunt toevoegen.

Broncode

De volledige ESPHome configuratie is open source:


Hulp Nodig?