海凌科HLK-LD2402 ESP8266, esphome接入HA

qyt2001

买了个LD2402，这玩意儿太便宜了
淘宝新用户3块多，老用户5块多包邮。
配上CH340C+ESP-01S，8.5+3元邮费。一套也就15块钱。

和2410效果差不多，但只能串口配置，不能蓝牙配置。
平时自动配置够用，但某个范围想调整的时候，就需要工程模式监控看是哪个gate扰动需要调阈值。
github上发现了一个别人用AI写的，实测普通模式没问题，但工程模式非常混乱。
用了2个月后，我最近想对着代码仔细改改，但是，折腾了一星期，做了一些修复，折腾不下去了。。。就这样吧

配置文件中，默认LEVEL：debug，但因为代码的debug信息太多，非常非常容易死机掉线，改到LEVEL：INFO就好了

修改内容很多，我也是AI改的，反正现在功能都能用。至于还有哪里有bug，哪里代码重复，也不想检查了。写点主要的：
1.原程序只有gate0到gate14，实际有gate15，补上；
2.原程序代码工程模式下，没有距离和存在状态获取，获得的gate信息也是各种错位的，做了修复；
3.原程序每个gate threshold都有一个单独的设置滑动杆，但实际是错位的，所以没法用。我把这部分全删了，做了一个设置单个gate threshold的方式，如下图；
4.原程序的Calibrate with Sensitivity Inputs结果有点问题，做了修复；
5.原程序Timeout和Max Distance不能设置，加上了，点击Reset Settings的时候可以设置


用法：
esphome用法不科普了，拷贝到config esphome，secrets.yaml填入自己的相关密码，我的环境是ESPHome 2024.9.2，其他可能不保证能用。
（PS：我试了下最新的2025.7.2，把api加密关掉就能用了，这部分对esp8266的CPU开销太大，新版本直接跑不起来了。2025.7.24更新，又删了点冗余代码，加了个内存监控，现在最新版Esphome也能跑了）
api:
  #encryption:
  #  key: !secret api_password

接入ha后，没人的情况下，点击Reset Settings，会按照3 3 3的默认值生成自动门限，Reset Settings是掉电保存的。

如果对3 3 3的默认门限不满意，比如有过多误触发，可以自己设置系数，然后点击Calibrate with Sensitivity Inputs重新生成，也可以按下图单独设置某个门限阈值。
这俩命令不带掉电保存的，如果需要掉电保存，需要额外点击一下Save Config。


sensor:
  - platform: hlk_ld2402
    id: radar_distance
    name: "Distance"
    hlk_ld2402_id: radar_sensor
    device_class: distance
    unit_of_measurement: "cm"
    accuracy_decimals: 1
    throttle: 1000ms  # Use direct parameter for throttling



yaml中的这个throttle决定普通模式更新频率，默认1秒
.h文件中的engineering_throttle_ms_决定工程模式更新频率，默认是2秒。

不要问我为什么不更新到yaml中，不想干了，又不是不能用，AI屎山代码快把我搞崩溃了。。。







参考资料：

用户手册：
h.hlktech.com/download/HLK-LD2402-24G/1/HLK-LD2402用户手册 V1.08 .pdf
一个github开源，但工程模式完成度不太好的项目：
Mc-Joung/hlk_ld2402_esphome: Support for the Hi-Link HLK-LD2402 microwave radar sensor in ESPHome. This sensor can detect human presence and measure the distance to detected objects.

qyt2001

贴一个完整的截图。
下面数字不对的是滚动截图过程中的问题，传感器都是全的。

a_dongde

我也买了一套，，，奈何没有完整的焊接和代码，，我又不会，，，一直放在盒子里吃灰

admin

LD2402还是非常稳的！

a5824420

2410b，2410c通用吗

qyt2001

a5824420 发表于 2025-7-23 22:30
2410b，2410c通用吗

2410b 2410c有esphome官方的，比这个容易多了

LD2410 传感器 — ESPHome --- LD2410 Sensor — ESPHome
你直接把这个链接丢给AI，让AI给你生成一份能直接用的yaml就行了。

qyt2001

a5824420 发表于 2025-7-23 22:30
2410b，2410c通用吗

2410有esphome官方的。直接把2410的esphome官方介绍页链接丢给deepseek，让它给你生成yaml文件就行了。