資源描述:
《stm32固件庫使用手冊的中文翻譯》由會員上傳分享,免費在線閱讀,更多相關(guān)內(nèi)容在教育資源-天天文庫。
1、UM0427用戶手冊32位基于ARM微控制器STM32F101xx與STM32F103xx固件函數(shù)庫介紹本手冊介紹了32位基于ARM微控制器STM32F101xx與STM32F103xx的固件函數(shù)庫。該函數(shù)庫是一個固件函數(shù)包,它由程序、數(shù)據(jù)結(jié)構(gòu)和宏組成,包括了微控制器所有外設(shè)的性能特征。該函數(shù)庫還包括每一個外設(shè)的驅(qū)動描述和應(yīng)用實例。通過使用本固件函數(shù)庫,無需深入掌握細節(jié),用戶也可以輕松應(yīng)用每一個外設(shè)。因此,使用本固態(tài)函數(shù)庫可以大大減少用戶的程序編寫時間,進而降低開發(fā)成本。每個外設(shè)驅(qū)動都由一組函數(shù)組
2、成,這組函數(shù)覆蓋了該外設(shè)所有功能。每個器件的開發(fā)都由一個通用API(applicationprogramminginterface應(yīng)用編程界面)驅(qū)動,API對該驅(qū)動程序的結(jié)構(gòu),函數(shù)和參數(shù)名稱都進行了標準化。所有的驅(qū)動源代碼都符合“StrictANSI-C”標準(項目于范例文件符合擴充ANSI-C標準)。我們已經(jīng)把驅(qū)動源代碼文檔化,他們同時兼容MISRA-C2004標準(根據(jù)需要,我們可以提供兼容矩陣)。由于整個固態(tài)函數(shù)庫按照“StrictANSI-C”標準編寫,它不受不同開發(fā)環(huán)境的影響。僅對話啟動
3、文件取決于開發(fā)環(huán)境。該固態(tài)函數(shù)庫通過校驗所有庫函數(shù)的輸入值來實現(xiàn)實時錯誤檢測。該動態(tài)校驗提高了軟件的魯棒性。實時檢測適合于用戶應(yīng)用程序的開發(fā)和調(diào)試。但這會增加了成本,可以在最終應(yīng)用程序代碼中移去,以優(yōu)化代碼大小和執(zhí)行速度。想要了解更多細節(jié),請參閱Section2.5。因為該固件庫是通用的,并且包括了所有外設(shè)的功能,所以應(yīng)用程序代碼的大小和執(zhí)行速度可能不是最優(yōu)的。對大多數(shù)應(yīng)用程序來說,用戶可以直接使用之,對于那些在代碼大小和執(zhí)行速度方面有嚴格要求的應(yīng)用程序,該固件庫驅(qū)動程序可以作為如何設(shè)置外設(shè)的一份
4、參考資料,根據(jù)實際需求對其進行調(diào)整。此份固件庫用戶手冊的整體架構(gòu)如下:n定義,文檔約定和固態(tài)函數(shù)庫規(guī)則。n固態(tài)函數(shù)庫概述(包的內(nèi)容,庫的架構(gòu)),安裝指南,庫使用實例。n固件庫具體描述:設(shè)置架構(gòu)和每個外設(shè)的函數(shù)。STM32F101xx和STM32F103xx在整個文檔中被寫作STM32F101x。譯文英文原版為UM0427Oct.2007Rev2,譯文僅供參考,與英文版沖突的,以英文版為準文檔和庫規(guī)范1.文檔和庫規(guī)范本用戶手冊和固態(tài)函數(shù)庫按照以下章節(jié)所描述的規(guī)范編寫。1.1縮寫Table1.本文檔所
5、有縮寫定義縮寫外設(shè)/單元ADC模數(shù)轉(zhuǎn)換器BKP備份寄存器CAN控制器局域網(wǎng)模塊DMA直接內(nèi)存存取控制器EXTI外部中斷事件控制器FLASH閃存存儲器GPIO通用輸入輸出I2C內(nèi)部集成電路IWDG獨立看門狗NVIC嵌套中斷向量列表控制器PWR電源/功耗控制RCC復(fù)位與時鐘控制器RTC實時時鐘SPI串行外設(shè)接口SysTick系統(tǒng)嘀嗒定時器TIM通用定時器TIM1高級控制定時器USART通用同步異步接收發(fā)射端WWDG窗口看門狗1.2命名規(guī)則固態(tài)函數(shù)庫遵從以下命名規(guī)則:PPP表示任一外設(shè)縮寫,例如:ADC
6、。更多縮寫相關(guān)信息參閱章節(jié)1.1縮寫。系統(tǒng)、源程序文件和頭文件命名都以“stm32f10x_”作為開頭,例如:stm32f10x_conf.h。常量僅被應(yīng)用于一個文件的,定義于該文件中;被應(yīng)用于多個文件的,在對應(yīng)頭文件中定義。所有常量都由英文字母大寫書寫。寄存器作為常量處理。他們的命名都由英文字母大寫書寫。在大多數(shù)情況下,他們采用與縮寫規(guī)范與本用戶手冊一致。譯文英文原版為UM0427Oct.2007Rev2,譯文僅供參考,與英文版沖突的,以英文版為準文檔和庫規(guī)范外設(shè)函數(shù)的命名以該外設(shè)的縮寫加下劃線
7、為開頭。每個單詞的第一個字母都由英文字母大寫書寫,例如:SPI_SendData。在函數(shù)名中,只允許存在一個下劃線,用以分隔外設(shè)縮寫和函數(shù)名的其它部分。名為PPP_Init的函數(shù),其功能是根據(jù)PPP_InitTypeDef中指定的參數(shù),初始化外設(shè)PPP,例如TIM_Init.名為PPP_DeInit的函數(shù),其功能為復(fù)位外設(shè)PPP的所有寄存器至缺省值,例如TIM_DeInit.名為PPP_StructInit的函數(shù),其功能為通過設(shè)置PPP_InitTypeDef結(jié)構(gòu)中的各種參數(shù)來定義外設(shè)的功能,例如
8、:USART_StructInit.名為PPP_Cmd的函數(shù),其功能為使能或者失能外設(shè)PPP,例如:SPI_Cmd.名為PPP_ITConfig的函數(shù),其功能為使能或者失能來自外設(shè)PPP某中斷源,例如:RCC_ITConfig.名為PPP_DMAConfig的函數(shù),其功能為使能或者失能外設(shè)PPP的DMA接口,例如:TIM1_DMAConfig.用以配置外設(shè)功能的函數(shù),總是以字符串“Config”結(jié)尾,例如GPIO_PinRemapConfig.名為PPP_GetFlagStatus