This page provides detailed explanations of all sensors, controls, and entities available on the CeilSense. Use this as a reference to understand what each value means and how to use it.
true when any target (moving or still) is detected. This is the main occupancy sensor you'll use for automations like turning lights on/off.
Moving Target
true when a moving target is detected. Useful for detecting active movement vs. someone sitting still.
Still Target
true when a stationary target is detected. Great for detecting someone sleeping, sitting, or lying still.
Distance Sensors
Entity
Description
Range
Moving Distance
Distance in cm to the detected moving target.
0-900 cm
Still Distance
Distance in cm to the detected still target.
0-900 cm
Detection Distance
Distance in cm to the closest detected target (moving or still).
0-900 cm
Energy Sensors
Entity
Description
Range
Move Energy
Signal strength of the moving target detection. Higher values = stronger/closer target.
0-100
Still Energy
Signal strength of the still target detection. Higher values = stronger/closer target.
0-100
Gate Configuration
The LD2412 divides its detection range into 14 gates (0-13). Each gate represents a distance segment of approximately 0.75 meters (with default resolution).
Entity
Description
Range
Minimum Distance Gate
The closest gate where detection begins. Gates before this are ignored.
1-12
Maximum Distance Gate
The furthest gate where detection ends. Gates after this are ignored.
2-13
Presence Timeout (s)
Time in seconds that presence remains true after the target is no longer detected.
0-900 s
Light Threshold
Light level for the light function of the radar.
0-255
Gate Distance Reference
Gate
Distance (0.75m resolution)
Distance (0.5m resolution)
Distance (0.2m resolution)
0
0 - 0.75m
0 - 0.5m
0 - 0.2m
1
0.75 - 1.5m
0.5 - 1.0m
0.2 - 0.4m
2
1.5 - 2.25m
1.0 - 1.5m
0.4 - 0.6m
3
2.25 - 3.0m
1.5 - 2.0m
0.6 - 0.8m
4
3.0 - 3.75m
2.0 - 2.5m
0.8 - 1.0m
5
3.75 - 4.5m
2.5 - 3.0m
1.0 - 1.2m
6
4.5 - 5.25m
3.0 - 3.5m
1.2 - 1.4m
7
5.25 - 6.0m
3.5 - 4.0m
1.4 - 1.6m
8
6.0 - 6.75m
4.0 - 4.5m
1.6 - 1.8m
9
6.75 - 7.5m
4.5 - 5.0m
1.8 - 2.0m
10
7.5 - 8.25m
5.0 - 5.5m
2.0 - 2.2m
11
8.25 - 9.0m
5.5 - 6.0m
2.2 - 2.4m
12
9.0 - 9.75m
-
2.4 - 2.6m
13
9.75 - 10.5m
-
2.6 - 2.8m
Gate Thresholds
The radar keeps a move and a still threshold per gate (0-100, lower = more sensitive). The CeilSense firmware does not show these as Home Assistant entities. Dynamic Background Correction sets them for you, and you can change them yourself with the HLK Radar Tool app.
Gate Energy Sensors (Engineering Mode)
When LD2412 Engineering Mode is on, the firmware shows the real-time energy of the first gate:
Entity
Description
Range
Gate 0 Move Energy
Current movement energy detected at gate 0.
0-100
Gate 0 Still Energy
Current still energy detected at gate 0.
0-100
LD2412 Controls
Entity
Type
Description
LD2412 Engineering Mode
Switch
Enables the extra energy sensors for tuning. Turn off after tuning to reduce data traffic.
LD2412 Bluetooth
Switch
Enables the LD2412's Bluetooth for connecting with the HLK Radar Tool app.
Start Dynamic Background Correction
Button
Calibrates the sensor to the current (empty) room. Room must be empty! Its progress shows in Dynamic Background Correction Status.
LD2412 Factory Reset
Button
Resets all radar settings to factory defaults.
LD2412 Restart
Button
Restarts the LD2412 sensor without rebooting the entire device.
LD2412 Query Parameters
Button
Refreshes all sensor values from the radar.
LD2412 Configuration
Entity
Type
Description
Options
LD2412 Distance Resolution
Select
Changes the distance per gate. Smaller = more precision, but shorter range.
0.75m (default), 0.5m, 0.2m
LD2412 Light Function
Select
Light function of the radar, works with Light Threshold.
off, below, above
LD2412 Diagnostic
Entity
Description
LD2412S FM Version
Firmware version of the LD2412 radar module.
LD2412S Mac
Bluetooth MAC address of the LD2412 (for HLK Radar Tool app).
Presence & Tracking (LD2450)
With the optional LD2450 module and LD2450 firmware you get these entities instead of the LD2412 entities.
Entity
Description
Presence, Moving Target, Still Target
Same meaning as with the LD2412
Target Count, Moving Target Count, Still Target Count
Number of targets, up to 3
Target 1 X to Target 3 X, also Y, Speed, Angle, Distance, Resolution and Direction
Position and movement per target, in mm and mm/s
Polygon Zone 1 Presence to Polygon Zone 4 Presence
Someone is inside that polygon zone
Polygon Zone 1 Target Count to Polygon Zone 4 Target Count
Number of people in that polygon zone
People Count, Last Crossing Direction
Room count from your entry lines and the last direction
Polygon Zones Enabled, Reset People Count
Switch for all polygon zones and a button that resets the count
Zone 1 X1 to Zone 3 Y2, Zone 1 Target Count to Zone 3 Target Count
The three rectangular zones of the radar itself
Presence Timeout
Time before presence clears after the last detection
LD2450 Bluetooth, LD2450 Multi Target Tracking
Bluetooth of the radar and tracking of several targets
LD2450 Restart, LD2450 Factory Reset
Restart or reset only the radar
Draw polygon zones, exclusion zones and entry lines in the Room Designer of the SmartHomeShop integration. The entities that start with Radar tell the Room Designer that the sensor is on the ceiling. You do not need to change them.
Environmental Sensors (Complete Only)
The CeilSense Complete includes the Sensirion SCD41 sensor for CO₂, temperature, and humidity measurement.
The CeilSense ships with WiFi firmware by default. You can switch to Ethernet firmware using this selector.
⚠️ Important: Connect your Ethernet cable before switching, or right after the restart. WiFi stops working as soon as the Ethernet firmware has started.