Netwerkconfiguratie

Deze handleiding legt uit hoe je je UltimateSensor verbindt met je netwerk via WiFi of Ethernet, en hoe je tussen deze opties wisselt.

Snel Overzicht

Je UltimateSensor wordt geleverd met WiFi firmware voorgeïnstalleerd. De meeste gebruikers kunnen gewoon WiFi gebruiken en hoeven nooit iets te wijzigen.

WiFi Setup

Initiële WiFi Configuratie

Wanneer je UltimateSensor voor het eerst wordt ingeschakeld (of na een factory reset), maakt het een WiFi hotspot aan:

1. Zoek naar de hotspot:

   • SSID: ultimatesensor
   • Wachtwoord: ultimatesensor

2. Verbinden en configureren:

   • Maak verbinding met het ultimatesensor netwerk vanaf je telefoon/laptop
   • Een captive portal zou automatisch moeten openen
   • Selecteer je thuis WiFi netwerk en voer het wachtwoord in
   • De UltimateSensor herstart en maakt verbinding met je netwerk

3. Als het captive portal niet opent:

   • Open een browser en ga naar http://192.168.4.1/
   • Configureer je WiFi vanaf daar

WiFi Vereisten

• 2.4 GHz netwerk (5 GHz wordt niet ondersteund)
• WPA2- of WPA3-beveiliging
• Goede signaalsterkte op de installatielocatie

WiFi Tips

• Controleer signaalsterkte op de montagelocatie voor installatie
• Als het signaal zwak is, overweeg dan Ethernet te gebruiken
• De UltimateSensor maakt automatisch opnieuw verbinding als WiFi tijdelijk verloren gaat
• Fallback hotspot verschijnt na 1 minuut als WiFi verbinding mislukt

Ethernet Setup

Ethernet biedt een betrouwbaardere verbinding en stelt je in staat om Power over Ethernet (PoE) te gebruiken voor een installatie met één kabel.

Ethernet Vereisten

Voordat je overschakelt naar Ethernet, zorg ervoor dat:

• ✅ DHCP ingeschakeld: Je netwerk moet automatisch IP-adressen toewijzen
• ✅ Zelfde VLAN: UltimateSensor moet op hetzelfde netwerk/VLAN zijn als Home Assistant
• ✅ Geen firewall blokkering: Sta verkeer toe tussen UltimateSensor en Home Assistant
• ✅ PoE switch (optioneel): Bij gebruik van PoE heb je een 802.3af compatibele switch of injector nodig

Overschakelen naar Ethernet

Om van WiFi naar Ethernet firmware te wisselen heb je drie opties:

Snel overzicht:

• Optie 1: Flash Ethernet firmware via USB-C voor installatie
• Optie 2: Wijzig UltimateSensor Firmware Variant in Home Assistant naar een Ethernet-optie. Het apparaat installeert de firmware zelf via WiFi
• Optie 3: Kies bij de eerste setup Ethernet op de instelpagina en vul toch je WiFi-gegevens in. Het apparaat gebruikt WiFi eenmalig om de Ethernet firmware te installeren

⚠️ Belangrijk: Optie 2 en 3 duren minstens 2 minuten, dus laat het apparaat aan staan. WiFi stopt zodra de Ethernet firmware is gestart. Sluit de Ethernet kabel aan voordat je wisselt of direct na de herstart.

📖 Volledige instructies: Zie Firmware Handleiding - Varianten Wisselen, of Methode 3: USB-C Web Flasher voor USB flashing.

Na Overschakelen naar Ethernet

• De UltimateSensor krijgt een nieuw IP-adres via DHCP
• Home Assistant zou het apparaat automatisch moeten ontdekken
• Indien niet gevonden, controleer je router's DHCP leases voor het nieuwe IP
• Voeg de ESPHome integratie handmatig toe indien nodig

Terug Wisselen naar WiFi

Als je op Ethernet zit en terug wilt naar WiFi, moet je via USB-C flashen.

📖 Volledige instructies: Zie de Firmware Handleiding - Methode 3: USB-C Web Flasher voor gedetailleerde flash stappen.

Snel overzicht:

1. Flash WiFi firmware via USB-C (V1: verwijder eerst LD2450 sensor)
2. Selecteer WiFi + Basic/Complete variant
3. Apparaat maakt WiFi hotspot aan voor configuratie

Opmerking: Ethernet firmware heeft geen instelpagina en wisselt niet zelf van variant. De update-entiteit biedt WiFi firmware alleen aan als die een nieuwere versie heeft dan de geïnstalleerde, dus USB-C is de betrouwbare weg terug.

Netwerk Communicatie & Privacy

100% Lokale Werking

De UltimateSensor werkt volledig lokaal. Alle sensordata blijft op je lokale netwerk:

• ✅ CO₂ metingen → Lokaal
• ✅ Temperatuur, luchtvochtigheid → Lokaal
• ✅ Fijnstof (Complete) → Lokaal
• ✅ mmWave aanwezigheidsdetectie → Lokaal
• ✅ VOC, NOx, licht sensoren → Lokaal
• ✅ Home Assistant communicatie → Lokaal
• ✅ Automatiseringen → Lokaal

Externe Communicatie

De lokale firmware gaat alleen voor deze twee dingen online:

Geen sensordata wordt ooit extern verzonden. De update controle haalt alleen een versienummer op. Cloudfirmware is de uitzondering: die stuurt je metingen naar de SmartHomeShop-app.

Update Controles Uitschakelen

Als je zelfs de versie controles wilt uitschakelen:

1. Adopteer het apparaat in ESPHome Device Builder
2. Voeg het update:-blok toe uit UltimateSensor v1 zonder internettoegang gebruiken
3. Installeer de firmware opnieuw

Probleemoplossing

WiFi Problemen

Kan de UltimateSensor hotspot niet vinden

• Wacht 1-2 minuten na inschakelen
• De hotspot verschijnt alleen als WiFi niet is geconfigureerd
• Zoek naar de ultimatesensor netwerknaam
• Was het apparaat eerder ingesteld, dan verschijnt de hotspot ongeveer 1 minuut nadat het je WiFi niet kan bereiken

Verbonden met hotspot maar geen captive portal

• Open browser handmatig naar http://192.168.4.1/
• Probeer een ander apparaat (telefoon vs laptop)
• Schakel mobiele data uit op je telefoon

WiFi verbinding mislukt

• Verifieer dat je een 2.4 GHz netwerk gebruikt (niet 5 GHz)
• Controleer of WiFi wachtwoord correct is
• Gebruik WPA2 of WPA3 op je router. Verbindt een netwerk met alleen WPA3 niet, zet de router dan op gemengd WPA2/WPA3
• Controleer signaalsterkte op installatielocatie

Frequente verbrekingen

• Controleer WiFi signaalsterkte
• Verplaats router/access point dichterbij
• Verminder interferentie van andere apparaten
• Overweeg overschakelen naar Ethernet voor betrouwbaarheid

Ethernet Problemen

Overgeschakeld naar Ethernet maar apparaat is offline

Oorzaak: WiFi stopte onmiddellijk maar Ethernet was niet aangesloten.

Oplossing:

1. Sluit een Ethernet kabel aan op de UltimateSensor
2. Controleer dat de kabel naar een switch met DHCP gaat
3. Verifieer zelfde VLAN als Home Assistant
4. Controleer of Ethernet poort LED brandt (continu of knipperend)
5. Apparaat zou in Home Assistant moeten verschijnen

Als Ethernet niet mogelijk is: Flash WiFi firmware via USB-C (zie Firmware Handleiding)

Ethernet aangesloten maar niet ontdekt

Controleer:

1. Link lichten op de Ethernet poort (zouden moeten knipperen)
2. Router DHCP leases voor nieuw apparaat
3. Zelfde VLAN als Home Assistant
4. Geen firewall blokkeert mDNS of ESPHome API

Handmatige verbinding:

1. Vind het IP in je router's DHCP lease tabel
2. Voeg in Home Assistant ESPHome integratie handmatig toe via IP

Apparaat krijgt geen IP-adres

• Verifieer dat DHCP is ingeschakeld op je netwerk
• Controleer Ethernet kabel en poort
• Probeer een andere switch poort
• Probeer een andere Ethernet kabel
• Verifieer dat PoE werkt (bij gebruik van PoE), of probeer USB-C voeding in plaats daarvan

PoE werkt niet

• Zorg dat je switch de 802.3af PoE standaard ondersteunt
• Controleer of PoE is ingeschakeld op de switch poort
• Probeer een andere PoE poort
• Test met USB-C voeding om voedingsproblemen te isoleren

Algemene Netwerk Problemen

Apparaat toont offline in Home Assistant

1. Controleer voeding (OLED display zou moeten oplichten bij opstarten)
2. Verifieer netwerkverbinding (WiFi signaal of Ethernet link)
3. Controleer of apparaat op hetzelfde netwerk is als Home Assistant
4. Probeer het apparaat IP te pingen
5. Herstart het apparaat (koppel los/sluit opnieuw aan)

Kan geen verbinding maken met apparaat web interface

De UltimateSensor heeft een ingebouwde webserver op http://[apparaat-ip]/:

• Werkt op zowel WiFi als Ethernet
• Toont sensorwaarden en basisinfo
• Nuttig voor debuggen zonder Home Assistant
• Als je er geen toegang toe hebt, controleer netwerkverbinding

Apparaat heeft verkeerd IP-adres

Als het apparaat een onverwacht IP kreeg:

• Controleer je DHCP server configuratie
• Stel een DHCP reservering in voor het apparaat (gebruik MAC-adres)
• Verifieer geen IP-conflicten op je netwerk

Geavanceerd: Statisch IP Configuratie

Als je een statisch IP nodig hebt in plaats van DHCP, kun je dit configureren in ESPHome:

1. Open ESPHome in Home Assistant
2. Bewerk je UltimateSensor configuratie
3. Voeg statische IP configuratie 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

4. Klik op Opslaan → Installeren → Draadloos

⚠️ Waarschuwing: Zorg dat het IP-adres buiten je DHCP bereik valt en niet al in gebruik is!

Hulp Nodig?

• Bekijk de Firmware Handleiding voor flash instructies
• Bekijk de Probleemoplossing pagina voor meer problemen
• Bekijk de FAQ voor veelgestelde vragen
• Sluit je aan bij onze Discord community
• Neem contact op via smarthomeshop.io/contact