作為智能家居的重要組成部分，Zigbee 照明設(shè)備憑借低功耗、高可靠、大規(guī)模組網(wǎng)等獨特能力，在提升生活便利性、節(jié)能效率及燈光系統(tǒng)穩(wěn)定性方面發(fā)揮了關(guān)鍵作用。它擁有遠程開關(guān)、調(diào)光調(diào)色、場景模式（如影院模式、離家模式）以及能耗監(jiān)測等功能，可廣泛應(yīng)用在家庭、工業(yè)、商用等復(fù)雜的場景部署中。但現(xiàn)階段，開發(fā) Zigbee 照明設(shè)備通常涉及許多難點，如：

Zigbee 標準協(xié)議復(fù)雜，開發(fā)符合標準規(guī)范的照明設(shè)備難度高、耗時長；

不同芯片平臺代碼接口差異大，代碼難復(fù)用，切換平臺成本高；

需要對顏色模型有較深理解，拉高了開發(fā)門檻。

一、涂鴉Zigbee照明產(chǎn)品開發(fā)包

因此，涂鴉推出TuyaOS Zigbee 照明產(chǎn)品開發(fā)包(以下簡稱開發(fā)包)，為不同芯片平臺提供了統(tǒng)一的接口，并助力開發(fā)者輕松實現(xiàn) Zigbee 照明設(shè)備的所有標準協(xié)議和部分涂鴉廠商協(xié)議，門檻超低，大大加速照明設(shè)備的落地量產(chǎn)速度。該開發(fā)包可用于球泡燈、筒射燈、吸頂燈等智能照明設(shè)備的開發(fā)，支持開發(fā) 1 ~ 5 路燈。設(shè)備接入 Zigbee 網(wǎng)關(guān)后，用戶就能通過手機 App 進行遠程管理，實現(xiàn)豐富多彩的燈光效果；也可以搭配場景面板、手持遙控器、旋鈕調(diào)光器等管控設(shè)備，實現(xiàn)各個功能的本地化應(yīng)用，帶來更方便快捷的用戶體驗。

戳下方視頻，體驗涂鴉賦能照明產(chǎn)品在不同管控設(shè)備下的燈光調(diào)節(jié)表現(xiàn)：

1、支持的設(shè)備類型

TuyaOS Zigbee 照明產(chǎn)品開發(fā)包支持 1 ~ 5 路輸出，對應(yīng) 1~ 5 路燈，用戶只需簡單配置即可編譯生成對應(yīng)的照明設(shè)備固件。

一路燈(C)：只有一種顏色燈珠（如冷白），可調(diào)節(jié)開關(guān)、亮度；

二路燈(CW)：有冷白和暖白兩種顏色燈珠，可調(diào)節(jié)開關(guān)、亮度、色溫；

三路燈(RGB)：有紅、綠、藍三種顏色燈珠，可調(diào)節(jié)開關(guān)、亮度、顏色；

四路燈(RGBC)：有紅、綠、藍、冷白四色燈珠，在三路燈彩光基礎(chǔ)上增加了冷白光的調(diào)節(jié)；

五路燈(RGBCW)：有紅、綠、藍、白、暖五色燈珠，相當于二路燈和三路燈的組合，可調(diào)節(jié)開關(guān)、亮度、色溫、顏色。

2、開發(fā)包功能框架圖

開發(fā)包提供的樣例功能框架圖如下所示，基于此開發(fā)包開發(fā)的照明產(chǎn)品完全符合 Zigbee 3.0 規(guī)范：支持 Zigbee 3.0 標準指令，用戶可直接接入支持 Zigbee 3.0 協(xié)議的網(wǎng)關(guān)。在照明產(chǎn)品的多樣化體驗上，該開發(fā)包原生支持涂鴉廠商的自定義指令，通過涂鴉賦能網(wǎng)關(guān)，用戶可體驗到更豐富的玩法和更細膩的調(diào)光(可精細到千分之一)。

（開發(fā)包功能框架圖）

3、支持多種配網(wǎng)方式

開發(fā)包支持多種 Zigbee 配網(wǎng)協(xié)議：

3.1 通用配網(wǎng)

即通過預(yù)置的公共密鑰加入網(wǎng)關(guān)，這種方式簡單易用、兼容性強，大多數(shù)品牌的 Zigbee 網(wǎng)關(guān)都支持這種入網(wǎng)方式。

3.2 掃碼配網(wǎng)

支持寫入和讀取配網(wǎng)密鑰(Installcode)。每臺設(shè)備都有唯一的配網(wǎng)密鑰，通過 App 掃描設(shè)備二維碼即可成功配網(wǎng)，適用于對安全性要求較高的產(chǎn)品。

3.3 本地配對（TouchLink ）

當燈具不需要遠程管理時，用戶可以將燈具和遙控器、場景開關(guān)、旋鈕調(diào)光器等進行本地配對使用。這種使用方式無需搭配網(wǎng)關(guān)即可成功配對，但僅限本地使用。

要注意：

通用配網(wǎng)和掃碼配網(wǎng)均需待照明設(shè)備進入配網(wǎng)狀態(tài)后，才能完成配網(wǎng)；

支持【上電即配網(wǎng)】、【連續(xù)通斷電】兩種方式，使設(shè)備快速進入配網(wǎng)狀態(tài)；

本地配對無需操作燈具，只需在要配對的設(shè)備上進行操作即可。

4、豐富的指令支持

該開發(fā)包同時支持 Zigbee 3.0 標準指令和涂鴉廠商自定義指令，兩者相結(jié)合能助力開發(fā)者打造更豐富多樣的照明玩法。其中，涂鴉廠商指令不僅支持多種工作模式和更高的調(diào)光分辨率，還可與涂鴉生態(tài)下其他品牌的智能設(shè)備進行互聯(lián)互通。

Zigbee 3.0 標準指令支持調(diào)節(jié)：開關(guān)、亮度、色相、飽和度、色溫等參數(shù)；

涂鴉廠商指令支持：情景模式、音樂律動、實時調(diào)光等模式，后續(xù)還會推出更多高級功能。

5、群組管理和標準場景

5.1 本地群組

用戶通過本地群組指令管理燈具可以達到很好的一致性：一條無線指令即可管控整個群組的設(shè)備狀態(tài)，同一個設(shè)備也可以加入到多個群組中，這樣能夠匹配更復(fù)雜場景下的用戶照明需求。

5.2 標準場景

搭配場景面板使用，用戶可以編輯某個空間的燈光狀態(tài)，并將其保存為一個場景(如回家、離家、工作、休息、電影等)。場景與場景面板按鍵進行綁定后，用戶只要操作面板的相應(yīng)按鍵即可一鍵喚醒場景，同一個設(shè)備也可以添加多個場景。標準場景是設(shè)備之間直接進行控制的，不受網(wǎng)關(guān)斷電/斷網(wǎng)影響。

6、步進調(diào)光+無極調(diào)光

開發(fā)包除了支持目標值調(diào)光外，還支持步進調(diào)光和無極調(diào)光，使用場景多數(shù)是在本地使用遙控器和旋鈕調(diào)光器來管理燈光。

目標值調(diào)光：指定目標亮度、色溫、顏色等，從當前狀態(tài)漸變/跳變到目標狀態(tài)；

步進值調(diào)光：基于燈具當前狀態(tài)，增加或減少一個步進值, 如亮度 +50、色溫 -25；

無極調(diào)光：指定一個參數(shù)和調(diào)節(jié)方向（如亮度增加），就能通過開始和停止命令來進行漸變式的絲滑調(diào)光。

7、顏色模型

涂鴉賦能照明設(shè)備支持的顏色模型有：色溫模型、HSV 顏色模型、XY 顏色模型，這些顏色模型通過計算可轉(zhuǎn)換成 RGBCW 各燈珠的輸出值，多個不同顏色燈珠能混合出更復(fù)雜的目標顏色和亮度。由于不同燈珠的實際物理特性不同，涂鴉開發(fā)包支持通過伽馬校正和白平衡調(diào)節(jié)，并對最終計算結(jié)果進行修正，從而匹配不同燈珠特性。

（三種顏色模型的調(diào)色模式展示）

色溫模型：主要應(yīng)用于白光模式, 通過控制冷白和暖色燈珠的亮度來調(diào)節(jié)色溫值；

HSV 顏色模型：能夠按色相(Hue)、飽和度(Saturation)、亮度(Value)進行顏色控制；

XY 顏色模型：符合 CIE xyY 色域模型，以 XY 坐標呈現(xiàn)最終顏色效果。

二、如何獲取涂鴉照明開發(fā)包？

1、安裝 Tuya Wind IDE 插件，并了解 TuyaOS 開發(fā)流程：

啟動 Tuya Wind IDE，進入“資源中心”， 獲取 Zigbee 子設(shè)備開發(fā)框架。下圖演示了安裝 TLSR8258 芯片平臺后，獲取 Zigbee 子設(shè)備開發(fā)框架的操作：

2、開發(fā)框架安裝完成后，進入“開發(fā)框架”，選擇“產(chǎn)品開發(fā)包”，可以看到該開發(fā)框架所支持的產(chǎn)品開發(fā)包，如下圖所示，選擇照明燈具產(chǎn)品開發(fā)包，點擊下載。

如果沒有權(quán)限，可以點擊申請權(quán)限并填寫涂鴉商務(wù)郵箱(zouxk@tuya.com)，發(fā)起申請。審批通過后，點擊下載按鈕進行下載。

3、完成產(chǎn)品開發(fā)包的下載后，默認位置在 software / TuyaOS / apps 目錄里，如下圖所示。鼠標右鍵點擊文件夾 light_demo_tl8258 , 在彈出框中選擇 build project ，即可構(gòu)建項目。

編譯產(chǎn)物在路徑：

software\TuyaOS\apps\light_demo_tl8258\output 文件夾下，其中 QIO 是生產(chǎn)固件，UG 是用于 OTA 的固件。