Gebruikshandleiding

Deze handleiding behandelt praktische manieren om je CeilSense te gebruiken in Home Assistant, inclusief automatiseringsvoorbeelden, LED-ring gebruik en dashboard tips.

Snel Starten

Na installatie en kalibratie biedt je CeilSense deze belangrijke entiteiten:

Entiteit	Gebruik Voor
Presence	Kamerbezetting detectie
Moving Target	Actieve bewegingsdetectie
Still Target	Stilstaande persoon detectie
SCD41 CO2	Luchtkwaliteitsmonitoring (alleen Complete)
SCD41 Temperature	Kamertemperatuur (alleen Complete)
SCD41 Humidity	Luchtvochtigheidsniveau (alleen Complete)
BH1750 Illuminance	Lichtniveau
CeilSense Status LED	Visuele notificaties

---

Automatiseringsvoorbeelden

1. Lichten Aan Bij Binnenkomst

alias: "Woonkamer - Licht aan bij bezetting"
trigger:
  - platform: state
    entity_id: binary_sensor.ceilsense_presence
    to: "on"
condition:
  - condition: numeric_state
    entity_id: sensor.ceilsense_bh1750_illuminance
    below: 100  # Alleen wanneer het donker is
action:
  - service: light.turn_on
    target:
      entity_id: light.woonkamer

2. Lichten Uit Bij Lege Kamer

alias: "Woonkamer - Licht uit wanneer leeg"
trigger:
  - platform: state
    entity_id: binary_sensor.ceilsense_presence
    to: "off"
    for:
      minutes: 5  # Wacht 5 minuten om valse triggers te voorkomen
action:
  - service: light.turn_off
    target:
      entity_id: light.woonkamer

3. Ventilatie Bij Hoge CO₂ (Alleen Complete)

alias: "Ventilatie - Hoge CO2 waarschuwing"
trigger:
  - platform: numeric_state
    entity_id: sensor.ceilsense_scd41_co2
    above: 1000
    for:
      minutes: 5
action:
  - service: notify.mobile_app
    data:
      title: "Luchtkwaliteit Waarschuwing"
      message: "CO₂ is {{ states('sensor.ceilsense_scd41_co2') }} ppm. Overweeg een raam te openen."
  - service: light.turn_on
    target:
      entity_id: light.ceilsense_status_led
    data:
      rgb_color: [255, 165, 0]  # Oranje waarschuwing
      brightness: 128

4. Ventilator Aan Bij Hoge CO₂

alias: "Ventilatie - Auto ventilatorbediening"
trigger:
  - platform: numeric_state
    entity_id: sensor.ceilsense_scd41_co2
    above: 1200
action:
  - service: fan.turn_on
    target:
      entity_id: fan.badkamer_ventilatie
  - wait_template: "{{ states('sensor.ceilsense_scd41_co2') | float < 800 }}"
  - service: fan.turn_off
    target:
      entity_id: fan.badkamer_ventilatie

5. Verschillende Acties voor Beweging vs. Stil Aanwezig

alias: "Kantoor - Helder licht bij werken, gedimd bij afwezig"
trigger:
  - platform: state
    entity_id: binary_sensor.ceilsense_moving_target
  - platform: state
    entity_id: binary_sensor.ceilsense_still_target
action:
  - choose:
      # Actieve beweging - helder licht
      - conditions:
          - condition: state
            entity_id: binary_sensor.ceilsense_moving_target
            state: "on"
        sequence:
          - service: light.turn_on
            target:
              entity_id: light.kantoor
            data:
              brightness_pct: 100
      # Alleen stil aanwezig - gedimd licht
      - conditions:
          - condition: state
            entity_id: binary_sensor.ceilsense_still_target
            state: "on"
          - condition: state
            entity_id: binary_sensor.ceilsense_moving_target
            state: "off"
        sequence:
          - service: light.turn_on
            target:
              entity_id: light.kantoor
            data:
              brightness_pct: 50
      # Geen aanwezigheid - lichten uit
      - conditions:
          - condition: state
            entity_id: binary_sensor.ceilsense_presence
            state: "off"
        sequence:
          - service: light.turn_off
            target:
              entity_id: light.kantoor

6. Adaptieve Verlichting Op Basis van Lux

alias: "Woonkamer - Adaptieve helderheid"
trigger:
  - platform: state
    entity_id: binary_sensor.ceilsense_presence
    to: "on"
action:
  - service: light.turn_on
    target:
      entity_id: light.woonkamer
    data:
      # Helderder wanneer het donkerder is buiten
      brightness_pct: >
        {% set lux = states('sensor.ceilsense_bh1750_illuminance') | float %}
        {% if lux < 50 %}100
        {% elif lux < 200 %}75
        {% elif lux < 500 %}50
        {% else %}25{% endif %}

7. Slaapkamer - Geen Licht Tijdens Slapen

alias: "Slaapkamer - Detecteer slapen"
trigger:
  - platform: state
    entity_id: binary_sensor.ceilsense_still_target
    to: "on"
    for:
      minutes: 30  # 30 minuten stil = waarschijnlijk slapen
condition:
  - condition: time
    after: "22:00:00"
    before: "08:00:00"
action:
  - service: input_boolean.turn_on
    target:
      entity_id: input_boolean.slaapkamer_slaapmodus

---

LED Ring Gebruik

De CeilSense heeft een 16-LED RGB ring die je kunt gebruiken voor visuele notificaties en status-indicatoren.

Bediening via Home Assistant

# Aanzetten met specifieke kleur
service: light.turn_on
target:
  entity_id: light.ceilsense_status_led
data:
  rgb_color: [255, 0, 0]  # Rood
  brightness: 128

# Uitzetten
service: light.turn_off
target:
  entity_id: light.ceilsense_status_led

Kleur Ideeën voor Status Indicatoren

Kleur	RGB Waarde	Suggestie
🔴 Rood	[255, 0, 0]	Hoge CO₂, alarm, fout
🟠 Oranje	[255, 165, 0]	Waarschuwing, matige CO₂
🟡 Geel	[255, 255, 0]	Let op, aandacht nodig
🟢 Groen	[0, 255, 0]	Goede luchtkwaliteit, OK status
🔵 Blauw	[0, 0, 255]	Informatie, aanwezigheid gedetecteerd
🟣 Paars	[128, 0, 128]	Nachtmodus, speciale status
⚪ Wit	[255, 255, 255]	Algemene verlichting, neutraal

CO₂ Niveau LED Indicator Automatisering

alias: "CeilSense - CO2 LED indicator"
trigger:
  - platform: state
    entity_id: sensor.ceilsense_scd41_co2
action:
  - choose:
      # Goede luchtkwaliteit
      - conditions:
          - condition: numeric_state
            entity_id: sensor.ceilsense_scd41_co2
            below: 800
        sequence:
          - service: light.turn_on
            target:
              entity_id: light.ceilsense_status_led
            data:
              rgb_color: [0, 255, 0]
              brightness: 50
      # Matig
      - conditions:
          - condition: numeric_state
            entity_id: sensor.ceilsense_scd41_co2
            above: 800
            below: 1200
        sequence:
          - service: light.turn_on
            target:
              entity_id: light.ceilsense_status_led
            data:
              rgb_color: [255, 165, 0]
              brightness: 100
      # Slecht
      - conditions:
          - condition: numeric_state
            entity_id: sensor.ceilsense_scd41_co2
            above: 1200
        sequence:
          - service: light.turn_on
            target:
              entity_id: light.ceilsense_status_led
            data:
              rgb_color: [255, 0, 0]
              brightness: 200

mode: restart

Belangrijke Opmerkingen Over LED Ring

⚠️ Warmte Waarschuwing: Langdurig gebruik van de LED-ring op hoge helderheid genereert warmte die temperatuur-, luchtvochtigheids- en CO₂-metingen kan beïnvloeden. Voor continue status-indicatoren, gebruik lage helderheid (50-100) of implementeer afkoelperiodes.

---

Dashboard Ideeën

Aanbevolen Entiteiten voor Je Dashboard

Essentieel:

• binary_sensor.ceilsense_presence — Hoofd bezettingsindicator
• sensor.ceilsense_scd41_co2 — Luchtkwaliteit (alleen Complete)

Omgevingsmonitoring:

• sensor.ceilsense_scd41_temperature
• sensor.ceilsense_scd41_humidity
• sensor.ceilsense_bh1750_illuminance
• sensor.ceilsense_bmp3xx_pressure

Geavanceerd/Debugging:

• binary_sensor.ceilsense_moving_target
• binary_sensor.ceilsense_still_target
• sensor.ceilsense_detection_distance

Voorbeeld Dashboard Card (YAML)

type: entities
title: Woonkamer Klimaat
entities:
  - entity: binary_sensor.ceilsense_presence
    name: Bezetting
  - entity: sensor.ceilsense_scd41_co2
    name: CO₂
  - entity: sensor.ceilsense_scd41_temperature
    name: Temperatuur
  - entity: sensor.ceilsense_scd41_humidity
    name: Luchtvochtigheid
  - entity: sensor.ceilsense_bh1750_illuminance
    name: Lichtniveau

Gauge Card voor CO₂

type: gauge
entity: sensor.ceilsense_scd41_co2
name: Luchtkwaliteit
min: 400
max: 2000
severity:
  green: 400
  yellow: 800
  red: 1200

---

Best Practices

Montagelocatie

✅ Doe:

• Monteer in het midden van de kamer voor gelijkmatige dekking
• Houd 2-4 meter boven de vloer
• Positioneer weg van direct zonlicht
• Zorg voor enige luchtstroom rond de sensor

❌ Doe niet:

• Monteer direct boven een warmtebron (radiator, lamp)
• Plaats waar plafondventilatoren valse detecties veroorzaken
• Installeer in ruimtes met hoge luchtvochtigheid zonder IP-bescherming (badkamerstoom)
• Monteer waar radar door dunne muren naar aangrenzende kamers kan zien

Detectie Optimaliseren

• Verminder valse positieven: Verlaag de Maximum Distance Gate naar je kamergrootte
• Verbeter stille detectie: Verhoog stille gevoeligheid als zittende mensen niet gedetecteerd worden
• Vermijd huisdiertriggers: Verhoog bewegingsdrempels of verminder detectiebereik
• Plafondventilator problemen: Voer Dynamic Background Correction uit met ventilator AAN

Omgevingssensor Nauwkeurigheid

• Temperatuur te hoog? Verminder LED-helderheid, voeg temperatuur-offset toe
• CO₂ metingen incorrect? Voer handmatige kalibratie uit in verse lucht, wacht tot ABC stabiliseert
• Luchtvochtigheid onnauwkeurig? Kalibreer eerst temperatuur, pas dan luchtvochtigheid-offset aan

Zie de Kalibratie Handleiding voor gedetailleerde tuning instructies.

---

Veelvoorkomende Toepassingen

Kamer	Primair Gebruik	Belangrijke Entiteiten
Woonkamer	Lichtbediening, bezetting	Presence, Lux
Slaapkamer	Slaapdetectie, nachtmodus	Still Target, Presence
Kantoor	Werkdetectie, luchtkwaliteit	Presence, CO₂
Badkamer	Ventilatiebediening	Presence, Humidity
Keuken	Kookdetectie, ventilatie	Movement, CO₂
Gang	Bewegingsgeactiveerde verlichting	Moving Target

---

Hulp Nodig?

• Kalibratie Handleiding — Optimaliseer sensorprestaties
• Sensor Definities — Begrijp alle entiteiten
• Probleemoplossing — Veelvoorkomende problemen
• FAQ — Veelgestelde vragen