第2章：硬件抽象层(HAL)设计原则：分层思想、接口隔离、可移植性

好，咱们进入正题。上一章聊了为什么需要软件架构，这一章我带你看看硬件抽象层——也就是HAL——到底该怎么设计。

说白了，HAL就是给上层应用和底层硬件之间加了一层“翻译官”。你想想看，没有这层翻译，你的业务代码就得直接操作寄存器。换一颗MCU，所有代码重写。这种事我干过，真的痛。

2.1 分层思想：别让上层知道底层长什么样

分层，是嵌入式软件最基础也最重要的原则。我个人的习惯是：每一层只关心自己该关心的事。

来看一个典型的分层结构：

每一层只调用下一层的接口，不能跨层。我在项目中遇到过有人直接在应用层写GPIO寄存器，结果换芯片时全盘崩溃。嗯，这就是不守规矩的代价。

2.2 接口隔离：只暴露该暴露的

接口隔离原则，说白了就是：不要给上层不需要的东西。

举个例子。你写一个UART驱动，底层有几十个寄存器。但上层应用只需要“发送一个字节”和“接收一个字节”。那你HAL接口就只暴露这两个函数。其他的——波特率配置、中断使能、FIFO设置——都藏在内部。

我曾经见过一个HAL，把UART的所有寄存器读写函数都暴露出来了。结果应用工程师直接调了寄存器，绕过了HAL的锁机制。调试了三天才发现是竞态问题。你说冤不冤？

来看一个接口隔离的对比：

不好的设计	好的设计
HAL_UART_SetBaud(uint32_t reg_val)	HAL_UART_Init(UART_Handle_t *handle)
HAL_UART_WriteReg(uint8_t reg, uint8_t val)	HAL_UART_Send(uint8_t *data, uint16_t len)
HAL_UART_ReadReg(uint8_t reg)	HAL_UART_Receive(uint8_t *data, uint16_t len)
HAL_UART_EnableIRQ()	HAL_UART_RegisterCallback(UART_Callback_t cb)

左边那列，每个函数都暴露了硬件细节。右边那列，上层根本不知道底层是寄存器还是DMA。这才是隔离。

2.3 可移植性：换芯片不换代码

可移植性，是HAL存在的终极目标。我做过一个项目，从STM32F1移植到GD32F3，只改了HAL层的实现文件，上层代码一行没动。那种感觉，真的很爽。

要做到这一点，有几个关键点：

• 接口标准化：所有外设的接口命名、参数类型、返回值格式统一
• 硬件参数结构体：把引脚、时钟、中断号等硬件相关参数封装成结构体
• 条件编译隔离：用宏定义区分不同MCU平台
• 避免直接依赖：不要在HAL头文件里包含MCU厂商的头文件

来看一个可移植的GPIO HAL接口设计：

// hal_gpio.h — 这个头文件在所有平台上都一样
#ifndef HAL_GPIO_H
#define HAL_GPIO_H

#include <stdint.h>

typedef struct {
    uint8_t  port;      // 端口号，0=A, 1=B, ...
    uint8_t  pin;       // 引脚号，0-15
    uint8_t  mode;      // 输入/输出/复用/模拟
    uint8_t  pull;      // 上拉/下拉/浮空
    uint8_t  speed;     // 低速/中速/高速
} GPIO_Config_t;

void HAL_GPIO_Init(GPIO_Config_t *config);
void HAL_GPIO_Write(GPIO_Config_t *config, uint8_t level);
uint8_t HAL_GPIO_Read(GPIO_Config_t *config);
void HAL_GPIO_Toggle(GPIO_Config_t *config);

#endif

然后在不同平台上分别实现：

// hal_gpio_stm32f1.c — STM32F1平台实现
#include "hal_gpio.h"

void HAL_GPIO_Init(GPIO_Config_t *config) {
    // 操作STM32F1的GPIO寄存器
    RCC->APB2ENR |= (1 << (config->port + 2));
    // ... 具体寄存器配置
}

// hal_gpio_gd32f3.c — GD32F3平台实现
#include "hal_gpio.h"

void HAL_GPIO_Init(GPIO_Config_t *config) {
    // 操作GD32F3的GPIO寄存器
    rcu_periph_clock_enable(RCU_GPIOA + config->port);
    // ... 具体寄存器配置
}

2.4 三个原则的协同关系

分层、接口隔离、可移植性，这三个原则不是孤立的。它们互相支撑：

• 分层为接口隔离提供了结构基础
• 接口隔离让可移植性更容易实现
• 可移植性反过来验证分层和隔离是否合理

我个人的习惯是：先画分层图，再定义接口，最后写实现。如果发现某个接口在移植时需要大改，说明分层或隔离没做好。