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

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

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

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

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

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

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

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

　　STM32F101xx 和 STM32F103xx 在整個文檔中被寫作 STM32F101x。