deCONZ项目下Shelly 1 Mini Gen4智能开关的Zigbee集成分析

设备概述

Shelly 1 Mini Gen4是一款基于ESP32平台的智能继电器设备，支持Zigbee协议。作为Shelly产品线中的新一代迷你设备，它主要提供开关控制功能，可通过Zigbee网络进行远程操作。设备采用紧凑设计，适合嵌入式安装场景。

技术特性

该设备在Zigbee网络中表现为一个终端设备(End Device)，具有以下关键特性：

1. 基础功能：

   • 支持标准的Zigbee On/Off Cluster(0x0006)
   • 提供基本的开关状态控制功能
   • 设备类型标识为"Mini1"

2. 硬件特性：

   • 内置物理按键支持多种操作模式
   • 可配置为瞬时开关或保持开关
   • 支持单/双/三击及长按操作

3. 特殊功能：

   • 使用专有Cluster 0xFC01(RPC Cluster)和0xFC02(WiFi Setup Cluster)
   • 支持Matter和Zigbee双模切换

集成挑战

在deCONZ项目集成过程中，主要遇到以下技术难点：

1. 输入功能缺失：

   • 设备物理按键的输入状态无法通过Zigbee上报
   • 当前固件版本不支持将按键事件传输至协调器
   • 导致无法实现本地开关控制其他Zigbee设备的功能

2. 设备类型识别：

   • 设备在Phoscon界面被识别为"Light"而非"Switch"
   • 这与用户期望的设备类型不符

3. 高级功能限制：

   • 功率测量功能未在Zigbee模式下实现
   • 特殊Cluster功能尚未完全解析和利用

解决方案

针对上述问题，技术社区提出了以下解决方案：

1. DDF设备描述文件：

   • 创建自定义设备描述文件准确定义设备功能
   • 通过DDF明确设备为开关输出类型
   • 确保设备在REST API中正确呈现

2. 自动化替代方案：

   • 通过家庭自动化平台创建规则
   • 利用设备状态变化触发其他设备动作
   • 弥补原生输入功能缺失的问题

3. 厂商协作：

   • 与Shelly技术团队沟通功能需求
   • 推动未来固件更新增加输入状态上报

实际应用建议

对于终端用户，建议采取以下应用策略：

1. 基础开关场景：

   • 适合需要远程控制继电器的场景
   • 可通过Phoscon的"Lights"界面操作

2. 自动化扩展：

   • 结合Home Assistant等平台创建复杂规则
   • 实现设备联动和场景控制

3. 功能取舍：

   • 暂无法实现纯Zigbee环境下的本地控制
   • 需依赖上层自动化平台实现完整功能

未来展望

随着设备固件更新和技术发展，预期将实现：

1. 完整的输入状态上报功能
2. 功率测量等高级特性的Zigbee支持
3. 更完善的专有Cluster功能实现

目前该设备已在deCONZ v2.29.3-beta版本中获得官方支持，为后续功能扩展奠定了基础。