SmartHomeShop Docs

Netwerkconfiguratie

Deze handleiding legt uit hoe je WaterFlowKit verbindt via WiFi of Ethernet, welke opties per hardwareversie beschikbaar zijn en hoe je veilig wisselt tussen firmwarevarianten.

Snel Overzicht

Variant V1 V2 Typische voeding Opmerkingen
WiFi ✅ ✅ USB-C Standaard geleverd
WiFi Cloud ✅ ✅ USB-C Cloud-sync variant
Ethernet ❌ ✅ USB-C of PoE Bekabeld Ethernet
Ethernet Cloud ❌ ✅ USB-C of PoE Bekabeld + cloud-sync
Thread ❌ ✅ USB-C Alleen lokaal, zie Verbinden via Thread

WaterFlowKit wordt standaard geleverd met WiFi firmware. Voor WaterFlowKit V2 kun je later overschakelen naar Ethernet, WiFi Cloud of Ethernet Cloud via USB-C of via de firmwareselector in Home Assistant.

Begin hier als je Ethernet op WaterFlowKit V2 wilt gebruiken. De Ethernetpoort werkt alleen wanneer het apparaat een Ethernet firmwarevariant draait.

Welke versie ondersteunt wat?

V1

  • WiFi
  • WiFi Cloud
  • Captive portal
  • Improv BLE
  • Improv Serial

V2

  • WiFi
  • Ethernet
  • WiFi Cloud
  • Ethernet Cloud
  • Captive portal
  • Improv BLE
  • Improv Serial
  • PoE ondersteuning op V2 hardware

Belangrijk: Alleen WaterFlowKit V2 ondersteunt Ethernet en PoE.

WiFi Setup

Eerste configuratie via hotspot

Wanneer de WiFi firmware nog niet geconfigureerd is, maakt WaterFlowKit een fallback hotspot aan:

  • SSID: waterflowkit
  • Wachtwoord: waterflowkit

Stap voor stap:

  1. Verbind je telefoon of laptop met het waterflowkit netwerk.
  2. Het captive portal opent automatisch.
  3. Kies je 2.4 GHz WiFi netwerk en voer het wachtwoord in.
  4. WaterFlowKit herstart en verbindt met je netwerk.

Als het captive portal niet opent:

  • open handmatig http://192.168.4.1/

Extra onboardingopties op WiFi firmware

De huidige WiFi builds ondersteunen daarnaast:

  • Improv BLE voor provisioning via Bluetooth
  • Improv Serial via USB, met doorverwijzing naar de SmartHomeShop onboardingflow

Dat maakt vooral WaterFlowKit V2 makkelijker in gebruik wanneer je snel vanuit Home Assistant of een provisioningtool wilt koppelen.

WiFi vereisten

  • 2.4 GHz netwerk
  • WPA2 of WPA3
  • voldoende signaalsterkte op de installatielocatie

WiFi tips

  • Controleer de signaalsterkte vóór montage in de meterkast, bijkeuken of technische ruimte.
  • Gebruik Ethernet op V2 als WiFi op die plek instabiel is.
  • Is er nog geen geldig WiFi opgeslagen, of is het opgeslagen netwerk ongeveer 90 seconden niet bereikbaar, dan start de fallback hotspot.

Ethernet Setup (Alleen V2)

WaterFlowKit V2 heeft een Ethernetpoort voor een bekabelde netwerkverbinding. Dit is bedoeld voor installaties waar stabiliteit belangrijker is dan draadloze flexibiliteit.

Waarom Ethernet kiezen?

  • stabielere verbinding dan WiFi
  • geen last van draadloze interferentie
  • handig in technische ruimtes of kasten
  • PoE mogelijk op V2 hardware
  • geschikt voor cloud- en lokale firmwarevarianten

Vereisten

Voordat je naar Ethernet overschakelt:

  • zorg dat je netwerk DHCP aanbiedt
  • controleer dat Home Assistant en WaterFlowKit op hetzelfde netwerk of VLAN zitten
  • sluit de netwerkkabel aan vóór je naar Ethernet firmware wisselt
  • gebruik bij PoE een geschikte injector of switch

Eerste keer naar Ethernet wisselen

De veiligste methode:

  1. Verbind WaterFlowKit V2 met USB-C.
  2. Open de web flasher.
  3. Kies WaterFlowKit, hardwareversie V2, hoe je het apparaat gebruikt (lokaal of met de app) en daarna Ethernet.
  4. Flash de firmware.
  5. Sluit daarna de Ethernet kabel aan als dat nog niet gebeurd was.

Bij de eerste installatie kun je ook Ethernet kiezen op de setuppagina van de waterflowkit hotspot. Je vult dan toch eenmalig je WiFi in: het apparaat gebruikt dat om de Ethernet-firmware op de achtergrond te installeren. Wacht minstens 2 minuten en sluit dan de netwerkkabel aan.

Wisselen vanuit Home Assistant

Als je apparaat al verbonden is met Home Assistant, kun je ook wisselen via:

  1. open het apparaat in Home Assistant
  2. zet Firmware Type op:
    • WiFi (local)
    • Ethernet (local)
    • WiFi + SmartHomeShop App (cloud)
    • Ethernet + SmartHomeShop App (cloud)
  3. op WiFi-firmware begint het apparaat die variant binnen ongeveer 20 seconden zelf te installeren
  4. op Ethernet-firmware druk je op de knop Firmware Update om de installatie te starten

Belangrijk: Het apparaat heeft internet nodig om de nieuwe firmware te downloaden. Sluit de netwerkkabel eerst aan als je naar Ethernet wisselt.

Na overschakelen naar Ethernet

  • het apparaat krijgt standaard een IP-adres via DHCP
  • Home Assistant kan het apparaat opnieuw ontdekken
  • als automatische ontdekking niet lukt, controleer dan de DHCP leases in je router
  • voeg ESPHome handmatig toe op IP-adres als nodig

Ethernet en PoE

WaterFlowKit V2 ondersteunt Ethernet en is bedoeld voor installaties waar ook PoE gewenst is.

Praktisch betekent dit:

  • je kunt V2 bekabeld inzetten in plaats van via WiFi
  • je kunt in PoE-opstellingen minder losse voedingen nodig hebben
  • bij storingen is een test met gewone USB-C voeding nog steeds de snelste manier om een voedingsprobleem uit te sluiten

Als Ethernet niet werkt:

  • test eerst met een gewone netwerkkabel en DHCP
  • test daarna eventueel zonder PoE, met USB-C voeding

Terug naar WiFi

Je kunt van Ethernet terug naar WiFi op twee manieren:

Methode 1: via USB-C web flasher

Dit is de veiligste methode als je apparaat niet meer goed bereikbaar is:

  1. sluit USB-C aan
  2. open de web flasher
  3. kies WaterFlowKit, hardwareversie V2, hoe je het apparaat gebruikt (lokaal of met de app) en daarna Wi-Fi
  4. flash de firmware opnieuw
  5. configureer WiFi via hotspot, Improv BLE of Improv Serial

Methode 2: via Home Assistant

Als het apparaat op Ethernet nog bereikbaar is:

  1. kies WiFi (local) of WiFi + SmartHomeShop App (cloud) in de Firmware Type selector
  2. druk op de knop Firmware Update
  3. laat het apparaat opnieuw opstarten
  4. configureer WiFi als nodig

Tip: Voor eerste adoptie, recovery of twijfelgevallen is USB-C nog steeds de meest voorspelbare methode.

Statisch IP

Standaard gebruikt WaterFlowKit DHCP. Als je een vast IP wilt, adopteer dan het apparaat in ESPHome en voeg handmatig manual_ip toe.

Voor WiFi

wifi:
  manual_ip:
    static_ip: 192.168.1.100
    gateway: 192.168.1.1
    subnet: 255.255.255.0

Voor Ethernet

ethernet:
  manual_ip:
    static_ip: 192.168.1.100
    gateway: 192.168.1.1
    subnet: 255.255.255.0

Gebruik een adres buiten je DHCP-pool of maak een DHCP-reservering in je router.

Netwerk Communicatie & Privacy

Lokaal standaard

De standaard WiFi- en Ethernet-varianten werken lokaal met Home Assistant en ESPHome.

Lokale data:

  • flow rate
  • totaalverbruik
  • watertemperatuur per ingang
  • omgevingstemperatuur en luchtvochtigheid
  • configuratie en automatiseringen

Cloud varianten

WaterFlowKit heeft ook WiFi Cloud en Ethernet Cloud firmwarevarianten. Die zijn bedoeld voor situaties waar je ook SmartHomeShop cloud-sync wilt gebruiken.

Kies dus bewust:

  • WiFi / Ethernet voor lokaal gebruik
  • WiFi Cloud / Ethernet Cloud voor cloud-sync

Probleemoplossing

WiFi hotspot verschijnt niet

  • wacht 1 tot 2 minuten na opstarten
  • controleer of het apparaat nog niet al geconfigureerd is
  • probeer een herstart of factory reset

WiFi is instabiel

  • controleer 2.4 GHz dekking
  • vermijd installaties direct achter veel metaal
  • gebruik Ethernet op V2 als de locatie structureel slecht WiFi heeft

Ethernet werkt niet

Controleer:

  1. dat je echt de Ethernet of Ethernet Cloud firmware draait
  2. dat de kabel goed aangesloten is
  3. dat DHCP actief is
  4. dat Home Assistant hetzelfde netwerk kan bereiken
  5. dat je eventueel PoE uitsluit door tijdelijk via USB-C te voeden

Geen nieuw IP zichtbaar

  • kijk in de DHCP lease tabel van je router
  • probeer een andere switchpoort
  • probeer een andere Ethernet kabel

Apparaat blijft offline in Home Assistant

  • herstart het apparaat
  • ping het laatst bekende IP-adres
  • open de ingebouwde webserver via http://[device-ip]/
  • flash indien nodig opnieuw via USB-C

Hulp Nodig?