LD2420 24GHz 毫米波雷达传感器

组件

ld2420 传感器平台允许您使用 HLK-LD2420 运动和存在传感器。必须在配置中设置 UART 才能使此传感器工作。

根据您的固件版本，串口波特率将有所不同：固件版本低于 v1.5.3 的模块为 256000，较新版本为 115200。固件 v1.5.3 的 tx_pin 从 ot2 更改为 ot1。固件 v1.5.4 及更高版本现在具有观察闸门能量信号电平的功能，在此版本中我们可以动态校准闸门静止和移动阈值。

此组件具有动态配置功能和紧凑的 UI 格式。选择器、数值和按钮组件提供配置值输入和控制。

模块引脚定义

固件 1.5.2 及更早版本

引脚#	名称	功能
1	3v3	VCC
2	GND	GND
3	OT1	存在信号输出
4	RX	串口 Rx（接 ESP Tx）
5	OT2	串口 Tx（接 ESP Rx）

固件 1.5.3 及更新版本

引脚#	名称	功能
1	3v3	VCC
2	GND	GND
3	OT1	串口 Tx（接 ESP Rx）
4	RX	串口 Rx（接 ESP Tx）
5	OT2	存在信号输出

# 示例配置条目
ld2420:

text_sensor:
  - platform: ld2420
    fw_version:
      name: LD2420 固件

sensor:
  - platform: ld2420
    moving_distance:
      name : 移动距离

binary_sensor:
  - platform: ld2420
    has_target:
      name: 存在

select:
  - platform: ld2420
    operating_mode:
      name: 操作模式

number:
  - platform: ld2420
    presence_timeout:
      name: 检测存在超时
    min_gate_distance:
      name: 检测闸门最小值
    max_gate_distance:
      name: 检测闸门最大值
    # 详见下方"数值"部分
    gate_select:
      name: 选择要设置的闸门
    still_threshold:
      name: 设置静止阈值
    move_threshold:
      name: 设置移动阈值

button:
  - platform: ld2420
    apply_config:
      name: 应用配置
    factory_reset:
      name: 恢复出厂设置
    restart_module:
      name: 重启模块
    revert_config:
      name: 撤销编辑

平台

ld2420:

配置变量

ld2420 (必需): 组件平台。

选择器

操作模式：

select:
  - platform: ld2420
    operating_mode:
      name: 操作模式

动态 UI 提供三种操作模式：Normal（正常）、Calibrate（校准） 和 Simple（简单）。选择器组件允许您选择活动模式。

Normal: 这是默认模式。它将 ld2420 设置为能量报告模式，适用于固件 v1.5.4 或更高版本。在此模式下，模块会在本地数组中持续记录所有闸门的能量级别，以便用于动态校准功能。
Calibrate: 当选择校准模式时，模块将收集平均和峰值能量级别，每五秒报告一次。报告仅在日志控制台中提供，仅供参考。为了校准闸门配置，目标环境中不应存在任何物体。记录将建立毫米波噪声底级别和不良反射或信号失真峰值。这应该收集至少 30 秒。更长的运行可以捕获更多潜在的虚假信号，例如当模块附近使用微波炉和其他噪声源时。

当在校准模式下按下 apply_config 按钮时，LD2420 将根据收集的噪声底数据配置计算值，模块将返回正常模式。选择任何其他模式将丢弃本次会话收集的噪声数据，不会暂存任何更改的设置。一旦执行 apply_config 动作，计算出的值将被持久化。闸门值可以手动调整或重新校准，或者您可以使用恢复出厂设置按钮来恢复模块的默认设置。
Simple: 提供与固件 v1.5.3 及更早版本的向后兼容性，当检测到的固件版本为 v1.5.3 或更早时将自动设置。

配置变量

operating_mode (必需): 提供操作模式选择组件。可包含选择器的任何选项。

数值

number:
  - platform: ld2420
    presence_timeout:
      name: 检测存在超时
    min_gate_distance:
      name: 检测闸门最小值
    max_gate_distance:
      name: 检测闸门最大值

    gate_select:
      name: 选择要设置的闸门
    still_threshold:
      name: 设置静止阈值
    move_threshold:
      name: 设置移动阈值

    gate_move_sensitivity:
      name: 移动校准灵敏度系数
    gate_still_sensitivity:
      name: 静止校准灵敏度系数

    gate_0:
      move_threshold:
        name: 闸门 0 移动阈值
      still_threshold:
        name: 闸门 0 静止阈值
    gate_1:
      move_threshold:
        name: 闸门 1 移动阈值
      still_threshold:
        name: 闸门 1 静止阈值

配置变量

presence_timeout (可选): 不再检测到存在后，占用状态（存在）持续的时间（秒）。在此时间窗口内的任何能量检测都会从此值重新开始倒计时。默认为 120 秒。当指定 min_gate_distance 和 max_gate_distance 时必需。可包含数值的任何选项。
min_gate_distance (可选): 移动或静止能量检测的最小距离。值在 0 到 max_gate_distance - 1 之间。每个增量等于 70 厘米。默认为 1。当指定 presence_timeout 和 max_gate_distance 时必需。可包含数值的任何选项。
max_gate_distance (可选): 移动检测的最大闸门。值从 1 到 15。每个闸门以 70 厘米的增量检测移动和静止能量。在最大值时，传感器的范围约等于 12 米；但是，在此范围内的精度可能会降低。建议的最大值为 12，结果约为 9 米。当指定 presence_timeout 和 min_gate_distance 时必需。可包含数值的任何选项。
gate_still_sensitivity (可选): 闸门静止阈值校准灵敏度系数。默认为 0.5，范围为 0-1，0 = 高，1 = 低。可包含数值的任何选项。
gate_move_sensitivity (可选): 闸门移动阈值校准灵敏度系数。默认为 0.5，范围为 0-1，0 = 高，1 = 低。可包含数值的任何选项。
gate_select (可选): 选择要编辑的闸门值（闸门 # 从 0 到 15）。闸门阈值通过选择闸门编号然后调整移动和静止阈值来编辑。请注意，当定义此变量时，组件将以紧凑 UI 模式运行，以下两个配置变量将变为必需： 可包含数值的任何选项。
- still_threshold (可选): 当前选定的闸门编号上运动能量检测的闸门静止值阈值级别。大于闸门（距离）指定值的值将触发移动检测。可包含数值的任何选项。
- move_threshold (可选): 当前选定的闸门编号上静止能量检测的闸门移动值阈值级别。小于闸门（距离）指定值的值将触发静止检测。可包含数值的任何选项。
gate_n (可选): 提供单独的闸门阈值数值输入。范围是 gate_0 到 gate_15。 不能与 gate_select（上文）一起使用。每个闸门条目需要一个 still_threshold 和 move_threshold：
- still_threshold (每个 gate_n 条目必需): 当前选定的闸门编号上运动能量检测的闸门静止值阈值级别。大于闸门（距离）指定值的值将触发移动检测。可包含数值的任何选项。
- move_threshold (每个 gate_n 条目必需): 当前选定的闸门编号上静止能量检测的闸门移动值阈值级别。小于闸门（距离）指定值的值将触发静止检测。可包含数值的任何选项。

按钮

button:
  - platform: ld2420
    apply_config:
      name: 应用配置
    factory_reset:
      name: 恢复出厂设置
    restart_module:
      name: 重启模块
    revert_config:
      name: 撤销编辑

提供四个按钮组件，用于编辑、保存、重启和恢复 LD2420 模块的出厂设置等配置控制。

配置变量

apply_config (可选): 保存手动配置调整或自动校准静止和移动阈值配置设置。可包含按钮的任何选项。
restart_module (可选): 重启 LD2420 模块。可包含按钮的任何选项。
revert_config (可选): 在通过 apply_config 按钮应用之前，撤销进行中的编辑。可包含按钮的任何选项。
factory_reset (可选): 恢复一组基本的 LD2420 配置值。可包含按钮的任何选项。

出厂设置默认值

设置:	值:
超时	120秒
最小闸门距离	1
最大闸门距离	12

闸门编号:	移动阈值	静止阈值
0	60000	40000
1	30000	20000
2	400	200
3	300	250
4	250	150
5	250	150
6	250	150
7	250	150
8	300	150
9	250	150
10	250	150
11	250	150
12	250	100
13	200	100
14	200	100
15	200	100

传感器

ld2420 传感器允许您使用 Ld2420 来近似测量传感器与其检测场内移动物体之间的距离。

sensor:
  - platform: ld2420
    moving_distance:
      name : 移动距离

配置变量

moving_distance (可选): 传感器与检测到的移动目标之间的距离。可包含传感器的任何选项。

二值传感器

ld2420 二值传感器允许您使用 Ld2420 来感知存在。

binary_sensor:
  - platform: ld2420
    has_target:
      name: 存在

配置变量

has_target (可选): 如果检测到静止或移动目标，has_target 将在 presence_time_window 设置的持续时间内设置为 true。可包含二值传感器的任何选项。

文本传感器

ld2420 文本传感器提供 Ld2420 的版本信息。

text_sensor:
  - platform: ld2420
    fw_version:
      name: LD2420 固件

配置变量

fw_version (可选): 允许您获取 Ld2420 固件版本。可包含文本传感器的任何选项。

重要信息

detection_gate_max 和 detection_gate_min 之外的固体物体和噪声可能会导致误检测或导致闸门阈值异常。例如，闸门最大范围内的墙壁可能导致信号反射。如果您的传感器报告意外检测，您应该通过将其放置在没有移动物体的完全开放的房间中来测试它。

此外，切勿以检测场重叠的方式放置两个或更多传感器，因为这肯定会导致误检测。

使用 HLKTech 提供的 LD2420 工具可以进行固件更新。您需要给他们发送电子邮件并请求 bin 文件。目前只有固件版本 v1.5.6 及更高版本可以升级。不要尝试更新到较旧的固件版本。这将使模块变砖。

另见

官方数据手册/手册仍在开发中；如需信息请发送电子邮件至 sales@hlktech.com。
官方网站 https://www.hlktech.net/