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:
| Firmware | Verbinding | Stroomopties |
|---|---|---|
| WiFi | 2.4 GHz draadloos | USB-C adapter |
| Ethernet | Bekabeld RJ45 | USB-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 β
- Verbind je WaterP1MeterKit met je computer via USB-C
- Open onze firmware pagina: smarthomeshop.io/firmware
- Selecteer je hardware versie (V1, V2 of V3)
- Kies de firmware variant (WiFi of Ethernet)
- Klik op "Connect" en selecteer je apparaat
- 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 β
- Sluit eerst een Ethernet kabel aan op je WaterP1MeterKit!
- Open Home Assistant β Apparaten β WaterP1MeterKit
- Zoek de "Firmware Type" selector
- Wijzig van "WiFi" naar "Ethernet"
- Het apparaat downloadt en installeert automatisch de nieuwe firmware
- 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 β
- Open ESPHome in Home Assistant
- Adopteer de WaterP1MeterKit (deze zou automatisch moeten verschijnen als hij op hetzelfde netwerk zit)
- Bewerk de apparaatconfiguratie
- Vervang de YAML met de configuratie van onze GitHub repository:
Voorbeeld: WiFi Configuratie β
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_passwordVoorbeeld: Ethernet Configuratie β
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-v3metwaterp1meterkit-v2ofwaterp1meterkit-v1afhankelijk 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:
| Hardware | WiFi YAML | Ethernet YAML |
|---|---|---|
| V1 | waterp1meterkit-v1/waterp1meterkit-wifi.yaml | waterp1meterkit-v1/waterp1meterkit-ethernet.yaml |
| V2 | waterp1meterkit-v2/waterp1meterkit-wifi.yaml | waterp1meterkit-v2/waterp1meterkit-ethernet.yaml |
| V3 | waterp1meterkit-v3/waterp1meterkit-wifi.yaml | waterp1meterkit-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:
- Ontkoppel USB-C stroom
- Sluit Ethernet kabel aan op een PoE switch (V2/V3) of gewone switch + USB-C stroom (V1)
- Het apparaat zou automatisch moeten verschijnen in Home Assistant
Wisselen naar WiFi β
Na het flashen van WiFi firmware:
- Het apparaat maakt een hotspot aan:
waterp1meterkit(wachtwoord:waterp1meterkit) - Verbind en configureer je thuis WiFi
- Het apparaat zou automatisch moeten verschijnen in Home Assistant
Opnieuw Adopteren in Home Assistant β
Als het apparaat niet verschijnt na flashen:
- Ga naar Instellingen β Apparaten & Diensten
- Zoek naar nieuwe ESPHome apparaten
- 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? β
- Discord Community β Krijg hulp van de community
- Probleemoplossing β Veelvoorkomende problemen en oplossingen
- Netwerk Configuratie β WiFi/Ethernet setup details