1095
引言
本文檔介紹了如何在 STM32WB 系列上使用 Zigbee?群集。
Zigbee 應(yīng)用通常構(gòu)建在 Zigbee 群集庫(kù)之上。
本應(yīng)用筆記說(shuō)明了此類群集的使用及控制方法。
本文檔適用于 STM32WB 系列基于雙核 Arm?的微控制器。
快速開始
本文檔可用于指導(dǎo)開發(fā)人員了解使用 Exegin ZCL 群集模板構(gòu)建應(yīng)用的要點(diǎn)。每個(gè) Exegin ZCL 群集模板均提供了起始源代碼，以便實(shí)現(xiàn)完整的群集。該模板提供了 Exegin 規(guī)范[R2]、[R4]中定義的強(qiáng)制性 ZCL 命令和屬性。
許多命令和屬性已成功通過(guò) Zigbee?認(rèn)證測(cè)試。應(yīng)用的構(gòu)建包括向特定硬件添加接口，或添加類似應(yīng)用特定的詳細(xì)信息。這對(duì)于以應(yīng)用為中心的群集尤為如此，以應(yīng)用為中心的群集的主要目的是提供應(yīng)用特定的功能，諸如“開關(guān)”群集，對(duì)于燈而言，該群集會(huì)打開和關(guān)閉燈。
除了特定于應(yīng)用程序的群集之外，還為其他類型的群集（如支持群集和專業(yè)群集）提供了模板。基本群集通過(guò)提供設(shè)備的品牌和型號(hào)等信息來(lái)支持常規(guī)操作。組合，可以將其它群集進(jìn)行組合管理。第三種類型的群集（即專業(yè)群集）獨(dú)立性較高，并且涉及到應(yīng)用的部分最少。這些群集提供了一些特殊函數(shù)，諸如 Touchlink、CBKE（智能能源安全）和綠色電源。
本文檔旨在與定義群集的[R2] ZCL 7 規(guī)范和[R3]結(jié)合使用，用于 Exegin ZSDK API。
群集和端點(diǎn)
協(xié)議棧負(fù)責(zé)建立和維護(hù)某個(gè)節(jié)點(diǎn)與 Zigbee 網(wǎng)絡(luò)上的其他節(jié)點(diǎn)之間的通信（參見[R1]和[R3]）。應(yīng)用組件建立在這些較低層上并交換 Zigbee 群集庫(kù)（ZCL）消息。
本文檔介紹了如何使用 ZSDK 提供的群集模板構(gòu)建應(yīng)用。
ZCL 由多套有組織的相關(guān)功能（即群集）組成。通常，該功能與特定的硬件原件相關(guān)聯(lián)，諸如單個(gè)燈或控制燈的開關(guān)。與給定設(shè)備相關(guān)聯(lián)的所有函數(shù)都位于單個(gè)端點(diǎn)上。
本文檔基于[R2]和[R3]構(gòu)建，為用戶使用群集模板構(gòu)建應(yīng)用提供了相關(guān)知識(shí)。
節(jié)點(diǎn)上的每個(gè)端點(diǎn)都具有一個(gè)唯一的端點(diǎn) ID（通常稱為“端點(diǎn)”），取值范圍從 1 到 239。保留端點(diǎn) 0 和240 到 255 用于特殊用途。
客戶端服務(wù)器的關(guān)系
群集功能分為服務(wù)器端和客戶端，服務(wù)器端通過(guò)一個(gè)節(jié)點(diǎn)上的端點(diǎn)提供服務(wù)，客戶端通過(guò)另一個(gè)節(jié)點(diǎn)上的另一個(gè)端點(diǎn)訪問(wèn)該服務(wù)）。
支持多個(gè)燈或多個(gè)開關(guān)）。因此，每個(gè)實(shí)例位于唯一的端點(diǎn)上，一個(gè)節(jié)點(diǎn)上的特定燈（“開關(guān)”服務(wù)器）通過(guò)使用相應(yīng)的節(jié)點(diǎn)端點(diǎn)，與另一個(gè)節(jié)點(diǎn)上的特定開關(guān)（“開關(guān)”客戶端）相關(guān)聯(lián)。
例如：開關(guān) 3 可以位于開關(guān)節(jié)點(diǎn)上的端點(diǎn) 3 上，并且配置為與燈節(jié)點(diǎn)的端點(diǎn) 2 上的燈 2 通信。
給定端點(diǎn)上只允許有一個(gè)群集實(shí)例，但每個(gè)端點(diǎn)通常具有多個(gè)群集（如“開關(guān)”、基本、報(bào)警、場(chǎng)景等）。
應(yīng)用使用 ZbZclAddEndpoint()函數(shù)創(chuàng)建一個(gè)或多個(gè)端點(diǎn)，該函數(shù)已在 Zigbee 群集庫(kù)頭文件 zcl.h 中予以聲明。
