Verbinden via Thread
De WaterFlowKit V2 gebruikt een ESP32-C6 met ingebouwde Thread-radio. Met de speciale Thread-firmware sluit de kit aan op je bestaande Thread-netwerk en praat hij via je Thread border router over IPv6 met Home Assistant, zonder WiFi.
Alleen lokaal. De Thread-firmware verbindt rechtstreeks met Home Assistant en bevat geen SmartHomeShop-cloud. Gebruik je de SmartHomeShop-app, blijf dan de gewone WiFi- of Ethernet-firmware gebruiken.
Wat je nodig hebt
| Vereiste | Toelichting |
|---|---|
| WaterFlowKit V2 | ESP32-C6-hardware. |
| Thread border router | Bijvoorbeeld Home Assistant met een Home Assistant Connect ZBT-1 / SkyConnect. |
| Een bestaand Thread-netwerk | Zichtbaar onder Instellingen → Apparaten en diensten → Thread in Home Assistant. |
| ESPHome Device Builder | De ESPHome Device Builder-app in Home Assistant, of een losse ESPHome-installatie. |
| USB-C-kabel | De eerste installatie gaat altijd via USB. |
Goed om te weten voordat je begint
- Geen SmartHomeShop-cloud via Thread. Cloud, de SmartHomeShop-app en online firmware-updates werken niet in deze variant.
- Geen fallback-hotspot. Komt het apparaat je Thread-netwerk niet op, flash dan opnieuw of herstel de dataset via USB.
- De Firmware Type-keuze en het firmware-update-entity hebben internet nodig en blijven inactief op Thread. Update via de ESPHome Device Builder.
Stap 1: Kopieer je Thread-dataset
- Ga in Home Assistant naar Instellingen → Apparaten en diensten → Thread.
- Klik op Configureren (tandwiel) en daarna op het informatie-icoon naast je netwerk.
- Kopieer de Active dataset TLVs-tekst.
Stap 2: Maak het apparaat aan in de ESPHome Device Builder
Maak een nieuw apparaat aan, open Edit en vervang de YAML door:
substitutions:
thread_dataset: "PLAK_HIER_JE_ACTIVE_DATASET_TLVS"
packages:
remote_package:
url: https://github.com/smarthomeshop/waterflowkit
ref: main
files: [waterflowkit-v2/waterflowkit-thread.yaml]
refresh: 1d
Plak je dataset-TLVs uit stap 1 in thread_dataset.
Stap 3: Eerste installatie via USB
Sluit de WaterFlowKit aan via USB-C, kies Install → Plug into this computer en wacht tot het flashen klaar is. Na het opstarten joint het apparaat je Thread-netwerk.
Stap 4: Toevoegen aan Home Assistant
Het apparaat wordt ontdekt als een gewoon ESPHome-apparaat (Instellingen → Apparaten en diensten → ESPHome). Alle flowsensoren werken precies zoals op de WiFi-firmware.
Problemen oplossen
| Probleem | Controleer |
|---|---|
| Apparaat joint het netwerk niet | Is thread_dataset de complete Active dataset TLVs-tekst? Is je border router online? |
| Niet ontdekt door Home Assistant | Home Assistant en de border router moeten op hetzelfde netwerk zitten. |
| Firmware-update-entity niet beschikbaar | Verwacht op Thread; update via de ESPHome Device Builder. |