EEPW论坛

1. 文档和库规范本

用户手册和固态函数库按照以下章节所描述的规范编写。

1.1缩写

缩写外设/单元

ADC 模数转换器

BKP 备份寄存器

CAN 控制器局域网模块

DMA 直接内存存取控制器

EXTI 外部中断事件控制器

FLASH 闪存存储器

GPIO 通用输入输出

I2C 内部集成电路

IWDG 独立看门狗

NVIC 嵌套中断向量列表控制器

PWR 电源/功耗控制

RCC 复位与时钟控制器

RTC 实时时钟

SPI 串行外设接口

SysTick 系统嘀嗒定时器

TIM 通用定时器

TIM1 高级控制定时器

USART 通用同步异步接收发射端

WWDG 窗口看门狗

1.2命名规则

固态函数库遵从以下命名规则 PPP表示任一外设缩写，例如：ADC。更多缩写相关信息参阅章节1.1 缩写

系统、源程序文件和头文件命名都以“stm32f10x_hal”作为开头，例如：stm32f10x_hal_conf.h。

常量仅被应用于一个文件的，定义于该文件中；被应用于多个文件的，在对应头文件中定义。所有常量都由英文字母大写书写。寄存器作为常量处理。他们的命名都由英文字母大写书写。

在大多数情况下，他们采用与缩写规范与本用户手册一致。

外设函数的命名以HAL加该外设的缩写加下划线为开头。每个单词的第一个字母都由英文字母大写书写，例如：HAL_I2C_Master_Transmit。在函数名中，以HAL开头加下划线加外设缩写，用以分隔外设缩写和函数名的其它部分。名为HAL_PPP_Init的函数，其功能是根据HAL_StatusTypeDef中指定的参数，初始化外设PPP，例如HAL_I2C_Init.

2. HAL函数库文件结构

2.1压缩包描述

STM32Fxx HAL函数库被压缩在一个zip文件中。解压该文件会产生一个文件夹：STM32Cube_FW_F1_V1.0.0，包含如下所示的子文件夹：

STM32 HAL固件库是Hardware Abstraction Layer的缩写，中文名称是：硬件抽象层。HAL库是ST公司为STM32的MCU最新推出的抽象层嵌入式软件，为更方便的

实现跨STM32产品的最大可移植性。HAL库的推出，可以说ST也慢慢的抛弃了原来的标准固件库，这也使得很多老用户不满。但是HAL库推出的同时，也加入了很多

第三方的中间件，有RTOS，USB，TCP / IP和图形等等。

和标准库对比起来，STM32的HAL库更加的抽象，ST最终的目的是要实现在STM32序列MCU之间无缝移植，甚至在其他MCU也能实现快速移植。

来源： 整理文章为传播相关技术，网络版权归原作者所有，如有侵权，请联系删除。