Tuya-Local项目：QLima D812智能除湿机设备接入指南

设备概述

QLima D812 Smart是一款支持Tuya协议的智能除湿设备，通过Tuya-Local项目可以实现本地化控制，摆脱云服务依赖。该设备具备湿度调节、定时功能、故障检测等核心功能。

技术参数

设备功能点(DPS)映射

设备采用标准Tuya协议，主要功能点如下：

1. 电源开关 (DP ID 1)

   • 类型：布尔值
   • 功能：控制设备开关状态

2. 湿度设置 (DP ID 3)

   • 类型：枚举值
   • 有效值范围：30%、40%、50%、60%
   • 注意：官方API文档仅显示30%、40%、50%，但实际设备支持60%

3. 定时器设置 (DP ID 17)

   • 类型：枚举值
   • 选项：取消(cancel)、2小时(2h)、4小时(4h)、6小时(6h)
   • 注意：官方API文档仅显示cancel和2h，但实际设备支持更多选项

4. 剩余时间 (DP ID 18)

   • 类型：整型
   • 单位：分钟
   • 范围：0-360分钟

5. 故障代码 (DP ID 19)

   • 类型：位图
   • 故障标识：E1、E2等

配置文件详解

设备配置文件采用YAML格式，主要包含以下部分：

主实体配置

primary_entity:
  entity: humidifier
  class: dehumidifier
  dps:
    - id: 1
      type: boolean
      name: switch
    - id: 3
      type: integer
      name: humidity
      range:
        min: 40
        max: 60
      mapping:
        - step: 10
    - id: 19
      type: bitfield
      name: fault_code

辅助实体配置

1. 风扇控制

   - entity: fan
     dps:
       - id: 1
         type: boolean
         name: switch
   

2. 故障传感器

   - entity: binary_sensor
     class: problem
     category: diagnostic
     dps:
       - id: 19
         type: bitfield
         name: sensor
         mapping:
           - dps_val: 0
             value: false
           - value: true
   

3. 定时器选择

   - entity: select
     translation_key: timer
     category: config
     dps:
       - id: 17
         type: string
         name: option
         mapping:
           - dps_val: cancel 
             value: cancel
           - dps_val: "2h"
             value: "2h"
           - dps_val: "4h"
             value: "4h"
           - dps_val: "6h"
             value: "6h"
   

4. 剩余时间传感器

   - entity: sensor
     translation_key: time_remaining
     class: duration
     category: diagnostic
     dps:
       - id: 18
         type: integer
         name: sensor
         unit: min
   

故障处理与自动化

设备支持多种故障代码，可以通过自动化实现故障提醒：

1. 自动除霜功能激活 (代码8)
2. 水箱满警告 (代码16)
3. 360小时维护提醒 (代码32)
4. 2160小时HEPA滤网更换提醒 (代码64)

建议创建模板传感器监控故障状态，并设置相应的自动化通知。

实际使用建议

1. 设备在Tuya-Local中的识别依赖于正确的产品ID(如pxlnsbmh6jdqh35n)和设备ID
2. 湿度设置范围实际比官方API文档更广，可以放心使用40%-60%的范围
3. 定时功能支持2h/4h/6h，尽管官方文档仅显示2h选项
4. 故障代码采用位图形式，需要特殊处理才能正确解析

通过合理配置，QLima D812 Smart可以在Tuya-Local项目中实现完整的本地控制功能，包括精确湿度控制、定时设置和故障监控等高级特性。