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:

Ingebouwde LED-functies

CeilSense regelt verschillende LED-functies al rechtstreeks in de firmware. Je hoeft hiervoor geen Home Assistant-automatisering te maken:

• Bewegingslamp: schakelt in wanneer de radar een bewegend doel detecteert.
• Nachtlamp: schakelt met de ingestelde helderheid in wanneer tijdens de ingestelde nachturen alleen stilstaande aanwezigheid wordt gedetecteerd.
• CO2-waarschuwing: knippert drie keer oranje wanneer de waarschuwingsgrens wordt bereikt (alleen Complete).
• Kritieke CO2-melding: knippert drie keer rood wanneer de kritieke grens wordt bereikt (alleen Complete).

De firmware verwerkt deze functies in een vaste prioriteitsvolgorde. Daardoor kunnen CO2-meldingen, de bewegingslamp en de nachtlamp de LED-ring niet tegelijk aansturen.

Bekijk LED-verlichting voor de exacte prioriteit, alle instellingen en probleemoplossing.

Optionele Home Assistant-automatiseringen

De onderstaande voorbeelden zijn optionele uitbreidingen om andere apparaten aan te sturen of gedrag toe te voegen dat niet in de ingebouwde CeilSense LED-functies zit.

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

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.

De bewegingslamp, nachtlamp en CO2-waarschuwingen uit LED-verlichting zijn al ingebouwd in de firmware. De onderstaande Home Assistant-voorbeelden zijn alleen nodig wanneer je de ring handmatig wilt aansturen of een ander visueel effect wilt maken.

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

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,5 tot 3 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: Verlaag de stille drempel in de HLK Radar Tool app als zittende mensen niet gedetecteerd worden
• Vermijd huisdiertriggers: Verhoog de bewegingsdrempel in de HLK Radar Tool app 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. Automatische kalibratie staat standaard uit
• Luchtvochtigheid onnauwkeurig? Kalibreer eerst temperatuur, pas dan luchtvochtigheid-offset aan

Zie de Kalibratie Handleiding voor gedetailleerde tuning instructies.

Veelvoorkomende Toepassingen

Hulp Nodig?

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