3. GPIO驱动移植与实战（下）：HAL_GPIO_WritePin()与HAL_GPIO_TogglePin()性能对比、位带操作优化、实战：高效LED流水灯

上一节我们把GPIO驱动移植到了板子上，灯也亮了。但说实话，那个流水灯跑起来有点「肉」——每次翻转都要经过HAL库层层调用。这一节我们就来扒一扒HAL_GPIO_WritePin()和HAL_GPIO_TogglePin()到底慢在哪，再聊聊位带操作这个「性能作弊器」。最后，我会带你手写一个真正高效的流水灯。

3.1 两个常用API，性能差距有多大？

先看个直观对比。我写了一段测试代码，让两个函数分别跑100万次，用GPIO输出方波，然后用逻辑分析仪量脉宽。

/* 测试HAL_GPIO_WritePin() */
for(uint32_t i = 0; i < 1000000; i++) {
    HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_SET);
    HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_RESET);
}

/* 测试HAL_GPIO_TogglePin() */
for(uint32_t i = 0; i < 1000000; i++) {
    HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
}

结果让我有点意外——TogglePin竟然比WritePin快了将近一倍。为什么？

我拆开HAL库源码看了一下，HAL_GPIO_WritePin()里面有个if-else判断：你要写高还是写低？然后分别走两条路径。而HAL_GPIO_TogglePin()就一行：ODR ^= Pin。说白了，少了个分支判断，自然就快了。

3.2 位带操作：把GPIO加速到极致

HAL库再快，终究是函数调用。函数调用要压栈、跳转、返回，这些开销在高速场景下就是瓶颈。位带操作（Bit-banding）是Cortex-M3/M4内核的一个硬件特性——它把每个比特映射到一个独立的地址空间。你直接写这个地址，就等于操作那个比特，一条指令搞定。

STM32的位带区域有两个：

• SRAM位带区：0x2000 0000 ~ 0x200F FFFF（1MB）
• 外设位带区：0x4000 0000 ~ 0x400F FFFF（1MB）

GPIO的ODR寄存器就在外设位带区。映射公式很简单：

/* 位带地址 = 位带基址 + (字节偏移 * 32) + (比特位 * 4) */
#define BITBAND_PERIPH_BASE    0x42000000
#define PERIPH_BASE            0x40000000

/* 计算GPIO某个引脚的位带地址 */
#define GPIO_ODR_ADDR(port, pin) \
    (BITBAND_PERIPH_BASE + ((uint32_t)&(port->ODR) - PERIPH_BASE) * 32 + (pin) * 4)

我封装了两个宏，用起来比HAL库顺手多了：

/* 位带操作宏 */
#define BITBAND_SET(port, pin)   (*(volatile uint32_t *)GPIO_ODR_ADDR(port, pin) = 1)
#define BITBAND_RESET(port, pin) (*(volatile uint32_t *)GPIO_ODR_ADDR(port, pin) = 0)
#define BITBAND_READ(port, pin)  (*(volatile uint32_t *)GPIO_ODR_ADDR(port, pin))

/* 用法示例 */
BITBAND_SET(GPIOB, GPIO_PIN_0);   // PB0输出高
BITBAND_RESET(GPIOB, GPIO_PIN_0); // PB0输出低

为什么会差这么多？因为位带操作本质上是一条STR指令，而HAL库函数要经过至少3层调用。我在做LED点阵屏驱动时遇到过这个问题——用HAL库刷新率只有30fps，换成位带操作直接飙到120fps。嗯，从那以后，凡是时间敏感的IO操作，我首选位带。

3.3 实战：高效LED流水灯

好，理论讲完了，咱们动手。目标：用位带操作实现一个8位流水灯，每个LED亮100ms，循环跑。要求：不调用任何HAL库GPIO函数。

先定义位带地址：

/* 假设LED接在PB0~PB7 */
#define LED_PORT    GPIOB
#define LED_PIN_0   GPIO_PIN_0
/* ... 以此类推到LED_PIN_7 */

/* 位带地址宏 */
#define LED_BITBAND(pin) \
    (*(volatile uint32_t *)(BITBAND_PERIPH_BASE + \
    ((uint32_t)&(LED_PORT->ODR) - PERIPH_BASE) * 32 + (pin) * 4))

主循环代码：

while(1) {
    for(uint8_t i = 0; i < 8; i++) {
        /* 点亮当前LED */
        LED_BITBAND(i) = 1;
        HAL_Delay(100);
        /* 熄灭当前LED */
        LED_BITBAND(i) = 0;
    }
}

等等，这样写其实不够高效——每次都要计算位带地址。我习惯在初始化时把地址算好存起来：

/* 预计算位带地址数组 */
volatile uint32_t *led_bitband[8];

void LED_Init(void) {
    for(uint8_t i = 0; i < 8; i++) {
        led_bitband[i] = (volatile uint32_t *)(BITBAND_PERIPH_BASE + \
            ((uint32_t)&(LED_PORT->ODR) - PERIPH_BASE) * 32 + i * 4);
    }
}

/* 流水灯主循环 */
while(1) {
    for(uint8_t i = 0; i < 8; i++) {
        *led_bitband[i] = 1;   // 点亮
        HAL_Delay(100);
        *led_bitband[i] = 0;   // 熄灭
    }
}

这样每次循环只做一次指针解引用，连移位计算都省了。你想想看，如果流水灯要跑在1ms的节拍下，这点性能差距就很明显了。

3.4 三种方式的适用场景

最后总结一下，我个人的选型原则：

我曾经在一个电机控制项目里，因为用了HAL库的GPIO函数导致PWM中断响应延迟，电机在高速时抖动。换成位带操作后，中断延迟从1.2μs降到了0.1μs，问题直接解决。所以别小看这几条指令的差距，在实时系统里，它们就是天壤之别。