1.1 Z-Stack 3.0.1 文件組織 · ZigBee 3.0 開發指南

* 導師視頻講解：[**去聽課**](https://www.bilibili.com/video/BV1k34y1D7Vz?p=22) >[success] **技術支持說明：** >**1**.一般以自主學習為主 > **2**.可到官方問答社區中提問：[**去提問**](https://bbs.csdn.net/forums/zigbee) > **3**.工程師**會盡快**解答社區問題，但他們是一線開發，【**難以保證**】解答時效，解答辛苦，感謝理解！ ## **協議棧簡介與安裝** Z-Stack 3.0 是TI（德州儀器）針對 ZigBee 3.0 協議而開發的技術方案，也稱為TI ZigBee 3.0 協議棧。通俗地講，Z-Stack 3.0就是TI根據 ZigBee 3.0 協議規范而編寫的程序（庫），開發者可以方便地調用Z-Stack 3.0中的各個API來進行基于ZigBee協議的數據通信。本節課需要用到TI Z-Stack 3.0 協議棧，讀者可以到《第一部分》中根據提示安裝。 ## **文件組織** 默認安裝Z-Stack 3.0 完成后可以在電腦C盤找到對應的文件夾，如圖所示。 ![](https://img.kancloud.cn/f9/93/f99351df31006e84dcc6f049b9e02bb1_388x142.png =300x) ### 打開Z-Stack 3.0.1文件夾，如圖所示。 ![](https://img.kancloud.cn/b4/ff/b4ffccede72407bdb0cf5f7db5a41d7f_1566x1261.png =400x) ## **Accessories目錄** 存放了各種輔助工具，進入Accessories目錄，如圖所示。 ![](https://img.kancloud.cn/9c/f7/9cf7307a2f7ccd394ccfcd21f76c6b02_329x129.png =250x) 目錄Accessories中的文件夾描述如下：（1）OtaServer：存放了OTA（Over The Air，空中升級）測試工具（2）SerialBootTool：存放了串口升級測試工具。 ## **Components目錄** 存放了Z-Stack核心源代碼和鏈接庫，進入Components目錄，如圖所示。 ![](https://img.kancloud.cn/9f/ab/9fabfd459eebfdb178bf2e3ce549dc49_324x288.png =250x) 目錄Components中的文件夾描述如下：（1）bsp：板級支持包，用于適配TI官方開發板的硬件資源。（2）driverlib：驅動程序鏈接庫，存放TI官方未開源驅動程序的鏈接庫。（3） hal：硬件抽象層，存放各種驅動程序。（4）mac：媒體介質訪問控制，實現物理層通信及IEEE 802.15.4協議。（5）mt：監視層，為監視協議棧各層的運行狀態提供支持。（6）osal：操作系統抽象層，是Z-Stack 3.0的操作系統。（7）services：提供一些公共的、常用的功能。（8）stack：ZigBee協議的實現。（9）usblib：USB鏈接庫，芯片支持USB（比如CC2538）時需要用到的功能。（10）zmac：屬于mac層的內容。 ## **Documents目錄** 存放了Z-Stack開發輔助的相關文檔，進入Documents目錄，如圖所示。 ![](https://img.kancloud.cn/9c/81/9c811db32989e645cc8e95d6dd1c0487_408x223.png) 目錄Documents中的文件夾及文件描述如下：（1）API：存放Z-Stack 3.0 相關API的說明文檔。（2）CC2530：存放適用于CC2530型號MCU的相關文檔。（3）CC2538：存放適用于CC2538型號MCU的相關文檔。（4）Z-Stack 3.0 Developer's Guide.pdf：Z-Stack 3.0 開發指導。（5）Z-Stack 3.0 Sample Application User's Guide.pdf：Z-Stack 3.0 應用例程指導。（6）Z-Stack OTA Upgrade User's Guide.pdf：OTA（Over The Air）空中升級說明指導。 ## **Projects目錄** 存放了ZigBee應用例程的工程文件和源碼文件，進入Projects目錄，如圖所示。 ![](https://img.kancloud.cn/0e/9a/0e9a12e39f2c4306e4f08215afe16b7f_297x133.png =250x) 目錄Projects中的文件夾描述如下：（1）tools：存放與ZigBee例程應用相關的工具。（2）zstack：存放ZigBee相關例程。 ### 進入zstack文件夾，如圖所示。 ![](https://img.kancloud.cn/9c/da/9cda5c0857caebc7e3c4a58e460c20f9_301x240.png =250x) 目錄zstack中的文件夾描述如下：（1）HomeAutomation：面向家庭自動化領域的相關例程。（2）Libraries：存放鏈接庫文件，TI不開放的源代碼會被編譯為鏈接庫的形式提供給開發者使用。（3）OTA：OTA（Over The Air）空中升級例程。（4）Tools：存放工程配置相關的文件。（5）Utilities：公共文件夾。（6）ZMain：存放主函數所在的源代碼文件及系統硬件啟動相關的源代碼文件。（7）ZNP：ZNP（ZigBee And Processor）例程。 ### 進入HomeAutomation文件夾，如圖所示。 ![](https://img.kancloud.cn/5a/e4/5ae434c18828458787b04ee774d4b69c_336x256.png =250x) 目錄HomeAutomation中的文件夾描述如下：（1）GenericApp：通用的應用場景例程。（2）SampleDoorLock：ZigBee 3.0門鎖例程。（3）SampleDoorLockController：ZigBee 3.0門鎖控制器例程。（4）SampleLight：ZigBee 3.0燈例程。（5）SampleSwitch：ZigBee 3.0插座例程。（6）SampleTemperatureSensor：ZigBee 3.0溫濕度傳感器例程。（7）SampleThermostat：ZigBee 3.0溫度控制器例程。（8）Source：存放公共代碼的文件夾。 ## **其他目錄** （1） Tools：存放開發調試相關的工具。（2） EULA.pdf：版權聲明文件。（3）Getting Started Guide - CC2530.pdf：針對CC2530型號MCU的開始向導文件。（4）Getting Started Guide - CC2538.pdf：針對CC2538型號MCU的開始向導文件。（5）Z-Stack 3.0 Release Notes.txt：Z-Stack 3.0 發布描述文件。（6）Z-Stack 3.0 Software Development Kit Resource Guide.html：Z-Stack 3.0 開發資源向導鏈接文件。（7） Z-Stack Core Release Notes.txt：Z-Stack Core發布描述文件。（8）Z-Stack_3.0.1_Manifest.html：Z-Stack 3.0 關鍵信息描述清單。（9）_iss：此文件夾為隱藏文件夾，存放用于卸載Z-Stack 3.0 的相關文件。 ## **項目定制** * 如需項目定制開發，可掃碼添加項目經理好友（注明“**項目定制**”） * 定制范圍：**NB-IoT**、**CATn（4G）**、**WiFi**、**ZigBee**、**BLE Mesh**以及**STM32**、**嵌入式Linux**等IoT技術方案 * 善學坊官網：[www.sxf-iot.com](https://www.sxf-iot.com/) ![](https://img.kancloud.cn/ca/73/ca739f92cab220a3059378642e3bd502_430x430.png =200x) * 非項目定制**勿擾**，此處**非**技術支持