如何快速上手使用STM32庫函數(shù)
一、背景
如前文所述，利用標(biāo)準(zhǔn)庫函數(shù)的好處在于，可以快速開發(fā)，不用去對著數(shù)據(jù)手冊，小心翼翼的一位一位的配置那
些繁復(fù)的寄存器，因?yàn)檫@些工作意法半導(dǎo)體已經(jīng)找了一些頂級的工程師幫你做了，杰作既是其庫函數(shù)。當(dāng)然，有些代碼
考慮到低功耗，或者需要極小的ROM，就不能使用庫函數(shù)，而這即是通常說的，"高度定制化"，犧牲開發(fā)時間來獲取更
高代碼效率，這個需要自己權(quán)衡。
本文以STM32之DMA庫函數(shù)為例，即如何快速使用STM32庫函數(shù)做個簡述及記錄。
二、正文
首先去官網(wǎng)或者論壇下載STM32的官方庫，解壓出來，會發(fā)現(xiàn)里面是各種".c"".h"，文件，不需要所有文件
一股腦的照單全收，只需要復(fù)制一些自己需要的即可，
1、 新建一個可用的工程（廢話:-D)，然后將庫函數(shù)的".c"".h"文件加入到自己的工程內(nèi)，并使其編譯通過；
最基本的工程所需要的庫函數(shù)文件有:
"startup_stm32f10x_hd.s" --> 啟動文件；
"system_stm32f10x.c" --> 常用來設(shè)置初始化時鐘，里面的“SystemInit()”函數(shù)在啟動文件內(nèi)調(diào)用；
"misc.c" --> Cotex-M3內(nèi)核常用的配置文件，譬如其內(nèi)包含NVIC配置庫函數(shù)等等；
"stm32f10x_rcc.c" --> 時鐘配置相關(guān)文件，里面包含了時鐘配置庫函數(shù)；
以DMA函數(shù)為例，將"stm32f10x_dma.c"，"stm32f10x_dma.h"文件放入指定文件夾內(nèi)，然后加入已有
工程，在主函數(shù)內(nèi)嘗試調(diào)用最簡單的一個庫函數(shù)，并編譯通過，然后主函數(shù)刪除測試調(diào)用的庫函數(shù)。
2、 先別急著去看庫函數(shù)有哪些具體的庫函數(shù)，更別急著去跟庫函數(shù)的代碼，首先去看STM32的技術(shù)手冊關(guān)于DMA
的內(nèi)容，弄清楚DMA是一個什么結(jié)構(gòu)，寄存器大概需要配置哪些，了解寄存器的時候不需要深究每一位，只需要
明白每個寄存器控制哪些功能即可。
3、 看完了STM32手冊內(nèi)關(guān)于DMA的介紹，就可以去解析庫函數(shù)代碼了。
一般庫函數(shù)代碼的參數(shù)都是一個地址，一個包含配置信息的結(jié)構(gòu)體參數(shù)，如DMA初始化庫函數(shù)：
/**
* @brief Initializes the DMAy Channelx according to the specified
* parameters in the DMA_InitStruct.
* @param DMAy_Channelx: where y can be 1 or 2 to select the DMA and
* x can be 1 to 7 for DMA1 and 1 to 5 for DMA2 to select the DMA Channel.
* @param DMA_InitStruct: pointer to a DMA_InitTypeDef structure that
* contains the configuration information for the specified DMA Channel.
* @retval None
*/
void DMA_Init(DMA_Channel_TypeDef* DMAy_Channelx, DMA_InitTypeDef* DMA_InitStruct);
每個庫函數(shù)之前都會有說明該庫函數(shù)的功能是什么，傳入的參數(shù)值得作用是什么，傳入什么參數(shù)會被認(rèn)定為有效
參數(shù)以及返回值等等信息。
對于傳入的參數(shù)，有些會比較復(fù)雜，往往不是開頭的只言片語就能介紹完整，此時你需要深入跟進(jìn)庫函數(shù)代碼，
看它拿這個參數(shù)具體做了什么。還是以此函數(shù)為例，第一個參數(shù)結(jié)構(gòu)體如下：
typedef struct
{
__IO uint32_t CCR;
__IO uint32_t CNDTR;
__IO uint32_t CPAR;
__IO uint32_t CMAR;
} DMA_Channel_TypeDef;
此時就很明了了，每個DMA通道都會有單獨(dú)獨(dú)立的寄存器，第一個參數(shù)即包含了這些獨(dú)立寄存器的地址。
而那些所有DMA通道共用的寄存器則不在該參數(shù)內(nèi)，也不需要在該參數(shù)內(nèi)。所以其在參數(shù)說明中做了如下
說明：
/*
* @param DMAy_Channelx: where y can be 1 or 2 to select the DMA and
* x can be 1 to 7 for DMA1 and 1 to 5 for DMA2 to select the DMA Channel.
*/
接著分析第二個參數(shù)結(jié)構(gòu)體，一般該結(jié)構(gòu)體包含了配置DMA的所有參數(shù)信息，具體如下：
typedef struct
{
uint32_t DMA_PeripheralBaseAddr;
uint32_t DMA_MemoryBaseAddr;
uint32_t DMA_DIR;
uint32_t DMA_BufferSize;
uint32_t DMA_PeripheralInc;
uint32_t DMA_MemoryInc;
uint32_t DMA_PeripheralDataSize;
uint32_t DMA_MemoryDataSize;
uint32_t DMA_Mode;
uint32_t DMA_Priority;
uint32_t DMA_M2M;
}DMA_InitTypeDef;
這個一眼望去，真的是倆眼懵逼，還是按著套路來（23333），進(jìn)入庫函數(shù)看每個參數(shù)做了什么。
tmpreg |= DMA_InitStruct->DMA_DIR | DMA_InitStruct->DMA_Mode |
DMA_InitStruct->DMA_PeripheralInc |
DMA_InitStruct->DMA_MemoryInc |
DMA_InitStruct->DMA_PeripheralDataSize |
DMA_InitStruct->DMA_MemoryDataSize |
DMA_InitStruct->DMA_Priority | DMA_InitStruct->DMA_M2M;
/* Write to DMAy Channelx CCR */
DMAy_Channelx->CCR = tmpreg;
看到這里，這里這么多參數(shù)，全部設(shè)置給了一個叫CCR的寄存器，接著我們查查這個CCR寄存器都設(shè)置了什么：
DMA通道x配置寄存器(DMA_CCRx)，定位到這個寄存器，再加上每個參數(shù)32位所處的位數(shù)則可以確定該結(jié)構(gòu)體
每個成員代表了什么，其他參數(shù)亦如此。
確定了所有的參數(shù)所控制的功能后，這時就可以按照自己的需求去傳入正確的參數(shù)做相應(yīng)的配置。
這里我想插一句，既有些新學(xué)STM32的朋友，我也曾算是一個，就覺著使用庫函數(shù)而不去配置每個寄存器，會覺
著心里不踏實(shí)，不能學(xué)到真正的STM32技術(shù)，而就剛剛所做的一系列動作來看，其實(shí)是誤解了，利用庫函數(shù)，同
樣的你也得去深入的了解STM32的技術(shù)手冊，所以并不存在不能學(xué)到實(shí)際技術(shù)之說。
技術(shù)一直在更新，老的技術(shù)也一直在沉淀穩(wěn)定，我們只需站在巨人的肩膀上，就可以看的更高更遠(yuǎn)，何苦還需要
浪費(fèi)時間和精力自己去做別人已經(jīng)做好的事情呢。:-D
4、 解析完所有的函數(shù)后，此時即可以利用庫函數(shù)去實(shí)現(xiàn)自己的功能邏輯啦。
三、參考文獻(xiàn)：
STM32F10x Standard Perpheral Libary (V3.5.0)
http://www.st.com/content/st_com/en/products/embedded-software/mcus-embedded-software/stm32-embedded-software/stm32-standard-peripheral-libraries/stsw-stm32054.html
STM32F10x Description of STM32F1XX Standard Perpheral Libary Documentation
http://stm32.kosyak.info/doc/
至此，記錄完畢。
下載文檔
