本文檔的主要內(nèi)容詳細(xì)介紹的是STM32F4xx HAL庫函數(shù)API的詳細(xì)資料說明。

　　STM32CubeTM是一個STMicroelectronics的原始計劃，通過減少開發(fā)工作、時間和成本來簡化開發(fā)人員的生活。STM32CubeTM涵蓋了STM32投資組合。STM32CubeTM Version 1.x包括：STM32CubeMX，一個允許使用圖形向?qū)蒀初始化代碼的圖形化軟件配置工具。一個全面的嵌入式軟件平臺，按系列交付（如STM32CubeF4用于STM32F4系列）–STM32Cube HAL，一個STM32抽象層嵌入式軟件，確保在STM32產(chǎn)品組合中最大程度的可移植性–一組一致的中間件組件，如RTOS、USB、TCP/IP、圖形–所有嵌入式提供了一整套示例的軟件實(shí)用程序。HAL驅(qū)動層提供了一組通用的多實(shí)例簡單api（應(yīng)用程序編程接口）來與上層（應(yīng)用程序、庫和棧）交互，它由通用api和擴(kuò)展api組成。它直接圍繞一個通用體系結(jié)構(gòu)構(gòu)建，并允許諸如中間件層之類的構(gòu)建層在不深入了解如何使用MCU的情況下實(shí)現(xiàn)其功能。這種結(jié)構(gòu)提高了庫代碼的可重用性，并保證了在其他設(shè)備上的易移植性。HAL驅(qū)動程序包括一整套現(xiàn)成的api，這些api簡化了用戶應(yīng)用程序的實(shí)現(xiàn)。例如，通信外圍設(shè)備包含用于初始化和配置外圍設(shè)備、基于輪詢管理數(shù)據(jù)傳輸、處理中斷或DMA以及管理通信錯誤的api。HAL驅(qū)動程序API分為兩類：為所有STM32系列提供通用和通用功能的通用API，以及為給定系列或零件號提供特定和自定義功能的擴(kuò)展API。HAL驅(qū)動程序是面向功能的，而不是面向IP的。例如，定時器api按照IP提供的功能分為基本定時器、捕獲、脈沖寬度調(diào)制（PWM）等幾類，驅(qū)動源代碼采用嚴(yán)格的ANSI-C語言編寫，使其獨(dú)立于開發(fā)工具。使用CodeSonarTM靜態(tài)分析工具對其進(jìn)行檢查。它有完整的文件記錄，符合MISRA-C 2004。HAL驅(qū)動層通過檢查所有函數(shù)的輸入值來實(shí)現(xiàn)運(yùn)行時故障檢測。這種動態(tài)檢查有助于增強(qiáng)固件的健壯性。運(yùn)行時檢測也適用于用戶應(yīng)用程序的開發(fā)和調(diào)試。本用戶手冊的結(jié)構(gòu)如下：HAL驅(qū)動程序概述；每個外圍驅(qū)動程序的詳細(xì)說明：配置結(jié)構(gòu)、功能以及如何使用給定的API構(gòu)建應(yīng)用程序。

?