deCONZ-REST-Plugin中Moes门窗传感器的集成指南

设备概述

Moes ZSS-S01-GWM-C是一款基于Zigbee协议的智能门窗传感器，制造商ID为_TZ3000_8yhypbo7，型号标识符为TS0203。该设备属于典型的Zigbee终端设备，主要用于检测门窗的开闭状态。

技术规格

该传感器具有以下关键特性：

• 支持Zigbee 3.0协议
• 内置电池供电（可通过Power Configuration集群监测电量）
• 采用IAS Zone集群报告门窗状态变化
• 工作频段2.4GHz

集成过程

设备识别

在deCONZ-REST-Plugin项目中，该设备已被归类到tuya目录下的_TZ3000_TS0203_door_sensor.json文件中。集成时需要同时匹配制造商名称和型号标识符，即使两者相同也需要明确指定。

功能实现

设备成功配对后，能够正常报告门窗的开闭状态。但部分用户反馈电池电量信息可能不会立即显示，这属于正常现象，因为：

1. 该设备没有强制每24小时上报电量的机制
2. 电量信息需要通过Power Configuration集群(0x0001)在端点1(0x0021)上读取

电量监测优化

如果24小时后仍未显示电量信息，建议尝试以下解决方案：

1. 重新加入设备（无需删除原有配置）
2. 在设备描述文件(DDF)中添加以下配置项以启用定期读取：

"config": {
    "battery": {
        "refresh.interval": 86400,
        "read": {
            "at": "0x0021",
            "cl": "0x0001",
            "ep": 1,
            "fn": "zcl:attr"
        }
    }
}

这段配置会：

• 设置24小时(86400秒)的刷新间隔
• 指定从正确的端点和集群读取电池信息
• 使用ZCL属性读取功能

使用建议

1. 首次配对后请等待至少24小时以获取完整的设备信息
2. 如遇电量不显示问题，优先尝试重新加入设备
3. 对于长期使用，建议添加上述配置以确保定期更新电量信息

该设备已得到社区验证，能够稳定工作在deCONZ环境中，是智能家居门窗监测的可靠选择。