SmartHomeShop Docs

Sensor Definitions

This page lists the entities of the current CeilSense Mini firmware, grouped by function and radar configuration. The current firmware is a WiFi build for LD2412 + LD2450, so that is the configuration this page describes in full.

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 Mini

Light

Entity Type Category Description
Illuminance Sensor Regular Value of the light sensor in lux. Updates every 10 seconds. The firmware applies no correction for the housing.

Light Diagnostics

These values are meant for diagnosis. The firmware marks Lux Gain and Lux Integration Time as diagnostic. Illuminance Full Spectrum is listed with the regular sensors.

Entity Type Category Description
Illuminance Full Spectrum Sensor Regular Light level measured on the white channel
Lux Gain Sensor Diagnostic Gain the sensor uses at this moment. The sensor chooses it automatically.
Lux Integration Time Sensor Diagnostic Measuring time the sensor uses at this moment. The sensor chooses it automatically.

LED Ring and Buzzer

Entity Type Category Description
LED Ring Light Regular Color, brightness and effect. Shows a rainbow during start-up, then stays off until you use it. Effect: Rainbow.
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, not room temperature
IP Address Text sensor Diagnostic IP address of the device

With LD2412 + LD2450

Combined Presence

Entity Type Category Description
Presence Binary sensor Regular On as soon as either radar sees someone. Off once both radars have reported that they see nobody. Stays unknown until both radars have reported. 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

The LD2460 build for the Mini is planned for release, so its entity names are not final and are not listed here. Expect target entities with X, Y, distance and angle per target, radar settings and polygon zones. CeilSense V2 shows what this radar offers on that model.

With LD6002B

Firmware for the LD6002B on CeilSense Mini 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.

Climate

The Mini has no climate sensors and no air pressure sensor, so there are no CO2, temperature, humidity or air pressure entities. For those readings, see CeilSense V2 and CeilSense Pro.

Example Entity IDs

Entity Example entity ID
Presence binary_sensor.ceilsense_mini_presence
Illuminance sensor.ceilsense_mini_illuminance
LED Ring light.ceilsense_mini_led_ring
Buzzer Test button.ceilsense_mini_buzzer_test

Related