作為智能家居的重要組成部分，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 的固件。