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

Watertemperatuur Entiteiten (indien van toepassing)

Omgevingssensor Entiteiten

Real-Time Monitoring

1. Open Home Assistant en navigeer naar Instellingen
2. Ga naar Apparaten en diensten → ESPHome
3. Selecteer je WaterFlowKit apparaat
4. Bekijk alle entiteiten: stroomsnelheid, totaal volume, temperatuur (indien van toepassing)

Ongebruikte Entiteiten Uitschakelen

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

1. Ga naar je WaterFlowKit apparaat
2. Klik op de ongebruikte entiteit
3. Zet Ingeschakeld op uit

Home Assistant Energy Dashboard

Voeg waterverbruik toe aan het Energy Dashboard voor mooie visualisaties.

Waterverbruik Toevoegen

1. Ga naar Instellingen → Dashboards → Energie
2. Onder Waterverbruik, klik Waterbron toevoegen
3. Selecteer je entiteit:
   • Flow1 Total Consumption
   • Flow2 Total Consumption
   • Flow3 Total Consumption (V2)
   • Flow4 Total Consumption (V2)
4. 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: Kies Je Sensortype

Begin hier. Elke ingang heeft een instelling Flow1 Sensor Type in Home Assistant (Flow1 en Flow2 op V1, Flow1 t/m Flow4 op V2). De standaardwaarde is YF-B1 / YF-B7, dus met elke andere sensor kloppen de metingen niet totdat je het juiste type kiest:

1. Open je WaterFlowKit apparaat in Home Assistant
2. Zet onder Configuratie de instelling Flow1 Sensor Type op je sensormodel
3. Herhaal dit voor elke ingang die je gebruikt

Methode 2: Meet Bekend Volume

1. Pak een container met bekend volume (bijv. 10L emmer)
2. Noteer de huidige waarde van Flow1 Total Consumption
3. Vul de container via de gemonitorde leiding
4. Vergelijk de toename van het totaal met het daadwerkelijke volume
5. Zet Flow1 Calibration % onder Configuratie op het huidige percentage × daadwerkelijk volume / gemeten toename. Het bereik is 50 tot 150%, standaard 100%.

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. Hoge Stroom Alert

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

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

2. Langdurige Stroom Detectie (Lekkage Waarschuwing)

Detecteer water dat langdurig loopt:

alias: "Water - Langdurige stroom waarschuwing"
trigger:
  - platform: numeric_state
    entity_id: sensor.waterflowkit_a1b2c3_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:

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:

alias: "Douche - Timer notificatie"
trigger:
  - platform: numeric_state
    entity_id: sensor.waterflowkit_a1b2c3_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):

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

6. Stroom Gestart/Gestopt Events

Start automatiseringen wanneer water begint of stopt met stromen:

alias: "Water - Stroom gestart"
trigger:
  - platform: numeric_state
    entity_id: sensor.waterflowkit_a1b2c3_flow1_current_water_usage
    above: 0.5
action:
  # Voeg hier je acties toe
  - service: logbook.log
    data:
      name: "Water Flow"
      message: "Gestart"

Dashboard Ideeen

Utility Meters Aanmaken

Volg dagelijks, wekelijks en maandelijks waterverbruik:

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

Aanbevolen Dashboard Entiteiten

Stroom Monitoring:

• sensor.waterflowkit_a1b2c3_flow1_current_water_usage: Huidige stroomsnelheid
• sensor.waterflowkit_a1b2c3_flow1_total_consumption: Totaal volume
• sensor.waterflowkit_a1b2c3_flow1_water_temperature: Watertemperatuur (indien YF-B7/B6)

Omgevings Monitoring:

• sensor.waterflowkit_a1b2c3_temperature: Omgevingstemperatuur
• sensor.waterflowkit_a1b2c3_humidity: Luchtvochtigheid

Voorbeeld Dashboard Kaart - Water Overzicht

type: entities
title: Water Monitoring
entities:
  - entity: sensor.waterflowkit_a1b2c3_flow1_current_water_usage
    name: Huidige Stroom
  - entity: sensor.waterflowkit_a1b2c3_flow1_total_consumption
    name: Totaal Volume
  - entity: sensor.waterflowkit_a1b2c3_flow1_water_temperature
    name: Watertemperatuur
  - entity: sensor.waterflowkit_a1b2c3_temperature
    name: Omgevingstemperatuur
  - entity: sensor.waterflowkit_a1b2c3_humidity
    name: Luchtvochtigheid

Stroomsnelheid Gauge Kaart

type: gauge
entity: sensor.waterflowkit_a1b2c3_flow1_current_water_usage
name: Water Stroom
min: 0
max: 30
severity:
  green: 0
  yellow: 10
  red: 20
unit: L/min

Geschiedenis Grafiek - Dagelijks Patroon

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

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

Meerdere Sensoren

Gebruik je meerdere sensoren? Denk aan:

• Warm en koud water
• Water in en water uit (lekdetectie)
• Voor en na een filter (filterefficiëntie)

ESPHome Configuratie

Voor gevorderde gebruikers die de WaterFlowKit firmware willen aanpassen.

Adopteren in ESPHome

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

GitHub Packages Gebruiken

Importeer direct van GitHub:

packages:
  smarthomeshop.waterflowkit: 
    github://smarthomeshop/waterflowkit/waterflowkit-v2/waterflowkit-wifi.yaml@main

Broncode

• GitHub Repository: smarthomeshop/waterflowkit

Veelvoorkomende Toepassingen

Integratie Ideeën

Combineer met Andere SmartHomeShop Producten

Hulp Nodig?

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