示例50:雷达感应模块

fastbee大约 2 分钟

示例50:雷达感应模块

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

接线

以 RCWL-0516 为例：

模块引脚	ESP32/ESP32-S3	说明
3V3	3.3V	模块 3.3V 输出或供电脚，按实物标注接线
GND	GND	必须共地
OUT	GPIO16 示例	检测到目标时默认输出高电平
VIN	4-28V	使用 VIN 供电时注意电源范围
CDS	可不接	可接光敏控制，按模块说明决定

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

外设执行读取

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

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

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

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

联动示例

有人时打开继电器：

创建定时触发规则，每 1-2 秒执行一次雷达读取。
创建事件触发规则，事件选择 ds:radar_01_presence，条件为 = 1。
动作选择继电器外设，设置高电平或低电平，按继电器有效电平决定。

调试接口

GET /api/peripherals/status?id=radar_01

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

安装建议

雷达天线区域不要贴金属外壳，安装时让感应面朝向检测区域。
RCWL-0516 默认检测距离约数米，输出会保持一段时间后再拉低，这是模块自身行为。
如果模块输出低电平表示检测到，取消勾选“OUT 高电平表示检测到”。
雷达比 PIR 更容易穿透薄塑料和纸板，也更容易受安装环境影响，固定安装后再做最终阈值和延时测试。