涂鸦打造Zigbee照明开发新标杆！全彩混光+超丰富本地场景联动，带你玩转照明产品

作为智能家居的重要组成部分，Zigbee 照明设备凭借低功耗、高可靠、大规模组网等独特能力，在提升生活便利性、节能效率及灯光系统稳定性方面发挥了关键作用。它拥有远程开关、调光调色、场景模式（如影院模式、离家模式）以及能耗监测等功能，可广泛应用在家庭、工业、商用等复杂的场景部署中。但现阶段，开发 Zigbee 照明设备通常涉及许多难点，如：

Zigbee 标准协议复杂，开发符合标准规范的照明设备难度高、耗时长；

不同芯片平台代码接口差异大，代码难复用，切换平台成本高；

需要对颜色模型有较深理解，拉高了开发门槛。

一、涂鸦Zigbee照明产品开发包

因此，涂鸦推出TuyaOS Zigbee 照明产品开发包(以下简称开发包)，为不同芯片平台提供了统一的接口，并助力开发者轻松实现 Zigbee 照明设备的所有标准协议和部分涂鸦厂商协议，门槛超低，大大加速照明设备的落地量产速度。该开发包可用于球泡灯、筒射灯、吸顶灯等智能照明设备的开发，支持开发 1 ~ 5 路灯。设备接入 Zigbee 网关后，用户就能通过手机 App 进行远程管理，实现丰富多彩的灯光效果；也可以搭配场景面板、手持遥控器、旋钮调光器等管控设备，实现各个功能的本地化应用，带来更方便快捷的用户体验。

戳下方视频，体验涂鸦赋能照明产品在不同管控设备下的灯光调节表现：

1、支持的设备类型

TuyaOS Zigbee 照明产品开发包支持 1 ~ 5 路输出，对应 1~ 5 路灯，用户只需简单配置即可编译生成对应的照明设备固件。

一路灯(C)：只有一种颜色灯珠（如冷白），可调节开关、亮度；

二路灯(CW)：有冷白和暖白两种颜色灯珠，可调节开关、亮度、色温；

三路灯(RGB)：有红、绿、蓝三种颜色灯珠，可调节开关、亮度、颜色；

四路灯(RGBC)：有红、绿、蓝、冷白四色灯珠，在三路灯彩光基础上增加了冷白光的调节；

五路灯(RGBCW)：有红、绿、蓝、白、暖五色灯珠，相当于二路灯和三路灯的组合，可调节开关、亮度、色温、颜色。

2、开发包功能框架图

开发包提供的样例功能框架图如下所示，基于此开发包开发的照明产品完全符合 Zigbee 3.0 规范：支持 Zigbee 3.0 标准指令，用户可直接接入支持 Zigbee 3.0 协议的网关。在照明产品的多样化体验上，该开发包原生支持涂鸦厂商的自定义指令，通过涂鸦赋能网关，用户可体验到更丰富的玩法和更细腻的调光(可精细到千分之一)。

（开发包功能框架图）

3、支持多种配网方式

开发包支持多种 Zigbee 配网协议：

3.1 通用配网

即通过预置的公共密钥加入网关，这种方式简单易用、兼容性强，大多数品牌的 Zigbee 网关都支持这种入网方式。

3.2 扫码配网

支持写入和读取配网密钥(Installcode)。每台设备都有唯一的配网密钥，通过 App 扫描设备二维码即可成功配网，适用于对安全性要求较高的产品。

3.3 本地配对（TouchLink ）

当灯具不需要远程管理时，用户可以将灯具和遥控器、场景开关、旋钮调光器等进行本地配对使用。这种使用方式无需搭配网关即可成功配对，但仅限本地使用。

要注意：

通用配网和扫码配网均需待照明设备进入配网状态后，才能完成配网；

支持【上电即配网】、【连续通断电】两种方式，使设备快速进入配网状态；

本地配对无需操作灯具，只需在要配对的设备上进行操作即可。

4、丰富的指令支持

该开发包同时支持 Zigbee 3.0 标准指令和涂鸦厂商自定义指令，两者相结合能助力开发者打造更丰富多样的照明玩法。其中，涂鸦厂商指令不仅支持多种工作模式和更高的调光分辨率，还可与涂鸦生态下其他品牌的智能设备进行互联互通。

Zigbee 3.0 标准指令支持调节：开关、亮度、色相、饱和度、色温等参数；

涂鸦厂商指令支持：情景模式、音乐律动、实时调光等模式，后续还会推出更多高级功能。

5、群组管理和标准场景

5.1 本地群组

用户通过本地群组指令管理灯具可以达到很好的一致性：一条无线指令即可管控整个群组的设备状态，同一个设备也可以加入到多个群组中，这样能够匹配更复杂场景下的用户照明需求。

5.2 标准场景

搭配场景面板使用，用户可以编辑某个空间的灯光状态，并将其保存为一个场景(如回家、离家、工作、休息、电影等)。场景与场景面板按键进行绑定后，用户只要操作面板的相应按键即可一键唤醒场景，同一个设备也可以添加多个场景。标准场景是设备之间直接进行控制的，不受网关断电/断网影响。

6、步进调光+无极调光

开发包除了支持目标值调光外，还支持步进调光和无极调光，使用场景多数是在本地使用遥控器和旋钮调光器来管理灯光。

目标值调光：指定目标亮度、色温、颜色等，从当前状态渐变/跳变到目标状态；

步进值调光：基于灯具当前状态，增加或减少一个步进值, 如亮度 +50、色温 -25；

无极调光：指定一个参数和调节方向（如亮度增加），就能通过开始和停止命令来进行渐变式的丝滑调光。

7、颜色模型

涂鸦赋能照明设备支持的颜色模型有：色温模型、HSV 颜色模型、XY 颜色模型，这些颜色模型通过计算可转换成 RGBCW 各灯珠的输出值，多个不同颜色灯珠能混合出更复杂的目标颜色和亮度。由于不同灯珠的实际物理特性不同，涂鸦开发包支持通过伽马校正和白平衡调节，并对最终计算结果进行修正，从而匹配不同灯珠特性。

（三种颜色模型的调色模式展示）

色温模型：主要应用于白光模式, 通过控制冷白和暖色灯珠的亮度来调节色温值；

HSV 颜色模型：能够按色相(Hue)、饱和度(Saturation)、亮度(Value)进行颜色控制；

XY 颜色模型：符合 CIE xyY 色域模型，以 XY 坐标呈现最终颜色效果。

二、如何获取涂鸦照明开发包？

1、安装 Tuya Wind IDE 插件，并了解 TuyaOS 开发流程：

启动 Tuya Wind IDE，进入“资源中心”， 获取 Zigbee 子设备开发框架。下图演示了安装 TLSR8258 芯片平台后，获取 Zigbee 子设备开发框架的操作：

2、开发框架安装完成后，进入“开发框架”，选择“产品开发包”，可以看到该开发框架所支持的产品开发包，如下图所示，选择照明灯具产品开发包，点击下载。

如果没有权限，可以点击申请权限并填写涂鸦商务邮箱(zouxk@tuya.com)，发起申请。审批通过后，点击下载按钮进行下载。

3、完成产品开发包的下载后，默认位置在 software / TuyaOS / apps 目录里，如下图所示。鼠标右键点击文件夹 light_demo_tl8258 , 在弹出框中选择 build project ，即可构建项目。

编译产物在路径：

software\TuyaOS\apps\light_demo_tl8258\output 文件夹下，其中 QIO 是生产固件，UG 是用于 OTA 的固件。