Zigbee 单火调光开关接入标准

更新时间:2024-06-24 03:30:08下载pdf

Zigbee 单火调光开关是一个受控设备,采用可控硅实现开关与调光动作并能接受开关、调光指令作用于调光灯。

您现在正在阅览的,是一篇不完全公开的文档,这表示该文档内容的适用性有一定的限制,文档或目录所描述的内容适用于旧版本 SDK、API、工具、平台等。
如果您需要更准确的技术文档,请访问 涂鸦开发者平台,然后自行搜索。

用 Zigbee 3.0 标准里的 Dimmer Light 设备来实现。

名词解释

名词 解释
Zigbee SDK 基于芯科 Zigbee 协议栈经过裁剪、优化后封装的涂鸦 Zigbee SDK。
Attribute Attribute (属性)是一个反映物理数量或状态的数据值
Cluster Cluster (群集)是包含一个或多个属性(Attribute)的群集
EndPoint EndPoint (端点)是协议栈应用层的入口,即入口地址,也可以理解应用对象存在的地方,它是为实现一个设备描述而定义的一组群集
Device Id Zigbee 中为每一种设备定义的序号
TYZS13 模组    一款适合用于开发单火调光设备的 Zigbee 模组
弱电设备 是指使用电池供电的设备,在 Zigbee 协议中被称为 Sleep End Device 的设备
强电设备 接入市电设备,在 Zigbee 协议中被称为 End Device 的设备
PID Product ID,在涂鸦开发者平台创建的每一个产品都会产生一个唯一的产品编号,关联了产品具体的功能点、APP 控制面板、出货信息等所有跟这个产品相关的信息。
SOC System On Chip,硬件本身无 MCU,控制程序写入联网模块中。
SDK Software Development Kit,软件开发工具包,辅助开发某一类软件的相关文档、范例和工具的集合。为了鼓励开发者使用其系统或者语言,许多 SDK 是免费提供的,涂鸦的也是。
固件 Firmware,就是写入 EROM(可擦写只读存储器)或 EEPROM (电可擦可编程只读存储器)中的程序。固件是指设备内部保存的设备“驱动程序”,通过固件,操作系统才能按照标准的设备驱动实现特定机器的运行动作,比如光驱、刻录机等都有内部固件。固件是担任着一个系统最基础最底层工作的软件。
OTA 是固件升级的意思,我们是支持 OTA 的。固件升级分为无线的和有线的,FOTA 是无线固件升级。

Zigbee 设备功能描述

Zigbee 3.0 协议版本

name ID
Profile Id 0x0104
Device Id 0x0101

Endpoint

enpoint 描述
1 第一路调光开关

支持的 Clusters

Dimmer Light(0x0101)
Input Clusters(Server) Output Clusters(Client)
Basic(0x0000) OTA(0x0019)
Identify(0x0003)
Group Cluster(0x0004)
Scene Cluster(0x0005)
On Off Cluster(0x0006)
level control cluster(0x0008)
Level Control Max Min(0xFC00)
Level Control Bulb Type(0xFC02)
Level Control Scr State(0xFC03)
Level Control Current Percent(0xFC04)
Level Control Min Percent(0xFC05)

支持的属性和命令

Basic Cluster

Attribute:

ID Name    Data Type    Range Defualt value
0x0000 ZCLVersion uint8 -0x20 0x00 - 0xff    0x01
0x0001 ApplicationVersion    uint8 -0x20 0x00 - 0xff    ie: 0b 01 00 0001 = 1.0.1即0x41为1.0.1
0x0002 StackVersion uint8 -0x20 0x00 - 0xff 2
0x0003 HardwareVersion uint8 -0x20 0x00 - 0xff 0x01
0x0004 ManufacturerName string -0x42 0 - 32 bytes XXX…XXX(长度为16个字节,由8字节前缀和8字节的PID组成) 0-7 bytes:TZ3000 8-16 bytes:PID(由产品经理在平台创建和提供) 1路调光开关 PID: 9v86hx9o
0x0005 ModleIdentifier string -0x42 0 - 32 bytes TS1101 该字段为了网关快速识别设备类型用,提升体验
0x0007 PowerSource enum8-0x30 0x00 - 0xff 0x01
0xFFFD clusterrevision uint16 -0x21 0x0000 - 0xffff 0x0001

Commands:

ID name Direction Description
0x00 Reset to factory default C->S
Identify Cluster

Attribute:

ID Name Data Type Range Defualt value
0x0000 IdentifyTime uint16 -0x21 0x0000 - 0xffff 0x0000
0xFFFD clusterrevision int16 -0x29 0x0000 - 0xffff 0x0001

Commands:

ID name Direction Description
0x00 Identify C->S
0x01 Identify Query C->S
On/Off Cluster

Attribute:

ID name Data Type Range Defualt value
0x0000 OnOff bool-0x10 0x00 - 0x01 0x00

Commands:

ID name Direction Description
0x00 Off C->S
0x01 On C->S
0x02 Toggle C->S
Level Control Cluster

Attribute:

ID Name Data Type Range Defualt value
0x0000 Currentlevel uint8 -0x20 0x01 - 0xfe 0xff

Commands:

ID name Direction Description
0x00 Move to Level C->S
0x02 Step C->S
0x04 Move to Level(with On/Off) C->S
Private Cluster

Attribute:

ID Name Data Type Range Defualt value
0xFC00 Level Control Max Min uint16 -0x21 0x0000 - 0xffff 0x01ff
0xFC02 Level Control Bulb Type uint8 -0x20 0x00 - 0xff 0x00
0xFC03 Level Control Scr State uint8 -0x20 0x00 - 0xff 0x01
0xFC04 Level Control Current Percent uint8 -0x20 0x00 - 0xff 0x01
0xFC05 Level Control Min Percent uint8 -0x20 0x00 - 0xff 0x01
Over The Air Upgrade Cluster

Attribute:

ID name Data Type Range Defualt value
0x0000 UpgradeServer ID EUI64-0xF0 0xffffffffffffffff
0x0001 FileOffset uint32-0x23 0x00000000
0x0002 CurrentFileVersion uint32-0x23 0x21050002
0x0006 ImageUpgradeStatus enum8-0x30 0x00
0x0007 ManufacturerID uint16 -0x21 0x1002
0x0008 ImageTypeID uint16 -0x21 0x1602
0x0009 MinBlockRequestPeriod uint16 -0x21 0x0000
0xfffd Clusterrevision uint16 -0x21 0x0001

Zigbee 设备流程机制

组网流程的要求

​ (1) Beacon Request 信道扫描间隔大于 150 ms,优先扫描优先信道。

​ (2) 扫描时间不超过 30s 。

​ (3) 如果需要上报数据,组网成功后采用 5s 到 10s 或者以上的随机延上报数据

设备断电启动流程

​ 由于设备支持断电记忆功能,断电上电时需要读取断电之前的开关状态、可控硅状态(双控使用)、亮度值。

链路维护的要求

​ 每隔 150s-180s 直接随机值上报设备版本号。

数据上报的要求

​ (1) 如果开启了 APS 层的重传建议把 Disable Default Response 设置成 1,避免太多 ack 。

​ (2) 重传数据的 Transaction Sequence Number 需要保持一致。

​ (3) 重传间隔大于 250ms,重传持续时间建议低于 3s 。

​ (4) 收到广播、组播、情景控制时,建议需要延迟 1 分钟- 2 分钟的随机值上报状态,延迟时间没有到达期间收到单播控 制,立即上报状态

特殊功能说明

​(1) 单火调光开关采用可控硅实现调光与开关动作并兼容双控功能。用上述私用属性对相关信息进行存储与交互,0xFC00 用于存储当前最大最小亮度值;0xFC02 用于区分灯泡类型;0xFC03 用于存储可控硅的状态;0xFC04 用于存储当前调光百分比;0xFC05 用于存储最小亮度百分比。

​(2) 最小亮度值用于适配不同品类不同瓦数的 LED 灯,可控硅状态用于双控功能。

开发方式

  1. 基于涂鸦 Zigbee SDK 开发:

    (1)你只需修改 demo 样例的模块型号和硬件配置即可完成上述功能,包括群组,场景均实现

    (2)涂鸦提供完整的烧录,授权,产测流程和软硬件工具

涂鸦 Zigbee SDK 使用说明

烧录授权、产测工具使用说明

  1. 自行开发-非涂鸦 Zigbee 模块:

    (1) 需要完整实现上述技术细节

    (2)完成设备授权

  2. 使用涂鸦完整授权工具授权

通过模块和上位机串口通信授权

串口通信协议文档

串口通信实例代码

使用涂鸦授权 SDK 授权

  1. 自行开发-涂鸦 Zigbee 模块:

    (1)只需要实现固件功能细节

    (2)购买授权过的涂鸦 Zigbee 模块即可