4.1 HAL的文件結構和工程結構 · ZigBee 3.0 開發指南

* 導師視頻講解：[**去聽課**](https://www.bilibili.com/video/BV1k34y1D7Vz?p=29) >[success] **技術支持說明：** >**1**.一般以自主學習為主 > **2**.可到官方問答社區中提問：[**去提問**](https://bbs.csdn.net/forums/zigbee) > **3**.工程師**會盡快**解答社區問題，但他們是一線開發，【**難以保證**】解答時效，解答辛苦，感謝理解！ 硬件適配層（Hardware Adaptation Layer，HAL），用于適配各種各樣的硬件，為上層提供統一的接口，從而方便開發者使用各種各樣的硬件。本節課從文件結構和工程結構這兩方面簡單地講解HAL的結構。 ## **HAL的文件結構** >[warning] HAL的文件結構較為復雜，讀者只需要跟筆者的講解思路簡單地了解一下就可以了。在安裝好Z-Stack 3.0 后，HAL相關的源代碼可以在Z-Stack 3.0的Components文件夾中找到，如圖所示。 ![](https://img.kancloud.cn/5a/8f/5a8fb8078d81eab2212e8eb829a7604b_1529x1440.png =200x) ### 進入hal目錄，如圖所示。 ![](https://img.kancloud.cn/8c/fe/8cfe5f86ed5942335367186d1d49fabb_346x151.png =200x) 其中的文件夾說明如下：（1）common：存放公共文件。（2）include：存放各種驅動程序接口文件。（3）target：存放各種類型主板的驅動程序源文件。 ### 進入common文件夾，如圖所示。 ![](https://img.kancloud.cn/5c/2e/5c2e61eae806afe8a2a835a82ec7b674_492x158.png =250x) common目錄中的文件說明如下：（1）hal_assert.c：實現條件合法性判斷功能的源代碼文件。（2）hal_drivers.c：硬件抽象層HAL任務初始化及事件處理函數所在文件，是HAL的入口源文件。 ### 返回上一級，并進入include目錄，如圖所示。 ![](https://img.kancloud.cn/b6/43/b643efc8a189fc406f367b98a1fefcb3_489x451.png =250x) include目錄中的文件描述如下：（1）hal_adc.h：ADC（模擬數字轉換）驅動程序頭文件。（2）hal_assert.h：條件合法性判斷功能的頭文件。（3）hal_board.h：各種類型主板的硬件資源配置頭文件。（4）hal_defs.h：通用定義頭文件。（5）hal_drivers.h：HAL任務初始化及事件處理函數的頭文件。（6）hal_flash.h：FLASH（存儲器）驅動程序頭文件。（7）hal_key.h：按鍵驅動程序頭文件。（8）hal_lcd.h：顯示屏驅動程序頭文件。（9）hal_led.h：LED驅動程序頭文件。（10）hal_rpc.h：RPC（Remote Procedure Call，遠程過程調用）驅動程序頭文件。（11）hal_sleep.h：休眠功能驅動程序頭文件。（12）hal_timer.h：定時器驅動程序頭文件。（13）hal_uart.h：串口驅動程序頭文件。 ### 返回上一級，然后進入target文件夾，如圖所示。 ![](https://img.kancloud.cn/bc/a8/bca80a20aeee9cc84808d283d71dcf8b_474x236.png =250x) target目錄中的文件夾描述如下：（1）CC2530EB：針對芯片主控為CC2530的評估板相關的驅動程序。（2）CC2530USB：針對芯片主控為CC2530的帶USB轉串口評估板的驅動程序。（3）CC2530ZNP：針對芯片主控為CC2530的ZNP（ZigBee And Processor）評估板的驅動程序。（4）CC2538：針對芯片主控為CC2538的評估板的驅動程序。（5）CC2538ZNP：針對芯片主控為CC2538的ZNP（ZigBee And Processor）評估板的驅動程序。 ### 以CC2530EB為例，進入到這個目錄，如圖所示。 ![](https://img.kancloud.cn/94/9e/949e5e17fbcf1bd1f768a9e1bef6c9a2_558x725.png =250x) ### 這個目錄下中存放兩種類型的硬件驅動程序源文件： * 一種是實現了剛才介紹過的include目錄中的接口的源代碼文件，例如hal\_led、hal\_lcd.c和hal\_adc.c等等。 * 另一種是與當前的主板類型相關的驅動程序源文件，比如DMA（Direct Memory Access，直接存儲器訪問）、OTA（Over The Air，空中升級）等。 ### 簡單地講解一下這個目錄中的各個文件：（1）_hal_uart_dma.c：串口DMA（Direct Memory Access，直接存儲器訪問）驅動程序源文件。（2）_hal_uart_isr.c：串口ISR（Interrupt Service Routines，中斷服務程序）驅動程序源文件。（3）hal_adc.c：ADC（模擬數字轉換）驅動程序源文件（4）hal_aes.h：AES（Advanced Encryption Standard，高級加密標準）驅動程序頭文件。（5）hal_board_cfg.h：當前主板的硬件資源配置頭文件。（6）hal_ccm.h：CCM（Counter with CBC-MAC，分組密碼鏈接-消息認證碼）驅動程序頭文件。（7）hal_dma.c：DMA（Direct Memory Access，直接存儲器訪問）驅動程序源文件。（8）hal_dma.h：DMA（Direct Memory Access，直接存儲器訪問）驅動程序頭文件。（9）hal_flash.c：FLASH（存儲器）驅動程序源文件。（10）hal_key.c：按鍵驅動程序源文件。（11）hal_lcd.c：顯示屏驅動程序接口文件。（12）hal_led.h：LED（發光二極管）驅動程序頭文件。（13）hal_mac_cfg.h：MAC（Medium Access Control，媒體介質訪問控制）相關配置頭文件。（14）hal_mcu.h：與主控芯片相關的驅動程序頭文件。（15）hal_oad.c：OAD（On Air Download，空中下載）驅動程序源文件。（16）hal_oad.h：OAD（On Air Download，空中下載）驅動程序頭文件。（17）hal_ota.c：OTA（Over The Air，空中升級）驅動程序源文件。（18）hal_ota.h：OTA（Over The Air，空中升級）驅動程序頭文件。（19）hal_sleep.c：休眠功能驅動程序源文件。（20）hal_startup.c：系統啟動相關的驅動程序源文件。（21）hal_timer.c：定時器驅動程序源文件。（22）hal_types.h：類型定義頭文件。（23）hal_uart.c：串口驅動程序源文件。 ## **HAL工程結構** 本節內容將以SampleSwitch例程為例來講解其中的HAL的工程文件結構。 ### **工程組織結構** 打開SampleSwitch工程，可以找到HAL所在目錄，如圖所示。 ![](https://img.kancloud.cn/a6/dc/a6dcf0b31e351a3f0d5702188ce14676_799x642.png =500x) #### 分別展開Common、Include和Target目錄，如圖所示。 ![](https://img.kancloud.cn/ba/24/ba24f9346da695951dd7fdae340efdf4_302x684.png =250x) #### Target目錄中有一個CC2530EB目錄，表示這個工程采用的是CC2530EB主板相關的驅動程序文件。 ### 在CC2530EB目錄中包含Config、Drivers和Includes這3個目錄。Config目錄存放了該主板的硬件資源配置頭文件，Drivers目錄存放了各種驅動程序源文件，Includes目錄存放了各種驅動程序頭文件。 ## **項目定制** * 如需項目定制開發，可掃碼添加項目經理好友（注明“**項目定制**”） * 定制范圍：**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) * 非項目定制**勿擾**，此處**非**技術支持