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

Omgevings Entiteiten

Home Assistant Energy Dashboard

Het Energy Dashboard geeft je mooie visualisaties van je waterverbruik.

Water Verbruik Toevoegen

1. Ga naar Instellingen → Dashboards → Energie
2. Onder Waterverbruik, klik op Waterbron toevoegen
3. Selecteer de Total Consumption entiteit
4. Klik op Opslaan

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

Het kan tot 2 uur duren voordat je waterdata verschijnt in het Energy Dashboard.

Je Watermeterstand Instellen

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

Eerste Keer Instellen

1. Lees je fysieke watermeter af (bijv. 125.456 m³)
2. Zoek in Home Assistant het WaterMeterKit 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 op V3 en elke 30 minuten op V1 en V2, als de stand is veranderd
• Opgeslagen bij elke nette herstart of OTA update, en direct nadat je Water Meter Initial Value instelt

Een plotselinge stroomuitval kan het verbruik sinds de laatste opslag kosten: tot 5 minuten op V3, tot 30 minuten op V1 en V2. Water dat je gebruikt terwijl het apparaat uit staat, wordt niet geteld.

Automatisering Voorbeelden

Let op: Vervang in alle voorbeelden hieronder a1b2c3 door het ID van je eigen apparaat en notify.mobile_app door je eigen meldingsdienst. Kopieer het exacte entiteit-ID van de entiteit in Home Assistant.

1. Waterlek Detectie (Ongebruikelijk Verbruik)

Waarschuwing wanneer water te lang heeft gelopen:

alias: "Water - Lek detectie waarschuwing"
trigger:
  - platform: numeric_state
    entity_id: sensor.watermeterkit_a1b2c3_watermeterkit_current_usage
    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_a1b2c3_watermeterkit_current_usage') }} L/min)"
      data:
        priority: high
        tag: water-leak

2. Dagelijks Water Verbruiksrapport

Stuur een melding met je dagelijks waterverbruik:

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') | float(0) * 1000) | round(0) }} 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:

alias: "Water - Lange douche waarschuwing"
trigger:
  - platform: numeric_state
    entity_id: sensor.watermeterkit_a1b2c3_watermeterkit_current_usage
    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):

alias: "Water - Nacht verbruik waarschuwing"
trigger:
  - platform: numeric_state
    entity_id: sensor.watermeterkit_a1b2c3_watermeterkit_current_usage
    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_a1b2c3_watermeterkit_current_usage') }} L/min"
      data:
        priority: high

5. Toilet Spoeling Detectie

Detecteer toilet spoelingen (typisch 6-9 liter snel waterverbruik):

alias: "Water - Toilet spoeling teller"
trigger:
  - platform: numeric_state
    entity_id: sensor.watermeterkit_a1b2c3_watermeterkit_current_usage
    above: 10  # Hoge doorstroomsnelheid
    for:
      seconds: 3
condition:
  - condition: numeric_state
    entity_id: sensor.watermeterkit_a1b2c3_watermeterkit_current_usage
    above: 10
action:
  - service: counter.increment
    target:
      entity_id: counter.toilet_flushes_today

6. Wekelijks Water Budget Waarschuwing

Waarschuwing wanneer je wekelijkse waterbudget nadert:

alias: "Water - Budget waarschuwing"
trigger:
  - platform: numeric_state
    entity_id: sensor.water_weekly  # Utility meter
    above: 0.7  # 0.7 m³ is 700 liter
action:
  - service: notify.mobile_app
    data:
      title: "💧 Water Budget Waarschuwing"
      message: "Je hebt {{ (states('sensor.water_weekly') | float(0) * 1000) | round(0) }} liter verbruikt deze week!"

7. Wasmachine Water Detectie

Detecteer wanneer de wasmachine water gebruikt:

alias: "Water - Wasmachine draait"
trigger:
  - platform: numeric_state
    entity_id: sensor.watermeterkit_a1b2c3_watermeterkit_current_usage
    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:

1. Ga naar Instellingen → Apparaten en diensten → Helpers
2. Klik op Helper aanmaken → Utility Meter
3. Configureer:
   • Naam: Water Daily
   • Input sensor: sensor.watermeterkit_a1b2c3_watermeterkit_total_consumption
   • Meter reset cyclus: Dagelijks
4. Herhaal voor wekelijks en maandelijks

Aanbevolen Dashboard Entiteiten

Water Monitoring:

• sensor.watermeterkit_a1b2c3_watermeterkit_total_consumption: Totaal water
• sensor.watermeterkit_a1b2c3_watermeterkit_current_usage: Huidige doorstroom
• sensor.watermeterkit_a1b2c3_watermeterkit_water_meter_total: Werkelijke meterstand
• sensor.water_daily: Dagelijks verbruik (utility meter)

Omgeving:

• sensor.watermeterkit_a1b2c3_watermeterkit_temperature
• sensor.watermeterkit_a1b2c3_watermeterkit_humidity

Voorbeeld Dashboard Kaart - Water Overzicht

type: entities
title: 💧 Water
entities:
  - entity: sensor.watermeterkit_a1b2c3_watermeterkit_current_usage
    name: Huidige Doorstroom
  - entity: sensor.water_daily
    name: Verbruik Vandaag
  - entity: sensor.watermeterkit_a1b2c3_watermeterkit_water_meter_total
    name: Meterstand
  - entity: sensor.watermeterkit_a1b2c3_watermeterkit_temperature
    name: Temperatuur

Water Doorstroom Gauge

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

Geschiedenis Grafiek - Dagelijks Water Patroon

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

Statistieken Kaart - Verbruik Deze Week

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

Mini Graph Card (vereist custom card)

type: custom:mini-graph-card
entities:
  - entity: sensor.watermeterkit_a1b2c3_watermeterkit_current_usage
name: Water Doorstroom
hours_to_show: 12
points_per_hour: 4
line_color: "#2196F3"

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:

Veelvoorkomende Toepassingen

Integratie Ideeën

Combineer met Andere SmartHomeShop Producten

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:

1. Open de ESPHome Device Builder-app in Home Assistant
2. Je WaterMeterKit zou moeten verschijnen. Klik Adopt
3. Eenmaal geadopteerd kun je de YAML configuratie bewerken

Belangrijke Substitutions

De firmware gebruikt substitutions voor eenvoudige aanpassingen:

substitutions:
  device_name: watermeterkit
  friendly_name: WaterMeterKit

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: -5.5  # Standaard offset, pas aan indien nodig
    humidity:
      filters:
        offset: 12  # Standaard offset, pas aan indien nodig

Hoe te kalibreren:

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

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

Dit haalt automatisch de laatste V3 configuratie op terwijl je hieronder aanpassingen kunt toevoegen. Gebruik het bijpassende watermeterkit-v2 of watermeterkit-v1 package als je oudere hardware hebt.

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:

Hulp Nodig?

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