deCONZ项目：Tuya毫米波雷达人体存在传感器WY-M100-S的集成与配置

设备概述

WY-M100-S是一款基于毫米波雷达技术的人体存在检测传感器，由Tuya生产制造。该设备是ZY-M100的升级版本，具有相同的核心功能但采用了不同的固件版本。作为智能家居环境中的关键感知设备，它能够精确检测人体存在状态、距离以及环境光照强度。

技术特性

该传感器具备以下核心功能组件：

1. 毫米波雷达模块：采用24GHz频段，可检测人体微动和呼吸
2. 光照传感器：测量环境光照强度（0-2000lux范围）
3. Zigbee 3.0通信：基于Tuya TS0601模组实现无线连接

设备集成方案

硬件识别参数

• 制造商代码：_TZE204_laokfqwu
• 设备型号：TS0601
• 产品标识：MmwRadar Human Presence Detector

端点与集群配置

设备通过Zigbee网络提供两个功能端点：

1. 端点0x01：主控制端点，处理设备基本功能
2. 集群EF00：Tuya私有集群，用于传输传感器数据和控制命令

功能实现细节

人体存在检测

设备通过以下参数实现精确的人体检测：

• 灵敏度调节：1-9级可调（默认7级）
• 触发距离：1-10米可调或关闭（默认10米）
• 检测延迟：0-10秒可调（默认0.1秒）
• 消失延迟：0-15000秒可调（默认90秒）

实现原理是通过毫米波雷达分析多普勒效应，检测人体微动和呼吸特征。

光照检测

设备内置光照传感器提供：

• 实时lux值测量（0-2000lux）
• 明暗状态判断（基于可配置阈值）
• 日光状态检测

配置注意事项

1. DDF文件配置：需要使用特定的设备描述文件，其中包含两个子设备定义：

   • 光照传感器（TYPE_LIGHT_LEVEL_SENSOR）
   • 存在传感器（TYPE_PRESENCE_SENSOR）

2. 脚本依赖：光照检测功能需要lux_to_lightlevel.js转换脚本，该脚本应放置在指定目录下。

3. 参数范围验证：配置敏感度、距离等参数时需注意设备支持的数值范围，避免设置无效值。

典型应用场景

1. 智能照明控制：根据人员存在和环境光照自动调节灯光
2. 安防监控：检测特定区域的人员活动
3. 能源管理：无人时自动关闭电器设备
4. 空间利用率分析：统计区域人员存在时间

故障排查指南

常见问题及解决方法：

1. 光照数据缺失：检查lux_to_lightlevel.js脚本是否放置在正确位置
2. 存在检测不准确：调整灵敏度和触发距离参数
3. 设备无响应：验证Zigbee信号强度，必要时调整设备位置
4. 错误代码解析：设备提供自检状态码（0-5），可据此判断故障类型

该设备的成功集成为智能家居系统提供了可靠的人体存在检测能力，通过合理的参数配置可以满足不同场景下的使用需求。