SmartHomeShop Docs

Probleemoplossing

Rode status-led knippert snel op een VLAN zonder internet

Blijft UltimateSensor v1 metingen doorgeven, maar knippert de rode status-led na het opstarten snel? Dan blokkeert je firewall of IoT-VLAN mogelijk de firmwarecontrole.

De lokale UltimateSensor v1-firmware leest een klein versiebestand vanaf SmartHomeShop GitHub Pages. Hiermee controleert het apparaat alleen of nieuwe firmware beschikbaar is. Het stuurt geen sensorwaarden, Home Assistant-gegevens, wifiwachtwoorden of API-sleutels naar GitHub.

De standaard ESPHome-status-led toont fouten van alle firmwarecomponenten. Een geblokkeerde updatecontrole kan daardoor op een opstartfout lijken, terwijl UltimateSensor v1 zelf normaal blijft werken.

Controleer of dit de oorzaak is

Open de log van UltimateSensor v1 in ESPHome en zoek naar http_request.update of Failed to fetch manifest. Zie je deze meldingen niet, controleer dan eerst de voeding, netwerkverbinding en initialisatie van de sensoren.

Geplande firmwarecontroles uitschakelen

  1. Open de ESPHome Device Builder-app/add-on in Home Assistant. Dit is iets anders dan de ESPHome-integratie onder Instellingen > Apparaten en diensten.
  2. Zoek UltimateSensor v1 en kies Overnemen, Take control of Adopt.
  3. Bewaar een kopie van de gegenereerde YAML, inclusief de API-encryptiesleutel.
  4. Kies Edit en voeg dit blok zonder extra inspringing onderaan de YAML toe:
update:
  - id: !extend firmware_update
    update_interval: never
  1. Sla het bestand op, kies Validate en daarna Install > Wirelessly.

Na installatie blijft UltimateSensor v1 lokaal meten en communiceren met Home Assistant, maar voert het apparaat geen geplande firmwarecontroles meer uit. Bijwerken kan later nog steeds via ESPHome of de SmartHomeShop-webflasher.

ESPHome haalt tijdens het compileren nog wel de UltimateSensor v1-configuratie achter de packages:-verwijzing op van GitHub. Die aanvraag komt van de Home Assistant-/ESPHome-host, niet van UltimateSensor v1 zelf.

Meldt de validatie dat firmware_update niet bestaat? Verwijder het blok dan weer en installeer eerst een actuele UltimateSensor v1-firmwareversie. Blijft de led daarna snel knipperen, dan kan er een andere echte firmware- of hardwarefout zijn.

Deze handleiding helpt je veelvoorkomende problemen met je UltimateSensor op te lossen.

Algemene Probleemoplossing Stappen

Voordat je specifieke problemen behandelt, probeer deze stappen:

  1. Controleer Voedingsaansluiting

    • Zorg dat USB-C kabel stevig is aangesloten
    • Probeer een andere voedingsadapter (minimaal 1A)
    • Bij PoE, controleer of switch/injector werkt

  2. Herstart het Apparaat

    • Haal voeding los, wacht 10 seconden, sluit opnieuw aan
    • Of gebruik de "Restart UltimateSensor" knop in Home Assistant

  3. Controleer Home Assistant

    • Herstart Home Assistant: Instellingen → Systeem → Herstarten
    • Update Home Assistant naar de nieuwste versie

  4. 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:

  1. Open handmatig een browser
  2. Navigeer naar http://192.168.4.1/
  3. Probeer mobiele data uit te schakelen op je telefoon
  4. 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

  1. Controleer firmware: Ethernet vereist Ethernet firmware (zie Firmware Handleiding)
  2. LED controle: Gele/groene LED op Ethernet poort geeft actieve verbinding aan
  3. Kabel controle: Probeer een andere Ethernet kabel
  4. DHCP: Zorg dat DHCP ingeschakeld is op je netwerk
  5. 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:

  • Verklein je polygonzones zodat ze bij de muur eindigen
  • Teken een uitsluitingszone over het probleemgebied in de Room Designer
  • Controleer bewegende objecten (ventilatoren, gordijnen, huisdieren)
  • Controleer reflecties van spiegels en grote metalen oppervlakken

mmWave Detecteert Niet

  • Controleer positionering: voorkant van apparaat moet naar gemonitord gebied wijzen
  • Verifieer entiteit states: controleer de waarden van Target X Distance
  • Timeout: Tracking Presence Timeout bepaalt hoe lang aanwezigheid aan blijft na de laatste detectie
  • Zones: controleer of Polygon Zones Enabled aan staat en of de zone op de juiste plek ligt

PIR Triggert Niet

  • Controleer entiteit: PIR Sensor binary 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
  • Meetcyclus: Met de standaard SPS30 Idle Interval van 5 minuten pauzeert de sensor tussen metingen. Zet deze op 0 om continu te meten
  • Schakelaars: Controleer of PM Sensor aan staat en Night Mode uit. De sensor stopt ook tijdens SPS30 Quiet Hours

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
  • Schakelaar: Controleer of LCD Display aan staat. Night Mode zet het display ook uit

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

Status LED op Cloudfirmware

Cloudfirmware laat de status LED knipperen zolang het apparaat offline is en zet hem uit zodra het online is. Op cloudfirmware wijst een knipperende LED dus op de netwerkverbinding.

Achter LED Niet Bestuurbaar

  • Controleer entiteit: Back Light light entiteit in Home Assistant
  • Automatic LED Lighting: Zolang deze schakelaar aan staat, bestuurt de firmware de LED zelf

Home Assistant Integratie Problemen

Apparaat Niet Automatisch Ontdekt

  1. Ga naar Instellingen → Apparaten & Services
  2. Klik op Integratie toevoegen
  3. Selecteer ESPHome
  4. Voer IP-adres van apparaat in (vind in router DHCP lijst)

Entiteiten Ontbreken

  • Sommige entiteiten zijn standaard uitgeschakeld (IP Address, Connected BSSID, de firmware update-entiteit en meer)
  • 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:

  1. Vind apparaat IP in DHCP lijst van je router
  2. Open browser en navigeer naar http://<apparaat-ip>/
  3. Bekijk sensorwaarden, logs en apparaatinfo

Logs Bekijken

In ESPHome:

  1. Open ESPHome Device Builder
  2. Klik op je UltimateSensor apparaat
  3. Klik op "Logs" om real-time output te zien

Fabrieksreset

Om het apparaat volledig te resetten:

  1. Volg Methode 3: USB-C Web Flasher, inclusief het verwijderen van de LD2450
  2. Stel WiFi opnieuw in via de hotspot ultimatesensor

Dit zet het apparaat terug naar de fabrieksinstellingen. WiFi-gegevens, zones en alle andere instellingen worden gewist.

Firmware Update

Voor OTA updates:

  • Gebruik de update-entiteit UltimateSensor Firmware in Home Assistant
  • Of klik voor een geadopteerd apparaat op "Install" → "Wirelessly" in ESPHome Device Builder

Voor USB updates:

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 lokale firmware gaat alleen online voor:

  • Firmware versiecontrole op SmartHomeShop GitHub Pages
  • De tijd van een NTP-server

Update Controles Uitschakelen

Volg Geplande firmwarecontroles uitschakelen bovenaan deze pagina.

Nog Steeds Problemen?

Als geen van de bovenstaande oplossingen werkt:

  1. Word lid van Discord: smarthomeshop.io/discord, snelste ondersteuning
  2. Neem contact op: smarthomeshop.io/contact
  3. Bekijk GitHub: github.com/smarthomeshop/ultimatesensor

Bij het vragen om hulp, vermeld:

  • Hardware versie (Basic/Complete)
  • Firmware versie
  • Connectietype (WiFi/Ethernet)
  • Beschrijving van het probleem
  • Eventuele foutmeldingen uit logs