Tuya-Local项目：Holman RGB Garden Light智能灯具接入指南

设备概述

Holman RGB Garden Light是一款支持多彩光效的智能户外灯具，通过Tuya云平台实现远程控制。该设备支持多种工作模式，包括白光模式、彩光模式、情景模式和音乐模式，能够满足不同场景下的照明需求。

技术规格

该设备的主要技术参数如下：

• 产品ID：34iad2he4ads3aeg
• 产品名称：RGB Garden Light
• 设备类别：dj（智能照明设备）
• 通信协议：Tuya 3.5协议版本

功能特性

1. 基础控制功能

• 开关控制（switch_led）：布尔型参数，控制灯具的开关状态
• 工作模式（work_mode）：支持四种模式切换
  • white：白光模式
  • colour：彩光模式
  • scene：情景模式
  • music：音乐模式

2. 彩光模式控制

• 色相（h）：0-360度可调
• 饱和度（s）：0-1000可调
• 亮度（v）：0-1000可调 通过colour_data_v2参数以JSON格式传递控制指令

3. 情景模式控制

支持最多8种情景预设，每种情景包含：

• 变化模式（static/jump/gradient）
• 切换持续时间（0-100）
• 渐变持续时间（0-100）
• 亮度、色温、HSV值等参数

4. 其他功能

• 倒计时功能（countdown_1）：最长86400秒
• 调节控制（control_data）：支持直接和渐变两种变化模式
• 生物节律（rhythm_mode）：自定义光照变化规律
• 断电记忆（power_memory）：断电后恢复上次状态
• 勿扰模式（do_not_disturb）：禁用某些干扰功能

接入Tuya-Local的注意事项

1. 协议版本选择：该设备需要使用Tuya 3.5协议版本进行连接，使用其他版本可能导致连接失败。

2. 参数配置：在配置文件中需要正确设置各功能对应的DP ID，特别是：

   • 开关：DP 20
   • 工作模式：DP 21
   • 彩光数据：DP 24
   • 情景数据：DP 25

3. 常见问题处理：

   • 如果出现"Failed to refresh device state"错误，首先检查设备是否在线
   • 确认本地网络环境是否允许设备与Home Assistant主机通信
   • 检查协议版本设置是否正确

4. 高级功能配置：

   • 情景模式配置较为复杂，建议先通过官方App设置好情景，再通过Tuya-Local调用
   • 生物节律功能需要特定的数据格式，可以参考Tuya官方文档进行配置

使用建议

对于家庭用户，建议主要使用彩光模式和白光模式，这两种模式配置简单且实用性强。情景模式适合有固定照明需求的场景，如花园派对、节日装饰等。音乐模式则需要配合音频输入设备使用，实现灯光随音乐变化的效果。

通过Tuya-Local接入后，用户可以在Home Assistant中创建自动化场景，如根据日落时间自动开启花园灯光，或与其他智能设备联动，打造完整的智能家居体验。