一、背景

如前文所述，利用標(biāo)準(zhǔn)庫函數(shù)的好處在于，可以快速開發(fā)，不用去對著數(shù)據(jù)手冊，小心翼翼的一位一位的配置那

些繁復(fù)的寄存器，因?yàn)檫@些工作意法半導(dǎo)體已經(jīng)找了一些頂級的工程師幫你做了，杰作既是其庫函數(shù)。當(dāng)然，有些代碼

考慮到低功耗，或者需要極小的ROM，就不能使用庫函數(shù)，而這即是通常說的，"高度定制化"，犧牲開發(fā)時(shí)間來獲取更

高代碼效率，這個(gè)需要自己權(quán)衡。

本文以STM32之DMA庫函數(shù)為例，即如何快速使用STM32庫函數(shù)做個(gè)簡述及記錄。

二、正文

首先去官網(wǎng)或者論壇下載STM32的官方庫，解壓出來，會發(fā)現(xiàn)里面是各種".c"".h"，文件，不需要所有文件

　　 一股腦的照單全收，只需要復(fù)制一些自己需要的即可，

1、 新建一個(gè)可用的工程（廢話:-D)，然后將庫函數(shù)的".c"".h"文件加入到自己的工程內(nèi)，并使其編譯通過；

最基本的工程所需要的庫函數(shù)文件有:

"startup_stm32f10x_hd.s" --> 啟動文件；

"system_stm32f10x.c" --> 常用來設(shè)置初始化時(shí)鐘，里面的“SystemInit()”函數(shù)在啟動文件內(nèi)調(diào)用；

"misc.c" --> Cotex-M3內(nèi)核常用的配置文件，譬如其內(nèi)包含NVIC配置庫函數(shù)等等；

"stm32f10x_rcc.c" --> 時(shí)鐘配置相關(guān)文件，里面包含了時(shí)鐘配置庫函數(shù)；

以DMA函數(shù)為例，將"stm32f10x_dma.c"，"stm32f10x_dma.h"文件放入指定文件夾內(nèi)，然后加入已有

　　　　　工程，在主函數(shù)內(nèi)嘗試調(diào)用最簡單的一個(gè)庫函數(shù)，并編譯通過，然后主函數(shù)刪除測試調(diào)用的庫函數(shù)。

2、 先別急著去看庫函數(shù)有哪些具體的庫函數(shù)，更別急著去跟庫函數(shù)的代碼，首先去看STM32的技術(shù)手冊關(guān)于DMA

　　　　 的內(nèi)容，弄清楚DMA是一個(gè)什么結(jié)構(gòu)，寄存器大概需要配置哪些，了解寄存器的時(shí)候不需要深究每一位，只需要

　　　　 明白每個(gè)寄存器控制哪些功能即可。

3、 看完了STM32手冊內(nèi)關(guān)于DMA的介紹，就可以去解析庫函數(shù)代碼了。

一般庫函數(shù)代碼的參數(shù)都是一個(gè)地址，一個(gè)包含配置信息的結(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);

每個(gè)庫函數(shù)之前都會有說明該庫函數(shù)的功能是什么，傳入的參數(shù)值得作用是什么，傳入什么參數(shù)會被認(rèn)定為有效

　　　　　參數(shù)以及返回值等等信息。

對于傳入的參數(shù)，有些會比較復(fù)雜，往往不是開頭的只言片語就能介紹完整，此時(shí)你需要深入跟進(jìn)庫函數(shù)代碼，

　　　　 看它拿這個(gè)參數(shù)具體做了什么。還是以此函數(shù)為例，第一個(gè)參數(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;

此時(shí)就很明了了，每個(gè)DMA通道都會有單獨(dú)獨(dú)立的寄存器，第一個(gè)參數(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.

*/

接著分析第二個(gè)參數(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;

這個(gè)一眼望去，真的是倆眼懵逼，還是按著套路來（23333），進(jìn)入庫函數(shù)看每個(gè)參數(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è)置給了一個(gè)叫CCR的寄存器，接著我們查查這個(gè)CCR寄存器都設(shè)置了什么：

DMA通道x配置寄存器(DMA_CCRx)，定位到這個(gè)寄存器，再加上每個(gè)參數(shù)32位所處的位數(shù)則可以確定該結(jié)構(gòu)體

　　　　 每個(gè)成員代表了什么，其他參數(shù)亦如此。

　　　　 確定了所有的參數(shù)所控制的功能后，這時(shí)就可以按照自己的需求去傳入正確的參數(shù)做相應(yīng)的配置。

這里我想插一句，既有些新學(xué)STM32的朋友，我也曾算是一個(gè)，就覺著使用庫函數(shù)而不去配置每個(gè)寄存器，會覺

　　　　 著心里不踏實(shí)，不能學(xué)到真正的STM32技術(shù)，而就剛剛所做的一系列動作來看，其實(shí)是誤解了，利用庫函數(shù)，同

　　　　 樣的你也得去深入的了解STM32的技術(shù)手冊，所以并不存在不能學(xué)到實(shí)際技術(shù)之說。

　　　　 技術(shù)一直在更新，老的技術(shù)也一直在沉淀穩(wěn)定，我們只需站在巨人的肩膀上，就可以看的更高更遠(yuǎn)，何苦還需要

　　　　 浪費(fèi)時(shí)間和精力自己去做別人已經(jīng)做好的事情呢。:-D

4、 解析完所有的函數(shù)后，此時(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/

至此，記錄完畢。