Skip to content

Firmware Handleiding ​

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 twee firmware varianten:

FirmwareVerbindingStroomopties
WiFi2.4 GHz draadloosUSB-C adapter
EthernetBekabeld RJ45USB-C adapter of PoE (V2/V3)

πŸ“¦ Standaard: Alle apparaten worden geleverd met WiFi firmware voorgeΓ―nstalleerd.


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 of V3)
  4. Kies de firmware variant (WiFi of Ethernet)
  5. Klik op "Connect" en selecteer je apparaat
  6. Klik op "Install" 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 addon 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 Type" selector
  4. Wijzig van "WiFi" naar "Ethernet"
  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 Addon (Geavanceerd) ​

Voor gebruikers die volledige controle willen over hun firmware, kun je de WaterP1MeterKit adopteren in de ESPHome addon 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:

Voorbeeld: WiFi Configuratie ​

yaml
substitutions:
  name: waterp1meterkit
  friendly_name: WaterP1MeterKit

packages:
  smarthomeshop.waterp1meterkit: github://smarthomeshop/waterp1meterkit/waterp1meterkit-v3/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 ​

yaml
substitutions:
  name: waterp1meterkit
  friendly_name: WaterP1MeterKit

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

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

api:

πŸ’‘ Tip: Vervang waterp1meterkit-v3 met waterp1meterkit-v2 of waterp1meterkit-v1 afhankelijk van je hardware versie.

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

Firmware Versies per Hardware ​

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

HardwareWiFi YAMLEthernet YAML
V1waterp1meterkit-v1/waterp1meterkit-wifi.yamlwaterp1meterkit-v1/waterp1meterkit-ethernet.yaml
V2waterp1meterkit-v2/waterp1meterkit-wifi.yamlwaterp1meterkit-v2/waterp1meterkit-ethernet.yaml
V3waterp1meterkit-v3/waterp1meterkit-wifi.yamlwaterp1meterkit-v3/waterp1meterkit-ethernet.yaml

πŸ” 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) 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 (wachtwoord: waterp1meterkit)
  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 & Diensten
  2. Zoek naar nieuwe ESPHome apparaten
  3. Klik op Configureren om toe te voegen

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
  • Op Windows: Installeer de CH340 driver

Flashen mislukt ​

  • Houd de BOOT knop ingedrukt terwijl je USB-C aansluit
  • 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


Hulp Nodig? ​