>[success] 導師視頻講解：[**去聽課**](https://www.bilibili.com/video/BV1k34y1D7Vz?p=35) >[success] **技術支持說明：** >**1**.一般以自主學習為主 > **2**.可到官方問答社區中提問：[**去提問**](https://bbs.csdn.net/forums/zigbee) > **3**.工程師**會盡快**解答社區問題，但他們是一線開發，【**難以保證**】解答時效，解答辛苦，感謝理解！ <br/> 上節課學習了BDB Commissioning Modes基本原理之后，本節課講解怎么樣實現設備之間的網絡組建。 <br/> ## **裁剪應用層UI** 協議棧裁剪是開發者需要掌握的一項技術，因為 Z-Stack 3.0 包含了豐富的功能，但是在實際的開發過程中，部分功能可能是冗余的，甚至會影響到開發過程。 ### 打開本章節配套的工程代碼，展開App層代碼，如圖所示。  紅框中的兩個文件是針對TI的評估板而設計的UI，在產品開發過程并不需要用到，而且還會影響其他的開發工作，因此需要把它們裁剪掉。右擊文件，選擇Remove，如圖所示。  ### 裁剪后如圖所示。  <br/> zcl\_samplesw.c文件中會調用到這些UI，也需要把其全部刪除。點擊Edit，然后選擇Find and Replace→Find in Files...，如圖所示。  ### 在彈出的窗口中輸入“UI\_”，然后點擊Find按鈕，如圖所示。  ### 最后，在文件zcl\_samplesw.c中根據搜索結果，一個一個地把帶“UI\_”的地方刪除，如圖所示。  ### 正確刪除完成后，工程代碼是可以編譯通過的。 <br/> ## **編寫設備組網代碼** 如同前面章節所述，設備組網代碼非常簡單： * 第一步，調用bdb\_StartCommissioning()讓協調器創建網絡。 * 第二步，還是調用bdb\_StartCommissioning()，讓其他設備加入到網絡。 ### **角色判斷** 在編譯工程的時候，可以選擇讓編譯出來的程序工作在協調器中、路由器中或者終端中，即選擇設備在ZigBee網絡中的角色。在代碼中，可以利用宏ZDO\_COORDINATOR來判斷當前的工作模式，判斷方法是如果宏ZDO\_COORDINATOR被定義了，那么說明程序工作在協調器環境中，否則就是工作在路由器或者終端環境中。 ### **編寫代碼** 在zcl\_samplesw.c的初始化函數zclSampleSw_Init()中添加如下代碼： ``` #ifdef ZDO_COORDINATOR bdb_StartCommissioning( BDB_COMMISSIONING_MODE_NWK_FORMATION | BDB_COMMISSIONING_MODE_FINDING_BINDING ); NLME_PermitJoiningRequest(255); #else bdb_StartCommissioning( BDB_COMMISSIONING_MODE_NWK_STEERING | BDB_COMMISSIONING_MODE_FINDING_BINDING ); #endif ``` 代碼比較簡單，如果是協調器那么就讓協調器創建網絡，如果是路由器或者終端那么就加入到網絡。 ### 其中的NLME\_PermitJoiningRequest(255)是允許其他設備加入到由本協調器創建的網絡中，這一點在介紹Network Formation時也有講述過，也就是設備要經過信任中心的同意才能加入到網絡中。參數255表示一直允許，如果改為0則表示一直不允許；如果改為1~254表示在1~254秒內允許。 <br/> ## **處理設備入網失敗** 然而，設備入網的過程可能會受到多種因素的影響，從而導致入網失敗，例如在入網過程信號受到干擾等。開發者需要學會處理設備入網失敗。一種簡單而有效的辦法就是在設備入網失敗后，讓設備自動重新嘗試入網。 ### 在zcl\_samplesw.c文件中可以找到一個zclSampleSw\_ProcessCommissioningStatus()函數，這個函數的作用是處理Commissioning結果，例如協調器創建網絡是否成功、設備是否成功加入到網絡等。 ### 可以在這個函數中根據Commissioning的結果采取相應的處理，例如在設備入網失敗后重新調用bdb_StartCommissioning()來再次入網。 ### 可以用事件的機制來實現這個過程，當設備入網失敗后就啟動一個事件，讓程序在1s后重新嘗試入網。Z-Stack 3.0的事件使用方法在前面的章節已經講解過了，這里就不再講了，而是直接使用。 ### 1.在頭文件zcl\_samplesw.h定義一個用戶事件，并且定義重新入網的時間間隔，代碼如下： ``` /* 協調器 */ #ifdef ZDO_COORDINATOR /* 路由器或者終端 */ #else // 重新加入事件 #define SAMPLEAPP_REJOIN_EVT 0x0100 // 時間間隔：1000ms(1秒) #define SAMPLEAPP_REJOIN_PERIOD 1000 #endif ``` 由于設備入網是針對路由器或者終端類型的ZigBee設備的，因此同樣地使用了宏來判斷程序角色。 <br/> 2.在函數zclSampleSw\_ProcessCommissioningStatus中找到找到入網失敗處理位置，如圖所示。  <br/> 3.在入網失敗的位置添加如下代碼： ``` /* 協調器 */ #ifdef ZDO_COORDINATOR /* 路由器或者終端 */ #else /* 啟動重新加入事件 */ osal_start_timerEx(zclSampleSw_TaskID, SAMPLEAPP_REJOIN_EVT, SAMPLEAPP_REJOIN_PERIOD); #endif ``` 代碼中，首先判斷設備角色，然后啟動剛才定義的事件。 開發者也可以在入網成功的位置添加一些代碼，例如在顯示器上顯示入網成功的信息等。 <br/> 3.在應用層事件處理函數zclSampleSw_event_loop()中處理該事件，也就是重新啟動入網，代碼如下。 ``` #ifdef ZDO_COORDINATOR #else if ( events & SAMPLEAPP_REJOIN_EVT )//如果事件類型為重新加入網絡事件 { /* 重新加入網絡 */ bdb_StartCommissioning(BDB_COMMISSIONING_MODE_NWK_STEERING | BDB_COMMISSIONING_MODE_FINDING_BINDING ); return ( events ^ SAMPLEAPP_REJOIN_EVT ); } #endif ``` <br/> ## **編譯下載** **角色選擇** 前文中多次提及到設備的網絡角色，其實在編譯代碼的時候可以選擇不同的網絡角色，從而編寫不同角色的程序。 ### 在工程中單擊選項卡，可以看到如圖所示的選擇框，可以選擇待開發設備的對應的工作模式。  ### 其中CoordinatorEB、RouterEB、EndDeviceEB的含義分別是： （1）CoordinatorEB：協調器角色設備。 （2）RouterEB：路由器角色設備。 （3）EndDeviceEB：終端角色設備。 ### 除了此之外，還有EndDeviceEB-OTAClient和RouterEB-OTAClient，其實這兩個指的是帶OTA功能的終端設備和帶OTA功能的路由設備。 <br/> **使用角色** 首先選擇CoordinatorEB，如圖所示，編譯完成后下載到其中一塊開發板中，建議使用ZigBee Mini板。此開發板在ZigBee網絡中會充當協調器角色設備。  ### 接著選擇RouterEB，如圖所示。同樣編譯完成后下載到另一個板子中，建議使用ZigBee標準板。此開發板ZigBee網絡中即會充當路由器角色設備。  ### >[danger] 注意：切換工程后，同樣需要在工程的預編譯那里開啟LED、串口、顯示屏等功能，并且把屏幕的路徑加入到工程中。 <br/> ## **仿真調試** 給協調器上電后，協調器會自動創建網絡。創建網絡成功后，在屏幕上可以看到網絡ID（PanID），如圖所示。  ### 接著給路由器或終端上電后，它會自動加入到由協調器創建的網絡中，加入后可以在屏幕上看到被分配到的網絡地址和父節點的網絡地址，路由器或終端設備加入后如圖所示。 * 路由器  ### * 終端  <br/> <br/> ## **項目定制** * 如需項目定制開發，可掃碼添加項目經理好友（注明“**項目定制**”） * 定制范圍：**NB-IoT**、**CATn（4G）**、**WiFi**、**ZigBee**、**BLE Mesh**以及**STM32**、**嵌入式Linux**等IoT技術方案 * 善學坊官網：[www.sxf-iot.com](https://www.sxf-iot.com/)  * 非項目定制**勿擾**，此處**非**技術支持