ESPHome LD2411S 毫米波传感器组件
esphome-ld2411s
智能家居, ESP32
2/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
**诊断信息**：提供重启原因、堆栈健康、循环时间等诊断传感器
技术规格
| 传感器型号 | HLK-LD2411S |
|---|---|
| 技术 | 24GHz 毫米波雷达 |
| 接口 | UART |
| 波特率 | 256000 |
| 供电电压 | 5V（⚠️ 不可使用 3.3V） |
| 检测区域 | 运动区、存在区（独立配置） |
| 最小检测距离 | 30cm |
| 超时设置 | 0-6553 秒（硬件，以 100ms 为单位） |
| 蓝牙 | 板载 BLE（默认关闭） |
| 兼容硬件 | LD2411 和 LD2411S |
| 测试平台 | ESP32-WROOM-32 + ESPHome 2026.2.4 + ESP-IDF |
项目资源
搜索资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| HLK-LD2411S 24GHz 毫米波雷达模块 | 1 | — | UART 接口，256000 波特率 |
| ESP32 开发板（如 ESP32-WROOM-32） | 1 | — | 推荐使用 ESP-IDF 框架 |
| USB 电源适配器（5V/1A 以上） | 1 | — | 建议 2A 以确保稳定 |
| 杜邦线/排线 | 若干 | — | 用于连接传感器和 ESP32 |
能力画像
⚪ 记忆与知识检索: 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分钟时，调暗灯光"