Zigbee 子设备开发框架

更新时间:2026-01-14 07:02:58LLM 副本以 Markdown 格式查看下载 PDF

Zigbee 子设备开发框架是 TuyaOS 系统的一个子集,致力于为您提供简单易用、接口统一的 Zigbee 子设备开发环境。标准的 API 让应用层代码在不同芯片平台之间可以做到无缝移植,从而加速产品落地。

功能概述

Zigbee 子设备开发框架提供了 网络管理硬件接口上下行数据通信本地群组(Group)标准场景(Scene)产测授权OTA 等功能模块的标准 API 接口,让您无需花费大量时间熟悉不同芯片平台的 SDK,只需要关注上层应用开发。

您可基于本开发框架开发 Zigbee 3.0 标准设备,设备可通过涂鸦网关接入 涂鸦开发者平台,获得丰富的功能体验,也可接入第三方 Zigbee3.0 标准网关。

适用平台

Zigbee 子设备开发框架适用于以下芯片平台和设备类型:

芯片平台 路由设备 低功耗设备 适用模组
EFR32MG21x ZS 系列模组(ZS24-U 除外)
EFR32MG24x × ZS24-U TS24 系列模组
TLSR8258 ZT 系列模组

特色能力

  • 差分 OTA 升级:是指提取新固件与老固件(当前运行的固件)的差异,生成差分升级 OTA 包。相对全量 OTA 可以明显减少 OTA 包的体积,缩减无线传输 OTA 包所需的时间,可较大加快 OTA 升级速度。

    另外,差分 OTA 需要留给 OTA 包下载存储的 Flash 空间更小,可以给固件的应用代码区(Firmware)留出更多的空间。

  • 群组 OTA 升级:通过 Zigbee 本地群组进行批量设备的固件升级,当一个网络中有较多相同设备需要进行 OTA 时,此方法可以节约大量时间。

  • 网络自恢复:本地操作(如长按某个按键)使设备进入配网状态后,若配网超时或配网过程中断电重启,可以自动恢复到原 Zigbee 网络。已经配置的群组和场景不丢失。该功能目的是为了防止本地误操作导致的设备离网。

支持与帮助

在开发过程遇到问题,您可以登录 TuyaOS 开发者论坛 TuyaOS-Zigbee 设备开发 进行咨询。