Sensor Definities

Deze pagina biedt gedetailleerde uitleg over alle sensoren, bedieningselementen en entiteiten die beschikbaar zijn op de WaterP1MeterKit. 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

Water Monitoring

De WaterP1MeterKit gebruikt een pulse meter om waterstroming te detecteren via een magnetische sensor die het roterende metalen plaatje in je watermeter detecteert.

📖 ESPHome Documentatie: Pulse Meter Sensor

Water Sensoren

Entiteit	Beschrijving	Eenheid
Water Current Usage	Huidige waterstroomsnelheid. Toont real-time waterverbruik wanneer kraan loopt.	L/min
Water Total Consumption	Totaal water verbruikt sinds apparaat opstart. Gebruik dit voor Energy Dashboard — Home Assistant houdt historie bij zelfs na herstarts.	m³

Hoe Het Werkt

Detectie: De sensor detecteert het roterende metalen plaatje in je watermeter
Pulse tellen: Elke rotatie = 1 liter water
Doorstroom berekening: De sensor berekent doorstroomsnelheid gebaseerd op pulse frequentie
LED feedback: Groene LED knippert één keer per gedetecteerde liter

Belangrijke Opmerkingen

De Water Total Consumption entiteit reset naar 0 na een apparaat herstart, maar dit is prima voor het Energy Dashboard — Home Assistant houdt het totaal bij over tijd
Gebruik Water Total Consumption (niet Water Meter Total) voor het Energy Dashboard
De sensor heeft een 200ms interne filter om valse pulses te filteren
Timeout is ingesteld op 2 minuten — doorstroomsnelheid keert terug naar 0 als geen pulse gedetecteerd wordt binnen deze tijd

Energie Monitoring (P1/DSMR)

De WaterP1MeterKit leest data van je slimme energiemeter via de P1 poort met het DSMR (Dutch Smart Meter Requirements) protocol.

📖 ESPHome Documentatie: DSMR Component

Energie Verbruik

Entiteit	Beschrijving	Eenheid
Energy Consumed Tariff 1	Totale energie verbruikt tijdens laag tarief (meestal nacht/weekend). Gebruik voor Energy Dashboard.	kWh
Energy Consumed Tariff 2	Totale energie verbruikt tijdens hoog tarief (meestal overdag). Gebruik voor Energy Dashboard.	kWh
Power Consumed	Huidig totaal vermogen dat verbruikt wordt. Real-time stroomverbruik.	W

Energie Productie (Zonnepanelen)

Entiteit	Beschrijving	Eenheid
Energy Produced Tariff 1	Totale energie teruggeleverd aan net tijdens laag tarief. Gebruik voor Energy Dashboard.	kWh
Energy Produced Tariff 2	Totale energie teruggeleverd aan net tijdens hoog tarief. Gebruik voor Energy Dashboard.	kWh
Power Produced	Huidig vermogen dat teruggeleverd wordt aan net. Real-time zonne-energie/batterij export.	W

Spanning Monitoring

Entiteit	Beschrijving	Eenheid
Voltage Phase 1	Huidige spanning op fase L1. Normaal bereik: 220-240V.	V
Voltage Phase 2	Huidige spanning op fase L2 (alleen 3-fase).	V
Voltage Phase 3	Huidige spanning op fase L3 (alleen 3-fase).	V

Stroom Monitoring

Entiteit	Beschrijving	Eenheid
Current Phase 1	Huidige amperage op fase L1.	A
Current Phase 2	Huidige amperage op fase L2 (alleen 3-fase).	A
Current Phase 3	Huidige amperage op fase L3 (alleen 3-fase).	A

Per-Fase Vermogen

Entiteit	Beschrijving	Eenheid
Power Consumed Phase 1/2/3	Stroomverbruik per individuele fase. Handig voor load balancing.	W
Power Produced Phase 1/2/3	Stroomproductie (teruglevering) per individuele fase.	W

Elektriciteitskwaliteit (Geavanceerd)

Deze sensoren helpen de kwaliteit van je elektriciteitsvoorziening te monitoren:

Entiteit	Beschrijving
Electricity Failures	Totaal aantal stroomstoringen geregistreerd door de meter.
Electricity Long Failures	Totaal aantal lange (>3 min) stroomstoringen.
Voltage Sags Phase 1/2/3	Aantal spanningsdips (brownouts) per fase.
Voltage Swells Phase 1/2/3	Aantal spanningspieken per fase.

Tarief Informatie

Entiteit	Beschrijving
Electricity Tariff	Huidig actief tarief (1 = laag/nacht, 2 = hoog/dag). Handig voor automatiseringen om apparaten te draaien tijdens goedkope uren.

België-Specifieke Sensoren

Deze sensoren zijn standaard uitgeschakeld maar kunnen ingeschakeld worden voor Belgische meters:

Entiteit	Beschrijving
Gas Consumed Belgium	Gasverbruik voor Belgische meters (ander protocol).
Current Average Demand	Actieve energie import gemiddelde vraag.
Maximum Demand Current Month	Piekvraag deze maand (voor capaciteitstarief).
Maximum Demand Last 13 Months	Piekvraag over laatste 13 maanden.

Luxemburg-Specifieke Sensoren

Entiteit	Beschrijving
Energy Consumed Luxembourg	Energieverbruik voor Luxemburgse meters.
Energy Produced Luxembourg	Energieproductie voor Luxemburgse meters.

Gas Monitoring

Gasverbruik wordt gelezen via de P1 poort van de gasmeter die is aangesloten op je slimme meter.

Entiteit	Beschrijving	Eenheid
Gas Consumed	Totaal gasverbruik. Wordt ongeveer elk uur bijgewerkt door de meeste meters. Gebruik voor Energy Dashboard.	m³

Gas MBus Configuratie

De gasmeter communiceert via MBus protocol. Standaard is MBus ID ingesteld op 1. Als je gasmeter geen data toont, moet je dit mogelijk wijzigen naar 2, 3, of 4.

⚠️ Gas toont niet? Zie Gebruikshandleiding — Gas MBus Configuratie voor stap-voor-stap instructies om het MBus ID te wijzigen.

Omgevingssensoren

De WaterP1MeterKit bevat een HDC1080 temperatuur- en vochtigheidssensor voor het monitoren van de omgeving op de apparaatlocatie.

📖 ESPHome Documentatie: HDC1080 Sensor

Entiteit	Beschrijving	Eenheid
Temperature	Temperatuur op de apparaatlocatie. Voorgekalibreerd met -4.5°C offset.	°C
Humidity	Relatieve luchtvochtigheid op de apparaatlocatie. Voorgekalibreerd met +12% offset.	%

Toepassingen

Monitor temperatuur in je meterkast
Detecteer vochtigheidsproblemen (mogelijke vochtproblemen)
Stel waarschuwingen in voor extreme temperaturen (vorstbeveiliging)

Waterlek Sensor (Alleen V3)

De WaterP1MeterKit V3 bevat een uitbreidingspoort voor een optionele waterlek sensor.

Entiteit	Beschrijving	Staten
Water Leak Sensor	Detecteert aanwezigheid van water op de sensorlocatie.	`on` = water gedetecteerd, `off` = droog

Eigenschappen

Gedebounced detectie: 100ms vertraging voor on triggeren, 2s vertraging voor terugkeren naar off
Device class: moisture — integreert met Home Assistant's waterlek kaarten en automatiseringen
GPIO: Aangesloten op GPIO2 met interne pull-up weerstand

💡 Automatisering voorbeelden: Zie Gebruikshandleiding — Waterlek Automatiseringen voor waarschuwing en afsluitklep automatiseringen.

Apparaat Bediening

Schakelaars

Entiteit	Beschrijving
Restart	Herstart de WaterP1MeterKit. Handig na configuratiewijzigingen of als het apparaat niet reageert.

Knoppen

Entiteit	Beschrijving
Factory Reset	Reset het apparaat naar fabrieksinstellingen. Waarschuwing: Dit verwijdert alle configuratie inclusief WiFi inloggegevens. Standaard uitgeschakeld voor veiligheid.

Selectoren

Entiteit	Beschrijving	Opties
Firmware Type	Selecteert welke firmware variant te gebruiken voor OTA updates.	`WiFi`, `Ethernet`

Hoe Firmware Type Werkt

De Firmware Type selector bepaalt welke firmware het apparaat downloadt tijdens OTA updates:

WiFi (standaard): Downloadt WiFi firmware van smarthomeshop.github.io/waterp1meterkit/waterp1meterkit-vX-wifi-manifest.json
Ethernet: Downloadt Ethernet firmware van smarthomeshop.github.io/waterp1meterkit/waterp1meterkit-vX-ethernet-manifest.json

⚠️ Belangrijk: Wisselen van WiFi naar Ethernet via deze selector vereist een actieve Ethernet kabel aangesloten. WiFi stopt direct wanneer Ethernet firmware is geïnstalleerd!

Diagnostische Entiteiten

Versie Informatie

Entiteit	Beschrijving
ESPHome Version	De ESPHome versie die draait op het apparaat.
Software Version	De WaterP1MeterKit firmware versie (bijv. "1.4").
Hardware Version	De hardware versie (V1, V2, of V3).

P1 Meter Informatie

Entiteit	Beschrijving
Identification	De identificatiestring van je slimme meter.
Version	De DSMR/ESMR protocol versie van je meter.
Gas Equipment ID	Het serienummer van je gasmeter (indien aangesloten).

Firmware Update

Entiteit	Beschrijving
Firmware Update	Toont beschikbare firmware updates. Installeer direct vanuit Home Assistant.

LED Indicatoren

De WaterP1MeterKit heeft drie LED indicatoren:

LED	Gedrag	Betekenis
Groen	Knippert 1 seconde	Water pulse gedetecteerd (1 liter)
Rood	Vast/knipperend	Status LED — knipperen geeft aan niet verbonden met WiFi/Home Assistant
Blauw/Wit	Vast	Apparaat is ingeschakeld

Entiteit Naamgeving Conventie

Alle entiteiten volgen dit naampatroon:

sensor.waterp1meterkit_[sensor_naam]
binary_sensor.waterp1meterkit_[sensor_naam]
switch.waterp1meterkit_[schakelaar_naam]
select.waterp1meterkit_[selector_naam]
button.waterp1meterkit_[knop_naam]

Als je meerdere WaterP1MeterKits hebt, zorgt het MAC-adres achtervoegsel voor unieke entiteit IDs.

ESPHome Configuratie

Voor gevorderde gebruikers die hun WaterP1MeterKit firmware willen aanpassen:

🔧 Geavanceerde Configuratie: Zie Gebruikshandleiding — ESPHome Configuratie voor substitutions, sensor kalibratie en aanpassingsmogelijkheden.

Hulp Nodig?

Gebruikshandleiding — Automatiseringen en dashboard voorbeelden
Probleemoplossing — Veelvoorkomende problemen
FAQ — Veelgestelde vragen
Discord — Community ondersteuning

Sensor Definities ​

Snelle Navigatie ​

Water Monitoring ​

Water Sensoren ​

Hoe Het Werkt ​

Belangrijke Opmerkingen ​

Energie Monitoring (P1/DSMR) ​

Energie Verbruik ​

Energie Productie (Zonnepanelen) ​

Spanning Monitoring ​

Stroom Monitoring ​

Per-Fase Vermogen ​

Elektriciteitskwaliteit (Geavanceerd) ​

Tarief Informatie ​

België-Specifieke Sensoren ​

Luxemburg-Specifieke Sensoren ​

Gas Monitoring ​

Gas MBus Configuratie ​

Omgevingssensoren ​

Toepassingen ​

Waterlek Sensor (Alleen V3) ​

Eigenschappen ​

Apparaat Bediening ​

Schakelaars ​

Knoppen ​

Selectoren ​

Hoe Firmware Type Werkt ​

Diagnostische Entiteiten ​

Versie Informatie ​

P1 Meter Informatie ​

Firmware Update ​

LED Indicatoren ​

Entiteit Naamgeving Conventie ​

ESPHome Configuratie ​

Hulp Nodig? ​