Gebruikshandleiding

Deze handleiding behandelt praktische manieren om je WaterFlowKit te gebruiken in Home Assistant, inclusief monitoring, kalibratie, automatiseringsvoorbeelden en dashboard tips.

Quick Start

Na installatie biedt je WaterFlowKit deze belangrijke entiteiten:

Stroomsensor Entiteiten

Entiteit	Gebruik Voor
Flow1 Current water usage	Real-time stroomsnelheid (L/min)
Flow1 Total Consumption	Cumulatief volume — gebruik voor Energy Dashboard
Flow2 Current water usage	Real-time stroomsnelheid sensor 2 (indien aangesloten)
Flow2 Total Consumption	Cumulatief volume sensor 2 — gebruik voor Energy Dashboard

Watertemperatuur Entiteiten (indien van toepassing)

Entiteit	Gebruik Voor
Flow1 Water Temperature	Watertemperatuur door sensor 1 (°C)
Flow2 Temperature	Watertemperatuur door sensor 2 (°C)

Omgevingssensor Entiteiten

Entiteit	Gebruik Voor
Temperature	Omgevingstemperatuur rond de WaterFlowKit (°C)
Humidity	Relatieve luchtvochtigheid (%)

Real-Time Monitoring

Open Home Assistant en navigeer naar Instellingen
Ga naar Apparaten & Diensten → ESPHome
Selecteer je WaterFlowKit apparaat
Bekijk alle entiteiten: stroomsnelheid, totaal volume, temperatuur (indien van toepassing)

Ongebruikte Entiteiten Uitschakelen

Als je slechts één sensor gebruikt of geen temperatuursensor hebt:

Ga naar je WaterFlowKit apparaat
Klik op de ongebruikte entiteit
Zet Ingeschakeld op uit

Home Assistant Energy Dashboard

Voeg waterverbruik toe aan het Energy Dashboard voor mooie visualisaties.

Waterverbruik Toevoegen

Ga naar Instellingen → Dashboards → Energie
Onder Waterverbruik, klik Waterbron toevoegen
Selecteer je entiteit:
- Flow1 Total Consumption of
- Flow2 Total Consumption
Klik Opslaan

Let op: Gebruik de Total Consumption entiteiten (cumulatief volume), niet de stroomsnelheid entiteiten.

Kalibratie

Als je sensormetingen niet overeenkomen met verwachte waarden, kun je kalibreren.

Methode 1: Meet Bekend Volume

Pak een container met bekend volume (bijv. 10L emmer)
Reset het sensor totaal in Home Assistant
Vul de container via de gemonitorde leiding
Vergelijk de sensormeting met daadwerkelijk volume

Bereken correctiefactor:

Correctie = Daadwerkelijk Volume / Sensormeting

Methode 2: Pas Pulsen Per Liter Aan in ESPHome

Adopteer de WaterFlowKit in ESPHome
Vind de pulse counter configuratie:

yaml

sensor:
  - platform: pulse_counter
    pin:
      number: GPIO26
      mode:
        input: true
        pullup: true
    name: "Flow1 Current water usage"
    filters:
      - multiply: 0.00172  # Pas aan voor stroomsnelheid (L/min)
    total:
      name: "Flow1 Total Consumption"
      unit_of_measurement: "L"
      filters:
        - multiply: 0.00163  # Pas aan voor totaal volume (L)

Pas de multiply filter aan:
- Meting te hoog? Verlaag de waarde
- Meting te laag? Verhoog de waarde
Opslaan en installeren

Standaard vs Sensor-Specifieke Waarden

De firmware wordt geleverd met standaardwaarden die werken voor de meeste sensoren:

Filter	Standaard Waarde	Beschrijving
Stroomsnelheid	0.00172	Voor L/min berekening
Totaal volume	0.00163	Voor L berekening

Voor meer precisie, gebruik sensor-specifieke waarden:

Sensor	Multiply Waarde	Pulsen/Liter
YF-B1, YF-B7	0.00151515	~660
YF-B5, YF-B6	0.00252525	~396
YF-B10	0.00222222	~450
YF-DN40-S	0.03703704	~27
YF-DN50-S	0.08333333	~12

Automatisering Voorbeelden

1. Hoge Stroom Alert

Waarschuw wanneer stroomsnelheid ongewoon hoog is (mogelijke lekkage of open kraan):

yaml

alias: "Water - Hoge stroom alert"
trigger:
  - platform: numeric_state
    entity_id: sensor.waterflowkit_flow1_current_water_usage
    above: 15
    for:
      minutes: 5
action:
  - service: notify.mobile_app
    data:
      title: "Hoge Waterstroom!"
      message: "Stroomsnelheid: {{ states('sensor.waterflowkit_flow1_current_water_usage') }} L/min voor 5+ minuten"

2. Langdurige Stroom Detectie (Lekkage Waarschuwing)

Detecteer water dat langdurig loopt:

yaml

alias: "Water - Langdurige stroom waarschuwing"
trigger:
  - platform: numeric_state
    entity_id: sensor.waterflowkit_flow1_current_water_usage
    above: 0.5
    for:
      minutes: 30
action:
  - service: notify.mobile_app
    data:
      title: "Water Loopt!"
      message: "Water loopt al 30+ minuten. Controleer op open kranen of lekkages."

3. Dagelijks Waterverbruik Rapport

Stuur een notificatie met 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: "Verbruik vandaag: {{ states('sensor.water_daily') }} L"

4. Douche Timer

Volg doucheduur op basis van stroom:

yaml

alias: "Douche - Timer notificatie"
trigger:
  - platform: numeric_state
    entity_id: sensor.waterflowkit_flow1_current_water_usage
    below: 1
condition:
  - condition: state
    entity_id: input_boolean.douche_bezig
    state: "on"
action:
  - service: input_boolean.turn_off
    target:
      entity_id: input_boolean.douche_bezig
  - service: notify.mobile_app
    data:
      title: "Douche Klaar"
      message: "Duur: {{ (as_timestamp(now()) - as_timestamp(states.input_boolean.douche_bezig.last_changed)) | int // 60 }} minuten"

5. Warmwater Temperatuur Alert

Waarschuw als warmwater niet warm genoeg is (vereist YF-B7 of YF-B6 sensor):

yaml

alias: "Warmwater - Temperatuur alert"
trigger:
  - platform: numeric_state
    entity_id: sensor.waterflowkit_flow1_water_temperature
    below: 45
condition:
  - condition: numeric_state
    entity_id: sensor.waterflowkit_flow1_current_water_usage
    above: 2
action:
  - service: notify.mobile_app
    data:
      title: "Warmwater Probleem"
      message: "Watertemperatuur is slechts {{ states('sensor.waterflowkit_flow1_water_temperature') }}°C"

Dashboard Ideeen

Utility Meters Aanmaken

Volg dagelijks, wekelijks en maandelijks waterverbruik:

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

Aanbevolen Dashboard Entiteiten

Stroom Monitoring:

sensor.waterflowkit_flow1_current_water_usage — Huidige stroomsnelheid
sensor.waterflowkit_flow1_total_consumption — Totaal volume
sensor.waterflowkit_flow1_water_temperature — Watertemperatuur (indien YF-B7/B6)

Omgevings Monitoring:

sensor.waterflowkit_temperature — Omgevingstemperatuur
sensor.waterflowkit_humidity — Luchtvochtigheid

Voorbeeld Dashboard Kaart - Water Overzicht

yaml

type: entities
title: Water Monitoring
entities:
  - entity: sensor.waterflowkit_flow1_current_water_usage
    name: Huidige Stroom
  - entity: sensor.waterflowkit_flow1_total_consumption
    name: Totaal Volume
  - entity: sensor.waterflowkit_flow1_water_temperature
    name: Watertemperatuur
  - entity: sensor.waterflowkit_temperature
    name: Omgevingstemperatuur
  - entity: sensor.waterflowkit_humidity
    name: Luchtvochtigheid

Best Practices

Installatie Tips

Gebruik schroefdraadtape (PTFE) op alle schroefdraadverbindingen
Test onder druk voor definitieve installatie
Vermijd installatie waar luchtbellen kunnen ophopen
Installeer op een toegankelijke locatie voor onderhoud

Nauwkeurigheid Tips

Zorg dat stroom binnen het opgegeven bereik van de sensor is
Vermijd zeer lage stroomsnelheden (onder minimum specificatie)
Kalibreer na installatie voor beste nauwkeurigheid
Positioneer sensor indien mogelijk in een recht leidingdeel

ESPHome Configuratie

Voor gevorderde gebruikers die de WaterFlowKit firmware willen aanpassen.

Adopteren in ESPHome

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

GitHub Packages Gebruiken

Importeer direct van GitHub:

yaml

packages:
  smarthomeshop.waterflowkit: 
    github://smarthomeshop/waterflowkit/waterflowkit.yaml@main

Broncode

GitHub Repository: smarthomeshop/waterflowkit

Hulp Nodig?

Installatie Handleiding — Setup instructies
Sensor Definities — Alle entiteiten uitgelegd
Probleemoplossing — Veelvoorkomende problemen
FAQ — Veelgestelde vragen
Discord — Community ondersteuning

Gebruikshandleiding ​

Quick Start ​

Stroomsensor Entiteiten ​

Watertemperatuur Entiteiten (indien van toepassing) ​

Omgevingssensor Entiteiten ​

Real-Time Monitoring ​

Ongebruikte Entiteiten Uitschakelen ​

Home Assistant Energy Dashboard ​

Waterverbruik Toevoegen ​

Kalibratie ​

Methode 1: Meet Bekend Volume ​

Methode 2: Pas Pulsen Per Liter Aan in ESPHome ​

Standaard vs Sensor-Specifieke Waarden ​

Automatisering Voorbeelden ​

1. Hoge Stroom Alert ​

2. Langdurige Stroom Detectie (Lekkage Waarschuwing) ​

3. Dagelijks Waterverbruik Rapport ​

4. Douche Timer ​

5. Warmwater Temperatuur Alert ​

Dashboard Ideeen ​

Utility Meters Aanmaken ​

Aanbevolen Dashboard Entiteiten ​

Voorbeeld Dashboard Kaart - Water Overzicht ​

Best Practices ​

Installatie Tips ​

Nauwkeurigheid Tips ​

ESPHome Configuratie ​

Adopteren in ESPHome ​

GitHub Packages Gebruiken ​

Broncode ​

Hulp Nodig? ​

Gebruikshandleiding

Quick Start

Stroomsensor Entiteiten

Watertemperatuur Entiteiten (indien van toepassing)

Omgevingssensor Entiteiten

Real-Time Monitoring

Ongebruikte Entiteiten Uitschakelen

Home Assistant Energy Dashboard

Waterverbruik Toevoegen

Kalibratie

Methode 1: Meet Bekend Volume

Methode 2: Pas Pulsen Per Liter Aan in ESPHome

Standaard vs Sensor-Specifieke Waarden

Automatisering Voorbeelden

1. Hoge Stroom Alert

2. Langdurige Stroom Detectie (Lekkage Waarschuwing)

3. Dagelijks Waterverbruik Rapport

4. Douche Timer

5. Warmwater Temperatuur Alert

Dashboard Ideeen

Utility Meters Aanmaken

Aanbevolen Dashboard Entiteiten

Voorbeeld Dashboard Kaart - Water Overzicht

Best Practices

Installatie Tips

Nauwkeurigheid Tips

ESPHome Configuratie

Adopteren in ESPHome

GitHub Packages Gebruiken

Broncode

Hulp Nodig?