2、GPIO输出驱动：LED灯实验、GPIO寄存器详解、位带操作、HAL库GPIO函数封装

各位同学，欢迎来到第二章。上一章我们把开发环境搭好了，也跑通了第一个点灯程序。但说实话，那时候你可能只是复制粘贴，并不知道背后发生了什么。这一章，我们就来彻底搞懂GPIO——这个嵌入式开发里最基础、也最常用的外设。

我个人习惯，学一个新东西，先动手再理论。所以我们先做实验，把LED点亮、熄灭、闪烁玩明白，然后再回头啃寄存器、学位带操作、最后封装成自己的HAL库函数。这样你心里有底，学起来不慌。

2.1 硬件连接与实验目标

先看硬件。我手头这块板子，LED接在GPIOB的第0号引脚（PB0），高电平点亮。你用的板子可能不一样，但原理完全相同——找到原理图，确认LED接在哪个GPIO上，是低电平点亮还是高电平点亮。

2.2 寄存器详解：GPIO的“控制面板”

GPIO说白了就是一组寄存器。你往这些寄存器里写值，引脚就输出对应的电平。STM32的每个GPIO端口（如GPIOA、GPIOB）都有7个32位寄存器。但做输出驱动，我们只需要关注其中4个。

这里我重点说一下CRL和CRH。每个引脚占用4位，其中低2位配置模式，高2位配置速度。比如PB0是低8位引脚，它的配置就在CRL寄存器的bit[3:0]。

2.3 位带操作：让GPIO像51单片机一样简单

你想想看，用ODR寄存器控制单个引脚，得先读-改-写三步。比如要单独把PB0置1，你得：

GPIOB->ODR |= (1 << 0);   // 读ODR，或操作，写回ODR

这中间有个隐患——如果刚好在读取和写入之间发生了中断，另一个任务也修改了ODR，那结果就不可控了。位带操作就是为了解决这个问题。

位带区的原理很简单：把每个bit映射到一个32位的地址上。你往这个地址写1，对应的bit就置1；写0，bit就清0。而且这是原子操作，不会被中断打断。

计算公式也不复杂：

别名地址 = 位带基地址 + (字节偏移 × 32) + (位号 × 4)

举个例子，GPIOB的ODR寄存器地址是0x4001 0C0C，我们要操作bit0：

字节偏移 = 0x4001 0C0C - 0x4000 0000 = 0x10C0C
别名地址 = 0x4200 0000 + (0x10C0C × 32) + (0 × 4)
         = 0x4200 0000 + 0x218180
         = 0x4221 8180

算出来之后，直接操作这个地址就行：

#define PB0_OUT  (*(volatile uint32_t *)0x42218180)
PB0_OUT = 1;  // PB0输出高电平
PB0_OUT = 0;  // PB0输出低电平

2.4 HAL库GPIO函数封装：从寄存器到API

好了，现在你已经理解了底层原理。但实际项目中，我们不会每次都去算位带地址、翻寄存器手册。我们需要一套好用的API。HAL库已经帮我们封装好了，但我想带你看看它背后做了什么。

HAL库的GPIO输出相关函数主要有这几个：

我们来看看HAL_GPIO_WritePin的内部实现（简化版）：

void HAL_GPIO_WritePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState)
{
    if (PinState != GPIO_PIN_RESET)
    {
        GPIOx->BSRR = GPIO_Pin;  // 写BSRR的对应位，输出高
    }
    else
    {
        GPIOx->BSRR = (uint32_t)GPIO_Pin << 16;  // 写BSRR的高16位，输出低
    }
}

看到了吗？它用的就是BSRR寄存器。BSRR的低16位是置位寄存器，写1对应引脚输出高；高16位是复位寄存器，写1对应引脚输出低。而且BSRR是只写寄存器，读它没用。

2.5 完整实验代码：LED闪烁

下面是一个完整的LED闪烁程序，我用了寄存器操作和HAL库两种方式，你可以对比一下。

方式一：寄存器操作

#include "stm32f10x.h"

void delay(volatile uint32_t count)
{
    while (count--);
}

int main(void)
{
    // 1. 使能GPIOB时钟
    RCC->APB2ENR |= (1 << 3);  // RCC_APB2ENR的bit3对应GPIOB
    
    // 2. 配置PB0为推挽输出，10MHz
    GPIOB->CRL &= ~(0xF << 0);  // 先清空bit[3:0]
    GPIOB->CRL |= (0x1 << 0);   // 设置为输出模式，10MHz
    
    while (1)
    {
        GPIOB->ODR |= (1 << 0);   // PB0输出高，LED亮
        delay(500000);
        GPIOB->ODR &= ~(1 << 0);  // PB0输出低，LED灭
        delay(500000);
    }
}

方式二：HAL库操作

#include "stm32f1xx_hal.h"

void SystemClock_Config(void);
static void MX_GPIO_Init(void);

int main(void)
{
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();
    
    while (1)
    {
        HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_SET);
        HAL_Delay(500);
        HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_RESET);
        HAL_Delay(500);
    }
}

static void MX_GPIO_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    
    __HAL_RCC_GPIOB_CLK_ENABLE();
    
    GPIO_InitStruct.Pin = GPIO_PIN_0;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
    HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);
}

两种方式都能跑，但寄存器方式代码量少、执行快；HAL库方式可移植性好、易读。我个人建议：学习阶段两种都写一遍，理解底层；项目阶段用HAL库，省时间。

2.6 知识体系总览

这一章的内容比较多，我画了一张图帮你梳理整个知识体系：

2.7 避坑指南与经验总结

最后，分享几个我踩过的坑：

• 时钟没使能： 这是新手最常犯的错误。操作GPIO之前，必须先使能对应端口的时钟。我刚开始学的时候，忘了使能时钟，折腾了一下午。
• 模式配置错误： 输出模式要选推挽输出（PP），不是开漏输出（OD）。开漏输出需要外部上拉电阻，否则输出不了高电平。
• 位带地址算错： 位带别名地址的计算公式一定要仔细。我曾经算错一次，写进去的值不知道写到哪里去了，整个系统跑飞。
• HAL_Delay阻塞： HAL_Delay是阻塞延时，在中断里调用会导致系统卡死。如果要在中断里做延时，用定时器或者状态机。

嗯，这一章的内容就到这里。记住，GPIO是嵌入式开发的基石，把它吃透了，后面的外设驱动学起来会轻松很多。去动手写代码吧，有问题随时回来翻这一章。