Detect occupancy
030: Radar - Presence
Use radar presence to check whether the room is occupied.
Home Assistant · Entity reference
Find the entity.
Understand what it does.
Match the name on your device screen to its purpose, then choose the right reading or setting for your room.
For LD2410 and LD2401 radar devices. PIR and ambient light entries apply where fitted; available entities vary by model and firmware.
Click or tap an entity to open its definition. Close it with ×, Escape, or a click outside.
Controls
Sensors
Configuration
Diagnostic
Start with these for lighting
Trigger on motion
020: PIR - Motion
On PIR-equipped devices, use motion to trigger your automation.
Check brightness
01: Ambient Light
On light-equipped devices, turn lights on only when the room is dim.
Number prefixes organize the list; they are not entity IDs.
Controls
Actions for the radar module and the ESP32 that runs the device.
01: Radar - Refresh values
Button
Request a fresh set of values from the radar module.
02: Radar - Restart
Button
Restart the radar module.
03: Radar - Factory reset
Button
Restore the radar’s settings. This is separate from resetting the ESP32.
Use when you intend to reset radar tuning.
04: ESP32 - Restart
Button
Reboot the device’s ESP32 controller; expect a brief disconnect.
05: ESP32 - Factory reset
Button
Reset saved ESPHome settings. Wi-Fi provisioning may be required again.
A reset action, not a firmware update.
06: MCU Firmware
Update
Use to check for and install the latest Akamatis firmware available for your model.
Sensors
Readings and detection states for automations and observation.
01: Ambient Light
Sensor · lx · Light-equipped devices
Measure room brightness. Use this reading to gate lighting automations.
020: PIR - Motion
Binary sensor · PIR-equipped devices
On models equipped with a PIR sensor, PIR Motion detects infrared changes caused by moving people and animals. This helps avoid false detections from moving curtains, fans, and similar sources of ambient motion. Use PIR Motion to trigger automations, such as turning lights on, and radar presence to keep them on while someone remains in the room.
021: PIR - Signal Strength
Sensor · PIR-equipped devices
Shows the PIR’s motion activity. Use it together with PIR Motion Threshold to fine-tune motion detection.
030: Radar - Presence
Binary sensor
Shows Detected when a moving or stationary target is detected, and Clear when neither is detected. Recommended for presence automations.
For a PIR/radar lighting automation, PIR can start the light and radar presence can keep it on.
Previously listed as: Presence
031: Radar - Detection Distance
Sensor · cm
Shows the distance to the active target detected by the radar, whether moving or stationary.
Previously listed as: Detection Distance
032: Radar - Moving Target
Binary sensor
Shows Detected when the radar detects movement, and Clear when no movement is detected.
Previously listed as: Moving Target
033: Radar - Moving Distance
Sensor · cm
Shows the distance to the moving target detected by the radar.
Previously listed as: Moving Distance
034: Radar - Moving Energy
Sensor · %
Shows the signal strength of movement, such as walking or arm movements, on a scale from 0 to 100.
Previously listed as: Move Energy
035: Radar - Still Target
Binary sensor
Shows Detected when the radar detects a stationary target, and Clear when no stationary target is detected.
Previously listed as: Still Target
036: Radar - Still Distance
Sensor · cm
Shows the distance to the stationary target detected by the radar.
Previously listed as: Still Distance
037: Radar - Still Energy
Sensor · %
Shows the signal strength of small movements, such as breathing or slight posture changes, on a scale from 0 to 100.
Previously listed as: Still Energy
Configuration
Settings for PIR behavior, calibration, radar coverage, and gate sensitivity.
010: PIR - Motion Threshold
Number · PIR-equipped devices
Set the level required for PIR motion detection. Raise it to reject weaker signals; lower it for greater sensitivity.
011: PIR - Required Samples
Number · PIR-equipped devices
Set how many qualifying PIR readings are required before motion is confirmed. Do not confuse internal readings with points in HA history.
012: PIR - Motion Hold
Number · s · PIR-equipped devices
Keeps PIR Motion Detected for the specified time after motion stops, even if everyone has left the detection area. It reports Clear when that time passes without further motion.
020: Radar - Auto Calibration
Switch
Runs radar auto-calibration for the duration set in 021: Radar - Calibration Time. It measures background noise and adjusts gate thresholds to help reduce false detections.
021: Radar - Calibration Time
Number · min
Sets how long radar auto-calibration runs.
022: Radar - Calibration Margin
Number · %
Adds a safety margin to each gate’s threshold above the maximum energy measured during auto-calibration. This extra margin helps prevent unwanted triggering.
023: Radar - Presence Hold
Number · s
Sets how long Radar Presence stays Detected after all targets disappear. It reports Clear once this hold time has passed.
Independent of PIR Motion Hold and any turn-off delay in your HA automation.
Previously listed as: Timeout
024: Radar - Max Move Gate
Number
Sets the farthest distance gate used to detect moving targets.
Previously listed as: Max Move Distance Gate
025: Radar - Max Still Gate
Number
Sets the farthest distance gate used to detect stationary targets.
Previously listed as: Max Still Distance Gate
026: Radar - Engineering Mode
Switch
Enables detailed readings, including energy for each gate, for debugging and tuning.
Warning: Continuous Engineering Mode operation increases UART traffic and can cause device disconnections. Use it cautiously for debugging, and turn it off when finished.
Previously listed as: Engineering Mode
G0–G8 move threshold
Number · %
Sets the energy level that moving signals must exceed for detection in each distance gate.
Each gate has its own entity, for example G0 move threshold. This is a distance band, not a room polygon or Skopos zone.
Previously listed as: gX Move Threshold
G0–G8 still threshold
Number · %
Sets the energy level that stationary signals must exceed for detection in each distance gate.
Check the configured distance resolution before converting gate numbers to distances.
Previously listed as: gX Still Threshold
Diagnostic
Calibration status, component identification, device uptime, and detailed radar readings.
01: Calibration status
Text sensor
Shows auto-calibration progress as a percentage while it is running. Reports Complete when calibration finishes.
Do not describe this entity as Engineering Mode-only without checking the firmware.
02: Radar Firmware
Text sensor
Shows the radar module’s firmware version.
This is separate from the MCU firmware used by the ESP32.
Previously listed as: Presence Sensor Version
03: MAC address
Text sensor
Shows the radar module’s Bluetooth MAC address.
Engineering Mode is not required; Bluetooth availability can affect this reading.
Previously listed as: Presence Sensor MAC Address
04: ESP32 - Uptime
Sensor
Check elapsed time since the ESP32 started. A reset uptime helps identify a reboot.
ESP32 - Last Reset Reason
Text sensor
Read the reported reason for the last ESP32 restart when troubleshooting reboots.
G0–G8 move energy
Sensor · %
Shows the current moving-target energy for each distance gate. Requires Engineering Mode.
Unknown can be expected when Engineering Mode is off.
Previously listed as: gX Move Energy
G0–G8 still energy
Sensor · %
Shows the current stationary-target energy for each distance gate. Requires Engineering Mode.
The Engineering Mode requirement belongs to per-gate telemetry, not the entire Diagnostic group.
Previously listed as: gX Still Energy
Other firmware and model-specific entities
These are on the current reference page but are not visible in the supplied screenshots. Keep them as conditional documentation until the complete entity list or YAML confirms availability.
Baud Rate
Select
Sets the radar’s UART communication speed. Leave it unchanged unless the firmware configuration is updated to match.
Control Bluetooth
Switch
Turns radar Bluetooth on or off for configuration with HLKRadar. Does not enable an ESP32 Bluetooth proxy.
Distance Resolution
Select
Sets the distance covered by each gate. Smaller gates offer finer tuning but reduce maximum range.
Light Function
Select
Controls how the radar’s built-in light reading affects its OUT pin.
These settings are often unused when the OUT pin is not connected.
Light Threshold
Number
Sets the light level used by the radar’s OUT-pin light function.
These settings are often unused when the OUT pin is not connected.
Out Pin Level
Select
Sets whether the radar’s OUT pin is high or low when no target is detected.
These settings are often unused when the OUT pin is not connected.