第2章硬件抽象层（HAL）设计

第2章：硬件抽象层（HAL）设计：针对STM32MP157平台的外设驱动封装与BSP适配

好，咱们直接进入正题。硬件抽象层，说白了就是给上层RTOS和应用程序一个「统一接口」，让它们不用关心底下是STM32还是别的芯片。我这些年做麻醉机项目，最怕的就是换主控芯片——那简直是噩梦。但有了好的HAL设计，噩梦就能变成小感冒。

2.1 为什么需要硬件抽象层？

你想想看，麻醉机里要控制的东西太多了：气阀、流量传感器、压力传感器、步进电机、报警蜂鸣器……每个外设的寄存器都不一样。如果RTOS直接操作寄存器，那代码就成了一锅粥。

我个人习惯，先把硬件操作分成三层：

底层驱动：直接读写寄存器，跟芯片手册打交道
HAL封装：提供统一的API，比如 hal_uart_send()、hal_timer_start()
BSP适配：把HAL接口绑定到具体的板级资源上，比如哪个UART接哪个外设

这样做的好处很明显：哪天你要把STM32MP157换成别的芯片，只需要重写底层驱动和BSP，上层RTOS和业务代码几乎不用动。我在一个呼吸机项目里就吃过这个亏——当时没做HAL，换芯片换了三个月，差点被老板骂死。

2.2 STM32MP157的外设特点

STM32MP157是个双核异构芯片：一个Cortex-A7跑Linux，一个Cortex-M4跑RTOS。咱们做麻醉机，RTOS通常跑在M4核上，负责实时控制。A7核跑人机界面和网络通信。

M4核能访问的外设包括：

外设类别	典型外设	麻醉机用途
定时器	TIM2~TIM8	PWM控制气阀、周期性采样
UART	USART1~USART8	与传感器模块通信、调试日志
SPI	SPI1~SPI5	ADC/DAC芯片、显示屏
I2C	I2C1~I2C5	温度传感器、EEPROM
GPIO	GPIOA~GPIOK	按键、LED、报警输出
ADC	ADC1~ADC2	压力传感器、流量传感器

嗯，这里要注意：M4核不能直接访问所有外设，有些外设被A7核占用了。所以BSP适配时，一定要确认外设的「所有权」。我曾经在调试时发现SPI2死活不工作，查了两天才发现是A7核的Linux驱动把它占用了——那叫一个郁闷。

2.3 HAL接口设计原则

我总结了几条原则，供你参考：

接口要简单：每个外设的API不要超过5个函数。比如UART就是初始化、发送、接收、中断回调、状态查询。
参数要通用：不要暴露寄存器细节。比如初始化参数用结构体，里面放波特率、数据位、停止位这些通用参数。
支持回调：中断处理不要写在HAL里，让上层注册回调函数。这样RTOS的任务切换更灵活。
错误处理要统一：所有函数返回统一的错误码，比如 HAL_OK、HAL_ERROR、HAL_TIMEOUT。

举个例子，UART的HAL接口可以这样设计：

/* hal_uart.h */
typedef struct {
    uint32_t baudrate;
    uint8_t data_bits;    /* 7 or 8 */
    uint8_t stop_bits;    /* 1 or 2 */
    uint8_t parity;       /* 0: none, 1: odd, 2: even */
} hal_uart_config_t;

typedef void (*hal_uart_rx_cb_t)(uint8_t data);

int hal_uart_init(uint8_t uart_id, hal_uart_config_t *config);
int hal_uart_send(uint8_t uart_id, uint8_t *data, uint32_t len);
int hal_uart_receive(uint8_t uart_id, uint8_t *data, uint32_t len, uint32_t timeout);
int hal_uart_set_rx_callback(uint8_t uart_id, hal_uart_rx_cb_t cb);
int hal_uart_get_status(uint8_t uart_id);

你看，这个接口完全看不出底层是STM32还是别的芯片。上层RTOS只管调用就行。

2.4 BSP适配实战：以UART为例

BSP适配就是把HAL接口跟具体的硬件引脚、时钟、中断号绑定。STM32MP157的M4核有专门的「资源分配表」，咱们得照着来。

我以USART1为例，它在M4核上的默认引脚是：

TX: PA9
RX: PA10
中断号: 37

BSP适配的代码大概长这样：

/* bsp_uart.c */
#include "hal_uart.h"
#include "stm32mp1xx_hal.h"

static UART_HandleTypeDef huart1;

int bsp_uart1_init(hal_uart_config_t *config) {
    /* 使能时钟 */
    __HAL_RCC_USART1_CLK_ENABLE();
    __HAL_RCC_GPIOA_CLK_ENABLE();

    /* 配置GPIO */
    GPIO_InitTypeDef gpio = {0};
    gpio.Pin = GPIO_PIN_9 | GPIO_PIN_10;
    gpio.Mode = GPIO_MODE_AF_PP;
    gpio.Alternate = GPIO_AF7_USART1;
    HAL_GPIO_Init(GPIOA, &gpio);

    /* 配置UART */
    huart1.Instance = USART1;
    huart1.Init.BaudRate = config->baudrate;
    huart1.Init.WordLength = (config->data_bits == 8) ? UART_WORDLENGTH_8B : UART_WORDLENGTH_7B;
    huart1.Init.StopBits = (config->stop_bits == 1) ? UART_STOPBITS_1 : UART_STOPBITS_2;
    huart1.Init.Parity = config->parity;
    huart1.Init.Mode = UART_MODE_TX_RX;
    huart1.Init.HwFlowCtl = UART_HWCONTROL_NONE;

    if (HAL_UART_Init(&huart1) != HAL_OK) {
        return -1;
    }

    /* 使能中断 */
    HAL_NVIC_SetPriority(USART1_IRQn, 5, 0);
    HAL_NVIC_EnableIRQ(USART1_IRQn);

    return 0;
}

这里有个坑：STM32MP157的M4核中断优先级只有两个位（0~3），跟A7核不一样。我刚开始移植时直接用了默认的优先级，结果中断响应乱套了。后来才发现M4核的NVIC只支持4级优先级——嗯，这个一定要记住。

2.5 中断处理与RTOS的配合

RTOS里中断处理是个敏感话题。我的做法是：

中断服务函数（ISR）里只做最少的操作，比如把数据放到一个环形缓冲区
然后通过信号量或消息队列通知RTOS任务来处理
HAL层只负责注册中断回调，不直接调用RTOS API

举个例子：

/* 中断服务函数 */
void USART1_IRQHandler(void) {
    uint8_t data;
    if (__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RXNE)) {
        data = (uint8_t)(huart1.Instance->DR & 0xFF);
        /* 调用HAL回调，把数据传给上层 */
        if (uart1_rx_callback) {
            uart1_rx_callback(data);
        }
    }
}

/* 上层注册的回调 */
void my_uart_rx_callback(uint8_t data) {
    /* 把数据放入环形缓冲区 */
    ringbuf_put(&rx_buf, data);
    /* 释放信号量，通知任务处理 */
    osSemaphoreRelease(rx_sem);
}

这样做的好处是：HAL层完全不依赖RTOS，可以单独测试。我在一个项目里就靠这个特性，先在裸机上把驱动调通，再挂到RTOS上，省了不少调试时间。

2.6 避坑指南

我曾经踩过的坑：

时钟配置冲突：M4核和A7核共享时钟树，千万别在M4核代码里乱改系统时钟。我建议用STM32CubeMX生成时钟配置，然后只读不改。
GPIO复用冲突：同一个引脚可能被多个外设复用。比如PA9既是USART1_TX，也是SPI1_NSS。BSP适配时一定要查清楚。
中断优先级分组：M4核的NVIC优先级分组是固定的，不能像A7核那样随意设置。我建议统一用4级优先级，别搞复杂了。
DMA缓冲区对齐：STM32MP157的DMA要求缓冲区地址按4字节对齐。我遇到过因为缓冲区没对齐导致DMA传输数据错位的问题，查了整整一天。

2.7 小结

硬件抽象层设计，说白了就是「隔离变化」。把芯片相关的细节藏在HAL和BSP后面，让上层代码干干净净。我做了这么多年嵌入式，越来越觉得：好的架构不是写出来的，是「设计」出来的。花一周时间设计HAL，能省下后面三个月的调试时间——这笔账，怎么算都划算。

我的个人建议：

刚开始做HAL时，别追求完美。先实现最常用的几个外设（UART、TIM、GPIO），跑通一个简单的RTOS任务再说。后面再慢慢加SPI、I2C这些。一口吃不成胖子，但一口一口吃，总能吃完。

下一章咱们聊聊RTOS内核移植的具体步骤，包括中断向量表重定向、系统时钟节拍配置这些硬骨头。到时候我会拿一个实际项目里的坑来举例——保证让你印象深刻。

📚 课程目录