Zigbee2MQTT项目：为Tuya 4路智能开关添加设备支持

设备背景

Tuya TS0601型号的4路智能开关是一款基于Zigbee协议的智能家居设备，由制造商_TZE204_unsxl4ir生产。该设备具有4个独立的物理按键开关，能够控制多个照明回路。设备采用单相电源供电，Zigbee协议版本为21（当前最新为23）。

技术特性分析

该设备在Zigbee网络中被识别为路由器设备（Router），具有以下技术特点：

1. 工作频率：2.4GHz Zigbee
2. 端点配置：
   • 端点1：包含输入集群4、5、61184、0和输出集群25、10
   • 端点242：仅包含输出集群33
3. 硬件版本：1
4. 固件版本：74
5. ZCL版本：3

设备支持实现

通过分析发现，该设备与已知的_TZE204_aagrxlbd和TB26-4型号实际上是同一款产品，只是厂商名称不同。因此可以采用相同的转换器配置来实现支持。

转换器配置详解

以下是完整的设备定义配置，通过外部转换器方式实现：

const fz = require('zigbee-herdsman-converters/converters/fromZigbee');
const tz = require('zigbee-herdsman-converters/converters/toZigbee');
const exposes = require('zigbee-herdsman-converters/lib/exposes');
const reporting = require('zigbee-herdsman-converters/lib/reporting');
const modernExtend = require('zigbee-herdsman-converters/lib/modernExtend');
const e = exposes.presets;
const ea = exposes.access;
const tuya = require('zigbee-herdsman-converters/lib/tuya');

const definition = {
    zigbeeModel: ['TS0601'],
    model: 'TS0601',
    vendor: '_TZE204_unsxl4ir',
    description: '4路智能开关',
    fromZigbee: [tuya.fz.datapoints],
    toZigbee: [tuya.tz.datapoints],
    configure: tuya.configureMagicPacket,
    exposes: [
        tuya.exposes.switch().withEndpoint('l1'),
        tuya.exposes.switch().withEndpoint('l2'),
        tuya.exposes.switch().withEndpoint('l3'),
        tuya.exposes.switch().withEndpoint('l4'),
    ],
    endpoint: (device) => {
        return {'l1': 1, 'l2': 1, 'l3': 1, 'l4': 1};
    },
    meta: {
        multiEndpoint: true,
        tuyaDatapoints: [
            [1, 'state_l1', tuya.valueConverter.onOff],
            [2, 'state_l2', tuya.valueConverter.onOff],
            [3, 'state_l3', tuya.valueConverter.onOff],
            [4, 'state_l4', tuya.valueConverter.onOff],
        ],
    },
};

module.exports = definition;

关键配置说明

1. 数据点映射：

   • 数据点1对应第一路开关状态
   • 数据点2对应第二路开关状态
   • 数据点3对应第三路开关状态
   • 数据点4对应第四路开关状态

2. 端点配置：

   • 虽然设备有多个物理开关，但Zigbee端点只有一个（端点1）
   • 通过multiEndpoint和端点映射实现多路控制

3. 特殊配置：

   • 使用tuya.configureMagicPacket进行设备配置
   • 如果遇到时间同步问题，可以取消注释onEvent: tuya.onEventSetTime

常见问题处理

1. 设备未显示在仪表盘：

   • 确保外部转换器文件已正确放置
   • 检查Zigbee2MQTT日志是否有加载错误

2. 控制无响应：

   • 确认数据点映射正确
   • 检查设备是否成功加入网络

3. 状态不同步：

   • 可能需要启用时间同步事件处理

总结

通过分析Tuya TS0601智能开关的通信协议和数据点结构，我们成功实现了对该设备的支持。这款4路智能开关现在可以通过Zigbee2MQTT进行集中控制，并集成到智能家居系统中。对于其他类似Tuya设备，也可以参考这种基于数据点的配置方法来实现支持。