Firmwarehandleiding

Lokale werking en GitHub-updatecontrole

De lokale Home Assistant-firmware houdt de metingen van WaterP1MeterKit op je eigen netwerk. Sensorwaarden gaan rechtstreeks naar Home Assistant en worden niet naar GitHub of de SmartHomeShop-cloud gestuurd.

WiFi- en Ethernetfirmware bevat een ESPHome-update-entiteit. Deze leest periodiek een klein firmwaremanifest vanaf SmartHomeShop GitHub Pages om de geïnstalleerde versie met de nieuwste release te vergelijken. Alleen firmwaremetadata wordt opgevraagd; het firmwarebestand wordt pas gedownload wanneer je een update installeert.

Cloudfirmware communiceert voor de cloudfuncties bewust met de SmartHomeShop-app. Het uitschakelen van de GitHub-controle verandert cloudfirmware niet in lokale firmware. Thread-firmware voert deze controle niet via WiFi of Ethernet uit.

WaterP1MeterKit zonder internettoegang gebruiken

Je mag internettoegang voor WaterP1MeterKit blokkeren; de lokale metingen en Home Assistant-verbinding blijven werken. Wil je voorkomen dat een geblokkeerde controle de rode status-led activeert? Neem het apparaat dan over in de ESPHome Device Builder-app/add-on, open de YAML en voeg dit onderaan toe:

update:
  - id: !extend firmware_update
    update_interval: never

Sla de YAML op, kies Validate en installeer de build met Install > Wirelessly. Hiermee schakel je alleen geplande controles uit; het updatecomponent en alle WaterP1MeterKit-sensoren blijven aanwezig.

De geadopteerde YAML bevat nog steeds een packages:-verwijzing naar de SmartHomeShop GitHub-repository. ESPHome gebruikt die verwijzing op de Home Assistant-host tijdens het compileren. Nadat de aangepaste build is geïnstalleerd, vraagt het apparaat zelf niet meer periodiek de firmwareversie op.

Wil je automatische controles herstellen? Verwijder dan het toegevoegde update:-blok en installeer de firmware opnieuw. Kan ESPHome het ID firmware_update niet vinden, werk WaterP1MeterKit dan eerst bij via de SmartHomeShop-webflasher.

Deze handleiding legt uit hoe je firmware kunt flashen, updaten of wisselen op je WaterP1MeterKit. Of je nu wilt wisselen tussen WiFi en Ethernet, updaten naar de nieuwste versie, of de firmware wilt aanpassen: hier vind je alle informatie.

Firmware Opties

De WaterP1MeterKit ondersteunt deze firmware varianten:

WiFi en Ethernet bestaan ook als SmartHomeShop App (cloud) variant voor de SmartHomeShop-app. Home Assistant blijft op die varianten gewoon werken.

📦 Standaard: Alle apparaten worden geleverd met WiFi firmware voorgeïnstalleerd.

DSMR/MBus Water Ondersteuning

WaterP1MeterKit ondersteunt Belgische digitale watermeters die via DSMR/MBus in het P1-telegram worden gerapporteerd.

• Belgische digitale watermeters via DSMR/MBus worden nu ondersteund
• Nieuwe DSMR-water entiteiten zijn beschikbaar, standaard uitgeschakeld:
  • DSMR Water Consumed
  • DSMR Water Equipment ID
  • DSMR Water Device Type
  • DSMR Water Valve Position
• Nieuwe DSMR gas/MBus diagnose-entiteiten zijn beschikbaar, standaard uitgeschakeld:
  • DSMR Gas Device Type
  • DSMR Gas Valve Position
  • DSMR Gas Equipment ID Belgium
• water_mbus_id is toegevoegd met default 2 voor Belgische digitale watermeters

Energy Dashboard opmerking: gebruik óf de pulse watersensor (Water Total Consumption) óf DSMR-water (DSMR Water Consumed). Voeg ze niet allebei toe voor dezelfde fysieke watermeter.

Methode 1: Web Flasher (Aanbevolen)

De makkelijkste manier om firmware te flashen is via onze web-gebaseerde flasher. Geen software installatie nodig: alleen een USB-C kabel en een Chrome/Edge browser.

Stappen

1. Verbind je WaterP1MeterKit met je computer via USB-C
2. Open onze firmware pagina: smarthomeshop.io/firmware
3. Selecteer je hardware versie (V1, V2, V3 of V4)
4. Kies hoe je het apparaat gebruikt: Lokaal met Home Assistant of SmartHomeShop-app + lokaal gebruik
5. Kies de firmware (WiFi of Ethernet)
6. Klik op Firmware installeren, selecteer de USB-poort van je apparaat en wacht tot het proces voltooid is

⚠️ Let op: Na het flashen van Ethernet firmware werkt WiFi niet meer. Sluit eerst een Ethernet kabel aan voordat je opstart.

Wanneer Gebruiken

• ✅ Eerste installatie
• ✅ Wisselen van WiFi naar Ethernet (of andersom)
• ✅ Apparaat reageert niet of moet hersteld worden
• ✅ Je gebruikt de ESPHome Device Builder-app niet

Methode 2: Home Assistant Selector (alleen WiFi → Ethernet)

Als je WaterP1MeterKit al verbonden is met Home Assistant via WiFi, kun je direct wisselen naar Ethernet firmware vanuit Home Assistant.

Stappen

1. Sluit eerst een Ethernet kabel aan op je WaterP1MeterKit!
2. Open Home Assistant → Apparaten → WaterP1MeterKit
3. Zoek de "Firmware Variant" selector
4. Wijzig van "WiFi (local)" naar "Ethernet (local)"
5. Het apparaat downloadt en installeert automatisch de nieuwe firmware
6. Na herstart is het apparaat beschikbaar via Ethernet

⚠️ Belangrijk: Deze methode werkt alleen voor WiFi → Ethernet. Om terug te wisselen van Ethernet naar WiFi, gebruik Methode 1 (Web Flasher) of Methode 3 (ESPHome).

Wanneer Gebruiken

• ✅ Wisselen van WiFi naar Ethernet zonder USB-C kabel
• ✅ Apparaat werkt al in Home Assistant
• ✅ Snelle en makkelijke methode

Methode 3: ESPHome Device Builder-app (Geavanceerd)

Voor gebruikers die volledige controle willen over hun firmware, kun je de WaterP1MeterKit adopteren in de ESPHome Device Builder-app en je eigen firmware compileren.

Stappen

1. Open ESPHome in Home Assistant
2. Adopteer de WaterP1MeterKit (deze zou automatisch moeten verschijnen als hij op hetzelfde netwerk zit)
3. Bewerk de apparaatconfiguratie
4. Vervang de YAML met de configuratie van onze GitHub repository:
   • 📁 GitHub: WaterP1MeterKit YAML bestanden

Voorbeeld: WiFi Configuratie

substitutions:
  name: waterp1meterkit
  friendly_name: WaterP1MeterKit

packages:
  smarthomeshop.waterp1meterkit: github://smarthomeshop/waterp1meterkit/waterp1meterkit-v4/waterp1meterkit-wifi.yaml@main

esphome:
  name: ${name}
  friendly_name: ${friendly_name}
  name_add_mac_suffix: false

api:

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

Voorbeeld: Ethernet Configuratie

substitutions:
  name: waterp1meterkit
  friendly_name: WaterP1MeterKit

packages:
  smarthomeshop.waterp1meterkit: github://smarthomeshop/waterp1meterkit/waterp1meterkit-v4/waterp1meterkit-ethernet.yaml@main

esphome:
  name: ${name}
  friendly_name: ${friendly_name}
  name_add_mac_suffix: false

api:

💡 Tip: Gebruik waterp1meterkit-v4 voor de actuele ESP32-C6 hardware. Vervang dit door waterp1meterkit-v3, waterp1meterkit-v2 of waterp1meterkit-v1 als je oudere hardware hebt.

Aanpassingen

Met ESPHome kun je:

• Extra sensoren toevoegen
• Update intervallen wijzigen
• Automatiseringen direct op het apparaat toevoegen
• Integreren met andere ESPHome functies

Wanneer Gebruiken

• ✅ Je wilt de firmware aanpassen
• ✅ Je bent bekend met ESPHome en YAML
• ✅ Je wilt extra sensoren of functies toevoegen
• ✅ Je compileert liever zelf firmware

Firmwarebestanden per Hardware

Zorg dat je de juiste firmware selecteert voor je hardware versie:

🔍 Niet zeker welke versie je hebt? Zie Hardware Versies

Na het Flashen

Wisselen naar Ethernet

Na het flashen van Ethernet firmware:

1. Ontkoppel USB-C stroom
2. Sluit Ethernet kabel aan op een PoE switch (V2/V3/V4) of gewone switch + USB-C stroom (V1)
3. Het apparaat zou automatisch moeten verschijnen in Home Assistant

Wisselen naar WiFi

Na het flashen van WiFi firmware:

1. Het apparaat maakt een hotspot aan: waterp1meterkit (V4 met oudere firmware: waterp1meterkit-v4, wachtwoord: gelijk aan de naam)
2. Verbind en configureer je thuis WiFi
3. Het apparaat zou automatisch moeten verschijnen in Home Assistant

Opnieuw Adopteren in Home Assistant

Als het apparaat niet verschijnt na flashen:

1. Ga naar Instellingen → Apparaten en diensten
2. Zoek naar nieuwe ESPHome apparaten
3. Klik op Configureren om toe te voegen

V4 met Ethernet-firmware: controleer dit vóór een update

Oudere Ethernet-firmware op V4 kan starten met Firmware Variant op WiFi (local), ook al draait de kit op Ethernet. Een update vanuit Home Assistant zet er dan WiFi-firmware op.

Zet daarom vóór een update Firmware Variant op Ethernet (local) of Ethernet + SmartHomeShop App (cloud).

Is de kit na een update offline en zie je zijn WiFi-hotspot? Dan draait hij WiFi-firmware. Flash de Ethernet-firmware via USB-C met Methode 1 (Web Flasher).

Probleemoplossing

Apparaat niet gedetecteerd via USB-C

• Probeer een andere USB-C kabel (sommige kabels zijn alleen voor opladen)
• Probeer een andere USB poort
• Zorg dat geen ander programma de seriële poort gebruikt
• Wordt het apparaat nog steeds niet gevonden: installeer de CP210x driver

Flashen mislukt

• Probeer de web flasher in incognito/privé modus
• Sluit andere browser tabs die seriële verbindingen gebruiken

Apparaat verschijnt niet in Home Assistant

• Controleer of apparaat op hetzelfde netwerk/VLAN zit
• Check je router voor het IP-adres van het apparaat
• Probeer ESPHome integratie handmatig toe te voegen met het IP-adres

Broncode

Alle firmware broncode is open source en beschikbaar op GitHub:

📁 github.com/smarthomeshop/waterp1meterkit

Releases & Changelog

Elke firmware release krijgt een eigen versie-entry. Gebruik deze links om snel te zien wat er is veranderd voordat je update:

• GitHub Releases
• CHANGELOG.md

Hulp Nodig?

• Discord Community: Krijg hulp van de community
• Probleemoplossing: Veelvoorkomende problemen en oplossingen
• Netwerk Configuratie: WiFi/Ethernet setup details

Thread-firmware

De WaterP1MeterKit V4 kan ook een Thread-netwerk joinen voor lokaal gebruik met Home Assistant, met één DSMR-telegram per 5 seconden. Zie WaterP1MeterKit verbinden via Thread.