📖 第 7 章：认识HAL库（Knowing HAL Library）

7.1 初识 STM32 HAL 库

HAL = Hardware Abstraction Layer，硬件抽象层。它把寄存器操作封装成「人类语言」函数：

HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);   // 点亮 PA5

HAL 库优势：

• 可移植：同一段代码在 F1/F4/F7/H7 间几乎不用改；
• 标准化：函数命名规则一致，学一个会一类；
• 配合 CubeMX：图形化配置自动生成初始化代码。

7.2 HAL 库驱动包

STM32Cube_FW_F4 固件包结构：

STM32Cube_FW_F4_V1.x.x/
├── Drivers/
│   ├── BSP/                # 板级支持包（LCD/SDRAM 等）
│   ├── CMSIS/              # ARM 内核头 + 启动文件
│   └── STM32F4xx_HAL_Driver/  # HAL 库主体
│       ├── Inc/            # 头文件
│       └── Src/            # 源文件
├── Middlewares/            # 中间件（FreeRTOS/LwIP/FatFs/USB）
├── Projects/               # 例程
└── Utilities/              # 工具（LCD 字模/PC 测试软件）

7.3 HAL 库框架结构

HAL 库主要文件：

分层：

1. 应用层：用户 main.c；
2. HAL 层：HAL_GPIO_Init 等通用 API；
3. MSP 层：HAL_GPIO_MspInit 时钟/GPIO/DMA 配置；
4. 寄存器层：HAL 内部直接写寄存器。

7.4 如何使用 HAL 库

典型流程：

1. CubeMX 配置 → 生成 main.c 骨架；
2. 在 MSP 回调 HAL_MspInit() 里加硬件相关配置；
3. 调用 外设初始化函数 HAL_GPIO_Init()；
4. 在 while 循环或回调里调用 外设操作函数；
5. 中断处理统一在 xxx_IRQHandler 里调 HAL_xxx_IRQHandler + 用户回调。

例：USART 收发字符串：

HAL_UART_Transmit(&huart1, (uint8_t *)"Hello\n", 6, 100);
HAL_UART_Receive_IT(&huart1, rx_buf, 1);          // 启动接收中断
// 中断回调
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) {
    if (huart->Instance == USART1) {
        // 处理 rx_buf[0]
        HAL_UART_Receive_IT(&huart1, rx_buf, 1);  // 重新开启
    }
}

7.5 HAL 库使用注意事项