Probleemoplossing
Deze handleiding helpt je veelvoorkomende problemen met je UltimateSensor op te lossen.
Algemene Probleemoplossing Stappen
Voordat je specifieke problemen behandelt, probeer deze stappen:
Controleer Voedingsaansluiting
- Zorg dat USB-C kabel stevig is aangesloten
- Probeer een andere voedingsadapter (minimaal 1A)
- Bij PoE, controleer of switch/injector werkt
Herstart het Apparaat
- Haal voeding los, wacht 10 seconden, sluit opnieuw aan
- Of gebruik de "Restart UltimateSensor" knop in Home Assistant
Controleer Home Assistant
- Herstart Home Assistant: Instellingen → Systeem → Herstarten
- Update Home Assistant naar de nieuwste versie
Verifieer Netwerkverbinding
- Controleer of apparaat in DHCP lijst van je router staat
- Zorg dat apparaat op hetzelfde netwerk/VLAN als Home Assistant zit
WiFi Connectiviteitsproblemen
Kan WiFi Hotspot Niet Vinden
De ultimatesensor hotspot zou na inschakelen moeten verschijnen:
- Wacht 1-2 minuten — het duurt even om te initialiseren
- Hotspot verschijnt alleen als WiFi nog niet geconfigureerd is
- Probeer andere apparaten — sommige telefoons/laptops zien hem beter
- Fabrieksreset indien eerder geconfigureerd (zie hieronder)
Verbonden met Hotspot maar Geen Captive Portal
Als de configuratiepagina niet automatisch opent:
- Open handmatig een browser
- Navigeer naar http://192.168.4.1/
- Probeer mobiele data uit te schakelen op je telefoon
- Probeer een andere browser
WiFi Maakt Geen Verbinding
- Alleen 2,4 GHz — 5 GHz netwerken worden niet ondersteund
- Controleer wachtwoord — WiFi wachtwoorden zijn hoofdlettergevoelig
- Signaalsterkte — ga dichter bij router staan tijdens setup
- Speciale tekens — sommige speciale tekens in SSID/wachtwoord kunnen problemen veroorzaken
Frequente Verbroken Verbindingen
- Controleer signaalsterkte op de sensorlocatie
- Verminder interferentie van andere 2,4 GHz apparaten
- Overweeg Ethernet voor stabielere connectiviteit
- Controleer router instellingen — sommige routers verbreken inactieve apparaten
Fallback Hotspot Modus
Als de UltimateSensor geen verbinding kan maken met WiFi, maakt hij automatisch na 1 minuut een fallback hotspot:
- SSID:
ultimatesensor - Wachtwoord:
ultimatesensor
Verbind om WiFi instellingen opnieuw te configureren.
Ethernet/PoE Problemen
Ethernet Werkt Niet
- Controleer firmware — Ethernet vereist Ethernet firmware (zie Firmware Handleiding)
- LED controle — Gele/groene LED op Ethernet poort geeft actieve verbinding aan
- Kabel controle — Probeer een andere Ethernet kabel
- DHCP — Zorg dat DHCP ingeschakeld is op je netwerk
- Geen VLANs — Test eerst zonder VLAN segmentatie
PoE Voedt Apparaat Niet
- Verifieer PoE standaard — IEEE 802.3af compatibel vereist
- Controleer PoE budget — Switch kan beperkt vermogensbudget hebben
- Probeer USB-C voeding met Ethernet kabel (niet-PoE) om te testen
Firmware Wissel Problemen
Bij wisselen tussen WiFi en Ethernet firmware:
- WiFi → Ethernet: Sluit Ethernet kabel aan VOORDAT je wisselt
- Ethernet → WiFi: Vereist USB-C flashen (zie Firmware Handleiding)
- Apparaat verdwijnt: Controleer DHCP client lijst voor nieuw IP-adres
Sensor Data Problemen
Sensoren Updaten Niet
- Opstarttijd: Sensoren hebben 10+ minuten nodig om te stabiliseren
- CO₂ specifiek: Kan 24-48 uur duren voor nauwkeurige metingen
- Controleer entiteiten: Sommige zijn standaard uitgeschakeld in Home Assistant
Onnauwkeurige CO₂ Metingen
- Initiële kalibratie: Wacht minimaal 24 uur
- Plaatsing: Vermijd warmtebronnen en direct zonlicht
- Handmatige kalibratie: Plaats buiten, gebruik "CO2 manual calibration" knop
- Zie Kalibratiehandleiding voor details
Temperatuur Meet Te Hoog
De SCD41 zit in de behuizing waar componenten warmte genereren:
- Verwachte offset: 2-5°C hoger dan omgeving
- Oplossing: Pas negatieve offset toe in ESPHome configuratie
- Zie Kalibratiehandleiding voor instructies
mmWave Valse Positieven
De radar kan beweging door muren detecteren of van bewegende objecten:
- Verlaag Max Distance instelling
- Configureer zones om problematische gebieden uit te sluiten
- Controleer bewegende objecten (ventilatoren, gordijnen, huisdieren)
- Pas zone grenzen aan om gebieden achter muren uit te sluiten
mmWave Detecteert Niet
- Controleer positionering — voorkant van apparaat moet naar gemonitord gebied wijzen
- Verifieer entiteit states — controleer
Target X Distancewaarden - Off delay — standaard 15 seconden voor melden "geen aanwezigheid"
- Afstandslimiet — controleer
Max Distanceinstelling
PIR Triggert Niet
- Controleer entiteit —
PIR Sensorbinary sensor in Home Assistant - Lijn van zicht — PIR vereist directe zicht op beweging
- Temperatuurverschil — PIR detecteert warmte, kan koude handen missen
PM Sensor Geen Data (Alleen Complete)
- Opstarttijd: SPS30 heeft tijd nodig om te initialiseren
- Controleer firmware: Moet "Complete" firmware variant gebruiken
- Update interval: PM data wordt elke 120 seconden bijgewerkt
Display Problemen
OLED Display Leeg
- Opstarttijd: Display initialiseert na sensoren
- Herstart: Probeer apparaat uit en aan te zetten
- Helderheid: Display staat ingesteld op 40% contrast
Display Toont Verkeerde Waarden
- Sensor opstart: Waarden stabiliseren na 10+ minuten
- Display vertraging: Toont laatste bekende waarden als sensor faalt
LED Indicator Problemen
Rode Status LED Knippert Langzaam
Apparaat is niet verbonden met WiFi of Home Assistant:
- Controleer WiFi configuratie
- Verifieer dat Home Assistant het apparaat kan bereiken
- Controleer of apparaat in fallback hotspot modus is
Rode Status LED Knippert Snel
Opstartfout gedetecteerd:
- Probeer stroomcyclus
- Flash firmware opnieuw indien persistent
- Controleer op hardwareproblemen
Achter LED Niet Bestuurbaar
- Controleer entiteit:
Back Lightlight entiteit in Home Assistant - Entiteit uitgeschakeld: Kan standaard uitgeschakeld zijn, schakel eerst in
Home Assistant Integratie Problemen
Apparaat Niet Automatisch Ontdekt
- Ga naar Instellingen → Apparaten & Services
- Klik op Integratie toevoegen
- Selecteer ESPHome
- Voer IP-adres van apparaat in (vind in router DHCP lijst)
Entiteiten Ontbreken
- Sommige entiteiten zijn standaard uitgeschakeld (Zone 2-4, etc.)
- Ga naar apparaat in Home Assistant, klik op entiteit, schakel in
Apparaat Offline in Home Assistant
- Controleer netwerkconnectiviteit
- Verifieer IP-adres is niet veranderd
- Firewall regels kunnen communicatie blokkeren
- mDNS problemen: Probeer IP-adres in plaats van hostnaam te gebruiken
Geavanceerde Probleemoplossing
Web Interface Toegang
De UltimateSensor heeft een ingebouwde web interface:
- Vind apparaat IP in DHCP lijst van je router
- Open browser en navigeer naar
http://<apparaat-ip>/ - Bekijk sensorwaarden, logs en apparaatinfo
Logs Bekijken
In ESPHome:
- Open ESPHome Dashboard
- Klik op je UltimateSensor apparaat
- Klik op "Logs" om real-time output te zien
Fabrieksreset
Om het apparaat volledig te resetten:
- Download firmware van GitHub
- Verbind via USB-C
- Flash met ESPHome Web Flasher
Dit wist WiFi credentials en reset alle instellingen.
Firmware Update
Voor OTA updates:
- Adopteer apparaat in ESPHome Dashboard
- Maak benodigde wijzigingen in YAML
- Klik op "Install" → "Wirelessly"
Voor USB updates:
- Zie Firmware Handleiding voor gedetailleerde instructies
Netwerkcommunicatie & Privacy
100% Lokale Werking
De UltimateSensor werkt volledig lokaal:
- ✅ Alle sensordata blijft op je netwerk
- ✅ Home Assistant communicatie is lokaal
- ✅ Automatiseringen draaien lokaal
Externe Communicatie
De enige externe communicatie is:
- Firmware versiecontrole naar GitHub/ESPHome (optioneel)
Update Controles Uitschakelen
Om externe versiecontroles uit te schakelen:
- Adopteer het apparaat in ESPHome
- Verwijder of commentarieer de
dashboard_importsectie - Deploy de configuratie
Nog Steeds Problemen?
Als geen van de bovenstaande oplossingen werkt:
- Word lid van Discord: smarthomeshop.io/discord — snelste ondersteuning
- Neem contact op: smarthomeshop.io/contact
- Bekijk GitHub: github.com/smarthomeshop/ultimatesensor
Bij het vragen om hulp, vermeld alstublieft:
- Hardware versie (Basic/Complete)
- Firmware versie
- Connectietype (WiFi/Ethernet)
- Beschrijving van het probleem
- Eventuele foutmeldingen uit logs