Kalibratie Handleiding voor CeilSense

Het kalibreren van je CeilSense zorgt voor nauwkeurige detectie en metingen. Elke installatie is uniek — plafondmaterialen, kamerindeling en omgevingsfactoren kunnen allemaal de sensorprestaties beïnvloeden.

Deze handleiding behandelt:

• mmWave Radar Tuning — Beschikbaar op zowel Basic als Complete varianten
• Omgevingssensor Kalibratie (CO₂, temperatuur, luchtvochtigheid) — Alleen Complete variant

Je Installatie Begrijpen

Elke CeilSense installatie is anders. Factoren die de prestaties kunnen beïnvloeden:

Voor mmWave detectie:

• Kamerindeling: Meubels, muren en obstakels beïnvloeden de radardekking
• Aangrenzende kamers: mmWave kan door dunne muren dringen
• Bewegende objecten: Plafondventilatoren, huisdieren of gordijnen
• Montagehoogte: Detectiepatronen veranderen op basis van plafondhoogte (2-4m aanbevolen)

Voor omgevingssensoren (alleen Complete):

• Plafondmateriaal: Sommige materialen houden meer warmte vast
• Isolatie: Goed geïsoleerde plafonds kunnen warme lucht rond de sensor vasthouden
• LED-ring gebruik: Langdurig gebruik van de RGB-LEDs genereert warmte

mmWave Radar Tuning

Eerste Setup: Kalibreren voor Jouw Kamer

Belangrijk: Na installatie moet de mmWave sensor jouw specifieke kameromgeving leren kennen. Zonder goede kalibratie kun je constante aanwezigheidsdetectie of hoge bewegingsenergie-waarden ervaren.

Waarom kalibratie nodig is:

De LD2412 mmWave radar is extreem gevoelig en kan detecteren:

• Beweging door muren (24GHz radar kan door gipsplaat en dunne muren)
• Plafondventilatoren (zelfs langzaam draaiend)
• HVAC luchtstroom (bewegende gordijnen, planten)
• Reflecterende oppervlakken (metalen objecten, spiegels)
• Huisdieren in de detectiezone

Stap 1: Voer Dynamic Background Correction Uit (BELANGRIJKST!)

Dit is de #1 oplossing voor constante valse detectie:

1. MAAK DE KAMER VOLLEDIG LEEG — Geen mensen, geen huisdieren
2. Zet plafondventilatoren uit en sluit ramen
3. Zoek in Home Assistant de "Start Dynamic Background Correction" knop
4. Druk op de knop en wacht tot het proces voltooid is
5. De sensor leert wat "leeg" eruitziet

Kritiek: Als je Dynamic Background Correction uitvoert terwijl iemand in de kamer is, zal detectie niet goed werken!

Stap 2: Verminder Maximale Detectieafstand

Als je door muren heen detecteert naar aangrenzende kamers:

1. Zoek in Home Assistant naar "Maximum Distance Gate"
2. Verminder deze van de standaard (13) naar je werkelijke kamergrootte
3. Elke gate is ongeveer 0.75 meter
4. Voor een 4m kamer, probeer max gate op 5-6 te zetten

Stap 3: Verhoog Gate Drempels

Als specifieke afstands-gates hoge energie tonen:

1. Schakel Engineering Mode in om realtime energie per gate te zien
2. Identificeer welke gates constant hoge energie tonen
3. Verhoog de Move Threshold en Still Threshold voor die gates

Stap 4: Factory Reset (Laatste Redmiddel)

1. Druk op de "Factory Reset" knop in Home Assistant
2. Voer Dynamic Background Correction opnieuw uit met een lege kamer

Tuning Methodes

Methode 1: Via Home Assistant (Aanbevolen)

1. Open Home Assistant → Instellingen → Apparaten & Diensten → ESPHome
2. Selecteer je CeilSense apparaat
3. Zoek de LD2412 bedieningselementen:

Afstandsinstellingen:

• Minimum Distance Gate: Minimale detectieafstand (gates 1-12, elke gate ≈ 0.75m)
• Maximum Distance Gate: Maximale detectieafstand (gates 2-13)
• Presence Timeout: Tijd dat aanwezigheid actief blijft na geen detectie

Per-Gate Drempelinstellingen (Gate 0-13):

• Gate X Move Threshold: Drempel voor bewegingsdetectie (0-100)
• Gate X Still Threshold: Drempel voor stille aanwezigheid (0-100)

Tip: Lagere drempelwaarden = gevoeliger. Hogere waarden = minder gevoelig.

Methode 2: Via HLK Radar Tool App

1. Download "HLK Radar Tool" (iOS App Store of Google Play)
2. Verbind via Bluetooth met je CeilSense
3. Pas Move/Still drempels per gate aan

Tuning Tips

Scenario	Aanbevolen Aanpassing
Valse triggers door muren	Verminder maximale detectieafstand
Huisdieren triggeren sensor	Verlaag bewegingsgevoeligheid
Zittend/liggend niet gedetecteerd	Verhoog stille gevoeligheid
Plafondventilator valse triggers	Verminder gevoeligheid bovenste gates

CO₂ Sensor Kalibratie (Alleen Complete)

De CeilSense Complete gebruikt de Sensirion SCD41 sensor.

Specificaties:

• CO₂ Meetbereik: 400 tot 5.000 ppm
• Temperatuur Meetbereik: -10 tot 60°C
• Luchtvochtigheid Meetbereik: 0 tot 100% RH

Automatische Zelfkalibratie (ASC)

Standaard is ASC uitgeschakeld. Dit is bewust omdat ASC vereist dat de sensor regelmatig verse lucht (400 ppm) ziet.

Handmatige CO₂ Kalibratie

1. Zorg dat de kamer goed geventileerd is (ramen open ≥3 minuten)
2. Ga naar Instellingen → Apparaten & Diensten → ESPHome → CeilSense
3. Druk op "CO2 manual calibration (fresh air ≥3min)"
4. De sensor kalibreert naar 426 ppm

CO₂ Niveaus en Gezondheid

• 350-450 ppm: Gezond buitenluchtniveau
• 600 ppm: Goede binnenluchtkwaliteit
• 1.000 ppm: Ventilatie aanbevolen
• 2.000 ppm: Slechte luchtkwaliteit

Temperatuur Kalibratie

De CeilSense heeft al een ingebouwde temperatuur-offset van 15°C totaal om te compenseren voor warmte van elektronica en plafondholte.

Methode 1: Via Home Assistant (Makkelijk)

1. Meet referentietemperatuur met een betrouwbare thermometer
2. Ga naar Instellingen → Apparaten & Diensten → ESPHome → CeilSense
3. Zoek "SCD4x Extra Temperature Offset (°C)"
4. Voer je offsetwaarde in (bereik -20 tot +20)

Methode 2: Via ESPHome Substitutions

substitutions:
  scd4x_temperature_offset: "12.0"  # Standaard is 10.0

Luchtvochtigheid Kalibratie

1. Meet referentie luchtvochtigheid met een gekalibreerde hygrometer
2. Ga naar CeilSense in Home Assistant
3. Zoek "SCD4x Humidity Offset (%)"
4. Voer je offsetwaarde in (bereik -20 tot +20)

Lichtsensor Kalibratie

Via ESPHome door de sensor uit te breiden:

sensor:
  - id: !extend illuminance
    filters:
      - multiply: 1.1  # Pas aan indien nodig

Barometrische Druk Kalibratie

sensor:
  - id: !extend bmp_pressure
    filters:
      - offset: 5.0  # In hPa

Geavanceerde ESPHome Configuratie

Beschikbare SCD41 Substitutions

substitutions:
  scd4x_i2c_id: "bus_a"
  scd4x_address: "0x62"
  scd4x_measurement_mode: "low_power_periodic"  # of "periodic"
  scd4x_update_interval: "30s"
  scd4x_asc: "false"  # Automatische Zelfkalibratie
  scd4x_temperature_offset: "10.0"

Wanneer ASC Inschakelen

Schakel ASC in (scd4x_asc: "true") alleen als:

• De kamer regelmatig verse lucht krijgt
• CO₂-niveaus zakken naar ~400 ppm minstens elke paar dagen

Kalibratie Best Practices

• Kalibreer onder stabiele omstandigheden
• Documenteer je offsets
• Herkalibreer elke 6-12 maanden
• Wacht 15-30 minuten na inschakelen voor stabilisatie

Hulp Nodig?

• Probleemoplossing handleiding
• Discord community
• Contactpagina