SmartHomeShop Docs

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

  1. Ga in Home Assistant naar Instellingen → Apparaten en diensten → Thread.
  2. Klik op Configureren (tandwiel) en daarna op het informatie-icoon naast je netwerk.
  3. 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.