ESPHome LD2411S 毫米波传感器组件 esphome-ld2411s

智能家居, ESP32 ⭐⭐☆☆☆ (2/5) 已发布
DAB-LABS 16 Stars MIT BOM 完整度: /5 教程完整度: /5

项目简介

ESPHome external component for the HLK-LD2411S 24GHz mmWave presence sensor. Motion, presence, and distance sensors. Run


esphome-ld2411s 是一个专为 HLK-LD2411S 24GHz 毫米波雷达传感器设计的 ESPHome 外部组件。该传感器由海凌科(Hi-Link)生产,与普通雷达模块不同,它能精确区分“运动”和“存在”两种状态——即使人静止不动(如坐在工位或书桌前),也能稳定检测到目标,非常适合需要判断“人是否在场”而非“人是否在动”的智能场景。

标签

项目特点

**存在检测**:二进制存在传感器,可检测静止目标(占用检测)
**运动检测**:二进制运动传感器,检测主动移动
**距离传感器**:以厘米为单位报告目标距离
**可配置检测区域**:支持运动区和存在区的独立最小/最大距离(厘米)配置
**运行时配置**:从 Home Assistant 调整设置,无需重新刷写固件
**雷达控制**:提供雷达重启和恢复出厂设置按钮
**蓝牙开关**:从 Home Assistant 启用/禁用传感器板载 BLE
**诊断信息**:提供重启原因、堆栈健康、循环时间等诊断传感器

技术规格

传感器型号
技术
接口
波特率
供电电压
检测区域
最小检测距离
超时设置
蓝牙
兼容硬件
测试平台

项目资源

物料清单 (BOM)

物料名称 数量 参考价格 备注
HLK-LD2411S 24GHz 毫米波雷达模块 1 UART 接口,256000 波特率
ESP32 开发板(如 ESP32-WROOM-32) 1 推荐使用 ESP-IDF 框架
USB 电源适配器(5V/1A 以上) 1 建议 2A 以确保稳定
杜邦线/排线 若干 用于连接传感器和 ESP32

所需工具

工具用途是否必需
计算机 编写和编译 ESPHome 固件 ✅ 是
USB 数据线 连接 ESP32 到计算机进行刷写 ✅ 是
Home Assistant 运行 ESPHome 并管理传感器 ✅ 是
烙铁(可选) 焊接排针到传感器模块 ▢ 推荐

能力画像

记忆与知识检索
2/5
逻辑推演
3/5
表达与交流
1/5
感知与观察
2/5
数理与计算
2/5
动手与操作
3/5
狂热与坚持
2/5
创造与创新
2/5

所需技能

🔧 **动手能力**:需要基本的电子连接能力,能够正确连接传感器到 ESP32 开发板(5V 供电、UART 接线) 💻 **编程能力**:需要了解 ESPHome YAML 配置语法,能够编写和修改配置文件 ⚡ **电子电路**:了解 UART 通信和基本供电要求,注意 LD2411S 需要 5V 供电而非 3.3V

适用场景

**智能家居存在检测**:检测房间内是否有人(包括静止状态),用于自动控制灯光、空调等设备
**办公区域监控**:检测工位是否有人,实现节能管理
**安全监控**:检测区域内是否有运动或静止目标
**自动化触发**:结合 Home Assistant 实现复杂的自动化场景,如"当检测到有人且静止超过5分钟时,调暗灯光"