Sensor Definities

Deze pagina geeft gedetailleerde uitleg over alle sensoren, besturingselementen en entiteiten die beschikbaar zijn op de WaterFlowKit. Gebruik dit als referentie om te begrijpen wat elke waarde betekent en hoe je deze kunt gebruiken.

Broncode: Bekijk de volledige ESPHome configuratie op GitHub

Snelle Navigatie

• Waterstroomsensoren
• Watertemperatuursensoren
• Omgevingssensoren
• Apparaatbesturing
• Diagnostische Entiteiten
• LED Indicatoren

---

Waterstroomsensoren

De WaterFlowKit ondersteunt tot 2 stroomsensoren. Elke sensor biedt stroomsnelheid en totaal volume entiteiten.

📖 ESPHome Documentatie: Pulse Counter

Stroomsnelheid (L/min)

Entiteit	ID	Beschrijving	Eenheid
Flow1 Current water usage	water_usage	Realtime stroomsnelheid door sensor 1	L/min
Flow2 Current water usage	sens2_water_usage	Realtime stroomsnelheid door sensor 2 (indien aangesloten)	L/min

Totaal Volume (L)

Entiteit	ID	Beschrijving	Eenheid
Flow1 Total Consumption	sensor_pulse_meter_total	Cumulatief watervolume door sensor 1. Gebruik voor Energy Dashboard.	L
Flow2 Total Consumption	sens_2_sensor_pulse_meter_total	Cumulatief watervolume door sensor 2. Gebruik voor Energy Dashboard.	L

Hoe Het Werkt

De sensoren gebruiken een turbinemechanisme:

1. Water stroomt door de sensor, waardoor een interne turbine draait
2. De turbine genereert elektrische pulsen
3. Elke puls vertegenwoordigt een specifiek volume water
4. De WaterFlowKit telt pulsen en berekent de stroomsnelheid

Standaard Vermenigvuldigingswaarden

De standaard firmware gebruikt deze vermenigvuldigingswaarden:

filters:
  - multiply: 0.00172  # Voor huidige stroomsnelheid (L/min)

total:
  filters:
    - multiply: 0.00163  # Voor totaal verbruik (L)

Deze standaardwaarden zijn gekalibreerd voor algemeen gebruik. Voor nauwkeurige metingen, kalibreer op basis van je specifieke sensormodel. Zie Gebruiksgids — Kalibratie.

Pulsformules per Sensormodel

Sensor	Formule	Ca. Pulsen/Liter	Berekende Multiply Waarde
YF-B1, YF-B7	F ≈ 11 × Q	~660 pulsen/L	0.00151515
YF-B5, YF-B6	F ≈ 6.6 × Q	~396 pulsen/L	0.00252525
YF-B10	F ≈ 7.5 × Q – 3	~450 pulsen/L	0.00222222
YF-DN40-S	F ≈ 0.45 × Q	~27 pulsen/L	0.03703704
YF-DN50-S	F ≈ 0.20 × Q	~12 pulsen/L	0.08333333

F = frequentie (Hz), Q = stroomsnelheid (L/min)

---

Watertemperatuursensoren

Alleen beschikbaar op YF-B7 en YF-B6 sensormodellen.

📖 ESPHome Documentatie: NTC Sensor

Entiteit	ID	Beschrijving	Eenheid
Flow1 Water Temperature	flow1_water_temperature	Watertemperatuur door stroomsensor 1	°C
Flow2 Temperature	flow2_water_temperature	Watertemperatuur door stroomsensor 2	°C

Technische Details

De temperatuursensoren zijn NTC thermistors geïntegreerd in de stroomsensoren:

sensor:
  - platform: ntc
    id: flow1_water_temperature
    sensor: resistance_sensor
    calibration:
      b_constant: 3950
      reference_temperature: 25°C
      reference_resistance: 50kOhm
    name: Flow1 Water Temperature

Specificaties

• Bereik: -20°C tot +80°C
• Nauwkeurigheid: ±0.5°C
• Sensortype: NTC thermistor (50kOhm @ 25°C, B=3950)

Toepassingen

• Monitor warmwatersysteem efficiëntie
• Detecteer problemen met waterverwarmer
• Volg zonneboiler prestaties
• Verifieer warm/koud water menging
• Warmtepomp monitoring (aanvoer/retour temperaturen)

---

Omgevingssensoren

De WaterFlowKit bevat een HDC1080 sensor voor omgevingstemperatuur en luchtvochtigheid monitoring.

📖 ESPHome Documentatie: HDC1080

Entiteit	ID	Beschrijving	Eenheid
Temperature	sensor_temperature	Omgevingstemperatuur rond de WaterFlowKit	°C
Humidity	sensor_humidity	Relatieve luchtvochtigheid	%

Technische Details

sensor:
  - platform: hdc1080
    temperature:
      name: "Temperature"
      filters:
        offset: -4.5
    humidity:
      name: "Humidity"
      filters:
        offset: 12
    update_interval: 60s

Standaard Offsets

De firmware past standaard kalibratie-offsets toe:

• Temperatuur: -4.5°C offset
• Luchtvochtigheid: +12% offset

Deze kunnen worden aangepast als je metingen niet overeenkomen met een referentie.

Toepassingen

• Monitor omstandigheden in meterkast
• Detecteer vochtproblemen
• Volg omgeving waar leidingen zich bevinden

---

Apparaatbesturing

Schakelaars

Entiteit	ID	Beschrijving
Restart	switch_restart	Herstart de WaterFlowKit. Handig na configuratiewijzigingen.

---

Diagnostische Entiteiten

Verbindingsstatus

Entiteit	ID	Beschrijving
WiFi Signal	sensor_wifi_signal	WiFi signaalsterkte in dBm. Update elke 5 minuten. Waarden dichter bij 0 = beter signaal.
Uptime	sensor_uptime_timestamp	Tijdstempel wanneer het apparaat voor het laatst is gestart.

Netwerkinformatie

Entiteit	Beschrijving
IP address	Huidig IP-adres van de WaterFlowKit
Connected SSID	Naam van het WiFi-netwerk
Connected BSSID	MAC-adres van het WiFi-toegangspunt

Versie-informatie

Entiteit	ID	Beschrijving
ESPHome Version	text_sensor_version	De ESPHome versie die op het apparaat draait
Software Version	text_sensor_waterflowkit_version	WaterFlowKit firmware versie (bijv. "2025.11")

---

LED Indicatoren

De WaterFlowKit heeft 3 LEDs (configureerbaar via ESPHome):

LED	ID	Kleur	Standaard Gedrag
LED Green	light_led_green	Groen	Beschikbaar voor aangepast gebruik
LED Red	light_led_red	Rood	Status LED (knipperend = niet verbonden)
LED Blue	light_led_blue	Blauw	Beschikbaar voor aangepast gebruik

LED Configuratie in ESPHome

output:
  - platform: ledc
    pin: GPIO16
    id: output_led_green
  - platform: ledc
    pin: GPIO17
    id: output_led_red
  - platform: ledc
    pin: GPIO04
    id: output_led_blue

light:
  - platform: monochromatic
    id: light_led_green
    output: output_led_green
  - platform: status_led
    id: light_led_red
    output: output_led_red
  - platform: monochromatic
    id: light_led_blue
    output: output_led_blue

---

Entiteit Naamgevingsconventie

Alle entiteiten volgen dit naampatroon:

sensor.waterflowkit_[sensor_name]
switch.waterflowkit_[switch_name]
light.waterflowkit_[light_name]

Bijvoorbeeld:

• sensor.waterflowkit_flow1_current_water_usage
• sensor.waterflowkit_flow1_total_consumption
• sensor.waterflowkit_flow1_water_temperature
• sensor.waterflowkit_temperature
• sensor.waterflowkit_humidity

---

Kalibratie

Als je sensormetingen niet overeenkomen met verwachte waarden, kun je kalibreren door de multiply filterwaarden aan te passen.

🔧 Kalibratiegids: Zie Gebruiksgids — Kalibratie voor stapsgewijze instructies.

---

ESPHome Configuratie

Voor gevorderde gebruikers die de WaterFlowKit firmware willen aanpassen:

🔧 Geavanceerde Configuratie: Zie Gebruiksgids — ESPHome Configuratie voor details.

---

Hulp Nodig?

• Gebruiksgids — Monitoring & automatiseringen
• Probleemoplossing — Veelvoorkomende problemen
• FAQ — Veelgestelde vragen
• Discord — Community support