deconz-rest-plugin项目：Moes智能水气阀门控制器集成指南

设备概述

Moes PF-PM02D-TYZ是一款基于Zigbee协议的智能水气阀门控制器，采用Tuya TS0601通信模块。该设备能够远程控制水气阀门的开关状态，适用于家庭和工业场景中的流体控制应用。

技术规格

• 制造商：Moes
• 型号标识符：PF-PM02D-TYZ
• 通信协议：Zigbee 3.0
• 主控芯片：Tuya TS0601
• 工作电压：DC 12V
• 控制方式：无线远程控制

设备功能特性

1. 远程阀门开关控制
2. 状态反馈功能
3. 低功耗设计
4. 兼容主流智能家居平台

集成方案

设备端点分析

该设备在Zigbee网络中呈现以下端点配置：

• 端点1：主控制端点
• 端点242：用于特定功能通信

关键集群支持

设备支持以下Zigbee集群：

1. 基本集群（0x0000）：提供设备基本信息
2. 电源配置集群（0x0001）：管理设备电源相关参数
3. 开关控制集群（0x0006）：控制阀门开关状态
4. 电平控制集群（0x0008）：支持阀门开度调节
5. 简单计量集群（0x0702）：记录流体使用量

DDF配置文件实现

通过创建设备描述文件(DDF)，可以实现设备与deCONZ平台的完整集成：

{
  "schema": "devcap1.schema.json",
  "manufacturername": "_TZE204_d0ypnbvn",
  "modelid": "TS0601",
  "product": "TS0601",
  "sleeper": false,
  "status": "Draft",
  "path": "/devices/tuya/_TZE204_d0ypnbvn_water_valve",
  "subdevices": [
    {
      "type": "$TYPE_ON_OFF_OUTPUT",
      "restapi": "/lights",
      "uuid": [
        "$address.ext",
        "0x01"
      ],
      "items": [
        {
          "name": "attr/id"
        },
        {
          "name": "attr/lastannounced"
        },
        {
          "name": "attr/lastseen"
        },
        {
          "name": "attr/manufacturername"
        },
        {
          "name": "attr/modelid"
        },
        {
          "name": "attr/name"
        },
        {
          "name": "attr/swversion",
          "parse": {"fn": "zcl", "ep": 1, "cl": "0x0000", "at": "0x0001", "script": "tuya_swversion.js"},
          "read": {"fn": "zcl", "ep": 1, "cl": "0x0000", "at": "0x0001"}
        },
        {
          "name": "attr/type"
        },
        {
          "name": "attr/uniqueid"
        },
        {
          "name": "state/alert",
          "default": "none",
          "public": false
        },
        {
          "name": "state/on",
          "parse": {"fn": "tuya", "dpid": 1, "eval": "Item.val = Attr.val;" },
          "write": {"fn": "tuya", "dpid": 1, "dt": "0x10", "eval": "Item.val == 1 ? 1 : 0;"},
          "read": {"fn": "tuya"},
          "refresh.interval": 300
        },
        {
          "name": "state/reachable"
        }
      ]
    }
  ]
}

控制指令说明

阀门开启指令

通过发送以下数据包可以开启阀门：

• 端点：1
• 集群：0x0006（开关控制）
• 命令：0x01（开启）

阀门关闭指令

通过发送以下数据包可以关闭阀门：

• 端点：1
• 集群：0x0006（开关控制）
• 命令：0x00（关闭）

应用场景建议

1. 家庭用水管理：远程控制家庭主水阀
2. 燃气安全控制：紧急情况下远程切断燃气供应
3. 灌溉系统：定时控制花园灌溉系统
4. 工业流程控制：自动化生产线的流体控制

注意事项

1. 设备需要稳定的Zigbee网络环境
2. 安装时需考虑阀门类型与设备兼容性
3. 定期检查设备电池状态（如适用）
4. 重要系统建议保留手动控制功能作为备份

通过以上配置方案，Moes智能水气阀门控制器可以很好地集成到基于deCONZ的智能家居系统中，为用户提供便捷的远程流体控制功能。