SENSORS

​

• Moving Distance
  Distance to the currently detected moving target.

• Move Energy
  Relative signal strength (0–100) of moving motion such as walking, arm movement, or body movement.

• Moving Target
  Binary sensor showing Detected or Clear depending on whether motion is currently detected.

• Still Distance
  Distance to the currently detected stationary target.

• Still Energy
  Relative signal strength (0–100) of small micro-movements such as breathing or slight posture changes.

• Still Target
  Binary sensor showing Detected or Clear depending on whether a stationary target is currently detected.

• Detection Distance
  Distance to the active detected target. This may reflect either the moving or still target, depending on which detection is currently dominant.

• Presence
  Combined presence sensor. Shows Detected when either a Moving Target or Still Target is active, and Clear only when both are inactive.
  This is the recommended sensor for automations.

CONFIGURATION

​

• Baud Rate
  UART communication speed of the LD2410 module. Normally this should not be changed, as incorrect values can break communication with the device.

• Control Bluetooth
  Enables or disables the LD2410 module’s Bluetooth radio. Bluetooth is mainly used with the HLKRadar mobile app for configuration and tuning.
  This does not turn the ESP device into a Bluetooth proxy.

• Engineering Mode
  Enables extended real-time diagnostic data, including per-gate energy values. Useful for tuning and troubleshooting, but usually best left disabled during normal operation because it generates a large amount of data.

• Light Function / Light Threshold / Out Pin Level
  The LD2410 includes a simple ambient light feature that can control a hardware output pin. On many ESPHome-based devices this output pin is not connected, so these settings are often unused.

IMPORTANT NOTE ON ZONES (GATES)

​

The LD2410 divides its detection area into multiple distance zones called gates, labeled g0 through g8.

Each gate represents a distance range from the sensor. These gates are used independently for motion and stationary presence detection.

Typical default gate size is approximately 75 cm (about 2.5 ft) per gate.

Understanding gates is important for proper tuning and reducing false detections.

• Distance Resolution
  Sets the size of each gate.
  Smaller gate sizes allow finer tuning but reduce maximum detection range. Larger gate sizes increase range but reduce tuning precision.

• gX Move Threshold
  Motion is detected in gate X when the move energy exceeds this threshold.

• gX Still Threshold
  Stationary presence is detected in gate X when the still energy exceeds this threshold.

• Max Move Distance Gate
  Limits the maximum gate used for moving target detection.

• Max Still Distance Gate
  Limits the maximum gate used for stationary target detection.

• Timeout
  Amount of time the Presence sensor remains in the Detected state after all targets disappear.

DIAGNOSTICS (ENGINEERING MODE ONLY)

​

These values are only available when Engineering Mode is enabled.

• gX Move Energy
  Current motion energy value for gate X.

• gX Still Energy
  Current stationary energy value for gate X.

• Presence Sensor MAC Address
  Bluetooth MAC address of the LD2410 module.

• Presence Sensor Version
  Firmware version reported by the LD2410 module.