Zigbee2MQTT项目新增对Tuya温湿度传感器的支持

设备概述

近期Zigbee2MQTT项目新增了对一款Tuya品牌的温湿度传感器的支持。该设备型号为TS0601，制造商名称为_TZE284_qyflbnbj，是一款带有外部传感器的Zigbee温湿度监测设备。

设备特性

这款温湿度传感器具有以下主要功能特点：

1. 温度监测功能
2. 湿度监测功能
3. 电池电量监测
4. LCD显示屏
5. 外部传感器探头

技术实现

在Zigbee2MQTT项目中，开发者为该设备创建了专门的转换器定义。核心实现包括：

1. 设备指纹识别：通过modelID和manufacturerName唯一标识设备
2. 数据点映射：将Tuya特有的数据点转换为标准MQTT消息
3. 状态暴露：将设备状态通过MQTT主题发布

代码实现

设备定义的核心代码如下：

const definition = {
    fingerprint: [
        {
            modelID: 'TS0601',
            manufacturerName: '_TZE284_qyflbnbj',
        },
    ],
    model: 'TS0601',
    vendor: '_TZE284_qyflbnbj',
    description: 'Temperature, Humidity and Battery Sensor (using datapoints)',
    fromZigbee: [legacy.fromZigbee.tuya_temperature_humidity_sensor],
    toZigbee: [],
    exposes: (device, options) => {
            const exps = [e.temperature(), e.humidity(), e.battery()];
            if (!device || device.manufacturerName === '_TZE200_qyflbnbj' || device.manufacturerName === '_TZE204_qyflbnbj') {
                exps.push(e.battery_low());
                exps.push(e.enum('battery_level', ea.STATE, ['low', 'middle', 'high']).withDescription('Battery level state'));
            }
            return exps;
    },
};

使用说明

用户在使用该设备时需要注意：

1. 设备需要运行Zigbee2MQTT的dev分支或等待下月正式版发布
2. 设备会自动上报温湿度数据
3. 电池电量信息也会定期上报
4. 设备支持低电量警告功能

技术背景

Tuya设备通常使用专有的数据点(DP)来传输数据，Zigbee2MQTT项目通过特定的转换器将这些专有数据点转换为标准的MQTT消息格式，使设备能够无缝集成到智能家居系统中。

这种转换器实现方式已经成为支持Tuya设备的通用模式，开发者可以基于已有实现快速适配新的Tuya设备。