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

1.固件庫文件夾組織結(jié)構(gòu)

GD32E230_Firmware_Library文件組織結(jié)構(gòu)如圖 0-1固件庫文件組織結(jié)構(gòu)圖所示。

2. 文件夾 Examples 文件詳解

文件夾Examples，對應(yīng)每一個GD32外設(shè)均包含一個子文件夾。 每個子文件夾包含了關(guān)于本外設(shè)的一個或多個例程，來示范如何使用對應(yīng)外設(shè)。 每個例程子文件夾包含如下文件：

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

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

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

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

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

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

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

? CMSIS子文件夾包含有Cortex M23內(nèi)核的支持文件、 基于Cortex M23內(nèi)核處理器的啟動代碼和庫引導(dǎo)文件以及基于GD32E230的全局頭文件和系統(tǒng)配置文件；

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

3. 固件庫例程使用方法

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

（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兩種版本的工程，根據(jù)客戶所安裝的軟件，打開不同的 project，如”Keil_project”，打開\Template\Keil_project\Project.uvproj，如圖所示

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

（4）編譯調(diào)試下載

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

4. Utilities 文件夾

Utilities文件夾包含運(yùn)行固件庫例程評估板的文件：

? Binary、 LCD_Commom及Third_Party子文件夾；

? GD32e230_eval.h及GD32e230_lcd_eval.h文件是運(yùn)行固件庫例程所需關(guān)于評估板的頭文件；

? GD32e230_eval.c及GD32e230_lcd_eval.c文件是運(yùn)行固件庫例程所需關(guān)于評估板的源文件

5. 固件函數(shù)庫文件描述

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

本教程由GD32 MCU方案商聚沃科技原創(chuàng)發(fā)布，了解更多GD32 MCU教程，關(guān)注聚沃科技官網(wǎng)