Gebruikshandleiding

Deze handleiding behandelt praktische manieren om je WaterMeterKit te gebruiken in Home Assistant, inclusief Energy Dashboard setup, automatisering voorbeelden en dashboard tips.

Snel Starten

Na installatie biedt je WaterMeterKit 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 doorstroom in L/min

Omgevings Entiteiten

Entiteit	Gebruik Voor
Temperature	Temperatuur op apparaatlocatie
Humidity	Luchtvochtigheid

Home Assistant Energy Dashboard

Het Energy Dashboard geeft je mooie visualisaties van je 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, niet Water Meter Total. Home Assistant houdt de historie bij van deze entiteit zelfs wanneer hij reset bij herstart.

Na ~5 minuten verschijnt je waterdata in het Energy Dashboard!

Je Watermeterstand Instellen

Om je werkelijke meterstand te volgen (niet alleen verbruik sinds installatie):

Eerste Keer Instellen

Lees je fysieke watermeter af (bijv. 125.456 m³)
Zoek in Home Assistant het WaterMeterKit 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 gebruikt)
Opgeslagen bij elke shutdown, OTA update of herstart

Maximaal verlies bij onverwachte stroomuitval: ~50 liter.

Automatisering Voorbeelden

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.watermeterkit_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.watermeterkit_water_flow_rate') }} L/min)"
      data:
        priority: high
        tag: water-leak

2. Dagelijks Water Verbruiksrapport

Stuur een melding met je dagelijks waterverbruik:

yaml

alias: "Water - Dagelijks verbruiksrapport"
trigger:
  - platform: time
    at: "21:00:00"
action:
  - service: notify.mobile_app
    data:
      title: "💧 Dagelijks Water Rapport"
      message: >
        Waterverbruik vandaag: {{ states('sensor.water_daily') }} liter

Let op: Je moet een utility meter helper aanmaken voor dagelijkse tracking (zie Dashboard sectie hieronder).

3. Douche Timer / Lange Douche Waarschuwing

Detecteer wanneer iemand lang aan het douchen is:

yaml

alias: "Water - Lange douche waarschuwing"
trigger:
  - platform: numeric_state
    entity_id: sensor.watermeterkit_water_flow_rate
    above: 5  # Typische douchestroom
    for:
      minutes: 15
action:
  - service: notify.mobile_app
    data:
      title: "🚿 Lange Douche"
      message: "Douche loopt al 15+ minuten"

4. Nacht Waterverbruik Waarschuwing

Detecteer onverwacht waterverbruik 's nachts (mogelijk lek):

yaml

alias: "Water - Nacht verbruik waarschuwing"
trigger:
  - platform: numeric_state
    entity_id: sensor.watermeterkit_water_flow_rate
    above: 0.5
    for:
      minutes: 5
condition:
  - condition: time
    after: "01:00:00"
    before: "05:00:00"
action:
  - service: notify.mobile_app
    data:
      title: "🌙 Nacht Waterverbruik"
      message: "Water loopt op {{ states('sensor.watermeterkit_water_flow_rate') }} L/min"
      data:
        priority: high

5. 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.watermeterkit_water_flow_rate
    above: 10  # Hoge doorstroomsnelheid
    for:
      seconds: 3
condition:
  - condition: numeric_state
    entity_id: sensor.watermeterkit_water_flow_rate
    above: 10
action:
  - service: counter.increment
    target:
      entity_id: counter.toilet_flushes_today

6. Wekelijks Water Budget Waarschuwing

Waarschuwing wanneer je wekelijkse waterbudget nadert:

yaml

alias: "Water - Budget waarschuwing"
trigger:
  - platform: numeric_state
    entity_id: sensor.water_weekly  # Utility meter
    above: 700  # 700 liter wekelijkse limiet
action:
  - service: notify.mobile_app
    data:
      title: "💧 Water Budget Waarschuwing"
      message: "Je hebt {{ states('sensor.water_weekly') }} liter verbruikt deze week!"

7. Wasmachine Water Detectie

Detecteer wanneer de wasmachine water gebruikt:

yaml

alias: "Water - Wasmachine draait"
trigger:
  - platform: numeric_state
    entity_id: sensor.watermeterkit_water_flow_rate
    above: 8  # Typische wasmachine vulsnelheid
    for:
      seconds: 10
action:
  - service: input_boolean.turn_on
    target:
      entity_id: input_boolean.washing_machine_running
  - service: notify.mobile_app
    data:
      title: "🧺 Wasmachine"
      message: "Wasmachine vult met water"

Dashboard Ideeën

Utility Meters Aanmaken

Om dagelijks, wekelijks en maandelijks verbruik te volgen, maak utility meter helpers aan:

Ga naar Instellingen → Apparaten & Diensten → Helpers
Klik op Helper aanmaken → Utility Meter
Configureer:
- Naam: Water Dagelijks
- Input sensor: sensor.watermeterkit_water_total_consumption
- Meter reset cyclus: Dagelijks
Herhaal voor wekelijks en maandelijks

Aanbevolen Dashboard Entiteiten

Water Monitoring:

sensor.watermeterkit_water_total_consumption — Totaal water
sensor.watermeterkit_water_flow_rate — Huidige doorstroom
sensor.watermeterkit_water_meter_total — Werkelijke meterstand
sensor.water_daily — Dagelijks verbruik (utility meter)

Omgeving:

sensor.watermeterkit_temperature
sensor.watermeterkit_humidity

Voorbeeld Dashboard Kaart - Water Overzicht

yaml

type: entities
title: 💧 Water
entities:
  - entity: sensor.watermeterkit_water_flow_rate
    name: Huidige Doorstroom
  - entity: sensor.water_daily
    name: Verbruik Vandaag
  - entity: sensor.watermeterkit_water_meter_total
    name: Meterstand
  - entity: sensor.watermeterkit_temperature
    name: Temperatuur

Water Doorstroom Gauge

yaml

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

Geschiedenis Grafiek - Dagelijks Water Patroon

yaml

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

Statistieken Kaart - Verbruik Deze Week

yaml

type: statistic
entity: sensor.watermeterkit_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 met elke liter water
De sensor detecteert dit metalen plaatje wanneer het passeert
De sensor heeft een kruisje/middelpunt dat zo gepositioneerd moet worden 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)
De zwarte kant moet zichtbaar zijn (naar boven)

✅ Wel doen:

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

❌ Niet doen:

Hele roterende indicator bedekken (sensor detecteert geen overgangen)
Sensor uit het midden 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

Persistente Data

De WaterMeterKit slaat je waterverbruik persistent op:

Gebeurtenis	Data Bewaard?
Herstart	✅ Ja
OTA firmware update	✅ Ja
Factory reset	✅ Ja (eerst opgeslagen)
Stroomuitval	⚠️ Mogelijk tot ~50 liter verlies

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 meldingen
Budget Tracking	Utility Meters	Waarschuwing bij naderen limiet
Nacht Monitoring	Water Flow Rate	Waarschuwing voor onverwacht nachtverbruik
Apparaat Detectie	Water Flow Rate	Detecteer wasmachine, toilet
Omgeving	Temperature, Humidity	Monitor watermeter locatie

Integratie Ideeën

Combineer met Andere SmartHomeShop Producten

Product	Gecombineerd Gebruik
WaterP1MeterKit	Voeg energiemonitoring toe aan je watermonitoring
CeilSense	Correleer aanwezigheid met waterverbruik
UltimateSensor	Kamerklimaat + watermonitoring

Third-Party Integraties

Grafana: Maak gedetailleerde waterverbruik 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 WaterMeterKit firmware willen aanpassen.

Adopteren in ESPHome

Om je WaterMeterKit aan te passen:

Ga naar Home Assistant → ESPHome addon
Je WaterMeterKit zou moeten verschijnen — klik Adopt
Eenmaal geadopteerd kun je de YAML configuratie bewerken

Belangrijke Substitutions

De firmware gebruikt substitutions voor eenvoudige aanpassingen:

yaml

substitutions:
  device_name: watermeterkit
  friendly_name: WaterMeterKit

Substitution	Beschrijving
`device_name`	Interne apparaatnaam (geen spaties)
`friendly_name`	Weergavenaam in Home Assistant

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:

Vergelijk WaterMeterKit 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:

yaml

packages:
  smarthomeshop.watermeterkit: 
    github://smarthomeshop/watermeterkit/watermeterkit-v2/watermeterkit.yaml@main

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

Broncode

De volledige ESPHome configuratie is open source:

📁 GitHub Repository: smarthomeshop/watermeterkit

Ook Energiemonitoring Nodig?

De WaterMeterKit focust puur op watermonitoring. Als je ook je energieverbruik wilt monitoren (elektriciteit, gas, zonnepanelen), overweeg de WaterP1MeterKit:

Eigenschap	WaterMeterKit	WaterP1MeterKit
Water monitoring	✅	✅
P1 energiemeter	❌	✅
Gas monitoring	❌	✅
Zonne-energie productie	❌	✅
Ethernet/PoE	❌	✅

Hulp Nodig?

Installatie Handleiding — Setup instructies
Probleemoplossing — Veelvoorkomende problemen
Firmware Handleiding — Firmware updaten
Discord Community — Krijg hulp

Gebruikshandleiding ​

Snel Starten ​

Water Entiteiten ​

Omgevings Entiteiten ​

Home Assistant Energy Dashboard ​

Water Verbruik Toevoegen ​

Je Watermeterstand Instellen ​

Eerste Keer Instellen ​

Na Stroomuitval of Herstart ​

Automatisering Voorbeelden ​

1. Waterlek Detectie (Ongebruikelijk Verbruik) ​

2. Dagelijks Water Verbruiksrapport ​

3. Douche Timer / Lange Douche Waarschuwing ​

4. Nacht Waterverbruik Waarschuwing ​

5. Toilet Spoeling Detectie ​

6. Wekelijks Water Budget Waarschuwing ​

7. Wasmachine Water Detectie ​

Dashboard Ideeën ​

Utility Meters Aanmaken ​

Aanbevolen Dashboard Entiteiten ​

Voorbeeld Dashboard Kaart - Water Overzicht ​

Water Doorstroom Gauge ​

Geschiedenis Grafiek - Dagelijks Water Patroon ​

Statistieken Kaart - Verbruik Deze Week ​

Best Practices ​

Water Sensor Positionering ​

Persistente Data ​

Veelvoorkomende Toepassingen ​

Integratie Ideeën ​

Combineer met Andere SmartHomeShop Producten ​

Third-Party Integraties ​

ESPHome Configuratie ​

Adopteren in ESPHome ​

Belangrijke Substitutions ​

Sensor Kalibratie Aanpassen ​

GitHub Packages Gebruiken ​

Broncode ​

Ook Energiemonitoring Nodig? ​

Hulp Nodig? ​

Gebruikshandleiding

Snel Starten

Water Entiteiten

Omgevings Entiteiten

Home Assistant Energy Dashboard

Water Verbruik Toevoegen

Je Watermeterstand Instellen

Eerste Keer Instellen

Na Stroomuitval of Herstart

Automatisering Voorbeelden

1. Waterlek Detectie (Ongebruikelijk Verbruik)

2. Dagelijks Water Verbruiksrapport

3. Douche Timer / Lange Douche Waarschuwing

4. Nacht Waterverbruik Waarschuwing

5. Toilet Spoeling Detectie

6. Wekelijks Water Budget Waarschuwing

7. Wasmachine Water Detectie

Dashboard Ideeën

Utility Meters Aanmaken

Aanbevolen Dashboard Entiteiten

Voorbeeld Dashboard Kaart - Water Overzicht

Water Doorstroom Gauge

Geschiedenis Grafiek - Dagelijks Water Patroon

Statistieken Kaart - Verbruik Deze Week

Best Practices

Water Sensor Positionering

Persistente Data

Veelvoorkomende Toepassingen

Integratie Ideeën

Combineer met Andere SmartHomeShop Producten

Third-Party Integraties

ESPHome Configuratie

Adopteren in ESPHome

Belangrijke Substitutions

Sensor Kalibratie Aanpassen

GitHub Packages Gebruiken

Broncode

Ook Energiemonitoring Nodig?

Hulp Nodig?