Sensor Definitions
This page lists the entities of the current CeilSense V2 firmware, grouped by function and radar configuration. Which entities you see depends on the modules in your device and the firmware on it.
Names can change until release. The names on this page come from the current pre-release firmware. Entity IDs in Home Assistant start with your device name, so they can differ per installation.
The Category column shows where Home Assistant lists the entity on the device page: Regular for normal sensors and controls, Config for settings and Diagnostic for technical information. Where several numbered entities work the same way, the table uses N for the number.
Every CeilSense V2
Light
| Entity | Type | Category | Description |
|---|---|---|---|
Illuminance |
Sensor | Regular | Raw value of the light sensor in lux. Updates every 10 seconds. |
Illuminance Calibrated |
Sensor | Regular | Illuminance with a correction for the light window, in lux. This correction is still being refined before release. |
Light Diagnostics
These values are meant for diagnosis. The firmware does not mark them as diagnostic, so Home Assistant lists them with the regular sensors.
| Entity | Type | Category | Description |
|---|---|---|---|
Illuminance Full Spectrum |
Sensor | Regular | Light level measured on the white channel |
Illuminance Infrared Estimate |
Sensor | Regular | Calculated value, not a separate photodiode |
Illuminance ALS Counts |
Sensor | Regular | Raw count of the ambient light channel |
Illuminance WHITE Counts |
Sensor | Regular | Raw count of the white channel |
Lux Gain |
Sensor | Regular | Gain the sensor uses at this moment. The sensor chooses it automatically. |
Lux Integration Time |
Sensor | Regular | Measuring time the sensor uses at this moment. The sensor chooses it automatically. |
Air Pressure
| Entity | Type | Category | Description |
|---|---|---|---|
Air Pressure |
Sensor | Regular | Air pressure from the Bosch BMP388. Updates every 30 seconds. |
BMP388 Temperature |
Sensor | Regular | Temperature inside the device, not room temperature |
LED Ring and Buzzer
| Entity | Type | Category | Description |
|---|---|---|---|
LED Ring |
Light | Regular | Color, brightness and effect. Off at every start. Effects: Rainbow, Color Wipe and Breathing. |
Buzzer Test |
Button | Diagnostic | Plays a short melody on the buzzer |
Device
| Entity | Type | Category | Description |
|---|---|---|---|
Restart |
Button | Config | Restarts the device |
Uptime |
Sensor | Diagnostic | Time since the last start |
CPU Temperature |
Sensor | Diagnostic | Temperature of the processor |
IP Address |
Text sensor | Diagnostic | IP address of the device. WiFi firmware only. |
With LD2412 + LD2450
Combined Presence
| Entity | Type | Category | Description |
|---|---|---|---|
Presence |
Binary sensor | Regular | On when either radar sees someone. Use this one for most automations. |
LD2412
| Entity | Type | Category | Description |
|---|---|---|---|
LD2412 Presence |
Binary sensor | Regular | On when the LD2412 sees a moving or still target |
LD2412 Moving Target |
Binary sensor | Regular | On when a moving target is detected |
LD2412 Still Target |
Binary sensor | Regular | On when a still target is detected |
LD2412 Moving Distance |
Sensor | Regular | Distance to the moving target |
LD2412 Still Distance |
Sensor | Regular | Distance to the still target |
LD2412 Moving Energy |
Sensor | Regular | Signal strength of the moving target |
LD2412 Still Energy |
Sensor | Regular | Signal strength of the still target |
LD2412 Detection Distance |
Sensor | Regular | Distance to the closest detected target |
LD2412 Light |
Sensor | Diagnostic | Light value reported by the radar module |
LD2412 Dynamic Background Correction |
Binary sensor | Diagnostic | On while the background correction runs |
LD2412 Firmware Version |
Text sensor | Diagnostic | Firmware of the radar module. Empty means the module is not seen. |
LD2412 MAC |
Text sensor | Diagnostic | Bluetooth address of the radar module |
LD2412 Presence Timeout |
Number | Config | Seconds that presence stays on after the last detection |
LD2412 Minimum Distance Gate |
Number | Config | Closest gate used for detection, 1 to 12 |
LD2412 Maximum Distance Gate |
Number | Config | Furthest gate used for detection, 2 to 13 |
LD2412 Distance Resolution |
Select | Config | Length of each gate: 0.2 m, 0.5 m or 0.75 m |
LD2412 Light Threshold |
Number | Config | Threshold for the radar's own light function |
LD2412 Light Function |
Select | Config | Light function of the radar: off, below or above |
LD2412 Engineering Mode |
Switch | Config | Engineering mode of the radar. Not needed in normal use. |
LD2412 Bluetooth |
Switch | Config | Bluetooth of the radar module, for the HLK Radar Tool app |
LD2412 Start Dynamic Background Correction |
Button | Diagnostic | Starts the background correction. The room must be empty. |
LD2412 Restart |
Button | Diagnostic | Restarts the radar module only |
LD2412 Query Parameters |
Button | Diagnostic | Reads the settings from the radar again |
LD2412 Factory Reset |
Button | Diagnostic | Resets the radar module to factory settings |
LD2450
| Entity | Type | Category | Description |
|---|---|---|---|
LD2450 Presence |
Binary sensor | Regular | On when the LD2450 sees a target |
LD2450 Moving Target |
Binary sensor | Regular | On when a moving target is detected |
LD2450 Still Target |
Binary sensor | Regular | On when a still target is detected |
LD2450 Target Count |
Sensor | Regular | Number of targets |
LD2450 Moving Target Count |
Sensor | Regular | Number of moving targets |
LD2450 Still Target Count |
Sensor | Regular | Number of still targets |
LD2450 Target N Distance |
Sensor | Regular | Distance to the target. N is 1 to 3. |
LD2450 Zone N Target Count |
Sensor | Regular | Number of targets inside the zone. N is 1 to 3. |
LD2450 Target N X |
Sensor | Diagnostic | X position in mm |
LD2450 Target N Y |
Sensor | Diagnostic | Y position in mm |
LD2450 Target N Speed |
Sensor | Diagnostic | Speed of the target |
LD2450 Target N Angle |
Sensor | Diagnostic | Angle to the target |
LD2450 Target N Direction |
Text sensor | Diagnostic | Direction of the target |
LD2450 Target N Resolution |
Sensor | Diagnostic | Distance resolution of the target |
LD2450 Firmware Version |
Text sensor | Diagnostic | Firmware of the radar module. Empty means the module is not seen. |
LD2450 MAC |
Text sensor | Diagnostic | Bluetooth address of the radar module |
LD2450 Presence Timeout |
Number | Config | Seconds that presence stays on after the last detection |
LD2450 Zone Type |
Select | Config | How the zones work: Disabled, Detection or Filter |
LD2450 Zone N X1, Y1, X2, Y2 |
Number | Config | Corners of the zone in mm. N is 1 to 3. |
LD2450 Multi Target Tracking |
Switch | Config | Tracks several people instead of one |
LD2450 Bluetooth |
Switch | Config | Bluetooth of the radar module, for the HLK Radar Tool app |
LD2450 Baud Rate |
Select | Config | Speed of the connection to the radar. Leave this as it is. |
LD2450 Restart |
Button | Diagnostic | Restarts the radar module only |
LD2450 Factory Reset |
Button | Diagnostic | Resets the radar module to factory settings |
With LD2460
Presence and Targets
| Entity | Type | Category | Description |
|---|---|---|---|
Presence |
Binary sensor | Regular | Follows Tracking Presence. Use this one for most automations. |
Tracking Presence |
Binary sensor | Regular | On when the LD2460 sees someone |
Tracking Target Count |
Sensor | Regular | Number of targets |
Tracking Targets |
Text sensor | Regular | Text summary of the targets |
Tracking Target N X |
Sensor | Regular | X position in meters. N is 1 to 5. |
Tracking Target N Y |
Sensor | Regular | Y position in meters |
Tracking Target N Distance |
Sensor | Regular | Distance to the target in meters |
Tracking Target N Angle |
Sensor | Regular | Angle to the target in degrees |
Radar Settings
| Entity | Type | Category | Description |
|---|---|---|---|
Tracking Radar Installation Mode |
Select | Config | side or top. The firmware sets top for ceiling mounting. |
Tracking Radar Detection Distance |
Number | Config | Distance of the detection sector in meters |
Tracking Radar Detection Start Angle |
Number | Config | Start of the detection sector in degrees |
Tracking Radar Detection End Angle |
Number | Config | End of the detection sector in degrees |
Tracking Radar Installation Height |
Number | Config | For wall mounting. Not needed on the ceiling. |
Tracking Radar Installation Angle |
Number | Config | For wall mounting. Not needed on the ceiling. |
Tracking Radar Firmware |
Text sensor | Diagnostic | Firmware of the radar module. Empty means the module is not seen. |
Tracking Radar Installation Mode |
Text sensor | Diagnostic | The mode the radar reports |
Tracking Raw UART |
Text sensor | Diagnostic | Raw data for diagnosis. Disabled by default. |
Tracking UART Bytes |
Sensor | Diagnostic | Byte counter for diagnosis. Disabled by default. |
Room Designer Zones
These entities belong to the zones you draw in the Room Designer.
| Entity | Type | Category | Description |
|---|---|---|---|
Polygon Zone N Presence |
Binary sensor | Regular | On when someone is inside the zone. N is 1 to 4. |
Polygon Zone N Target Count |
Sensor | Regular | Number of targets inside the zone. N is 1 to 4. |
People Count |
Sensor | Regular | Running count of people in the room, based on entry lines |
Last Crossing Direction |
Text sensor | Regular | Direction of the last crossing of an entry line |
Polygon Zones Enabled |
Switch | Config | Turns the zones on or off. On by default. |
Polygon Zone N |
Text | Config | Shape of the zone. The Room Designer writes this. N is 1 to 4. |
Polygon Exclusion N |
Text | Config | Area where targets are ignored. The Room Designer writes this. N is 1 or 2. |
Entry Line N |
Text | Config | Line used for counting people. The Room Designer writes this. N is 1 or 2. |
Reset People Count |
Button | Config | Sets the people count back to zero |
Mounting Information
These values tell the Room Designer how the radar is mounted. You do not need to change them.
| Entity | Type | Category | Description |
|---|---|---|---|
Radar Model |
Text sensor | Diagnostic | Radar type |
Radar Mounting Mode |
Text sensor | Diagnostic | Mounting mode |
Radar Required Installation Mode |
Text sensor | Diagnostic | Installation mode the mounting needs |
Radar Hardware Mounting Modes |
Text sensor | Diagnostic | Mounting modes the radar supports |
Radar Coordinate Projection |
Text sensor | Diagnostic | How coordinates are projected on the floor |
Radar Coordinate Frame |
Text sensor | Diagnostic | Coordinate system of the radar |
Radar Coordinate Scale To Millimetres |
Sensor | Diagnostic | Conversion to millimeters |
Radar Default Mounting Height |
Sensor | Diagnostic | Default height in mm |
Radar Default Range |
Sensor | Diagnostic | Default range in mm |
Radar Default Field Of View |
Sensor | Diagnostic | Default field of view in degrees |
Radar Maximum Targets |
Sensor | Diagnostic | Maximum number of targets |
With LD6002B
Firmware for the LD6002B on CeilSense V2 is not finished, so its entity names are not final and are not listed here. Expect presence per target, detection areas, target and point counts, X, Y and Z per target in meters, and settings for installation mode, sensitivity and trigger speed.
With the SCD41 Module
| Entity | Type | Category | Description |
|---|---|---|---|
CO2 |
Sensor | Regular | CO2 in ppm. New value every 30 seconds. |
SCD41 Temperature |
Sensor | Regular | Temperature in °C. New value every 30 seconds. |
Humidity |
Sensor | Regular | Relative humidity in %. New value every 30 seconds. |
Temperature Offset |
Number | Config | Correction in °C, -50 to +50, step 0.1, default 0. Added on top of the factory correction and kept after a restart. |
Humidity Offset |
Number | Config | Correction in %, -50 to +50, step 0.1, default 0. Added on top of the factory correction and kept after a restart. |
Example Entity IDs
| Entity | Example entity ID |
|---|---|
Presence |
binary_sensor.ceilsense_v2_presence |
Illuminance |
sensor.ceilsense_v2_illuminance |
Air Pressure |
sensor.ceilsense_v2_air_pressure |
CO2 |
sensor.ceilsense_v2_co2 |
LED Ring |
light.ceilsense_v2_led_ring |
Buzzer Test |
button.ceilsense_v2_buzzer_test |