Kalibratiehandleiding

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,5 tot 3 m 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: Pas Gate Drempels Aan in de App

Is Dynamic Background Correction niet genoeg:

1. Open de HLK Radar Tool app
2. Identificeer welke afstands-gates constant hoge energie tonen
3. Verhoog de bewegings- en stille drempel voor die gates

Home Assistant toont alleen de energie van gate 0, zie Sensor Definities.

Stap 4: Controleer Storende Objecten

Loop deze lijst na:

• Plafondventilator uit of op de laagste stand?
• Geen gordijnen of jaloezieën die bewegen door de ventilatie?
• Geen huisdieren in de kamer tijdens het kalibreren?
• Geen grote metalen objecten direct in het sensorpad?
• Detecteert de sensor door een dunne muur?

Stap 5: Factory Reset (Laatste Redmiddel)

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

Waarom de mmWave Sensor Afstellen?

Veelvoorkomende redenen om de gevoeligheid aan te passen:

• Valse triggers: beweging in aangrenzende kamers door muren
• Huisdieren: de sensor pikt katten, honden of andere huisdieren op
• Plafondventilatoren: draaiende ventilatoren triggeren bewegingsdetectie
• Gemiste stille aanwezigheid: iemand die zit of ligt wordt niet gezien
• Bereik te ver of te kort: de detectiezone past niet bij je kamer

Tuning Methodes

Methode 1: Via Home Assistant (Aanbevolen)

1. Open Home Assistant → Instellingen → Apparaten en 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 (s): Tijd dat aanwezigheid actief blijft na geen detectie (0-900)

Methode 2: Via HLK Radar Tool App

1. Download "HLK Radar Tool" (iOS App Store of Google Play)
2. Zet de schakelaar LD2412 Bluetooth aan in Home Assistant en verbind via Bluetooth met je CeilSense
3. Pas Move/Still drempels per gate aan

Geavanceerd Afstellen: Engineering Mode

De schakelaar LD2412 Engineering Mode in Home Assistant voegt energie sensoren voor gate 0 toe:

• Gate 0 Move Energy: Realtime energie voor beweging bij de eerste gate
• Gate 0 Still Energy: Realtime energie voor stille aanwezigheid bij de eerste gate

Gebruik voor alle gates de HLK Radar Tool app. Zet Engineering Mode weer uit als je klaar bent.

Dynamic Background Correction

De makkelijkste manier om te kalibreren is Dynamic Background Correction:

1. Zorg dat de kamer leeg is (geen mensen, huisdieren of bewegende objecten)
2. Zoek in Home Assistant de knop Start Dynamic Background Correction
3. Druk op de knop en wacht tot het proces klaar is
4. De sensor leert de achtergrondruis en stelt passende drempels in

Let op: Tijdens de correctie toont de binaire sensor Dynamic Background Correction Status de waarde true. Wacht tot die terug is op false voordat je de sensor gebruikt.

Tuning Tips

Sensorspecifieke Afstelling

LD2412 (Standaard):

• Heeft aparte instellingen voor bewegende en stilstaande doelen
• 14 afstands-gates (0-13, elk ~0.75m)
• Ideaal voor het afstellen van stille aanwezigheid

LD2450 (Optioneel):

• Teken polygonzones, uitsluitingszones en tellijnen in de Room Designer van de SmartHomeShop-integratie
• Gebruik uitsluitingszones om bepaalde gebieden te negeren
• Er is geen Dynamic Background Correction of gate-afstelling

Je Configuratie Testen

Na het aanpassen van instellingen:

1. Verlaat de kamer volledig en controleer of de sensor "niet bezet" toont
2. Kom de kamer binnen en controleer de detectiesnelheid
3. Zit of lig stil en controleer of aanwezigheid behouden blijft
4. Test randgevallen (aangrenzende kamers, huisdieren indien van toepassing)

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

CO₂ Nauwkeurigheid:

• 400-1.000 ppm: ±(50 ppm + 2,5% van de meting)
• 1.001-2.000 ppm: ±(50 ppm + 3% van de meting)
• 2.001-5.000 ppm: ±(40 ppm + 5% van de meting)

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 en 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 en diensten → ESPHome → CeilSense
3. Zoek "SCD4x Extra Temperature Offset (°C)"
4. Voer je offsetwaarde in (bereik -20 tot +20)

Methode 2: Via ESPHome Substitutions (Gevorderd)

Voor permanente wijzigingen kun je het apparaat adopteren in ESPHome en de substitutions aanpassen:

1. Adopteer het apparaat in ESPHome Device Builder (zie Firmware Handleiding: ESPHome Integratie voor stap-voor-stap instructies)
2. Bewerk de YAML en wijzig de substitution:

substitutions:
  scd4x_temperature_offset: "12.0"  # Standaard is 10.0

3. Sla op en installeer de configuratie OTA

Tips voor Nauwkeurige Temperatuurmetingen

• Verlaag de LED-helderheid: minder helderheid is minder warmte
• Gebruik afkoelpauzes: laat de leds niet continu op hoge helderheid branden
• Zorg voor luchtstroom: de plafondholte heeft enige luchtcirculatie nodig
• Wacht op stabilisatie: wacht na het inschakelen 15-30 minuten voordat je referentiemetingen doet

Luchtvochtigheid Kalibratie

Methode 1: Via Home Assistant (Makkelijk)

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)

Methode 2: Via ESPHome Substitutions (Gevorderd)

Voor permanente wijzigingen via ESPHome wordt de luchtvochtigheidsoffset toegepast via de number-entiteit (er is standaard geen substitution voor de luchtvochtigheidsoffset).

Lichtsensor Kalibratie

Via ESPHome door de sensor uit te breiden (adopteer eerst het apparaat, zie Firmware Handleiding):

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

Voor deze geavanceerde configuraties moet je eerst je CeilSense adopteren in ESPHome.

Zo Adopteer en Configureer Je

1. Open ESPHome Device Builder in Home Assistant
2. Adopteer het CeilSense apparaat (het verschijnt als ontdekt apparaat)
3. Bewerk de YAML configuratie
4. Wijzig de substitutions waar nodig
5. Sla op en installeer OTA (Over-The-Air)

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

Kalibratieproblemen Oplossen

Hulp Nodig?

• Probleemoplossing handleiding
• Discord community
• Contactpagina