Gebruikshandleiding

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

Snel Starten

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

Omgevingsmonitoring

Entiteit	Toepassing
`SCD41 CO2`	Monitor luchtkwaliteit, ventilatiebehoefte
`SCD41 Temperature`	Klimaatregeling, comfortmonitoring
`SCD41 Humidity`	Vochtigheidswaarschuwingen, HVAC besturing
`BH1750 Illuminance`	Licht-gebaseerde automatiseringen
`VOC Index`	Luchtkwaliteitsmonitoring

Aanwezigheidsdetectie

Entiteit	Toepassing
`Occupancy`	Ruimte bezet (iemand aanwezig)
`PIR Sensor`	Snelle bewegingsdetectie
`Zone 1 Occupancy`	Specifieke gebiedsmonitoring
`Zone 1 Target Count`	Tel personen in zone

Real-Time Monitoring

Sensordata Bekijken

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

Historische Data

Om trends over tijd te bekijken:

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

Plaatsingsaanbevelingen

Optimale Positionering

Hoogte: 1-2 meter van de vloer
Locatie: Centraal in de ruimte, indien mogelijk weg van muren
Oriëntatie: Voorkant van apparaat gericht op het te monitoren gebied

Vermijd Deze Plaatsingen

❌ Direct zonlicht (veroorzaakt vergeling en onnauwkeurige metingen)
❌ Bij warmtebronnen (radiatoren, elektronica)
❌ Bij luchtventilatie of tocht
❌ Achter meubels of obstakels
❌ Afgesloten ruimtes met slechte luchtcirculatie

mmWave Overwegingen

De LD2450 radar:

Detecteert door dunne muren (kan zone-aanpassingen vereisen)
Werkt het best met directe lijn van zicht
Kan tot 3 personen gelijktijdig volgen

Automatiseringsvoorbeelden

1. Ventilatie op Basis van CO₂

yaml

automation:
  - alias: "Ventileer bij Hoge CO2"
    trigger:
      - platform: numeric_state
        entity_id: sensor.ultimatesensor_scd41_co2
        above: 1000
        for:
          minutes: 5
    action:
      - service: switch.turn_on
        target:
          entity_id: switch.ventilation_fan
      - service: notify.mobile_app
        data:
          title: "Luchtkwaliteit Waarschuwing"
          message: "CO₂ is {{ states('sensor.ultimatesensor_scd41_co2') }} ppm. Ventilatie gestart."

2. Lampen Aan Bij Bezetting

yaml

automation:
  - alias: "Lampen aan bij bezetting"
    trigger:
      - platform: state
        entity_id: binary_sensor.ultimatesensor_occupancy
        to: "on"
    condition:
      - condition: numeric_state
        entity_id: sensor.ultimatesensor_bh1750_illuminance
        below: 50
    action:
      - service: light.turn_on
        target:
          entity_id: light.living_room
        data:
          brightness_pct: 80

3. Lampen Uit Bij Lege Ruimte

yaml

automation:
  - alias: "Lampen uit bij lege ruimte"
    trigger:
      - platform: state
        entity_id: binary_sensor.ultimatesensor_occupancy
        to: "off"
        for:
          minutes: 5
    action:
      - service: light.turn_off
        target:
          entity_id: light.living_room

4. Temperatuurwaarschuwing

yaml

automation:
  - alias: "Hoge Temperatuur Waarschuwing"
    trigger:
      - platform: numeric_state
        entity_id: sensor.ultimatesensor_scd41_temperature
        above: 28
    action:
      - service: notify.mobile_app
        data:
          title: "Temperatuur Waarschuwing"
          message: "Kamertemperatuur is {{ states('sensor.ultimatesensor_scd41_temperature') }}°C"

5. VOC Luchtkwaliteit Waarschuwing

yaml

automation:
  - alias: "VOC Waarschuwing"
    trigger:
      - platform: numeric_state
        entity_id: sensor.ultimatesensor_voc_index
        above: 200
        for:
          minutes: 10
    action:
      - service: notify.mobile_app
        data:
          title: "Luchtkwaliteit Waarschuwing"
          message: "VOC niveaus zijn verhoogd. Overweeg de ruimte te ventileren."

6. Bewegingsgestuurde Snelle Reactie

yaml

automation:
  - alias: "Snelle bewegingsreactie"
    trigger:
      - platform: state
        entity_id: binary_sensor.ultimatesensor_pir_sensor
        to: "on"
    action:
      - service: light.turn_on
        target:
          entity_id: light.hallway

7. Zone-Gebaseerde Automatisering

yaml

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

8. Personenteller

yaml

automation:
  - alias: "Vergaderruimte vol"
    trigger:
      - platform: numeric_state
        entity_id: sensor.ultimatesensor_zone_1_target_count
        above: 2
    action:
      - service: notify.mobile_app
        data:
          title: "Vergaderruimte"
          message: "{{ states('sensor.ultimatesensor_zone_1_target_count') }} personen in de ruimte"

Dashboard Ideeën

Luchtkwaliteit Card

yaml

type: entities
title: Luchtkwaliteit
entities:
  - entity: sensor.ultimatesensor_scd41_co2
    name: CO₂
  - entity: sensor.ultimatesensor_voc_index
    name: VOC Index
  - entity: sensor.ultimatesensor_nox_index
    name: NOx Index
  - entity: sensor.ultimatesensor_pm_2_5um_weight_concentration
    name: PM2.5

Klimaat Card

yaml

type: glance
title: Kamerklimaat
entities:
  - entity: sensor.ultimatesensor_scd41_temperature
    name: Temperatuur
  - entity: sensor.ultimatesensor_scd41_humidity
    name: Vochtigheid
  - entity: sensor.ultimatesensor_bh1750_illuminance
    name: Licht

Aanwezigheid Card

yaml

type: entities
title: Ruimte Aanwezigheid
entities:
  - entity: binary_sensor.ultimatesensor_occupancy
    name: Ruimte Bezet
  - entity: binary_sensor.ultimatesensor_pir_sensor
    name: Beweging (PIR)
  - entity: binary_sensor.ultimatesensor_zone_1_occupancy
    name: Zone 1
  - entity: sensor.ultimatesensor_zone_1_target_count
    name: Personen in Zone 1

CO₂ Gauge

yaml

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

Geschiedenis Grafiek

yaml

type: history-graph
title: 24u Luchtkwaliteit
hours_to_show: 24
entities:
  - entity: sensor.ultimatesensor_scd41_co2
    name: CO₂
  - entity: sensor.ultimatesensor_scd41_temperature
    name: Temperatuur

Zone Configuratie

De UltimateSensor 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 apparaat
Zoek naar Zone X Begin/End X/Y number entiteiten
Pas waarden aan om overeen te komen met je ruimte-indeling
Test door door het gebied te lopen en Zone X Occupancy te controleren

LED Gebruik

De achter-LED kan worden gebruikt voor statusindicatie:

CO₂ Status Indicator

yaml

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

Kalibratie Herinnering

Voor nauwkeurige metingen:

CO₂: Laat 24+ uur toe voor automatische baseline kalibratie
Temperatuur: Kan offset aanpassing nodig hebben als deze te hoog meet
Vochtigheid: Over het algemeen nauwkeurig, offset beschikbaar indien nodig

👉 Zie de Kalibratiehandleiding voor gedetailleerde instructies.

ESPHome Configuratie

Het Apparaat Adopteren

Om je UltimateSensor aan te passen:

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

Packages Gebruiken (Aanbevolen)

Voor eenvoudige updates, gebruik de packages functie:

yaml

packages:
  smarthomeshop.ultimatesensor: github://smarthomeshop/ultimatesensor/ultimatesensor-v1/ultimatesensor-wifi-complete.yaml@main

Temperatuur Offset Voorbeeld

Als temperatuur te hoog meet door interne warmte:

yaml

sensor:
  - id: !extend scd41
    temperature:
      filters:
        - offset: -2.0  # Pas aan naar behoefte

Aangepaste Zone Standaardwaarden

Wijzig standaard zone grenzen:

yaml

number:
  - id: !extend zone1_begin_x
    initial_value: -2000
  - id: !extend zone1_end_x
    initial_value: 2000

Veelvoorkomende Toepassingen

Ruimte	Belangrijke Entiteiten	Automatiseringen
Woonkamer	Occupancy, CO₂, Licht	Lampen aan/uit, ventilatie
Slaapkamer	CO₂, Temperatuur, Vochtigheid	Slaapklimaat, nachtlampje
Kantoor	Zone occupancy, CO₂, Licht	Bureaulampen, vergaderdetectie
Keuken	VOC, PM, Temperatuur	Kookdetectie, afzuigkap
Badkamer	Vochtigheid, Occupancy	Ventilatorbesturing, lampen

Hulp Nodig?

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

Gebruikshandleiding ​

Snel Starten ​

Omgevingsmonitoring ​

Aanwezigheidsdetectie ​

Real-Time Monitoring ​

Sensordata Bekijken ​

Historische Data ​

Plaatsingsaanbevelingen ​

Optimale Positionering ​

Vermijd Deze Plaatsingen ​

mmWave Overwegingen ​

Automatiseringsvoorbeelden ​

1. Ventilatie op Basis van CO₂ ​

2. Lampen Aan Bij Bezetting ​

3. Lampen Uit Bij Lege Ruimte ​

4. Temperatuurwaarschuwing ​

5. VOC Luchtkwaliteit Waarschuwing ​

6. Bewegingsgestuurde Snelle Reactie ​

7. Zone-Gebaseerde Automatisering ​

8. Personenteller ​

Dashboard Ideeën ​

Luchtkwaliteit Card ​

Klimaat Card ​

Aanwezigheid Card ​

CO₂ Gauge ​

Geschiedenis Grafiek ​

Zone Configuratie ​

Zones Begrijpen ​

Voorbeeld Zone Setup ​

Zones Configureren ​

LED Gebruik ​

CO₂ Status Indicator ​

Kalibratie Herinnering ​

ESPHome Configuratie ​

Het Apparaat Adopteren ​

Packages Gebruiken (Aanbevolen) ​

Temperatuur Offset Voorbeeld ​

Aangepaste Zone Standaardwaarden ​

Veelvoorkomende Toepassingen ​

Hulp Nodig? ​

Gebruikshandleiding

Snel Starten

Omgevingsmonitoring

Aanwezigheidsdetectie

Real-Time Monitoring

Sensordata Bekijken

Historische Data

Plaatsingsaanbevelingen

Optimale Positionering

Vermijd Deze Plaatsingen

mmWave Overwegingen

Automatiseringsvoorbeelden

1. Ventilatie op Basis van CO₂

2. Lampen Aan Bij Bezetting

3. Lampen Uit Bij Lege Ruimte

4. Temperatuurwaarschuwing

5. VOC Luchtkwaliteit Waarschuwing

6. Bewegingsgestuurde Snelle Reactie

7. Zone-Gebaseerde Automatisering

8. Personenteller

Dashboard Ideeën

Luchtkwaliteit Card

Klimaat Card

Aanwezigheid Card

CO₂ Gauge

Geschiedenis Grafiek

Zone Configuratie

Zones Begrijpen

Voorbeeld Zone Setup

Zones Configureren

LED Gebruik

CO₂ Status Indicator

Kalibratie Herinnering

ESPHome Configuratie

Het Apparaat Adopteren

Packages Gebruiken (Aanbevolen)

Temperatuur Offset Voorbeeld

Aangepaste Zone Standaardwaarden

Veelvoorkomende Toepassingen

Hulp Nodig?