SmartHomeShop

Nederlands

English

Nederlands

English

Appearance

Probleemoplossing ​

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

Algemene Probleemoplossing ​

Probeer deze stappen voordat je in specifieke problemen duikt:

  1. Controleer Voedingsaansluiting

    • Zorg dat USB-C kabel stevig aangesloten is
    • Probeer een andere voedingsadapter (minimaal 1A)

  2. Herstart het Apparaat

    • Haal stroom eraf, wacht 10 seconden, sluit weer aan
    • Of gebruik de "Restart" knop in Home Assistant

  3. Controleer Home Assistant

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

  4. Verifieer Netwerkverbinding

    • Controleer of apparaat verschijnt in je router's DHCP lijst
    • Check de WiFi Signal diagnostische entiteit

WiFi Connectiviteitsproblemen ​

Kan WiFi Hotspot Niet Vinden ​

Het ultimatesensor-mini hotspot zou moeten verschijnen na inschakelen:

  • Wacht 1-2 minuten — het kost tijd om te initialiseren
  • Hotspot verschijnt alleen als WiFi nog niet geconfigureerd is
  • Probeer andere apparaten — sommige telefoons/laptops zien het beter dan andere
  • Factory reset als eerder geconfigureerd (zie hieronder)

Verbonden met Hotspot maar Geen Captive Portal ​

Als de configuratiepagina niet automatisch opent:

  1. Open een browser handmatig
  2. Navigeer naar http://192.168.4.1/
  3. Probeer mobiele data uit te schakelen op je telefoon
  4. Probeer een andere browser

WiFi Verbindt Niet ​

  • Alleen 2.4 GHz — 5 GHz netwerken worden niet ondersteund
  • Controleer wachtwoord — WiFi wachtwoorden zijn hoofdlettergevoelig
  • Signaalsterkte — ga dichter bij de router staan tijdens setup
  • Speciale tekens — sommige speciale tekens in SSID/wachtwoord kunnen problemen veroorzaken

Frequente Verbroken Verbindingen ​

  • Controleer signaalsterkte — bekijk de WiFi Signal entiteit
  • Verminder interferentie van andere 2.4 GHz apparaten
  • Controleer router instellingen — sommige routers verbreken inactieve apparaten

Alternatieve WiFi Setup Methoden ​

Als de captive portal niet werkt:

  1. Improv Serial: Verbind via USB-C, gebruik ESPHome Web Tools
  2. Improv BLE: Gebruik Bluetooth voor initiële setup (uitgeschakeld na WiFi verbinding)

Fallback Hotspot Modus ​

Als de UltimateSensor Mini niet kan verbinden met WiFi, maakt het automatisch een fallback hotspot:

  • SSID: ultimatesensor-mini
  • Wachtwoord: ultimatesensor-mini

Verbind om WiFi instellingen te herconfigureren.

Voice Assistant Problemen ​

Voice Assistant Reageert Niet ​

  1. Controleer configuratie

    • Verifieer dat voice assistant is ingesteld in Home Assistant
    • Zorg dat Use wake word schakelaar AAN staat
    • Check dat Home Assistant Assist correct geconfigureerd is

  2. Controleer verbinding

    • Verifieer dat de API Connection binary sensor connected toont
    • Check WiFi signaalsterkte

  3. LED feedback

    • Front LED zou ROOD moeten worden wanneer wake word gedetecteerd wordt
    • Als geen LED reactie, wordt wake word niet gedetecteerd

Wake Word Wordt Niet Gedetecteerd ​

  • Positie: Zorg dat je duidelijk richting het apparaat spreekt
  • Afstand: Probeer dichter bij de sensor te spreken (1-3 meter werkt het beste)
  • Ruis: Verminder achtergrondgeluid
  • Configuratie: Verifieer dat wake word geconfigureerd is in Home Assistant

Audio Kwaliteitsproblemen ​

Krakend of Haperend Geluid ​

De speaker deelt resources met wake word detectie:

  1. Schakel wake word uit tijdens het afspelen van audio
  2. Controleer WiFi signaal — zwak signaal veroorzaakt buffering
  3. Verlaag volume enigszins
  4. Gebruik lokale audiobestanden in plaats van streaming wanneer mogelijk

Geen Geluid uit Speaker ​

  1. Controleer US Mini Media Player entiteit in Home Assistant
  2. Verifieer dat volume niet op 0 staat
  3. Probeer een testgeluid af te spelen:
    yaml
    service: media_player.play_media
target:
  entity_id: media_player.us_mini_media_player
data:
  media_content_id: "https://smarthomeshop.io/products/ultimatesensor-mini/v1/audio/boot1.mp3"
  media_content_type: "music"

Text-to-Speech Werkt Niet ​

  1. Verifieer dat TTS geconfigureerd is in Home Assistant
  2. Controleer of media player entiteit beschikbaar is
  3. Test met een simpele TTS aanroep:
    yaml
    service: tts.speak
target:
  entity_id: media_player.us_mini_media_player
data:
  message: "Test bericht"

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 kunnen standaard uitgeschakeld zijn in Home Assistant

Onnauwkeurige CO₂ Metingen ​

  • Initiële kalibratie: Wacht minimaal 24 uur
  • Plaatsing: Vermijd warmtebronnen en direct zonlicht
  • Handmatige kalibratie: Plaats buiten in frisse lucht voor 10+ minuten, gebruik dan "CO2 manual calibration" knop (kalibreert naar 420 ppm)
  • Zie Kalibratiehandleiding voor details

Temperatuur Meet Hoog/Laag ​

De SCD41 heeft een ingebouwde offset van -2,3°C. Als nog steeds onnauwkeurig:

  • Controleer plaatsing: Weg van warmtebronnen
  • Extra offset: Kan toegevoegd worden in ESPHome configuratie
  • Zie Kalibratiehandleiding voor instructies

Luchtvochtigheid Meet Onnauwkeurig ​

De SCD41 heeft een ingebouwde offset van +3%. Als nog steeds onnauwkeurig:

  • Plaatsing: Vermijd vochtige gebieden of tocht
  • Extra offset: Kan aangepast worden in ESPHome configuratie

mmWave Valse Positieven ​

De radar kan beweging detecteren door muren of van bewegende objecten:

  • Verminder Max Distance instelling
  • Configureer zones om problematische gebieden uit te sluiten
  • Controleer op bewegende objecten (ventilatoren, gordijnen, huisdieren)
  • Pas zonegrenzen aan om gebieden achter muren uit te sluiten

mmWave Detecteert Niet ​

  • Controleer positionering — voorkant van apparaat moet naar gemonitord gebied wijzen
  • Verifieer entiteit staten — check Target X Distance waarden
  • Off delay — standaard 15 seconden voordat "geen bezetting" gemeld wordt
  • Afstandslimiet — check Max Distance instelling

LED Problemen ​

LEDs Werken Niet ​

  1. Controleer Front light en Back light entiteiten in Home Assistant
  2. Entiteiten kunnen uitgeschakeld zijn — schakel ze eerst in
  3. Probeer handmatig aan te zetten:
    yaml
    service: light.turn_on
target:
  entity_id: light.ultimatesensor_mini_front_light
data:
  rgb_color: [255, 255, 255]

Status LED Knippert ​

  • Langzaam knipperen: Apparaat niet verbonden met WiFi of Home Assistant
  • Snel knipperen: Opstartfout — probeer stroom te cyclen

Home Assistant Integratie Problemen ​

Apparaat Niet Automatisch Ontdekt ​

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

Ontbrekende Entiteiten ​

  • Sommige entiteiten zijn standaard uitgeschakeld (Zone 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 blokkeren mogelijk communicatie
  • mDNS problemen: Probeer IP-adres te gebruiken in plaats van hostname

ESPHome Specifieke Problemen ​

Fout: default_16MB.csv Niet Gevonden ​

Als je ziet:

Could not find file '/config/esphome/default_16MB.csv'

Oplossing: Download default_16MB.csv van onze GitHub repository en plaats het in je ESPHome map.

OTA Update Mislukt ​

  • Controleer WiFi signaal tijdens update
  • Onderbreek stroom niet tijdens updates
  • Probeer USB-C flashen als OTA consistent faalt

Geavanceerde Probleemoplossing ​

Toegang tot Web Interface ​

De UltimateSensor Mini heeft een ingebouwde web interface (indien ingeschakeld):

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

Opmerking: Web server kan standaard uitgeschakeld zijn in huidige firmware.

Logs Bekijken ​

In ESPHome:

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

Factory Reset ​

Om het apparaat volledig te resetten:

  1. Schakel de Factory Reset knop entiteit in Home Assistant in (standaard uitgeschakeld)
  2. Druk op de knop
  3. Apparaat reset naar fabrieksinstellingen inclusief WiFi gegevens

Of flash nieuwe firmware via USB-C.

Firmware Update ​

Voor OTA updates:

  1. Adopteer apparaat in ESPHome Dashboard
  2. Maak eventuele wijzigingen aan YAML
  3. Klik "Install" → "Wirelessly"

Voor USB updates:

Netwerkcommunicatie & Privacy ​

100% Lokale Werking ​

De UltimateSensor Mini werkt volledig lokaal:

  • ✅ Alle sensordata blijft op je netwerk
  • ✅ Home Assistant communicatie is lokaal
  • ✅ Spraakverwerking gebeurt in Home Assistant
  • ✅ Automatiseringen draaien lokaal

Externe Communicatie ​

Beperkte externe communicatie:

  • Opstartgeluid van SmartHomeShop server (optioneel)
  • Firmware update checks (kan uitgeschakeld worden)

Nog Steeds Problemen? ​

Als geen van de bovenstaande oplossingen werkt:

  1. Join Discord: smarthomeshop.io/discord — snelste ondersteuning
  2. Neem contact op: smarthomeshop.io/contact
  3. Check GitHub: github.com/smarthomeshop/ultimatesensor-mini

Wanneer je om hulp vraagt, vermeld:

  • Hardware versie (Basic/Complete)
  • Firmware versie (Software Version entiteit)
  • Beschrijving van het probleem
  • Eventuele foutmeldingen uit logs