SmartHomeShop Docs

Sensordefinities

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

Snelle Navigatie

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³
Water Meter Initial Value Vul hier je huidige fysieke meterstand in. m³
Water Meter Total Je werkelijke meterstand: de ingevulde waarde plus het water dat daarna is gemeten. m³

Hoe Het Werkt

  1. Detectie: De sensor detecteert het roterende metalen plaatje in je watermeter
  2. Pulse tellen: Elke rotatie = 1 liter water
  3. Doorstroom berekening: De sensor berekent doorstroomsnelheid gebaseerd op pulse frequentie
  4. 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

DSMR/MBus Digitale Watermeters

Belgische digitale watermeters kunnen door de slimme energiemeter via DSMR/MBus in het P1 telegram worden gerapporteerd. Deze entiteiten staan standaard uit omdat de meeste gebruikers óf de fysieke pulse watersensor gebruiken óf geen digitale waterdata in het P1 telegram hebben.

Entiteit Beschrijving Eenheid Standaard
DSMR Water Consumed Digitaal waterverbruik via DSMR/MBus. Gebruik deze als waterbron in het Energy Dashboard als je Belgische digitale waterdata gebruikt. m³ Uitgeschakeld
DSMR Water Equipment ID Equipment ID / serienummerreferentie van de digitale watermeter die door de slimme meter wordt gerapporteerd. - Uitgeschakeld
DSMR Water Device Type Device type van de digitale watermeter. - Uitgeschakeld
DSMR Water Valve Position Klepstand van de digitale watermeter, indien beschikbaar. - Uitgeschakeld

Combineer waterbronnen niet: als je DSMR Water Consumed gebruikt, voeg dan niet ook Water Total Consumption toe voor dezelfde fysieke watermeter. Gebruik óf DSMR-water óf pulse-water.

De firmware gebruikt water_mbus_id om het digitale water MBus apparaat te selecteren. De default is 2, wat past bij veel Belgische digitale watermeter setups.

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 zoals de meter het stuurt: 0001 = laag tarief, 0002 = normaal tarief. Op Belgische meters is dit omgedraaid. 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).
DSMR Water Consumed Belgisch digitaal waterverbruik via DSMR/MBus. Standaard uitgeschakeld; alleen inschakelen indien nodig.
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 Diagnose

Deze diagnose-entiteiten staan standaard uit. Schakel ze alleen in als je wilt controleren wat de slimme meter rapporteert voor het aangesloten MBus gasapparaat.

Entiteit Beschrijving Standaard
DSMR Gas Device Type Device type van het gas MBus apparaat. Uitgeschakeld
DSMR Gas Valve Position Klepstand van de gasmeter, indien beschikbaar. Uitgeschakeld
DSMR Gas Equipment ID Belgium Belgische equipment ID / serienummerreferentie van het gas MBus apparaat. Uitgeschakeld

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 en Water 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 (V3/V4)

De WaterP1MeterKit V3 en V4 bevatten 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

💡 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 Variant Selecteert welke firmware variant het apparaat installeert en gebruikt voor OTA updates. WiFi (local), Ethernet (local), WiFi + SmartHomeShop App (cloud), Ethernet + SmartHomeShop App (cloud)

Hoe Firmware Variant Werkt

De Firmware Variant selector bepaalt welke firmware het apparaat downloadt tijdens OTA updates. Op WiFi firmware installeert het apparaat een nieuw gekozen variant zelf:

  1. WiFi (local) (standaard): smarthomeshop.github.io/waterp1meterkit/waterp1meterkit-vX-wifi-manifest.json
  2. Ethernet (local): smarthomeshop.github.io/waterp1meterkit/waterp1meterkit-vX-ethernet-manifest.json
  3. WiFi + SmartHomeShop App (cloud): smarthomeshop.github.io/waterp1meterkit/waterp1meterkit-vX-wifi-cloud-manifest.json
  4. Ethernet + SmartHomeShop App (cloud): smarthomeshop.github.io/waterp1meterkit/waterp1meterkit-vX-ethernet-cloud-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, V3, of V4).

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). Staat standaard uit.

Firmware Update

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

Verbinding en Systeem

Entiteit Beschrijving
WiFi Signal Sterkte van het WiFi-signaal (WiFi firmware).
IP Address Huidig IP-adres van het apparaat.
Connected SSID / Connected BSSID WiFi-netwerk en accesspoint waarmee het apparaat verbonden is (WiFi firmware).
MAC Address MAC-adres van het apparaat.
Uptime Tijd sinds de laatste herstart. Helpt om herstarts te onderscheiden van API-herverbindingen.
CPU Temperature Temperatuur van de chip, voor diagnose.

SmartHomeShop Cloud (alleen cloudfirmware)

Entiteit Beschrijving
Cloud Status Huidige cloudstatus, bijvoorbeeld Connected.
Cloud Connected Aan als het apparaat geregistreerd is en de laatste synchronisatie lukte.
Cloud Device ID De ID waarmee je het apparaat in de app toevoegt als het niet automatisch gevonden wordt.
Cloud Sync Failures Aantal mislukte synchronisaties.
Reset Cloud Knop die de cloudregistratie op het apparaat wist.

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
Rood (V4), wit (V2/V3), blauw (V1) Vast Voedings-LED: apparaat is ingeschakeld

Entiteit Naamgeving Conventie

Alle entiteiten volgen dit naampatroon. De kit voegt zijn MAC-achtervoegsel (hier a1b2c3) toe aan de naam, zodat je meerdere kits naast elkaar kunt gebruiken:

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

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?