SmartHomeShop Docs

Sensordefinities

Deze pagina biedt gedetailleerde uitleg over alle sensoren, bedieningselementen en entiteiten die beschikbaar zijn op de WaterMeterKit. 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 WaterMeterKit 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
Current Usage Huidige waterstroomsnelheid. Toont real-time waterverbruik wanneer kraan loopt. L/min
Total Consumption Totaal water verbruikt sinds apparaat opstart. Gebruik dit voor Energy Dashboard: Home Assistant houdt historie bij zelfs na herstarts. m³
Water Meter Total Je absolute meterstand. Blijft behouden bij herstarts en OTA updates. m³
Water Meter Initial Value Vul hier één keer je fysieke meterstand in. Staat bij de configuratie van het apparaat. 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 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 Total Consumption (niet Water Meter Total) voor het Energy Dashboard, want Water Meter Total springt zodra je je meterstand invult
  • 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. Kleine lekken onder 0,5 L/min zie je daardoor niet als vaste stroming, kijk daarvoor naar Total Consumption

Omgevingssensoren

De WaterMeterKit 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 offset. °C
Humidity Relatieve luchtvochtigheid op de apparaatlocatie. Voorgekalibreerd met offset. %

Toepassingen

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

🔧 Kalibratie: Zie Gebruikshandleiding: ESPHome Configuratie voor instructies over het aanpassen van sensor kalibratie.

Apparaat Bediening

Schakelaars

Entiteit Beschrijving
Restart Herstart de WaterMeterKit. 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 en de opgeslagen watermeterstand. Standaard uitgeschakeld voor veiligheid.

Diagnostische Entiteiten

Versie Informatie

Entiteit Beschrijving
ESPHome Version De ESPHome versie die draait op het apparaat.
Software Version De WaterMeterKit firmware versie.
Hardware Version De hardwareversie van je kit (V1, V2 of V3).

Netwerk en Systeem

Entiteit Beschrijving
WiFi Signal WiFi signaalsterkte in dBm.
IP Address Huidig IP-adres. Standaard uitgeschakeld op V3.
MAC Address MAC-adres van het apparaat. Standaard uitgeschakeld op V3.
Connected SSID / Connected BSSID Het verbonden WiFi-netwerk (V1 en V2).
Uptime Tijdstip waarop het apparaat voor het laatst is gestart.
CPU Temperature Interne chiptemperatuur (alleen V3).

Cloudfirmware

Entiteit Beschrijving
Cloud Connected Aan als de laatste synchronisatie met de SmartHomeShop-app is gelukt.
Cloud Status Status in tekst, zoals Connected of Registering.
Cloud Device ID Het ID waarmee je het apparaat in de app kunt toevoegen.
Cloud Sync Failures Aantal mislukte synchronisaties op rij.
Reset Cloud Knop die de cloudregistratie wist en het apparaat opnieuw registreert.

Firmware Update

Entiteit Beschrijving
Firmware Update-entiteit (alleen V3). Toont beschikbare firmware updates. Installeer direct vanuit Home Assistant.
Firmware Variant Keuze (alleen V3): WiFi (local) of WiFi + SmartHomeShop App (cloud). Wijzigen installeert die firmware.

LED Indicatoren

De WaterMeterKit heeft drie LED indicatoren:

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

Rode status-LED: uit betekent dat alles goed is. Langzaam knipperen betekent nog niet verbonden met WiFi of Home Assistant. Snel knipperen betekent dat een firmwareonderdeel een fout meldt, zie Probleemoplossing. Op V3-cloudfirmware knippert hij alleen als het apparaat offline is.

Met cloudfirmware zie je ook een korte blauwe flits na elke geslaagde synchronisatie.

Entiteit Naamgeving Conventie

Alle entiteiten volgen dit naampatroon:

sensor.watermeterkit_a1b2c3_watermeterkit_[sensor_naam]
switch.watermeterkit_a1b2c3_watermeterkit_[schakelaar_naam]
button.watermeterkit_a1b2c3_watermeterkit_[knop_naam]

a1b2c3 staat voor de laatste zes tekens van het MAC-adres van je apparaat, zodat elke WaterMeterKit eigen entiteit-ID's krijgt. Kopieer het exacte ID altijd van de entiteit in Home Assistant.

ESPHome Configuratie

Voor gevorderde gebruikers die de WaterMeterKit firmware willen aanpassen:

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

WaterMeterKit vs WaterP1MeterKit

Op zoek naar meer functies? De WaterP1MeterKit voegt toe:

Eigenschap WaterMeterKit WaterP1MeterKit
Water monitoring ✅ ✅
Temperatuur & Vochtigheid ✅ ✅
P1 energiemeter ❌ ✅
Gas monitoring ❌ ✅
Ethernet/PoE ❌ ✅ (V2 en later)
Waterlek sensor poort ❌ ✅ (V3 en V4)

Hulp Nodig?