Deconz项目：Mumibiz TYZGTH4CH智能开关温度传感器集成指南

设备概述

Mumibiz TYZGTH4CH是一款多功能Zigbee智能设备，集成了4路开关控制和温度传感功能。该设备采用Tuya通信协议，在Deconz/Phoscon生态系统中需要特殊配置才能完整支持所有功能。本文将详细介绍如何通过DDF（设备描述文件）配置实现温度传感器的正常使用。

技术背景

该设备在标准Zigbee协议基础上使用了Tuya私有集群进行数据传输。温度数据通过特定的DPID（Data Point ID）进行标识和传输，这是Tuya设备的典型特征。在原生Deconz支持中，开关功能可以正常工作，但温度传感器需要额外配置。

配置步骤详解

1. 基础设备识别

设备型号为TYZGTH4CH，制造商为Mumibiz。在Deconz中识别为4路开关设备，包含以下主要集群：

• 基本集群（0x0000）
• 电源配置（0x0001）
• 开关控制（0x0006）
• 电平控制（0x0008）
• 颜色控制（0x0300）

2. 温度传感器配置

温度传感器需要通过DDF文件手动添加。关键配置参数包括：

{
  "type": "$TYPE_TEMPERATURE_SENSOR",
  "restapi": "/sensors",
  "uuid": [
    "$address.ext",
    "0x01",
    "0x0402"
  ],
  "items": [
    {
      "name": "state/temperature",
      "parse": {
        "fn": "tuya",
        "dpid": 102,
        "eval": "Item.val = 10 * Attr.val + R.item('config/offset').val;"
      },
      "read": {"fn": "none"},
      "default": 0
    }
  ]
}

3. Tuya设备解锁

为确保Tuya设备正常上报数据，需要在DDF中添加解锁配置：

{
  "name": "config/tuya_unlock"
}

常见问题解决

1. 温度显示为0的问题：

   • 确认使用了正确的DPID（102对应温度）
   • 检查Tuya解锁配置是否生效
   • 重新配对设备或等待24小时自动上报周期

2. 数据不更新问题：

   • 在Deconz调试视图中检查"info"和"info_l2"日志
   • 确认DDF文件已正确加载（查看DDF调试输出）

3. Phoscon界面不显示传感器：

   • 温度传感器仅在API层面可见
   • 通过Phoscon/help/API Information/sensors路径验证

最佳实践建议

1. 使用文本编辑器直接修改DDF文件，避免GUI编辑器可能引入的问题
2. 设备重新配对后，建议重启Deconz服务
3. 对于Tuya设备，耐心等待24小时自动上报周期是必要的
4. 温度值计算注意：原始数据需要乘以10（0.1°C精度）

技术细节说明

温度数据处理采用特殊算法： 温度值 = 原始值 × 10 + 偏移量 其中偏移量可通过config/offset项配置，默认为0。这种处理方式源于Tuya设备通常以整数形式传输温度数据，实际精度为0.1°C。

通过以上配置，用户可以完整使用Mumibiz TYZGTH4CH的全部功能，包括4路开关控制和精确温度监测。这一解决方案已提交至Deconz主项目，将在未来版本中作为官方支持提供。