STM32學(xué)習(xí)筆記五:初識(shí)庫函數(shù)
固件庫文件分析:
1-匯編編寫的啟動(dòng)文件
startup_stm32f10x_hd.s:設(shè)置堆棧指針、設(shè)置PC指針、初始化中斷向量表、配置系統(tǒng)時(shí)鐘、對用C庫函數(shù)_main最終去到C的世界
2-時(shí)鐘配置文件
system_stm32f10x.c:把外部時(shí)鐘HSE=8M,經(jīng)過PLL倍頻為72M。
3-外設(shè)相關(guān)的
stm32f10x.h:實(shí)現(xiàn)了內(nèi)核之外的外設(shè)的寄存器映射
xxx:GPIO、USRAT、I2C、SPI、FSMC
stm32f10x_xx.c:外設(shè)的驅(qū)動(dòng)函數(shù)庫文件
stm32f10x_xx.h:存放外設(shè)的初始化結(jié)構(gòu)體,外設(shè)初始化結(jié)構(gòu)體成員的參數(shù)列表,外設(shè)固件庫函數(shù)的聲明
4-內(nèi)核相關(guān)的
CMSIS - Cortex 微控制器軟件接口標(biāo)準(zhǔn)
core_cm3.h:實(shí)現(xiàn)了內(nèi)核里面外設(shè)的寄存器映射
core_cm3.c:內(nèi)核外設(shè)的驅(qū)動(dòng)固件庫
NVIC(嵌套向量中斷控制器)、SysTick(系統(tǒng)滴答定時(shí)器)
misc.h
misc.c
5-頭文件的配置文件
stm32f10x_conf.h:頭文件的頭文件
//stm32f10x_usart.h
//stm32f10x_i2c.h
//stm32f10x_spi.h
//stm32f10x_adc.h
//stm32f10x_fsmc.h
......
6-專門存放中斷服務(wù)函數(shù)的C文件
stm32f10x_it.c
stm32f10x_it.h
中斷服務(wù)函數(shù)你可以隨意放在其他的地方,并不是一定要放在stm32f10x_it.c
#include "stm32f10x.h" // 相當(dāng)于51單片機(jī)中的 #include
int main(void)
{
// 來到這里的時(shí)候,系統(tǒng)的時(shí)鐘已經(jīng)被配置成72M。
}
我們還需要了解的是 core_cm3.h 頭文件中包含了“stdint.h” 這個(gè)頭文件,這是一個(gè)
ANSI C 文件,是獨(dú)立于處理器之外的,就像我們熟知的 C 語言頭文件 “stdio.h” 文件一
樣。位于 RVMDK 這個(gè)軟件的安裝目錄下,主要作用是提供一些類型定義。
啟動(dòng)文件
stm32f10x_it.c:這個(gè)文件是專門用來編寫中斷服務(wù)函數(shù)的,在我們修改前,這個(gè)文件已經(jīng)定義了一些系統(tǒng)異常(特殊中斷)的接口,其它普通中斷服務(wù)函數(shù)由我們自己添加。但是我們怎么知道這些中斷服務(wù)函數(shù)的接口如何寫?是不是可以自定義呢?答案當(dāng)然不是,這些都可以在匯編啟動(dòng)文件中找到,在學(xué)習(xí)中斷和啟動(dòng)文件的時(shí)候我們會(huì)詳細(xì)介紹。
system_stm32f10x.c:這個(gè)文件包含了 STM32 芯片上電后初始化系統(tǒng)時(shí)鐘、擴(kuò)展外部存儲(chǔ)器用的函數(shù),例如我們前兩章提到供啟動(dòng)文件調(diào)用的“SystemInit”函數(shù),用于上電后初始化時(shí)鐘,該函數(shù)的定義就存儲(chǔ)在 system_stm32f10x.c 文件。STM32F103 系列的芯片,調(diào)用庫的這個(gè) SystemInit 函數(shù)后,系統(tǒng)時(shí)鐘被初始化為 72MHz,如有需要可以修改這個(gè)文件的內(nèi)容,設(shè)置成自己所需的時(shí)鐘頻率,但鑒于保持庫的完整性,我們在做系統(tǒng)時(shí)鐘配置的時(shí)候會(huì)另外重寫時(shí)鐘配置函數(shù)。
stm32f10x_conf.h:這個(gè)文件被包含進(jìn) stm32f10x.h 文件。當(dāng)我們使用固件庫編程的時(shí)候,如果需要某個(gè)外設(shè)的驅(qū)動(dòng)庫,就需要包含該外設(shè)的頭文件:stm32f10x_ppp.h,包含一個(gè)還好,如果是用了多外設(shè),就需要包含多個(gè)頭文件,這不僅影響代碼美觀也不好管理,現(xiàn)我們用一個(gè)頭文件 stm32f10x_conf.h 把這些外設(shè)的頭文件都包含在里面,讓這個(gè)配置頭文件統(tǒng)一管理這些外設(shè)的頭文件,我們在應(yīng)用程序中只需要包含這個(gè)配置頭文件即可,我們又知道這個(gè)頭文件在 stm32f10x.h 的最后被包含,所以最終我們只需要包含 stm32f10x.h這個(gè)頭文件即可,非常方便。
stm32f10x_conf.h這個(gè)文件還可配置是否使用“斷言”編譯選項(xiàng)
在 ST 標(biāo)準(zhǔn)庫的函數(shù)中,一般會(huì)包含輸入?yún)?shù)檢查,即上述代碼中的“assert_param”宏,當(dāng)參數(shù)不符合要求時(shí),會(huì)調(diào)用“assert_failed”函數(shù),這個(gè)函數(shù)默認(rèn)是空的。實(shí)際開發(fā)中使用斷言時(shí),先通過定義 USE_FULL_ASSERT 宏來使能斷言,然后定義“assert_failed”函數(shù),通常我們會(huì)讓它調(diào)用 printf 函數(shù)輸出錯(cuò)誤說明。使能斷言后,程序運(yùn)行時(shí)會(huì)檢查函數(shù)的輸入?yún)?shù),當(dāng)軟件經(jīng)過測試,可發(fā)布時(shí),會(huì)取消 USE_FULL_ASSERT宏來去掉斷言功能,使程序全速運(yùn)行。