Sensor Definities

Op deze pagina staan de geplande entiteiten van CeilSense Pro, gegroepeerd per functie en radarconfiguratie. Welke entiteiten je straks ziet, hangt af van de radar in je apparaat en de firmware erop.

Namen kunnen bij de release veranderen. De firmware voor de definitieve CeilSense Pro is nog niet geschreven. De namen op deze pagina komen van een eerder prototype en kunnen bij de release veranderen. Entity-ID's in Home Assistant beginnen met je apparaatnaam en kunnen dus per installatie verschillen.

De kolom Categorie laat zien waar Home Assistant de entiteit straks op de apparaatpagina toont: Normaal voor gewone sensoren en bediening, Configuratie voor instellingen en Diagnostisch voor technische informatie. Werken genummerde entiteiten hetzelfde, dan staat in de tabel N voor het nummer.

Elke CeilSense Pro

Licht

Entiteit	Type	Categorie	Omschrijving
`Illuminance`	Sensor	Normaal	Lichtniveau in lux van de Vishay VEML6030

Of er net als op CeilSense V2 een aparte gecorrigeerde waarde komt, wordt met de firmware bepaald.

CO2, temperatuur en luchtvochtigheid (SCD41)

Entiteit	Type	Categorie	Omschrijving
`SCD41 CO2`	Sensor	Normaal	CO2 in ppm. Elke 30 seconden nieuw.
`SCD41 Temperature`	Sensor	Normaal	Temperatuur in °C. Elke 30 seconden nieuw.
`SCD41 Humidity`	Sensor	Normaal	Relatieve luchtvochtigheid in %. Elke 30 seconden nieuw.
`SCD41 Extra Temperature Offset`	Getal	Configuratie	Correctie in °C, -20 tot +20, stap 0,1. Komt bovenop de fabriekscorrectie en blijft bewaard na een herstart.
`SCD41 Humidity Offset`	Getal	Configuratie	Correctie in %, -20 tot +20, stap 0,1, standaard 0. Blijft bewaard na een herstart.
`SCD41 Calibrate Fresh Air`	Knop	Configuratie	Zet de CO2-meting op 426 ppm. Druk hier alleen op in frisse lucht: zie Kalibratie.

Temperatuur en luchtvochtigheid (SHT45)

De prototypefirmware heeft nog geen SHT45-entiteiten. De namen volgen met de releasefirmware.

VOC en NOx (SGP41)

Deze waarden zijn indexen, geen ppm.

Entiteit	Type	Categorie	Omschrijving
`SGP41 VOC Index`	Sensor	Normaal	VOC-index van 1 tot 500
`SGP41 NOx Index`	Sensor	Normaal	NOx-index van 1 tot 500

Luchtdruk

Entiteit	Type	Categorie	Omschrijving
`BMP388 Pressure`	Sensor	Normaal	Luchtdruk van de Bosch BMP388
`BMP388 Temperature`	Sensor	Normaal	Temperatuur binnen in het apparaat, niet de kamertemperatuur

Ledring en buzzer

Entiteit	Type	Categorie	Omschrijving
`LED Ring`	Lamp	Normaal	Kleur, helderheid en effect. Standaard uit. De lijst met effecten volgt met de releasefirmware.
`Buzzer Test`	Knop	Diagnostisch	Speelt een kort melodietje op de buzzer

Speaker en microfoon

Entiteit	Type	Categorie	Omschrijving
`Speaker`	Mediaspeler	Normaal	Speelt muziek, MP3-bestanden en gesproken meldingen af via Home Assistant

De prototypefirmware heeft nog geen entiteiten voor de microfoon. Die volgen met de releasefirmware.

Optische rookmeting

Experimenteel, en geen veiligheidsfunctie. Zie Optische rookmeting. Entiteiten met uitgeschakeld zijn standaard uitgeschakeld.

Entiteit	Type	Categorie	Omschrijving
`ADPD188BI Smoke Alert`	Binaire sensor	Normaal	Aan na vier kandidaten achter elkaar. Uit betekent alleen dat deze meting geen alert heeft.
`ADPD188BI Smoke Index`	Sensor	Normaal	Relatieve stijging boven de basislijn in %. Geen concentratie. Blijft 0 tijdens de opwarmfase.
`ADPD188BI Blue`	Sensor	Normaal	Ruwe meting van het blauwe kanaal
`ADPD188BI Infrared`	Sensor	Normaal	Ruwe meting van het infrarode kanaal
`Smoke Siren Enabled`	Schakelaar	Configuratie	Staat de sirene op de buzzer toe. Standaard uit, en je instelling blijft bewaard na een herstart.
`Remote Smoke Alarm`	Schakelaar	Normaal	Laat Home Assistant de sirene en het knipperen van dit apparaat starten. Wordt niet hersteld na een herstart.
`Smoke Alarm Silence`	Knop	Normaal	Dempt een actieve sirene 10 minuten
`Smoke Test`	Knop	Diagnostisch	Doet een zelftest van de sensor
`Smoke Self Test Result`	Tekstsensor	Diagnostisch	`PASS` of `FAIL` van de laatste `Smoke Test`
`ADPD188BI Sensor Problem`	Binaire sensor	Diagnostisch	Aan na een fout bij het opstarten of mislukte uitlezingen
`ADPD188BI Baseline Ready`	Binaire sensor	Diagnostisch	Aan als de opwarmfase klaar is
`ADPD188BI Measurement Stable`	Binaire sensor	Diagnostisch	Aan als het meetvenster geldig is
`ADPD188BI Alarm Candidate`	Binaire sensor	Diagnostisch	Aan zolang een venster als kandidaat telt
`ADPD188BI eFuse Calibration Ready`	Binaire sensor	Diagnostisch	Aan als de fabriekskalibratie van de sensor is gelezen
`ADPD188BI Blue Delta`	Sensor	Diagnostisch	Stijging van het blauwe kanaal boven de basislijn
`ADPD188BI Infrared Delta`	Sensor	Diagnostisch	Stijging van het infrarode kanaal boven de basislijn
`ADPD188BI Blue Baseline`	Sensor	Diagnostisch	Basislijn van het blauwe kanaal, uitgeschakeld
`ADPD188BI Infrared Baseline`	Sensor	Diagnostisch	Basislijn van het infrarode kanaal, uitgeschakeld
`ADPD188BI Blue IR Ratio`	Sensor	Diagnostisch	Verhouding tussen het blauwe en infrarode kanaal, uitgeschakeld
`ADPD188BI Device ID`	Sensor	Diagnostisch	Identificatie van de sensor, uitgeschakeld
`ADPD188BI eFuse Module ID`	Sensor	Diagnostisch	Modulenummer van de sensor, uitgeschakeld
`ADPD188BI Blue Calibration Gain`	Sensor	Diagnostisch	Fabriekskalibratie van het blauwe kanaal, uitgeschakeld
`ADPD188BI Infrared Calibration Gain`	Sensor	Diagnostisch	Fabriekskalibratie van het infrarode kanaal, uitgeschakeld

Apparaat

Entiteit	Type	Categorie	Omschrijving
`Restart Device`	Knop	Configuratie	Herstart het apparaat. De optische rookmeting begint dan opnieuw met de opwarmfase.
`Factory Reset`	Knop	Configuratie	Zet het apparaat terug naar fabrieksinstellingen. Standaard uitgeschakeld.
`Software Version`	Tekstsensor	Normaal	Firmwareversie
`Hardware Version`	Tekstsensor	Normaal	Hardwareversie
`Network Variant`	Tekstsensor	Normaal	WiFi- of Ethernet-build
`CPU Temperature`	Sensor	Diagnostisch	Temperatuur van de processor
`Device Info`	Tekstsensor	Diagnostisch	Technische informatie over het apparaat
`ESP Reset Reason`	Tekstsensor	Diagnostisch	Reden van de laatste herstart. Standaard uitgeschakeld.

Netwerk

Deze zijn allemaal standaard uitgeschakeld.

Entiteit	Type	Categorie	Omschrijving
`WiFi IP Address`	Tekstsensor	Diagnostisch	IP-adres van het apparaat. Alleen met WiFi-firmware.
`WiFi MAC`	Tekstsensor	Diagnostisch	Netwerkadres van de WiFi-verbinding. Alleen met WiFi-firmware.
`WiFi Signal`	Sensor	Diagnostisch	Sterkte van het WiFi-signaal. Alleen met WiFi-firmware.
`Ethernet IP Address`	Tekstsensor	Diagnostisch	IP-adres van het apparaat. Alleen met Ethernet-firmware.
`Ethernet MAC`	Tekstsensor	Diagnostisch	Netwerkadres van de Ethernet-verbinding. Alleen met Ethernet-firmware.

Met LD2412 + LD2450

Gecombineerde aanwezigheid

Entiteit	Type	Categorie	Omschrijving
`Presence`	Binaire sensor	Normaal	Aan als een van beide radars iemand ziet. Gebruik deze voor de meeste automatiseringen.

LD2412

Entiteit	Type	Categorie	Omschrijving
`LD2412 Presence`	Binaire sensor	Normaal	Aan als de LD2412 een bewegend of stil target ziet
`LD2412 Moving Target`	Binaire sensor	Normaal	Aan bij een bewegend target
`LD2412 Still Target`	Binaire sensor	Normaal	Aan bij een stil target
`LD2412 Moving Distance`	Sensor	Normaal	Afstand tot het bewegende target
`LD2412 Still Distance`	Sensor	Normaal	Afstand tot het stille target
`LD2412 Moving Energy`	Sensor	Normaal	Signaalsterkte van het bewegende target
`LD2412 Still Energy`	Sensor	Normaal	Signaalsterkte van het stille target
`LD2412 Detection Distance`	Sensor	Normaal	Afstand tot het dichtstbijzijnde target
`LD2412 Light`	Sensor	Diagnostisch	Lichtwaarde die de radarmodule doorgeeft
`LD2412 Dynamic Background Correction`	Binaire sensor	Diagnostisch	Aan zolang de achtergrondcorrectie loopt
`LD2412 Firmware Version`	Tekstsensor	Diagnostisch	Firmware van de radarmodule. Leeg betekent dat de module niet wordt gezien.
`LD2412 MAC`	Tekstsensor	Diagnostisch	Bluetooth-adres van de radarmodule
`LD2412 Presence Timeout`	Getal	Configuratie	Aantal seconden dat aanwezigheid aan blijft na de laatste detectie
`LD2412 Minimum Distance Gate`	Getal	Configuratie	Dichtstbijzijnde gate voor detectie, 1 tot 12
`LD2412 Maximum Distance Gate`	Getal	Configuratie	Verste gate voor detectie, 2 tot 13
`LD2412 Distance Resolution`	Keuzelijst	Configuratie	Lengte van elke gate: 0,2 m, 0,5 m of 0,75 m
`LD2412 Light Threshold`	Getal	Configuratie	Grenswaarde voor de eigen lichtfunctie van de radar
`LD2412 Light Function`	Keuzelijst	Configuratie	Lichtfunctie van de radar: off, below of above
`LD2412 Engineering Mode`	Schakelaar	Configuratie	Engineering mode van de radar. Niet nodig bij normaal gebruik.
`LD2412 Bluetooth`	Schakelaar	Configuratie	Bluetooth van de radarmodule, voor de HLK Radar Tool-app
`LD2412 Start Dynamic Background Correction`	Knop	Diagnostisch	Start de achtergrondcorrectie. De ruimte moet leeg zijn.
`LD2412 Restart`	Knop	Diagnostisch	Herstart alleen de radarmodule
`LD2412 Query Parameters`	Knop	Diagnostisch	Leest de instellingen opnieuw uit de radar
`LD2412 Factory Reset`	Knop	Diagnostisch	Zet de radarmodule terug naar fabrieksinstellingen

LD2450

Entiteit	Type	Categorie	Omschrijving
`LD2450 Presence`	Binaire sensor	Normaal	Aan als de LD2450 een target ziet
`LD2450 Moving Target`	Binaire sensor	Normaal	Aan bij een bewegend target
`LD2450 Still Target`	Binaire sensor	Normaal	Aan bij een stil target
`LD2450 Target Count`	Sensor	Normaal	Aantal targets
`LD2450 Moving Target Count`	Sensor	Normaal	Aantal bewegende targets
`LD2450 Still Target Count`	Sensor	Normaal	Aantal stille targets
`LD2450 Target N Distance`	Sensor	Normaal	Afstand tot het target. N is 1 tot 3.
`LD2450 Zone N Target Count`	Sensor	Normaal	Aantal targets in de zone. N is 1 tot 3.
`LD2450 Target N X`	Sensor	Diagnostisch	X-positie in mm
`LD2450 Target N Y`	Sensor	Diagnostisch	Y-positie in mm
`LD2450 Target N Speed`	Sensor	Diagnostisch	Snelheid van het target
`LD2450 Target N Angle`	Sensor	Diagnostisch	Hoek naar het target
`LD2450 Target N Direction`	Tekstsensor	Diagnostisch	Richting van het target
`LD2450 Target N Resolution`	Sensor	Diagnostisch	Afstandsresolutie van het target
`LD2450 Firmware Version`	Tekstsensor	Diagnostisch	Firmware van de radarmodule. Leeg betekent dat de module niet wordt gezien.
`LD2450 MAC`	Tekstsensor	Diagnostisch	Bluetooth-adres van de radarmodule
`LD2450 Presence Timeout`	Getal	Configuratie	Aantal seconden dat aanwezigheid aan blijft na de laatste detectie
`LD2450 Zone Type`	Keuzelijst	Configuratie	Hoe de zones werken: Disabled, Detection of Filter
`LD2450 Zone N X1`, `Y1`, `X2`, `Y2`	Getal	Configuratie	Hoeken van de zone in mm. N is 1 tot 3.
`LD2450 Multi Target Tracking`	Schakelaar	Configuratie	Volgt meerdere mensen in plaats van één
`LD2450 Bluetooth`	Schakelaar	Configuratie	Bluetooth van de radarmodule, voor de HLK Radar Tool-app
`LD2450 Baud Rate`	Keuzelijst	Configuratie	Snelheid van de verbinding met de radar. Verander deze niet.
`LD2450 Restart`	Knop	Diagnostisch	Herstart alleen de radarmodule
`LD2450 Factory Reset`	Knop	Diagnostisch	Zet de radarmodule terug naar fabrieksinstellingen

Met LD2460

De firmware voor de LD2460 op CeilSense Pro is gepland. De namen hieronder zijn die van de LD2460-component die SmartHomeShop onderhoudt.

Aanwezigheid en targets

Entiteit	Type	Categorie	Omschrijving
`Presence`	Binaire sensor	Normaal	Volgt `Tracking Presence`. Gebruik deze voor de meeste automatiseringen.
`Tracking Presence`	Binaire sensor	Normaal	Aan als de LD2460 iemand ziet
`Tracking Target Count`	Sensor	Normaal	Aantal targets
`Tracking Targets`	Tekstsensor	Normaal	Samenvatting van de targets in tekst
`Tracking Target N X`	Sensor	Normaal	X-positie in meter. N is 1 tot 5.
`Tracking Target N Y`	Sensor	Normaal	Y-positie in meter
`Tracking Target N Distance`	Sensor	Normaal	Afstand tot het target in meter
`Tracking Target N Angle`	Sensor	Normaal	Hoek naar het target in graden

Radarinstellingen

Entiteit	Type	Categorie	Omschrijving
`Tracking Radar Installation Mode`	Keuzelijst	Configuratie	`side` of `top`. De firmware kiest `top` voor plafondmontage.
`Tracking Radar Detection Distance`	Getal	Configuratie	Afstand van de detectiesector in meter
`Tracking Radar Detection Start Angle`	Getal	Configuratie	Begin van de detectiesector in graden
`Tracking Radar Detection End Angle`	Getal	Configuratie	Einde van de detectiesector in graden
`Tracking Radar Installation Height`	Getal	Configuratie	Voor wandmontage. Niet nodig aan het plafond.
`Tracking Radar Installation Angle`	Getal	Configuratie	Voor wandmontage. Niet nodig aan het plafond.
`Tracking Radar Firmware`	Tekstsensor	Diagnostisch	Firmware van de radarmodule. Leeg betekent dat de module niet wordt gezien.
`Tracking Radar Installation Mode`	Tekstsensor	Diagnostisch	De modus die de radar doorgeeft
`Tracking Raw UART`	Tekstsensor	Diagnostisch	Ruwe data voor diagnose. Standaard uitgeschakeld.
`Tracking UART Bytes`	Sensor	Diagnostisch	Byteteller voor diagnose. Standaard uitgeschakeld.

Zones uit de Room Designer

Deze entiteiten horen bij de zones die je tekent in de Room Designer.

Entiteit	Type	Categorie	Omschrijving
`Polygon Zone N Presence`	Binaire sensor	Normaal	Aan als er iemand in de zone is. N is 1 tot 4.
`Polygon Zone N Target Count`	Sensor	Normaal	Aantal targets in de zone. N is 1 tot 4.
`People Count`	Sensor	Normaal	Lopende telling van mensen in de ruimte, op basis van entry lines
`Last Crossing Direction`	Tekstsensor	Normaal	Richting van de laatste keer dat iemand een entry line passeerde
`Polygon Zones Enabled`	Schakelaar	Configuratie	Zet de zones aan of uit. Standaard aan.
`Polygon Zone N`	Tekst	Configuratie	Vorm van de zone. De Room Designer vult dit in. N is 1 tot 4.
`Polygon Exclusion N`	Tekst	Configuratie	Gebied waar targets worden genegeerd. De Room Designer vult dit in. N is 1 of 2.
`Entry Line N`	Tekst	Configuratie	Lijn om mensen te tellen. De Room Designer vult dit in. N is 1 of 2.
`Reset People Count`	Knop	Configuratie	Zet de telling terug naar nul

De LD2460-build heeft ook een reeks diagnostische entiteiten die met Radar beginnen, zoals Radar Model en Radar Mounting Mode. Die vertellen de Room Designer hoe de radar is gemonteerd, en je hoeft ze niet aan te passen.

Met LD6002B

De firmware voor de LD6002B op CeilSense Pro is nog niet af. De namen van de entiteiten liggen dus nog niet vast en staan hier niet. Reken op aanwezigheid per target, detectiegebieden, aantallen targets en punten, X, Y en Z per target in meter, en instellingen voor installatiemodus, gevoeligheid en triggersnelheid.

Voorbeelden van entity-ID's

Entiteit	Voorbeeld van entity-ID
`Presence`	`binary_sensor.ceilsense_pro_presence`
`Illuminance`	`sensor.ceilsense_pro_illuminance`
`SCD41 CO2`	`sensor.ceilsense_pro_scd41_co2`
`SGP41 VOC Index`	`sensor.ceilsense_pro_sgp41_voc_index`
`BMP388 Pressure`	`sensor.ceilsense_pro_bmp388_pressure`
`LED Ring`	`light.ceilsense_pro_led_ring`
`Buzzer Test`	`button.ceilsense_pro_buzzer_test`
`Speaker`	`media_player.ceilsense_pro_speaker`
`ADPD188BI Smoke Alert`	`binary_sensor.ceilsense_pro_adpd188bi_smoke_alert`