2. 开发环境搭建

各位同学，今天我们来聊聊嵌入式开发中最基础、也最绕不开的一个外设——GPIO。说白了，GPIO就是芯片的“手脚”，你要让芯片对外输出信号，或者读取外部电平，都得靠它。

我刚开始做嵌入式那会儿，第一个实验就是点亮LED。当时用的是标准库，对着寄存器一顿操作。现在有了HAL库，开发效率确实高了不少，但底层原理还是得吃透。不然出了问题，你都不知道从哪查起。

2.1 GPIO工作原理：芯片的“手脚”怎么动？

GPIO全称是General Purpose Input Output，通用输入输出口。每个GPIO引脚都可以独立配置成输入或输出模式。

你想想看，一个引脚内部其实是一堆MOS管和逻辑电路组成的。输出模式下，你往寄存器里写1，引脚就输出高电平；写0，就输出低电平。输入模式下，你读寄存器，就能知道外部是高还是低。

但这里有个坑——不是所有引脚都能随便用。我遇到过一块板子，某个引脚默认是JTAG调试口，我直接当普通GPIO用，结果死活拉不低电平。查了半天手册才发现，得先关闭JTAG复用功能。

2.2 寄存器映射：C语言怎么操作硬件？

寄存器映射，说白了就是给硬件寄存器起个C语言名字。每个寄存器都有固定的物理地址，我们通过指针来访问它。

以STM32F103为例，GPIOA的基地址是0x40010800。它的CRL寄存器（控制低8位）偏移地址是0x00，所以CRL的绝对地址就是0x40010800。

HAL库已经帮我们把映射做好了，但你得知道底层是怎么玩的。我习惯在调试时直接看寄存器值，比看HAL库封装后的变量更直观。

寄存器名称	偏移地址	功能描述
GPIOx_CRL	0x00	端口配置低寄存器（Pin0~7）
GPIOx_CRH	0x04	端口配置高寄存器（Pin8~15）
GPIOx_IDR	0x08	端口输入数据寄存器
GPIOx_ODR	0x0C	端口输出数据寄存器
GPIOx_BSRR	0x10	端口位设置/清除寄存器
GPIOx_BRR	0x14	端口位清除寄存器
GPIOx_LCKR	0x18	端口配置锁定寄存器

嗯，这里要注意BSRR寄存器。写1到低16位对应引脚输出高电平，写1到高16位对应引脚输出低电平。而且它是原子操作，不会被中断打断。我写驱动时，切换IO口电平优先用BSRR，而不是ODR。

2.3 HAL库GPIO函数：封装好的“瑞士军刀”

HAL库把寄存器操作封装成了几个核心函数。你不需要直接操作寄存器，但得知道每个函数背后干了什么。

2.3.1 GPIO初始化：HAL_GPIO_Init()

这个函数负责配置引脚的模式、速度、上下拉等。它的参数是一个GPIO_InitTypeDef结构体。

GPIO_InitTypeDef GPIO_InitStruct = {0};
GPIO_InitStruct.Pin = GPIO_PIN_0;          // 选择Pin0
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; // 推挽输出
GPIO_InitStruct.Pull = GPIO_NOPULL;         // 无上下拉
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;// 低速
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

我个人习惯把引脚配置放在一个单独的函数里，比如MX_GPIO_Init()。这样代码结构清晰，后期改引脚也方便。

2.3.2 输出控制：HAL_GPIO_WritePin() 与 HAL_GPIO_TogglePin()

写引脚电平用HAL_GPIO_WritePin()，翻转电平用HAL_GPIO_TogglePin()。

// 输出高电平
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_SET);
// 输出低电平
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_RESET);
// 翻转电平
HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_0);

这里有个小技巧：如果你要同时控制多个引脚，可以用位运算组合Pin参数。比如HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0 | GPIO_PIN_1, GPIO_PIN_SET)，一次操作两个引脚。

2.3.3 输入读取：HAL_GPIO_ReadPin()

读取引脚电平状态，返回GPIO_PIN_SET或GPIO_PIN_RESET。

GPIO_PinState state = HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0);
if(state == GPIO_PIN_SET) {
    // 引脚为高电平
}

2.4 点亮LED实战：从原理图到代码跑通

好了，理论讲完了，咱们直接上手干。点亮LED是嵌入式界的“Hello World”，但别小看它——这里面包含了GPIO配置、时钟使能、代码调试等全套流程。

2.4.1 看原理图，确定引脚

第一步，打开你的开发板原理图。找到LED对应的引脚。以STM32F103C8T6最小系统板为例，通常板载LED接在PC13上，低电平点亮。

我见过不少新手不看原理图，直接拿例程的引脚往上怼，结果灯不亮就怀疑板子坏了。其实多半是引脚不对。

2.4.2 使能GPIO时钟

STM32的GPIO外设默认时钟是关闭的。你得先打开对应的时钟，才能操作寄存器。HAL库中，时钟使能在HAL_GPIO_Init()内部自动完成，但前提是你得先调用HAL_RCC_GPIOx_CLK_ENABLE()。

__HAL_RCC_GPIOC_CLK_ENABLE();  // 使能GPIOC时钟

嗯，这里有个容易忽略的点：不同系列的STM32，时钟使能宏可能不一样。F1系列用__HAL_RCC_GPIOC_CLK_ENABLE()，F4系列可能用__HAL_RCC_GPIOG_CLK_ENABLE()。移植代码时一定要确认。

2.4.3 完整代码示例

#include "main.h"

void LED_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    
    // 使能GPIOC时钟
    __HAL_RCC_GPIOC_CLK_ENABLE();
    
    // 配置PC13为推挽输出
    GPIO_InitStruct.Pin = GPIO_PIN_13;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
    HAL_GPIO_Init(GPIOC, &GPIO_InitStruct);
    
    // 初始状态：熄灭（高电平）
    HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_SET);
}

void LED_On(void)
{
    HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_RESET);
}

void LED_Off(void)
{
    HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_SET);
}

void LED_Toggle(void)
{
    HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);
}

int main(void)
{
    HAL_Init();      // 初始化HAL库
    LED_Init();      // 初始化LED引脚
    
    while(1)
    {
        LED_On();    // 点亮LED
        HAL_Delay(500); // 延时500ms
        LED_Off();   // 熄灭LED
        HAL_Delay(500);
    }
}

2.4.4 避坑指南

我曾经在调试时遇到LED不亮，查了半天发现是HAL_Delay()没生效。原因是我没有配置系统滴答定时器中断。HAL_Delay()依赖SysTick中断来计时，如果中断没开，延时函数就卡死了。

解决办法：确保在HAL_Init()之后，调用了HAL_SYSTICK_Config(SystemCoreClock / 1000)来配置SysTick为1ms中断一次。

2.5 知识体系总览

下面这张图，把GPIO从硬件到软件的全链路串起来了。你对照着看，思路会更清晰。

这张图从硬件层一直延伸到调试层。你写代码时，心里要有这个层次感。出了问题，逐层排查，很快就能定位。

好了，GPIO基础就讲到这里。点亮LED只是第一步，后面我们会用GPIO驱动更多外设——按键、蜂鸣器、数码管，甚至模拟I2C和SPI时序。原理都一样，只是配置不同而已。