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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

3.1 通用配網(wǎng)

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

3.2 掃碼配網(wǎng)

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

3.3 本地配對(duì)（TouchLink ）

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

要注意：

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

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

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

4、豐富的指令支持

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

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

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

5、群組管理和標(biāo)準(zhǔn)場景

5.1 本地群組

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

5.2 標(biāo)準(zhǔn)場景

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

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

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

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

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

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

7、顏色模型

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

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

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

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

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

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

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

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

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

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

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

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

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