簡介

本開發(fā)人員教程旨在說明在 Silicon Labs EmberZNet SoC 平臺上“從零開始”進(jìn)行基本應(yīng)用程序開發(fā)，這意味著在使用 ZCL 應(yīng)用程序框架 (AF) 及其各種插件時，不會使用“示例應(yīng)用程序”場景中預(yù)先編寫的回調(diào)代碼。?內(nèi)容涉及 AF 提供的基本結(jié)構(gòu)以及添加插件和回調(diào)以不斷增加功能，讓開發(fā)人員能夠?qū)θ绾窝驖u進(jìn)地構(gòu)建應(yīng)用程序有一個基本的了解。

概要

本教程包含多個部分，引導(dǎo)用戶通過一組預(yù)先編寫的說明（基于 EmberZNet 5.10.1），來創(chuàng)建 Zigbee 3.0 開/關(guān)開關(guān)和開/關(guān)燈——它們可以通過命令行界面 (CLI) 彼此通話。然后使用應(yīng)用程序框架 API 指南和 EmberZNet API 指南作為參考編寫自定義 C 代碼，擴(kuò)展生成的應(yīng)用程序，以實(shí)現(xiàn)在 Switch（開關(guān)）節(jié)點(diǎn)上按下按鈕即可遠(yuǎn)程切換 Light （燈）節(jié)點(diǎn)上的 LED。
?

要求

• 知識：
  • 級別：初級到中級學(xué)習(xí)者。
  • 概念：Zigbee/ZCL 基礎(chǔ)知識，C 編程。
• 預(yù)備知識：
  • 設(shè)置 EFR32 開發(fā)套件硬件
  • 安裝適用于 EFR32 開發(fā)套件的 Simplicity Studio
  • 創(chuàng)建一個 EmberZNet 網(wǎng)絡(luò)示例
• 硬件：EFR32MG12 2.4 GHz 網(wǎng)狀網(wǎng)絡(luò)套件 (P/N: SLWSTK6000B)
• 軟件：
  • Simplicity Studio v4（已安裝無線產(chǎn)品支持和最新更新包）
  • EmberZNet 5.10.0 (Gecko SDK Suite v1.1) 或更高版本
  • 推薦使用 IAR 嵌入式工作臺 7.80.2，但如果協(xié)議棧支持，也可以使用 GCC（EmberZNet 6.0.0 和更高版本）

資源

• Z3.0_DIY_Light_and_Switch_setup_instructionsPDF（見下面附件部分）
• UG102: 應(yīng)用程序框架開發(fā)人員指南
• 適用于應(yīng)用程序框架 V2 的 Ember 應(yīng)用程序框架 API（和命令行）參考（HTML 格式，見 SDK 文件夾，例如：{STUDIO_V4_INSTALL_DIR}/ developer/sdks/gecko_sdk_suite/ {SDK_SUITE_VERSION_NUMBER}/protocol/zigbee_X.Y/documentation/120-3023-000_AF_V2_API/index.html)

?

第 1 部分：準(zhǔn)備設(shè)置

1. 啟動 Simplicity Studio v4。
2. 確保在 Devices（設(shè)備）窗格中基于 EFR32MG12 的設(shè)備至少存在兩個節(jié)點(diǎn)（通過 USB 或以太網(wǎng)）。

3. 轉(zhuǎn)至 Window（窗口）> Preference（首選項）> Simplicity Studio> SDK，并確保希望于此練習(xí)的 EmberZNet 協(xié)議棧版本顯示在列表中，并且已啟用（復(fù)選框已啟用）以供使用。?確認(rèn)/啟用后，單擊 “OK”（確定）。

a. 如果所需版本尚未安裝，請轉(zhuǎn)至 Help（幫助）? Update Software（更新軟件），并通過 SDK 選項卡來安裝。

轉(zhuǎn)至 File（文件）> Preferences（首選項）> Simplicity Studio > Toolchains（工具鏈），并確保 IAR ARM 已列出并啟用，以及確保在對話框底部的 Description（描述）區(qū)域中描述了正確的版本。?（如果 Toolchains（工具鏈）窗口上半部分的 Version（版本）列顯示“0.0.0”，也不用擔(dān)心。有時，Studio 無法確定整個工具鏈的程序包版本。）?請注意，EmberZNet 5.8 及更高版本所需的 IAR ARM 版本為 IAR-EWARM v7.80.2）。確認(rèn)后，單擊 “OK”（確定）。如果出現(xiàn)問題，請使用 “Add”（添加）按鈕將正確的 IAR ARM 裝置添加到 Studio 中。

第 2 部分：為 Switch（開關(guān)）創(chuàng)建新的 Simplicity Studio 項目和 AppBuilder 配置

1. 轉(zhuǎn)到 File（文件）> New（新建）> Project（項目）> Silicon Labs AppBuilder 項目，然后選擇“Next”（下一步）。
2. 選擇“ZCL Application Framework V2”（ZCL 應(yīng)用程序框架 V2），然后單擊“Next”（下一步）。
3. 選擇所需的 EmberZNet SoC（非主機(jī)）版本，然后單擊“Next”（下一步）。
4. 選擇“Start with a blank application”（從空白應(yīng)用程序開始），然后單擊“下一步”。
5. 在“Project name”（項目名稱）字段中，輸入“開/關(guān)開關(guān)”項目的名稱，例如“MySwitch”，然后單擊“Next”（下一步）。
6. 在“Boards”（板）列表中，確保 EFR32MG12 收音機(jī)板只有唯一條目，如“BRD4161A”或“BRD4162A”。
   • ?如果列出了其他板類型，請單擊其列表項右上角的小“x”將其刪除。
   • 要向列表項添加新板，請在上面的 Search（搜索）框中輸入其名稱（如“EFR32MG12”）的一部分。
7. 確認(rèn) IAR ARM v7.80.2 工具鏈已列于對話框底部的工具鏈列表中，然后單擊“Finish”（完成）。

觀看視頻：Silicon Labs Zigbee 3.0 DIY 燈/開關(guān)教程：第 2 部分：開關(guān)項目初始化

第 3 部分：配置和構(gòu)建開關(guān)

1. “ZCL clusters”（ZCL 群集）選項卡下，確保 “ZCL device type”（ZCL 設(shè)備類型）設(shè)置為 “HA On/Off Switch”（HA 開/關(guān)開關(guān)）。為什么？- 這是展示 ZCL 開/關(guān)群集客戶端的最基本 Zigbee 設(shè)備類型。
2. 在 “Znet stack”（Znet 協(xié)議棧）選項卡下：

a. 在 “Network configuration”（網(wǎng)絡(luò)配置）中，將 Security Type（安全類型）更改為“ZigBee 3.0 安全”。

為什么？- 舊的家庭自動化安全方法現(xiàn)在已棄用，Zigbee 3.0 的新設(shè)備認(rèn)證需要 Zigbee 3.0-樣式安全，這是舊的 Zigbee 家庭自動化安全模型的超集。有關(guān) ZHA 和 Z3.0 設(shè)備之間互操作性的更多詳細(xì)信息，請參閱此 KBA：

http://community.silabs.com/t5/Mesh-Knowledge-Base/Zigbee-3-0-Device-Interoperability-with-Legacy-ZigBee-Devices/ta-p/201682

b. 在 “ZDO settings”（ZDO 設(shè)置）中，啟用 “Enable serial commands for sending ZDO messages”（啟用串行命令發(fā)送 ZDO 消息）復(fù)選框。為什么？- 這為設(shè)備發(fā)現(xiàn)提供了一些有用的 CLI 命令，我們可以使用這些命令從 Switch 搜索可用的 Light 設(shè)備，而無需編寫額外的代碼。

3.在 “Printing and CLI”（打印和 CLI）選項卡下：

a. 在 “Debug printing”（調(diào)試打印）部分，啟用 “Enable debug printing”（啟用調(diào)試打印）復(fù)選框。
b. 在同一部分的 “Cluster debugging”（群集調(diào)試）下，查看“開/關(guān)”兩列。

為什么？- 這將在 CLI 上提供額外的調(diào)試消息，以告訴我們有關(guān)“開/關(guān)”群集活動的信息。

4. 在 “HAL configuration”（HAL 配置）選項卡下，確保 “Bootloader”（引導(dǎo)加載程序）選擇列表值設(shè)置為 "Application”（應(yīng)用程序）。

為什么？- 雖然通常在開發(fā)過程中沒有引導(dǎo)加載程序更容易進(jìn)行原型設(shè)計，但所有設(shè)備最終都需要一個引導(dǎo)加載程序，因此，最好要養(yǎng)成一種確保有引導(dǎo)加載程序的習(xí)慣——具體來說，在開始開發(fā)應(yīng)用程序時，確保有適合產(chǎn)品用例和架構(gòu)的引導(dǎo)加載程序加載到目標(biāo)芯片上。?參閱 UG103.6：引導(dǎo)加載基礎(chǔ)知識 (https://www.silabs.com/documents/public/user-guides/UG103-06)，了解有關(guān)不同類型引導(dǎo)加載程序的更多信息。

5. 在 “Plugins”（插件）選項卡下，通過為以下插件啟用 “Use?”（使用？）復(fù)選框來添加功能：

a. 在 “EmberZNet Libraries”（EmberZNet 庫）下，啟用 “Install Code Library”（安裝代碼庫）。

為什么？- Zigbee 3.0 的要求規(guī)定，加入設(shè)備必須支持基于安裝代碼的加入，其中預(yù)編程的種子值用于導(dǎo)出加入網(wǎng)絡(luò)的唯一設(shè)備特定密鑰。參閱 AN1089：將安裝代碼與 Zigbee 設(shè)備配合使用 (https://www.silabs.com/documents/public/application-notes/an1089-using-installation-codes-with-zigbee-devices.pdf)，了解有關(guān)此功能的更多信息。

b. 在 “Network Form and Join”（網(wǎng)絡(luò)表單和加入）下，禁用 “Network Find”（網(wǎng)絡(luò)查找）。（將使用 “網(wǎng)絡(luò)轉(zhuǎn)向” 插件。）

為什么？- “網(wǎng)絡(luò)查找”插件使用舊版家庭自動化安全設(shè)置和可用網(wǎng)絡(luò)搜索的樣式，這與我們?yōu)榇伺渲眠x擇的“Zigbee 3.0 安全”設(shè)置不兼容，因此，如果“網(wǎng)絡(luò)查找”仍然啟用（早期的“家庭自動化安全”默認(rèn)設(shè)置），我們需要禁用它，以防止與 Zigbee 3.0-樣式插件發(fā)生沖突。

c. 在 “Utility”（實(shí)用程序）下，啟用 “General response commands”（一般響應(yīng)命令）。

為什么？- 這可讓基本的 ZCL 讀/寫屬性響應(yīng)消息被框架獲得、解析并打印到 CLI 以提供反饋，這在早期階段很有用，因?yàn)樵谠缙陔A段與應(yīng)用程序的交互仍主要由 CLI 驅(qū)動，而不是由代碼中的狀態(tài)機(jī)驅(qū)動。

d. 在 “ZigBee 3.0” 下，啟用“Find and Bind Initiator”（查找并綁定啟動器）、“Network Steering”（網(wǎng)絡(luò)轉(zhuǎn)向）和“Update TC Link Key”（更新 TC 鏈路密鑰）。

為什么？- 這些插件提供將 Zigbee 3.0 設(shè)備調(diào)試到網(wǎng)絡(luò)所需的狀態(tài)機(jī)器的生產(chǎn)就緒實(shí)現(xiàn)，包括 “Network Steering”（網(wǎng)絡(luò)轉(zhuǎn)向）過程和 “Finding and Binding”（查找和綁定）過程。有關(guān)詳細(xì)信息，請參閱 UG103.2 的 “ZigBee 3.0” 章節(jié)：Zigbee 基礎(chǔ)知識 (https://www.silabs.com/documents/public/user-guides/UG103-02-AppDevFundamentals-ZigBee.pdf) 和 ZigBee 基礎(chǔ)設(shè)備行為規(guī)范的 “調(diào)試” 章節(jié)（文件編號 13-0402，網(wǎng)址 www.zigbee.org）。

?

觀看視頻：Silicon Labs Zigbee 3.0 DIY 燈/開關(guān)教程：第 3.9 部分：開關(guān)構(gòu)建

6. 通過 File（文件）>? Save（保存）來保存設(shè)置。
7. 單擊右上角的 “Generate”（生成）按鈕。幾秒鐘后，出現(xiàn) “Generation successful!！”（生成成功），表示生成完成。

8. 在 Simplicity Studio 的 “Project Explorer”（項目資源管理器）窗格（AppBuilder 窗口左側(cè)）中，右鍵單擊項目的頂級文件夾（與項目名稱相同，如 “MySwitch”），然后從上下文菜單中選擇 “Build Project” (構(gòu)建項目)。

9. 要確認(rèn)構(gòu)建完成沒有錯誤，請在構(gòu)建控制臺中從末端向上滾動幾行，并查找 “Writing GBL file… DONE”（寫入 GBL 文件……完成）。

觀看視頻：Silicon Labs Zigbee 3.0 DIY 燈/開關(guān)教程：第 3.9 部分：開關(guān)構(gòu)建

第 4 部分：將開關(guān)應(yīng)用程序加載到 ZigBee 開發(fā)板

1. 在 Devices（設(shè)備）視圖中，右鍵單擊所需 Switch（開關(guān)）節(jié)點(diǎn)的調(diào)試適配器，然后選擇 Upload Application（上傳應(yīng)用程序）。
注意：在 Simplicity Studio 中，有很多方法可以將固件加載到目標(biāo)芯片上，但這是唯一一種允許您同時選擇應(yīng)用程序和引導(dǎo)加載程序固件的方法，因此您可以確保必要的引導(dǎo)加載程序已加載。

2. 啟用“Erase chip before uploading image”（上傳圖像前擦除芯片）復(fù)選框，以防止節(jié)點(diǎn)使用較早保存的網(wǎng)絡(luò)數(shù)據(jù)。
為什么？- EmberZNet 協(xié)議棧上線后，所有網(wǎng)絡(luò)參數(shù)都被提交至非易失性存儲器 (NVM)，并且 AF 會嘗試在后續(xù)的引導(dǎo)順序中重用此數(shù)據(jù)。但是，由于我們正在開始建立一個全新的網(wǎng)絡(luò)，所以您不希望系統(tǒng)先錯誤地恢復(fù)舊的網(wǎng)絡(luò)，然后才能設(shè)置這個網(wǎng)絡(luò)。

3. 單擊“Application image path”（應(yīng)用程序圖像路徑）旁的文件夾圖標(biāo)，然后瀏覽至為 Switch（開關(guān)）應(yīng)用程序新創(chuàng)建的 GBL 文件。

默認(rèn)路徑通常為：C:\SiliconLabs\SimplicityStudio\v4\developer\sdks\ gecko_sdk_suite\{versionNumber}\app\builder\{Project Name}\IAR ARM - Debug - {ChipVariant}\{ProjectName}.gbl

4. 如果 Gecko Bootloader（Gecko 引導(dǎo)加載程序）之前未加載至此設(shè)備（可能已通過快速入門指南完成）：

a. 啟用“Bootloader image”（引導(dǎo)加載程序圖像）復(fù)選框。
b. 單擊“Bootloader image”（引導(dǎo)加載程序圖像）旁的文件夾圖標(biāo)，瀏覽至“Gecko 引導(dǎo)加載程序”二進(jìn)制文件 S37。本練習(xí)旨在與“bootloader-storage-internal”或“bootloader-storage-spiflash”示例配合使用。用于開發(fā)套件測試的預(yù)構(gòu)建樣本引導(dǎo)加載程序二進(jìn)制文件可在每個芯片的文件夾中找到
C:\SiliconLabs\SimplicityStudio\v4\developer\sdks\gecko_sdk_suite\ {versionNumber}\platform\bootloader\sample-apps.

注意：最后，您將希望構(gòu)建自己的 Gecko 引導(dǎo)加載程序二進(jìn)制文件，其中包含您想要的安全功能和存儲設(shè)置，但預(yù)構(gòu)建的樣本在早期開發(fā)中更容易使用，因?yàn)樗鼈儾恍枰獢?shù)字簽名或加密圖像。有關(guān) Gecko 引導(dǎo)加載程序的詳細(xì)信息，請參閱 UG266：Gecko 引導(dǎo)加載程序用戶指南 (https://www.silabs.com/documents/public/user-guides/ug266-gecko-bootloader-user-guide.pdf)。

5. 單擊“OK”（確定），開始上傳過程。確保完成，沒有出現(xiàn)錯誤。（Device（設(shè)備）圖標(biāo)應(yīng)恢復(fù)為綠色。）

觀看視頻：Silicon Labs Zigbee 3.0 DIY 燈/開關(guān)教程：第 4 部分：加載 Switch App（開關(guān)應(yīng)用程序）

?

第 5 部分：將用于 Switch（開關(guān)）的 AppBuilder 配置克隆作為 Light（燈）的起始點(diǎn)

注意：您可以返回到在第 2 部分和第 3 部分中所執(zhí)行的步驟來創(chuàng)建新的 Light（燈）配置，但有時候，使用另一個項目作為起點(diǎn)來節(jié)省時間并避免遺漏某些內(nèi)容會很有用。

1. 在 Simplicity Studio 中，轉(zhuǎn)至 File（文件）> Save（保存），將您的 AppBuilder Switch 配置另存為 ISC 文件，例如 MySwitch.isc。
2. 轉(zhuǎn)至 File（文件）> New（新建）> Project（項目）> Silicon Labs MCU Project（Silicon Labs MCU 項目）（非 AppBuilder 項目），然后單擊 “Next”（下一步）。

a. 在生成的“Project Setup”（項目設(shè)置）對話框中，確保 SDK 選擇是“Gecko SDK Suite”(Gecko SDK 套件)，其版本與使用的 Switch（開關(guān)）版本相同，并且 Board/Part（板/部件）與 Light（燈）的目標(biāo)硬件匹配，然后單擊“Next”（下一步）。
b. 在下一個“Project Setup”（項目設(shè)置）對話框中，確保選中“Empty Program”（清空程序），然后單擊“Next”（下一步）。
c. 在“Project Configuration”（項目配置）對話框中，將項目名稱更改為 Light（燈）的名稱，例如“MyLight”。
d. 取消選中“Use default location”（使用默認(rèn)位置）復(fù)選框。
e. 單擊“Browse”（瀏覽）按鈕，并瀏覽至您當(dāng)前的 Gecko SDK 裝置（例如 C:\SiliconLabs\SimplicityStudio\v4\developer\sdks\gecko_sdk_suite\v1.1)，然后瀏覽至 app\builder 子目錄）。
f. 點(diǎn)擊“Make New Folder”（創(chuàng)建新文件夾）并更改文件夾的名稱，以匹配您的 Light 項目名稱，如“MyLight”。
g. 點(diǎn)擊“OK”（確定）退出瀏覽對話框，然后點(diǎn)擊“Next”（下一步）。（“Link to sources”（鏈接至來源）默認(rèn)選擇為“OK”（正常）。）h. 取消選擇對應(yīng)于“Build Configurations”（內(nèi)部版本配置）窗口中“GNU ARM”內(nèi)部版本配置的任何條目（因?yàn)槲覀冊诖司毩?xí)中僅使用 IAR ARM），然后點(diǎn)擊 “Finish”（完成）。

3. 滾動到原始 Switch 項目的“Project Explorer”（項目資源管理器）樹，找到其 ISC 文件，如“MySwitch.isc”。
4. 右鍵點(diǎn)擊此 ISC 文件，并選擇“Copy”（復(fù)制）。
5. 滾動到 Light 項目的頂級項目條目，右鍵點(diǎn)擊該條目，然后選擇“Paste”（粘貼）。
6. 右鍵點(diǎn)擊 Light 項目中新復(fù)制的 ISC 文件，然后選擇“Rename”（重命名）。
7. 為 Light 配置設(shè)置新名稱，如“MyLight.isc”，然后點(diǎn)擊“OK”（確定）。
8. 雙擊新重命名的 Light ISC 文件，以開始編輯其 AppBuilder 配置。

觀看視頻：Silicon Labs Zigbee 3.0 DIY 燈/開關(guān)教程：第 5 部分：克隆 Light 的 Switch 項目

第 6 部分：配置、構(gòu)建 Light 應(yīng)用程序并將其加載到第二個節(jié)點(diǎn)

1. 在 Simplicity IDE 的 AppBuilder 視圖中的“General”（常規(guī)）選項卡下，更改“Device name”（設(shè)備名稱）以使其與 Light 的項目名稱匹配，如“MyLight”。
2. 在“ZCL clusters”（ZCL 集群）選項卡下，將“ZCL device type”（ZCL 設(shè)備類型）更改為“HA On/Off Switch”（HA 開/關(guān)開關(guān)）。
3. 在“ZNet stack”（ZNet 堆棧）選項卡下，將“ZigBee Device Type”（ZigBee 設(shè)備類型）更改為“Coordinator or Router”（協(xié)調(diào)器或路由器）。
4. 在“Plugins”（插件）選項卡下，對所述部分中的插件進(jìn)行以下調(diào)整：

a. 常見集群：禁用“Scenes Server Cluster”插件。

為什么？- 某些版本的 AppBuilder 在為需使用適當(dāng)令牌 (NVM) 定義的插件（包括 Scenes Server Cluster 插件）生成這些定義時會出現(xiàn)問題，但僅當(dāng)在默認(rèn)將這些插件作為空白項目模板的一部分啟用的情況下才會如此。（這可表現(xiàn)為在構(gòu)建過程中缺失 scenes-token.h 文件。）本教程不使用 Scenes 集群，因此您不需要插件代碼即可處理命令，但是，如果您確實(shí)想要在新的空白項目中包括 Scenes 集群支持，則可通過禁用并隨后重新啟用插件來解決此問題。

b. ZigBee 3.0：啟用“Find and Bind Target”、“Network Creator”和“Network Creator Security”插件。

為什么？-“Network Creator”插件允許 Light 為其他節(jié)點(diǎn)（如 Switch 或其他 Light）組建自己的 Zigbee 3.0 網(wǎng)絡(luò)，從而支持傳入 Zigbee 3.0 和傳統(tǒng) HA 設(shè)備的所有安全模型。“Find and Bind Target”插件允許 Find and Bind Initiator 設(shè)備（如 Switch）根據(jù) Zigbee 3.0 調(diào)試發(fā)現(xiàn)并配對到 Light 的服務(wù)器端集群（在 ZigBee 基礎(chǔ)設(shè)備行為規(guī)范的“調(diào)試”章節(jié)（ZigBee 文檔 13- 0402）中討論）。

5. 點(diǎn)擊“Generate”（生成）按鈕；在生成過程完成后，確認(rèn)該過程已成功，然后點(diǎn)擊“OK”（確定）。
6. 使用“Ctrl+S”或“File”（文件）? “Save”（保存）來保存 Light 的 AppBuilder 配置，以備將來參考。
7. 在“Project Explorer”（項目資源管理器）中右鍵點(diǎn)擊 Light 的項目文件夾，然后選擇“Build Project”（構(gòu)建項目）。
8. 確保構(gòu)建完成而不發(fā)生錯誤。（如果發(fā)出警告，則表示正常。）
9. 使用不同于您的 Switch 的 EFR32 + 無線入門套件目標(biāo)設(shè)備重復(fù)第 IV 節(jié)中針對 Light 應(yīng)用的步驟。

觀看視頻：Silicon Labs Zigbee 3.0 DIY 燈/開關(guān)教程：第 6 部分：克隆 Light 的 Switch 項目

?

第 7 部分：啟動調(diào)試通信

1. 為 Light 和 Switch 成功執(zhí)行上傳后，右鍵點(diǎn)擊“Devices”（設(shè)備）窗格中的每個節(jié)點(diǎn)，然后選擇“Launch console”（啟動控制臺）。
2. 對于每個節(jié)點(diǎn)，選擇“Serial 1”（串行 1）選項卡并按 Enter 鍵以確保您收到提示，該提示中指出您正在與“Light”或“Switch”節(jié)點(diǎn)通話。（提示應(yīng)顯示 AppBuilder 的“General（常規(guī)）”選項卡中已配置的應(yīng)用程序名稱。）

為什么？- 通過 Simplicity Studio 控制臺視圖中的“Serial 1”（串行 1）選項卡，您可以使用無線入門套件上的 USB-串行接口或無線入門套件上的 TCP 端口 4901 與物理串行端口（USART0 或連接到板上 VCOM_TX/RX 引腳的任何 UART TXD/RXD 引腳）進(jìn)行交互。這甚至可用于基于定制 EFR32 的硬件，前提條件是它通過 Mini-Simplicity 連接器重新連接到無線入門套件調(diào)試適配器。“Serial 0”選項卡表示通過“Debug Basic Library”插件在 SWO 和 SWDIO 調(diào)試引腳上進(jìn)行模擬，并通過無線入門套件上的 TCP 端口 4900 顯露的“虛擬 UART”。有關(guān)如何通過無線入門套件訪問 EFR32 調(diào)試接口的更多信息，請參閱 AN958：用于定制設(shè)計的調(diào)試和編程接口 (https://www.silabs.com/documents/public/application-notes/an958-mcu-stk-wstk-guide.pdf)。

3. 轉(zhuǎn)到 Window（窗口）> Preferences（首選項）> Network Analyzer（網(wǎng)絡(luò)分析器）> Decoding（解碼）> Stack Versions（堆棧版本），并設(shè)置為與用于構(gòu)建這些應(yīng)用程序的 SDK 對應(yīng)的 EmberZNet 版本（如果未列出您的版本，則為最新可用版本），以確保捕獲的數(shù)據(jù)包被正確解析為 Zigbee 流量。在設(shè)置此項后，點(diǎn)擊“OK（確定）”以繼續(xù)。

為什么？- “自動檢測”的默認(rèn)網(wǎng)絡(luò)分析器設(shè)置無法始終正確猜測在捕獲過程中使用的協(xié)議類型，尤其是在含基于 802.15.4 的混合流量的環(huán)境中。此外，EmberZNet 固件發(fā)布的一些非數(shù)據(jù)包事件可能本質(zhì)上具有版本特定性，因此，獲取用于解碼的正確堆棧版本就變得更加重要。

4. 在“Devices”（設(shè)備）視圖中，右鍵點(diǎn)擊 Switch 節(jié)點(diǎn)，然后選擇“Start Capture（開始捕獲）”。網(wǎng)絡(luò)分析器將打開。

為什么？- 這允許 Simplicity Studio 使用 FRC_DFRAME 和 FRC_DOUT 引腳上的 EFR32 數(shù)據(jù)包追蹤接口 (PTI) 外圍設(shè)備 ，通過無線入門套件開始收集數(shù)據(jù)包事件和網(wǎng)絡(luò)事務(wù)。此外，如果啟用了“Debug Basic Library”或“Debug Extended Library”插件，則固件可能會使用無線入門套件到 EFR32 SWO 引腳的連接來發(fā)布軟件事件跟蹤，如復(fù)位、確定、調(diào)試 Printfs 和 EZSP 命令/響應(yīng)。然后，在捕獲期間，所有這些事件都會在網(wǎng)絡(luò)分析器中聚合，并可保存以供日后使用。有關(guān) EmberZNet 堆棧中可用的調(diào)試功能的更多信息，請參閱 KBA：http://community.silabs.com/t5/Proprietary-Knowledge-Base/What-are-the-different-levels-of-debug-in-the-mesh-stacks-and/ta-p/113207

觀看視頻：Silicon Labs Zigbee 3.0 DIY 燈/開關(guān)教程：第 7 部分：開始捕獲

?

第 8 部分：設(shè)置網(wǎng)絡(luò)

1. 在 Light 節(jié)點(diǎn)的“Serial 1”（串行 1）控制臺選項卡中輸入如下命令：plugin network-creator form 1 0x5432 10 12

此處的選項將構(gòu)成網(wǎng)絡(luò)，該網(wǎng)絡(luò)：
(1) – 為集中化網(wǎng)絡(luò)
(0x5432) – 使用此 PAN ID（您可以選擇 0x0000-0xFFFE 范圍內(nèi)的任何內(nèi)容。）
(10) – 從 +10 dBm 發(fā)射功率開始（您可以選擇受硬件支持的任何級別，最高為 20+）。
(12) – 在通道 12 上開始（您可以選擇 11-26 范圍內(nèi)的任何內(nèi)容。）

2. 對于 Light 節(jié)點(diǎn)，當(dāng)控制臺在“Serial 1”（串行 1）上輸出“EMBER_NETWORK_UP”后，輸入以下命令來打開網(wǎng)絡(luò)以在 254 秒內(nèi)加入：plugin network-creator-security open-network

3. 于 254 秒內(nèi)在 Switch 節(jié)點(diǎn)的“Serial 1”（串行 1）控制臺選項卡上，輸入以下內(nèi)容以嘗試加入：plugin network-steering start 0

為什么？- 這將啟動“網(wǎng)絡(luò)導(dǎo)航”流程，該流程會嘗試通道的不同安全密鑰和不同掩碼，以加入 Zigbee 3.0 網(wǎng)絡(luò)的各種配置。“0”參數(shù)指示插件使用標(biāo)準(zhǔn)行為而不是提供“1”，后一種情況將導(dǎo)致無法在成功完成加入操作后對信任中心鏈路密鑰進(jìn)行一般更新。由于在此過程中會嘗試不同的安全密鑰，因此您可能會看到一些加入失敗消息（打印“EMBER_JOIN_FAILED”狀態(tài)），然后才能看到成功加入嘗試的消息。

4. 如果加入成功，Switch 的控制臺將在“Serial 1”（串行 1）中打印“EMBER_NETWORK_UP”，并且您會看到網(wǎng)絡(luò)分析器的“Transactions”（事務(wù)）視圖中出現(xiàn)“Association”和“Transport Key”事務(wù)（如以下視頻所示）。如果成功，請繼續(xù)下一節(jié)。否則，請重復(fù)步驟 2 和 3 如果是在課堂上和他人同時進(jìn)行這項工作，應(yīng)確保您加入了自己的網(wǎng)絡(luò)（基于 PAN ID），而不是您鄰居的網(wǎng)絡(luò)。

注意： 同一通道上可能存在其他 802.15.4 流量，因此網(wǎng)絡(luò)分析器中可能會出現(xiàn)不相關(guān)的事件/事務(wù)，其中包括您沒有其解密密鑰的流量。如果系統(tǒng)顯示關(guān)于您無法解密的流量的警告，只需點(diǎn)擊“OK”（確定）并繼續(xù)，忽略其他流量即可。（您可以稍后將其過濾掉。）

Silicon Labs Zigbee 3.0 DIY Light/Switch 教程：第 8 部分：克隆 Light 的 Switch 項目

第 9 部分：開/關(guān)切換

1. 在 Switch 節(jié)點(diǎn)的“Serial 1”（串行 1）上，輸入以下內(nèi)容：
zcl on-off toggle
send 0 1 1

2. 確認(rèn)在網(wǎng)絡(luò)分析器的“Transactions”（事務(wù)）視圖中的 Switch 和 Light 之間發(fā)送“ZCL: Toggle”和“ZCL: Default Response”。（注意，無線入門套件上的 LED 不會切換，因?yàn)槲覀兩形礊榇颂砑哟a。）

3. 在網(wǎng)絡(luò)分析器的“Live capture”（實(shí)時捕獲）選項卡下，突出顯示“ZCL: DefaultResponse”，并在右側(cè)的“Event Detail”（事件詳細(xì)信息）面板中檢查“Status: SUCCESS (0x00)”（在“Zigbee Cluster Library”（Zigbee 集群庫）部分下）。

4. 確認(rèn) Light 的“Serial 1”（串行 1）中打印“Toggle”消息。鍵入以下 CLI 命令以輸出屬性表，并驗(yàn)證在收到切換時開/關(guān)集群 (0x0006) 的屬性 00 是否更改：print attr

5. 有關(guān)可用于通過 AF CLI 控制 Switch 和 Light 的其他 CLI 命令，請參閱 Ember 應(yīng)用程序框架命令行界面 (CLI) 文檔（{GECKO_SDK_SUITE_DIR}/protocol/zigbee_X.Y/documentation/120-3023-000_AF_V2_API/index.html 處的 HTML 文件）。您還可以在 CLI 上鍵入“help”以獲取受支持命令的列表；任何非完整命令都將觸發(fā)針對這些命令的幫助語法。

觀看視頻：Silicon Labs Zigbee 3.0 DIY 燈/開關(guān)教程：第 9 部分：通過 CLI 切換 Light

?

接下來呢？

在本教程的后續(xù)部分中，我們將研究如何使切換命令在 Light 的無線入門套件上實(shí)際切換實(shí)體 LED，并介紹如何從 Switch 中的 CLI 驅(qū)動式切換命令過渡到由 Switch 無線入門套件上的按鈕啟動的按鈕驅(qū)動式命令。