Gebruikershandleiding

Deze handleiding helpt je het maximale uit je UltimateSensor Mini te halen met Home Assistant, inclusief monitoring, voice assistant, automatiseringen en dashboard ideeën.

Snel Starten

Na installatie zijn dit de belangrijkste entiteiten die je het meest zult gebruiken:

Omgevingsmonitoring

Entiteit	Gebruik
`SCD41 CO2`	Monitor luchtkwaliteit, ventilatiebehoeften
`SCD41 Temperature`	Klimaatregeling, comfortmonitoring
`SCD41 Humidity`	Vochtigheidswaarschuwingen, HVAC regeling
`BH1750 Illuminance`	Licht-gebaseerde automatiseringen
`VOC Index`	Luchtkwaliteitsmonitoring

Aanwezigheidsdetectie

Entiteit	Gebruik
`Occupancy`	Kamer bezet (iemand aanwezig)
`Zone 1 Occupancy`	Specifieke gebiedsmonitoring
`Zone 1 Target Count`	Tel personen in zone

Voice & Audio

Entiteit	Gebruik
`US Mini Media Player`	TTS mededelingen, alarmen
`Use wake word`	Voice commando activering
`Front light` / `Back light`	Visuele feedback

Real-Time Monitoring

Sensordata Bekijken

Open Home Assistant → Instellingen → Apparaten & Services
Vind ESPHome integratie
Klik op je UltimateSensor Mini apparaat
Bekijk alle entiteiten en hun huidige waarden

Historische Data

Om trends in de tijd te bekijken:

Navigeer naar Geschiedenis in Home Assistant
Selecteer de tijdsperiode (uur, dag, week, maand)
Kies de UltimateSensor Mini entiteiten om weer te geven

Voice Assistant Setup

De UltimateSensor Mini heeft ingebouwde voice assistant mogelijkheden.

Basis Setup

Configureer Voice Assistant in Home Assistant
- Ga naar Instellingen → Voice Assistants
- Stel je gewenste assistent in (bijv. Home Assistant Cloud, lokale Whisper)
Schakel Wake Word in
- Vind de Use wake word schakelaar in Home Assistant
- Zet deze AAN
Configureer Wake Word
- Configureer in Home Assistant je gewenste wake word
- Het apparaat luistert continu wanneer ingeschakeld

Voice LED Feedback

Rood: Wake word gedetecteerd, luistert
Uit: Verwerkt spraakcommando

Media Player Gebruik

De US Mini Media Player kan gebruikt worden voor:

yaml

# Text-to-speech mededeling
service: tts.speak
target:
  entity_id: media_player.us_mini_media_player
data:
  message: "Welkom thuis!"

# Audio bestand afspelen
service: media_player.play_media
target:
  entity_id: media_player.us_mini_media_player
data:
  media_content_id: "https://example.com/sound.mp3"
  media_content_type: "music"

# Volume instellen
service: media_player.volume_set
target:
  entity_id: media_player.us_mini_media_player
data:
  volume_level: 0.5

👉 Zie de Voice Assistant Handleiding voor gedetailleerde setup.

Plaatsingsaanbevelingen

Optimale Positionering

Hoogte: 1-2 meter van de vloer
Locatie: Centraal in de kamer, goede zichtlijn
Voice: Positioneer waar spraakcommando's duidelijk gehoord kunnen worden
mmWave: Voorkant van apparaat gericht naar het te monitoren gebied

Vermijd Deze Plaatsingen

❌ Direct zonlicht (veroorzaakt verkleuring en onnauwkeurige metingen)
❌ Nabij warmtebronnen (radiatoren, elektronica)
❌ Nabij luide geluidsbronnen (beïnvloedt spraakherkenning)
❌ Achter meubels of obstakels
❌ In afgesloten ruimtes met slechte luchtcirculatie

Automatiseringsvoorbeelden

1. Ventilatie Gebaseerd op CO₂

yaml

automation:
  - alias: "Ventileren bij Hoge CO2"
    trigger:
      - platform: numeric_state
        entity_id: sensor.ultimatesensor_mini_scd41_co2
        above: 1000
        for:
          minutes: 5
    action:
      - service: switch.turn_on
        target:
          entity_id: switch.ventilatie_fan
      - service: tts.speak
        target:
          entity_id: media_player.us_mini_media_player
        data:
          message: "CO2 niveaus zijn hoog. Ventilatie gestart."

2. Welkom Thuis Mededeling

yaml

automation:
  - alias: "Welkom Thuis"
    trigger:
      - platform: state
        entity_id: binary_sensor.ultimatesensor_mini_occupancy
        from: "off"
        to: "on"
    condition:
      - condition: state
        entity_id: input_boolean.afwezig_modus
        state: "on"
    action:
      - service: input_boolean.turn_off
        target:
          entity_id: input_boolean.afwezig_modus
      - service: tts.speak
        target:
          entity_id: media_player.us_mini_media_player
        data:
          message: "Welkom thuis!"

3. Lichten Aan Bij Bezetting

yaml

automation:
  - alias: "Lichten aan bij bezetting"
    trigger:
      - platform: state
        entity_id: binary_sensor.ultimatesensor_mini_occupancy
        to: "on"
    condition:
      - condition: numeric_state
        entity_id: sensor.ultimatesensor_mini_bh1750_illuminance
        below: 50
    action:
      - service: light.turn_on
        target:
          entity_id: light.woonkamer
        data:
          brightness_pct: 80

4. CO₂ LED Indicator

yaml

automation:
  - alias: "CO2 LED indicator"
    trigger:
      - platform: state
        entity_id: sensor.ultimatesensor_mini_scd41_co2
    action:
      - choose:
          - conditions:
              - condition: numeric_state
                entity_id: sensor.ultimatesensor_mini_scd41_co2
                below: 800
            sequence:
              - service: light.turn_on
                target:
                  entity_id: light.ultimatesensor_mini_front_light
                data:
                  rgb_color: [0, 255, 0]  # Groen
          - conditions:
              - condition: numeric_state
                entity_id: sensor.ultimatesensor_mini_scd41_co2
                above: 800
                below: 1200
            sequence:
              - service: light.turn_on
                target:
                  entity_id: light.ultimatesensor_mini_front_light
                data:
                  rgb_color: [255, 165, 0]  # Oranje
          - conditions:
              - condition: numeric_state
                entity_id: sensor.ultimatesensor_mini_scd41_co2
                above: 1200
            sequence:
              - service: light.turn_on
                target:
                  entity_id: light.ultimatesensor_mini_front_light
                data:
                  rgb_color: [255, 0, 0]  # Rood

5. Alarmgeluid

yaml

automation:
  - alias: "Beveiligingsalarm"
    trigger:
      - platform: state
        entity_id: binary_sensor.ultimatesensor_mini_occupancy
        to: "on"
    condition:
      - condition: state
        entity_id: alarm_control_panel.thuis
        state: "armed_away"
    action:
      - 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/alarm.mp3"
          media_content_type: "music"

6. Temperatuur Waarschuwing

yaml

automation:
  - alias: "Hoge Temperatuur Waarschuwing"
    trigger:
      - platform: numeric_state
        entity_id: sensor.ultimatesensor_mini_scd41_temperature
        above: 28
    action:
      - service: tts.speak
        target:
          entity_id: media_player.us_mini_media_player
        data:
          message: "Temperatuur is {{ states('sensor.ultimatesensor_mini_scd41_temperature') }} graden"

7. Zone-Gebaseerde Aanwezigheid

yaml

automation:
  - alias: "Bureau zone bezet"
    trigger:
      - platform: state
        entity_id: binary_sensor.ultimatesensor_mini_zone_1_occupancy
        to: "on"
    action:
      - service: light.turn_on
        target:
          entity_id: light.bureau_lamp

Dashboard Ideeën

Luchtkwaliteit Kaart

yaml

type: entities
title: Luchtkwaliteit
entities:
  - entity: sensor.ultimatesensor_mini_scd41_co2
    name: CO₂
  - entity: sensor.ultimatesensor_mini_voc_index
    name: VOC Index
  - entity: sensor.ultimatesensor_mini_nox_index
    name: NOx Index

Klimaat Kaart

yaml

type: glance
title: Kamer Klimaat
entities:
  - entity: sensor.ultimatesensor_mini_scd41_temperature
    name: Temperatuur
  - entity: sensor.ultimatesensor_mini_scd41_humidity
    name: Luchtvochtigheid
  - entity: sensor.ultimatesensor_mini_bh1750_illuminance
    name: Licht

Aanwezigheid Kaart

yaml

type: entities
title: Kamer Aanwezigheid
entities:
  - entity: binary_sensor.ultimatesensor_mini_occupancy
    name: Kamer Bezet
  - entity: binary_sensor.ultimatesensor_mini_zone_1_occupancy
    name: Zone 1
  - entity: sensor.ultimatesensor_mini_zone_1_target_count
    name: Personen in Zone 1

Voice Assistant Kaart

yaml

type: entities
title: Voice Assistant
entities:
  - entity: switch.ultimatesensor_mini_use_wake_word
    name: Wake Word Actief
  - entity: media_player.us_mini_media_player
    name: Media Player
  - entity: light.ultimatesensor_mini_front_light
    name: Front LED

CO₂ Meter

yaml

type: gauge
entity: sensor.ultimatesensor_mini_scd41_co2
name: CO₂ Niveau
min: 400
max: 2000
severity:
  green: 400
  yellow: 800
  red: 1200

Zone Configuratie

De UltimateSensor Mini ondersteunt 4 configureerbare detectiezones voor mmWave radar.

Zones Begrijpen

Elke zone is een rechthoekig gebied gedefinieerd door X en Y coördinaten:

        Sensor (0,0)
           |
    -X <---+---> +X
           |
           v
          +Y (afstand van sensor)

Voorbeeld Zone Setup

Zone 1: Bureau Gebied

Begin X: -1000 mm (1m links van midden)
End X: 1000 mm (1m rechts van midden)
Begin Y: 500 mm (0,5m van sensor)
End Y: 2000 mm (2m van sensor)

Zones Configureren

Vind in Home Assistant je UltimateSensor Mini apparaat
Zoek de Zone X Begin/End X/Y number entiteiten
Pas waarden aan om overeen te komen met je kamerindeling
Test door door het gebied te lopen en Zone X Occupancy te controleren

LED Gebruik

Beide LEDs kunnen gebruikt worden voor visuele feedback:

Status Indicator Voorbeeld

yaml

automation:
  - alias: "Status LED"
    trigger:
      - platform: state
        entity_id: binary_sensor.ultimatesensor_mini_occupancy
    action:
      - choose:
          - conditions:
              - condition: state
                entity_id: binary_sensor.ultimatesensor_mini_occupancy
                state: "on"
            sequence:
              - service: light.turn_on
                target:
                  entity_id: light.ultimatesensor_mini_back_light
                data:
                  rgb_color: [0, 255, 0]
                  brightness: 50
          - conditions:
              - condition: state
                entity_id: binary_sensor.ultimatesensor_mini_occupancy
                state: "off"
            sequence:
              - service: light.turn_off
                target:
                  entity_id: light.ultimatesensor_mini_back_light

Kalibratie Herinnering

Voor nauwkeurige metingen:

CO₂: Laat 24+ uur voor automatische baseline kalibratie (kalibreert naar 420 ppm)
Temperatuur: Ingebouwde offset van -2,3°C, mogelijk verdere aanpassing nodig
Luchtvochtigheid: Ingebouwde offset van +3%, mogelijk aanpassing nodig

👉 Zie de Kalibratiehandleiding voor gedetailleerde instructies.

ESPHome Configuratie

Het Apparaat Adopteren

Om je UltimateSensor Mini aan te passen:

Open ESPHome Dashboard in Home Assistant
Het apparaat zou moeten verschijnen als "Discovered"
Klik Adopt om het toe te voegen aan je ESPHome
Bewerk de YAML configuratie naar wens
Klik Install om wijzigingen via OTA te deployen

Packages Gebruiken (Aanbevolen)

Voor eenvoudige updates, gebruik de packages feature:

yaml

packages:
  smarthomeshop.ultimatesensor_mini: github://smarthomeshop/ultimatesensor-mini/ultimatesensor-mini-v1/ultimatesensor-mini-basic.yaml@main

Temperatuur Offset Voorbeeld

Als temperatuur nog steeds te hoog/laag meet:

yaml

sensor:
  - id: !extend my_scd41
    temperature:
      filters:
        - offset: -1.0  # Extra offset indien nodig

Veelvoorkomende Gebruikssituaties

Kamer	Belangrijkste Entiteiten	Features
Woonkamer	Occupancy, CO₂, Licht	Lichten, TTS mededelingen
Slaapkamer	CO₂, Temperatuur, Voice	Slaapklimaat, wakker alarmen
Kantoor	Zone occupancy, CO₂, Voice	Bureau aanwezigheid, vergader alerts
Keuken	VOC, Temperatuur, Voice	Kook alerts, timers
Gang	Occupancy, Voice	Welkom mededelingen

Hulp Nodig?

Discord: smarthomeshop.io/discord
Probleemoplossing: Probleemoplossing Handleiding
FAQ: Veelgestelde Vragen
Voice Setup: Voice Assistant Handleiding

Gebruikershandleiding ​

Snel Starten ​

Omgevingsmonitoring ​

Aanwezigheidsdetectie ​

Voice & Audio ​

Real-Time Monitoring ​

Sensordata Bekijken ​

Historische Data ​

Voice Assistant Setup ​

Basis Setup ​

Voice LED Feedback ​

Media Player Gebruik ​

Plaatsingsaanbevelingen ​

Optimale Positionering ​

Vermijd Deze Plaatsingen ​

Automatiseringsvoorbeelden ​

1. Ventilatie Gebaseerd op CO₂ ​

2. Welkom Thuis Mededeling ​

3. Lichten Aan Bij Bezetting ​

4. CO₂ LED Indicator ​

5. Alarmgeluid ​

6. Temperatuur Waarschuwing ​

7. Zone-Gebaseerde Aanwezigheid ​

Dashboard Ideeën ​

Luchtkwaliteit Kaart ​

Klimaat Kaart ​

Aanwezigheid Kaart ​

Voice Assistant Kaart ​

CO₂ Meter ​

Zone Configuratie ​

Zones Begrijpen ​

Voorbeeld Zone Setup ​

Zones Configureren ​

LED Gebruik ​

Status Indicator Voorbeeld ​

Kalibratie Herinnering ​

ESPHome Configuratie ​

Het Apparaat Adopteren ​

Packages Gebruiken (Aanbevolen) ​

Temperatuur Offset Voorbeeld ​

Veelvoorkomende Gebruikssituaties ​

Hulp Nodig? ​

Gebruikershandleiding

Snel Starten

Omgevingsmonitoring

Aanwezigheidsdetectie

Voice & Audio

Real-Time Monitoring

Sensordata Bekijken

Historische Data

Voice Assistant Setup

Basis Setup

Voice LED Feedback

Media Player Gebruik

Plaatsingsaanbevelingen

Optimale Positionering

Vermijd Deze Plaatsingen

Automatiseringsvoorbeelden

1. Ventilatie Gebaseerd op CO₂

2. Welkom Thuis Mededeling

3. Lichten Aan Bij Bezetting

4. CO₂ LED Indicator

5. Alarmgeluid

6. Temperatuur Waarschuwing

7. Zone-Gebaseerde Aanwezigheid

Dashboard Ideeën

Luchtkwaliteit Kaart

Klimaat Kaart

Aanwezigheid Kaart

Voice Assistant Kaart

CO₂ Meter

Zone Configuratie

Zones Begrijpen

Voorbeeld Zone Setup

Zones Configureren

LED Gebruik

Status Indicator Voorbeeld

Kalibratie Herinnering

ESPHome Configuratie

Het Apparaat Adopteren

Packages Gebruiken (Aanbevolen)

Temperatuur Offset Voorbeeld

Veelvoorkomende Gebruikssituaties

Hulp Nodig?