GD32 MCU標準固件庫是一個固件函數包，它由程序、數據結構和宏組成，包括了GD32 MCU所 有外設的性能特征。固件庫還包括每一個外設的驅動描述和基于評估板的固件庫使用例程。通過 使用標準固件庫，用戶無需深入掌握細節，也可以輕松應用每一個外設。使用固件庫可以大大減 少用戶的編程時間， 從而降低開發成本。每個外設驅動都由一組函數組成，這組函數覆蓋了該外 設所有功能。 可以通過調用一組通用API(application programming interface應用編程界面)來實 現對外設的驅動， 這些API的結構、函數名稱和參數名稱都進行了標準化規范。 在此以GD32E23x系列固件庫為例進行說明固件庫架構及使用方法，其他系列固件庫可類比參考。

1.固件庫文件夾組織結構

GD32E230_Firmware_Library文件組織結構如圖 0-1固件庫文件組織結構圖所示。

2. 文件夾 Examples 文件詳解

文件夾Examples，對應每一個GD32外設均包含一個子文件夾。 每個子文件夾包含了關于本外設的一個或多個例程，來示范如何使用對應外設。 每個例程子文件夾包含如下文件：

? readme.txt： 關于本例程的簡單描述和使用說明；

? GD32e230_libopt.h：該頭文件可以設置例程所使用到的外設，由不同的“DEFINE”語句組成（默認情況下，所有外設均打開）；

? GD32e230_it.c：該源文件包含了所有的中斷處理程序（如果未使用到中斷，則所有的函數體都為空）；

? GD32e230.it.h：該頭文件包含了所有的中斷處理程序的原形；

? systick.c： 該源文件包含了使用systick的精準延時程序；

? systick.h： 該頭文件包含了使用systick的精準延時程序的原形；

? main.c：例程代碼注：所有的例程的使用，都不受不同軟件開發環境的影響。Firmware文件夾包含組成固件庫核心的所有子文件夾和文件：

? CMSIS子文件夾包含有Cortex M23內核的支持文件、 基于Cortex M23內核處理器的啟動代碼和庫引導文件以及基于GD32E230的全局頭文件和系統配置文件；

? GD32E230_standard_peripheral子文件夾；
– Include子文件夾包含了固件函數庫所需的頭文件，用戶無需修改該文件夾；
– Source子文件夾包含了固件函數庫所需的源文件，用戶無需修改該文件夾。

3. 固件庫例程使用方法

3、Template文件夾包含一個關于使用LED、 USART打印、 按鍵控制的簡單例程，（IAR_project用于IAR編譯環境， Keil_project用于Keil5編譯環境）。 用戶可以使用該工程模板進行固件庫例程的移植編譯， 具體使用方法見下：

（1） 選擇文件

打開“Examples”文件夾，選擇需要測試的模塊，如SPI，打開”SPI”文件夾，選擇SPI的一個例程，如”SPI_master_transmit_slave_receive_interrupt”，如圖所示

（2）拷貝文件

打開“Template”文件夾，將” IAR_project”和” Keil_project”兩個文件夾保留，其他文件都刪除，然后將“SPI_master_transmit_slave_receive_interrupt”文件夾中的所有文件拷到“Template”文件夾子目錄下，如圖所示

（3）打開工程

GD提 供 Keil和 IAR兩種版本的工程，根據客戶所安裝的軟件，打開不同的 project，如”Keil_project”，打開\Template\Keil_project\Project.uvproj，如圖所示

由于不同的模塊、不同的功能，會使用到不同的文件，需要根據客戶選擇拷貝的文件，對工程里的文件進行增加或刪除，如圖所示

（4）編譯調試下載

首先編譯整個工程，如果無錯誤，按照readme中的介紹，選擇正確的跳線及連線，然后再將程序下載到目標板上，則會有如readme中描述的現象。 IDE的具體使用，請參考相應的軟件使用說明。如客戶使用的是Keil，可見下圖

4. Utilities 文件夾

Utilities文件夾包含運行固件庫例程評估板的文件：

? Binary、 LCD_Commom及Third_Party子文件夾；

? GD32e230_eval.h及GD32e230_lcd_eval.h文件是運行固件庫例程所需關于評估板的頭文件；

? GD32e230_eval.c及GD32e230_lcd_eval.c文件是運行固件庫例程所需關于評估板的源文件

5. 固件函數庫文件描述

固件庫使用的主要文件如表下表固件函數庫文件描述所示，讀者可以參考。

本教程由GD32 MCU方案商聚沃科技原創發布，了解更多GD32 MCU教程，關注聚沃科技官網