LD2410S Sensor

Component/Hub

The ld2410s component allows you to use the HI-LINK LD2410S presence radar with ESPHome. It is a lower-power relative of the LD2410 that reports presence over a serial connection.

The UART is required to be set up in your configuration for this sensor to work; baud_rate, parity and stop_bits must be respectively 115200, NONE and 1. Use of a hardware UART is recommended.

# Example configuration entry
ld2410s:

Configuration Variables

• uart_id (Optional, ID): Manually specify the ID of the UART Component, which is necessary if you have multiple UARTs defined in your configuration.
• id (Optional, ID): Manually specify the ID for this component.

At start the component reads the module’s firmware version and settings, then switches it to its minimal output mode, in which the module only reports presence and distance. If the module stops sending data for five seconds the component raises a warning and runs the setup again.

Binary Sensor

binary_sensor:
  - platform: ld2410s
    has_target:
      name: Presence

Configuration Variables

• has_target (Optional): True while the module detects a target. All options from Binary Sensor.
• ld2410s_id (Optional, ID): Manually specify the ID of the ld2410s component, which is necessary if you have more than one.

Sensor

sensor:
  - platform: ld2410s
    distance:
      name: Distance

Configuration Variables

• distance (Required): The distance to the detected target in cm, 0 while there is no target. All options from Sensor.
• ld2410s_id (Optional, ID): Manually specify the ID of the ld2410s component, which is necessary if you have more than one.

Text Sensor

text_sensor:
  - platform: ld2410s
    version:
      name: Firmware

Configuration Variables

• version (Required): The firmware version of the module, read once at start. All options from Text Sensor.
• ld2410s_id (Optional, ID): Manually specify the ID of the ld2410s component, which is necessary if you have more than one.

Number

The module’s settings are read at start and written back whenever one of them is changed.

number:
  - platform: ld2410s
    max_distance:
      name: Max Distance
    min_distance:
      name: Min Distance
    no_delay:
      name: No Delay
    status_reporting_frequency:
      name: Status Reporting Frequency
    distance_reporting_frequency:
      name: Distance Reporting Frequency

Configuration Variables

• max_distance (Optional): The farthest distance at which a target is detected, in steps of 0.7 m up to 11.2 m. All options from Number.
• min_distance (Optional): The nearest distance at which a target is detected, in steps of 0.7 m. All options from Number.
• no_delay (Optional): How long the module keeps reporting a target after it left, from 1 to 120 s. All options from Number.
• status_reporting_frequency (Optional): How often the module reports presence, from 0.5 to 8 Hz. All options from Number.
• distance_reporting_frequency (Optional): How often the module reports the distance, from 0.5 to 8 Hz. All options from Number.
• ld2410s_id (Optional, ID): Manually specify the ID of the ld2410s component, which is necessary if you have more than one.

Select

select:
  - platform: ld2410s
    response_speed:
      name: Response Speed

Configuration Variables

• response_speed (Required): How quickly the module reacts to a change, Normal or Fast. All options from Select.
• ld2410s_id (Optional, ID): Manually specify the ID of the ld2410s component, which is necessary if you have more than one.

See Also

• LD2410 Sensor
• API Reference: ld2410s.h