刚接手一个项目时，我遇到了一个典型问题：同一套传感器驱动代码，在x86工控机上跑得完美，移植到ARM Cortex-M内核的MCU后，读取温湿度数据的时序全部乱掉。原因很简单——底层I2C操作的实现完全不同。这个坑促使我重新思考硬件抽象层的价值。

什么是硬件抽象层

在ROS2嵌入式生态中，HAL承担着桥梁角色：向上为节点提供统一的传感器驱动、执行器控制接口；向下屏蔽MCU型号、外设IP核的差异。这样你写的电机控制代码，今天在STM32F4上验证，明天就能原封不动地部署到GD32或AT32上。

HAL与BSP的关系

维度	硬件抽象层 (HAL)	板级支持包 (BSP)
关注点	外设功能的接口标准化	具体板卡的初始化与配置
可移植性	跨MCU型号通用	绑定特定开发板（引脚映射、时钟配置）
示例	HAL_I2C_Master_Transmit()	BSP_LED_Init(LED3)
层次	更接近应用层	更接近硬件层

STM32的HAL库是典型例子，但它包含太多硬件细节。在ROS2微ROS框架中，我们需要的HAL更加轻量——只暴露read()、write()、ioctl()这类POSIX风格接口。

接口设计原则

• 统一签名：所有外设的初始化、读、写、控制函数使用相同的参数模式
• 错误码标准化：用返回值和errno表达失败原因，而非硬件状态寄存器
• 无状态设计：HAL函数不依赖全局变量，所有上下文通过设备句柄传递
• 性能可预测：接口设计需考虑实时性，避免动态内存分配和阻塞调用

实现一个轻量级HAL

让我们从零构建一个适合ROS2微代理的HAL。核心思路是将每个外设抽象为一个设备对象，通过函数指针表调用底层操作。

// hal_device.h - 设备抽象接口
typedef struct {
    int (*init)(void *config);
    int (*read)(uint8_t *buf, uint32_t len);
    int (*write)(const uint8_t *buf, uint32_t len);
    int (*ioctl)(uint32_t cmd, void *arg);
} hal_dev_ops_t;

typedef struct {
    const char *name;
    hal_dev_ops_t *ops;
    void *priv;       // 硬件特定数据指针
} hal_device_t;

priv指针是关键——它指向硬件相关的寄存器基地址或外设句柄，这样同一个I2C接口可以操作不同总线实例，只需传入不同的priv实例。

设备注册与查找

你需要一个注册表来管理所有抽象设备。我通常用静态数组，避免动态分配的风险。

#define HAL_MAX_DEVICES 16
static hal_device_t device_table[HAL_MAX_DEVICES];
static uint8_t num_devices = 0;

int hal_device_register(const char *name, hal_dev_ops_t *ops, void *priv) {
    if (num_devices >= HAL_MAX_DEVICES) return -1;
    device_table[num_devices].name = name;
    device_table[num_devices].ops  = ops;
    device_table[num_devices].priv = priv;
    return num_devices++;
}

hal_device_t *hal_device_find(const char *name) {
    for (int i = 0; i < num_devices; i++)
        if (strcmp(device_table[i].name, name) == 0)
            return &device_table[i];
    return NULL;
}

移植到新硬件时，你只需编写底层函数实现，然后调用hal_device_register注册即可。应用代码通过hal_device_find("i2c1")获取设备句柄，完全不感知底层是哪种MCU。

外设接口封装实例

以I2C温湿度传感器SHT30为例，展示完整封装流程。

// stm32_i2c_impl.c - 以STM32 HAL库实现底层
int stm32_i2c_read(uint8_t *buf, uint32_t len) {
    hal_device_t *dev = hal_device_find("i2c1");
    if (!dev) return -1;
    // dev->priv 指向 I2C_HandleTypeDef*
    I2C_HandleTypeDef *hi2c = (I2C_HandleTypeDef *)dev->priv;
    return HAL_I2C_Master_Receive(hi2c, SHT30_ADDR, buf, len, HAL_MAX_DELAY);
}

// 注册到设备表
void hal_i2c_init(void) {
    static hal_dev_ops_t ops = {
        .init  = stm32_i2c_init,
        .read  = stm32_i2c_read,
        .write = stm32_i2c_write,
        .ioctl = stm32_i2c_ioctl
    };
    hal_device_register("i2c1", &ops, &hi2c1);
}

时序适配

硬件抽象还包括延迟函数。Linux上的usleep()在FreeRTOS下要换成vTaskDelay(pdMS_TO_TICKS(ms))。建议封装一个统一的延迟接口，内部通过条件编译选择实现。

// hal_delay.h
void hal_delay_ms(uint32_t ms);
void hal_delay_us(uint32_t us);

// hal_delay_stm32.c
void hal_delay_ms(uint32_t ms) { HAL_Delay(ms); }
void hal_delay_us(uint32_t us) { delay_us_cycle(us); } // 使用DWT计时

中断与回调的抽象

外设事件（如数据就绪、传输完成）不能硬编码中断处理函数。方案：HAL提供回调注册接口，应用层挂载自己的处理函数。

typedef void (*hal_irq_callback_t)(void *arg);

int hal_irq_attach(const char *dev_name, hal_irq_callback_t cb, void *arg);
void hal_irq_detach(const char *dev_name);

// 使用示例：温度传感器就绪中断
hal_irq_attach("temp_sensor", on_temperature_ready, NULL);

在STM32的I2C中断服务函数中，通过查找已注册的回调并调用之，这样应用代码不需要修改中断向量表。