示例50:雷达感应模块

支持 RCWL-0516 微波雷达、5.8GHz 人体存在/运动雷达等带 OUT 数字输出的模块。FastBee 内置 RADAR_SENSOR 外设类型，类型 ID 为 49，读取结果为 1/0。

接线

以 RCWL-0516 为例：

5.8GHz 雷达模块如果只有 VCC/GND/OUT，同样把 OUT 接到一个输入 GPIO 即可。

先在外设配置添加id=radar_01、type49、pins=[16]的禁用外设，核验板卡引脚和供电后启用；RCWL从VIN按模块额定范围供电，OUT必须兼容3.3V。

新增外设执行规则，动作选择 传感器读取：

json

{
  "periphId": "radar_01",
  "sensorCategory": "radar",
  "dataField": "presence",
  "sensorLabel": "雷达存在",
  "unit": "",
  "decimalPlaces": 0
}

执行后会写入数据源 ds:radar_01_presence：

值	含义
`1`	检测到运动或存在
`0`	未检测到

有人时打开继电器：

http

GET /api/peripherals/status?id=radar_01

返回中的 detected 和 value 可用于确认模块输出。

首次读取、重新初始化后的去抖未完成或外设暂停/故障时，这两个字段为null，不代表无人。debounceMs同时确认激活与失活；确认失活后再计holdMs，所以落低通常经历去抖+保持。保持期间短毛刺不会延长时间，只有完成去抖的激活才能重触发。

滤波在实际读取时推进：上面的1～2秒规则间隔也决定观察分辨率，不能据50ms配置声称已捕获50ms脉冲。首次未就绪沿规则既有失败/退避策略处理，下一次采集可能晚于规则配置间隔。调试时使用较短且受控的读取间隔，结合模块自身的OUT保持观察；不要用界面数值代替真实存在、断线或负载反馈。