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

Aanwezigheidsdetectie

Real-Time Monitoring

Sensordata Bekijken

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

Historische Data

Om trends over tijd te bekijken:

1. Navigeer naar Geschiedenis in Home Assistant
2. Selecteer de tijdsperiode (uur, dag, week, maand)
3. 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

Let op: De entiteit-ID's hieronder beginnen met ultimatesensor. In Home Assistant bevatten ze ook de zes tekens van jouw apparaat, bijvoorbeeld sensor.ultimatesensor_1a2b3c_scd41_co2. Kopieer de echte ID's van de apparaatpagina en vervang de voorbeelden.

1. Ventilatie op Basis van CO₂

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

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

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

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

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

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

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

8. Personenteller

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

Dashboard Ideeën

Luchtkwaliteit Card

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

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

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_polygon_zone_1_presence
    name: Zone 1
  - entity: sensor.ultimatesensor_polygon_zone_1_target_count
    name: Personen in Zone 1

CO₂ Gauge

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

Geschiedenis Grafiek

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 polygonzones, 2 uitsluitingszones en 2 tellijnen voor mmWave radar. Je tekent ze in de Room Designer van de SmartHomeShop-integratie.

Zones Begrijpen

Elke zone is een vorm van tot 20 punten in de X- en Y-coördinaten van de radar:

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

Voorbeeld Zone Setup

Zone 1: Bureau Gebied

• Teken een vorm rond je bureau
• Voeg een uitsluitingszone toe over een spiegel of raam als de radar daar reflecties ziet
• Voeg een tellijn toe in de deuropening als je People Count wilt gebruiken

Zones Configureren

1. Open SmartHomeShop in de zijbalk van Home Assistant en ga naar de Room Designer
2. Teken je zones en sla op
3. Test door door het gebied te lopen en Polygon Zone 1 Presence te controleren

LED Gebruik

De achter-LED kan worden gebruikt voor statusindicatie. De firmware heeft al een bewegingslicht, nachtlampje en CO₂-waarschuwing, zie Sensor Definities. Het voorbeeld hieronder heb je alleen nodig voor eigen kleuren:

CO₂ Status Indicator

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:

1. Open ESPHome Device Builder in Home Assistant
2. De UltimateSensor zou moeten verschijnen als "Discovered"
3. Klik op Adopt om het aan je ESPHome toe te voegen
4. Bewerk de YAML configuratie naar wens
5. Klik op Install om wijzigingen via OTA te deployen

Packages Gebruiken (Aanbevolen)

Voor eenvoudige updates, gebruik de packages functie:

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

Temperatuur Offset Voorbeeld

Als temperatuur te hoog meet door interne warmte:

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

Veelvoorkomende Toepassingen

Hulp Nodig?

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