STM32F4xx HAL库函数API的详细资料说明

本文档的主要内容详细介绍的是STM32F4xx HAL库函数API的详细资料说明。

　　STM32CubeTM是一个STMicroelectronics的原始计划，通过减少开发工作、时间和成本来简化开发人员的生活。STM32CubeTM涵盖了STM32投资组合。STM32CubeTM Version 1.x包括：STM32CubeMX，一个允许使用图形向导生成C初始化代码的图形化软件配置工具。一个全面的嵌入式软件平台，按系列交付（如STM32CubeF4用于STM32F4系列）–STM32Cube HAL，一个STM32抽象层嵌入式软件，确保在STM32产品组合中最大程度的可移植性–一组一致的中间件组件，如RTOS、USB、TCP/IP、图形–所有嵌入式提供了一整套示例的软件实用程序。HAL驱动层提供了一组通用的多实例简单api（应用程序编程接口）来与上层（应用程序、库和栈）交互，它由通用api和扩展api组成。它直接围绕一个通用体系结构构建，并允许诸如中间件层之类的构建层在不深入了解如何使用MCU的情况下实现其功能。这种结构提高了库代码的可重用性，并保证了在其他设备上的易移植性。HAL驱动程序包括一整套现成的api，这些api简化了用户应用程序的实现。例如，通信外围设备包含用于初始化和配置外围设备、基于轮询管理数据传输、处理中断或DMA以及管理通信错误的api。HAL驱动程序API分为两类：为所有STM32系列提供通用和通用功能的通用API，以及为给定系列或零件号提供特定和自定义功能的扩展API。HAL驱动程序是面向功能的，而不是面向IP的。例如，定时器api按照IP提供的功能分为基本定时器、捕获、脉冲宽度调制（PWM）等几类，驱动源代码采用严格的ANSI-C语言编写，使其独立于开发工具。使用CodeSonarTM静态分析工具对其进行检查。它有完整的文件记录，符合MISRA-C 2004。HAL驱动层通过检查所有函数的输入值来实现运行时故障检测。这种动态检查有助于增强固件的健壮性。运行时检测也适用于用户应用程序的开发和调试。本用户手册的结构如下：HAL驱动程序概述；每个外围驱动程序的详细说明：配置结构、功能以及如何使用给定的API构建应用程序。