本手冊(cè)介紹了 32 位基于 ARM 微控制器 STM32F101xx 與 STM32F103xx 的固件函數(shù)庫(kù)。

　　該函數(shù)庫(kù)是一個(gè)固件函數(shù)包，它由程序、數(shù)據(jù)結(jié)構(gòu)和宏組成，包括了微控制器所有外設(shè)的性能特征。該函數(shù)庫(kù)還包括每一個(gè)外設(shè)的驅(qū)動(dòng)描述和應(yīng)用實(shí)例。通過(guò)使用本固件函數(shù)庫(kù)，無(wú)需深入掌握細(xì)節(jié)，用戶也可以輕松應(yīng)用每一個(gè)外設(shè)。因此，使用本固態(tài)函數(shù)庫(kù)可以大大減少用戶的程序編寫時(shí)間，進(jìn)而降低開發(fā)成本。

　　每個(gè)外設(shè)驅(qū)動(dòng)都由一組函數(shù)組成，這組函數(shù)覆蓋了該外設(shè)所有功能。每個(gè)器件的開發(fā)都由一個(gè)通用 API （application programming interface 應(yīng)用編程界面）驅(qū)動(dòng)，API 對(duì)該驅(qū)動(dòng)程序的結(jié)構(gòu)，函數(shù)和參數(shù)名稱都進(jìn)行了標(biāo)準(zhǔn)化。

　　所有的驅(qū)動(dòng)源代碼都符合“Strict ANSI-C”標(biāo)準(zhǔn)（項(xiàng)目于范例文件符合擴(kuò)充 ANSI-C 標(biāo)準(zhǔn)）。我們已經(jīng)把驅(qū)動(dòng)源代碼文檔化，他們同時(shí)兼容 MISRA-C 2004 標(biāo)準(zhǔn)（根據(jù)需要，我們可以提供兼容矩陣）。由于整個(gè)固態(tài)函數(shù)庫(kù)按照“Strict ANSI-C”標(biāo)準(zhǔn)編寫，它不受不同開發(fā)環(huán)境的影響。僅對(duì)話啟動(dòng)文件取決于開發(fā)環(huán)境。

　　該固態(tài)函數(shù)庫(kù)通過(guò)校驗(yàn)所有庫(kù)函數(shù)的輸入值來(lái)實(shí)現(xiàn)實(shí)時(shí)錯(cuò)誤檢測(cè)。該動(dòng)態(tài)校驗(yàn)提高了軟件的魯棒性。實(shí)時(shí)檢測(cè)適合于用戶應(yīng)用程序的開發(fā)和調(diào)試。但這會(huì)增加了成本，可以在最終應(yīng)用程序代碼中移去，以優(yōu)化代碼大小和執(zhí)行速度。想要了解更多細(xì)節(jié)，請(qǐng)參閱 Section 2.5。

　　因?yàn)樵摴碳?kù)是通用的，并且包括了所有外設(shè)的功能，所以應(yīng)用程序代碼的大小和執(zhí)行速度可能不是最優(yōu)的。對(duì)大多數(shù)應(yīng)用程序來(lái)說(shuō)，用戶可以直接使用之，對(duì)于那些在代碼大小和執(zhí)行速度方面有嚴(yán)格要求的應(yīng)用程序，該固件庫(kù)驅(qū)動(dòng)程序可以作為如何設(shè)置外設(shè)的一份參考資料，根據(jù)實(shí)際需求對(duì)其進(jìn)行調(diào)整。

　　此份固件庫(kù)用戶手冊(cè)的整體架構(gòu)如下： ?

　　定義，文檔約定和固態(tài)函數(shù)庫(kù)規(guī)則。

　　? 固態(tài)函數(shù)庫(kù)概述（包的內(nèi)容，庫(kù)的架構(gòu)），安裝指南，庫(kù)使用實(shí)例。

　　? 固件庫(kù)具體描述：設(shè)置架構(gòu)和每個(gè)外設(shè)的函數(shù)。

　　STM32F101xx 和 STM32F103xx 在整個(gè)文檔中被寫作 STM32F101x。