Sensordefinities
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:
- WaterFlowKit V1: tot 2 stroomsensoren
- WaterFlowKit V2: tot 4 stroomsensoren
Elke aangesloten sensor biedt entiteiten voor stroomsnelheid en totaal volume.
📖 ESPHome Documentatie: Pulse Counter
Stroomsnelheid (L/min)
| Entiteit | ID | Beschrijving | Eenheid |
|---|---|---|---|
| Flow1 Current water usage | water_usage1 (V1: water_usage) |
Realtime stroomsnelheid door sensor 1 | L/min |
| Flow2 Current water usage | water_usage2 (V1: sens2_water_usage) |
Realtime stroomsnelheid door sensor 2 (indien aangesloten) | L/min |
| Flow3 Current water usage | water_usage3 |
Realtime stroomsnelheid door sensor 3 (alleen V2) | L/min |
| Flow4 Current water usage | water_usage4 |
Realtime stroomsnelheid door sensor 4 (alleen V2) | L/min |
Totaal Volume (L)
| Entiteit | ID | Beschrijving | Eenheid |
|---|---|---|---|
| Flow1 Total Consumption | sensor_pulse_meter_total1 (V1: sensor_pulse_meter_total) |
Cumulatief watervolume door sensor 1. Gebruik voor Energy Dashboard. | L |
| Flow2 Total Consumption | sensor_pulse_meter_total2 (V1: sens_2_sensor_pulse_meter_total) |
Cumulatief watervolume door sensor 2. Gebruik voor Energy Dashboard. | L |
| Flow3 Total Consumption | sensor_pulse_meter_total3 |
Cumulatief watervolume door sensor 3. Gebruik voor Energy Dashboard. (alleen V2) | L |
| Flow4 Total Consumption | sensor_pulse_meter_total4 |
Cumulatief watervolume door sensor 4. Gebruik voor Energy Dashboard. (alleen V2) | L |
Hoe Het Werkt
De sensoren gebruiken een turbinemechanisme:
- Water stroomt door de sensor, waardoor een interne turbine draait
- De turbine genereert elektrische pulsen
- Elke puls vertegenwoordigt een specifiek volume water
- De WaterFlowKit telt pulsen en berekent de stroomsnelheid
Sensortype en Kalibratie
De firmware rekent pulsen om naar liters met de instelling Flow1 Sensor Type van elke ingang (standaard YF-B1 / YF-B7). Stem fijn af met Flow1 Calibration % (50-150%, standaard 100). 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 Water Temperature (V1: Flow2 Temperature) | flow2_water_temperature |
Watertemperatuur door stroomsensor 2 | °C |
| Flow3 Water Temperature | flow3_water_temperature |
Watertemperatuur door stroomsensor 3 (alleen V2) | °C |
| Flow4 Water Temperature | flow4_water_temperature |
Watertemperatuur door stroomsensor 4 (alleen V2) | °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: 0°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. |
| Disable BLE after boot | ble_disable_after_boot |
V2 WiFi-firmware. Staat standaard aan: Bluetooth gaat een paar seconden nadat WiFi verbonden is uit, om geheugen te sparen. |
Instellingen
| Entiteit | Beschrijving |
|---|---|
| Flow1 Sensor Type t/m Flow4 Sensor Type | Kiest het sensormodel per ingang. Standaard YF-B1 / YF-B7. Flow3 en Flow4 alleen op V2. |
| Flow1 Calibration % t/m Flow4 Calibration % | Stemt elke ingang fijn af, 50 tot 150%, standaard 100%. Flow3 en Flow4 alleen op V2. |
| Firmware Type | Kiest de firmwarevariant. Zie Netwerk Configuratie. |
Knoppen
| Entiteit | Beschrijving |
|---|---|
| Firmware Update | Installeert de firmwarevariant die bij Firmware Type is gekozen. |
| Factory Reset | Zet het apparaat terug naar fabrieksinstellingen, inclusief WiFi-gegevens en sensorinstellingen. Standaard uitgeschakeld voor veiligheid. |
| Reset Cloud | Alleen cloudfirmware. Wist de cloudregistratie en registreert het apparaat opnieuw. |
Diagnostische Entiteiten
Verbindingsstatus
| Entiteit | ID | Beschrijving |
|---|---|---|
| WiFi Signal | sensor_wifi_signal |
WiFi signaalsterkte in dBm op WiFi-firmware. 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 op WiFi- of Ethernet-firmware |
| Connected SSID | Naam van het WiFi-netwerk op WiFi-firmware |
| Connected BSSID | MAC-adres van het WiFi-toegangspunt op WiFi-firmware |
| MAC Address | Netwerk-MAC-adres van de actieve firmwarevariant |
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. "2.15.0") |
| Hardware Version | text_sensor_hardware_version |
De hardwareversie van je kit (V1 of V2) |
Systeem
| Entiteit | Beschrijving |
|---|---|
| CPU Temperature | Interne chiptemperatuur. |
| Firmware | Update-entiteit. Toont beschikbare firmware updates. |
| Device Info / Reset Reason | Technische details voor support. V2 lokale firmware. |
| Cloud Connected, Cloud Status, Cloud Device ID, Cloud Sync Failures | Verbinding met de SmartHomeShop-app. Alleen cloudfirmware. |
LED Indicatoren
De WaterFlowKit heeft 3 LED-kleuren:
| LED | Kleur | Standaard Gedrag |
|---|---|---|
| LED Green | Groen | Niet gebruikt door de standaard firmware |
| LED Red | Rood | Status LED: uit als alles goed is, langzaam knipperend als er geen verbinding is, snel knipperend bij een firmwarefout. Op V2-cloudfirmware knippert hij alleen als het apparaat offline is |
| LED Blue | Blauw | Korte flits na elke geslaagde synchronisatie op cloudfirmware |
Entiteit Naamgevingsconventie
Alle entiteiten volgen dit naampatroon:
sensor.waterflowkit_a1b2c3_[sensor_name]
switch.waterflowkit_a1b2c3_[switch_name]
a1b2c3 staat voor de laatste zes tekens van het MAC-adres van je apparaat. Kopieer het exacte ID altijd van de entiteit in Home Assistant.
Bijvoorbeeld:
sensor.waterflowkit_a1b2c3_flow1_current_water_usagesensor.waterflowkit_a1b2c3_flow1_total_consumptionsensor.waterflowkit_a1b2c3_flow1_water_temperaturesensor.waterflowkit_a1b2c3_temperaturesensor.waterflowkit_a1b2c3_humidity
Kalibratie
Als je sensormetingen niet overeenkomen met verwachte waarden, kies dan het juiste sensortype en pas het kalibratiepercentage aan in Home Assistant.
Elke ingang heeft een eigen Sensor Type selector en Calibration % instelling: Flow1 en Flow2 op V1, Flow1 t/m Flow4 op V2.
🔧 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