STM32 GPIO深度解析：从基础配置到中断、DMA高级应用

1. 从“点灯”到“万物互联”：为什么GPIO是STM32的基石

如果你刚开始接触STM32，或者已经用它做过几个项目，那么“GPIO”这个词对你来说一定不陌生。几乎所有的教程、第一个实验，都是从“点灯”开始的——通过控制一个GPIO引脚输出高电平或低电平，来点亮或熄灭一个LED。这个看似简单的操作，背后却隐藏着微控制器与物理世界交互的全部秘密。很多人把GPIO（通用输入输出）当作一个理所当然的、简单的开关来用，但当你真正深入项目，比如想用PWM驱动电机、用外部中断捕获按键、用模拟输入读取传感器，甚至想实现一个软件模拟的通信协议时，你会发现，对GPIO的理解深度，直接决定了你项目的稳定性、性能和开发效率。

STM32的GPIO远不止是“开”和“关”。它是一扇高度可配置的“门”，这扇门可以设置为输入来感知外部世界的电压信号，也可以设置为输出去驱动外部设备；它可以被配置成推挽输出提供强劲的驱动能力，也可以被配置成开漏输出方便实现“线与”逻辑或连接不同电压的设备；它还能被重映射到片上外设（如USART、SPI），让硬件设计更加灵活。更重要的是，STM32的GPIO与中断、DMA等高级功能紧密耦合，构成了其强大实时控制能力的基础。无论是做智能家居、无人机飞控、工业控制还是物联网终端，GPIO都是你第一个需要征服，也必须征服的关卡。

这篇文章，我将抛开官方手册那种罗列寄存器的方式，从一个实际开发者的角度，结合我这些年踩过的坑和积累的经验，带你重新认识STM32的GPIO。我们会从最根本的电路模型和寄存器操作讲起，透彻理解8种工作模式的本质区别和适用场景，然后深入到中断、重映射、复用功能等高级应用，最后还会探讨如何利用DMA来操作GPIO以实现一些“骚操作”。我的目标是，让你看完之后，不仅能熟练配置GPIO，更能明白“为什么要这样配置”，在面对任何外设驱动需求时，都能做出最合理、最稳定的设计选择。

2. GPIO的物理层与电气特性：不只是0和1

在写代码配置GPIO_InitStruct.Mode之前，我们有必要先看看芯片引脚连接的那个小小的物理世界。STM32的每一个GPIO引脚内部，都不是一个简单的开关，而是一套精密的模拟与数字电路。理解这套电路，是避免硬件损坏、保证信号质量的前提。

2.1 推挽输出 vs. 开漏输出：驱动能力的博弈

这是输出模式中最核心的两种，它们的区别源于内部输出级电路的结构。

推挽输出就像一对“推”和“拉”的搭档。内部有两个MOS管，一个接到VDD（电源），我们叫它上管（P-MOS）；一个接到VSS（地），我们叫它下管（N-MOS）。当输出逻辑‘1’（高电平）时，上管导通，下管关闭，引脚被“推”到接近VDD的电压（比如3.3V）。当输出逻辑‘0’（低电平）时，上管关闭，下管导通，引脚被“拉”到接近0V的电压。这种结构的优点是驱动能力强，高低电平都很“硬”，上升沿和下降沿陡峭，适合高速开关和直接驱动LED、继电器等负载。

但是，推挽输出有一个限制：不能直接实现“线与”。如果两个推挽输出的引脚直接连在一起，一个输出高，一个输出低，就会形成VDD到VSS的短路通路，产生大电流，可能损坏芯片。这在I2C等需要多个设备共享数据线的总线协议中是绝对不允许的。

开漏输出则只提供了“拉”的能力。内部只有下管（N-MOS），没有上管。当输出逻辑‘0’时，下管导通，引脚被拉低到0V。当输出逻辑‘1’时，下管关闭，引脚相当于断开（高阻态）。此时，引脚的电平状态是未知的，必须依靠外部的一个上拉电阻连接到某个电源（比如3.3V），才能在被释放时被拉到高电平。

开漏输出的妙处就在这里：

1. 电平转换：外部上拉电阻可以接到5V电源。当STM32（3.3V逻辑）输出‘1’（断开）时，引脚被外部5V上拉拉至5V；输出‘0’时，引脚被内部MOS管拉低到0V。这样就实现了3.3V到5V的电平转换，而且非常安全。
2. 线与逻辑：多个开漏输出的引脚可以直接连在一起，共用同一个上拉电阻。只要任何一个设备输出‘0’，总线就被拉低为‘0’；只有当所有设备都输出‘1’（高阻态）时，总线才被上拉电阻拉高为‘1’。这正是I2C和SMBUS等总线的基础。
3. 降低功耗：在总线空闲时，所有设备都输出高阻态，只有上拉电阻消耗微小的电流。

实操心得：驱动一个普通的LED，用推挽输出是最直接、亮度最高的。但如果你需要连接一个5V的器件，或者设计一个多主机的通信总线，开漏输出加外部上拉是唯一安全可靠的选择。永远记住，STM32的IO口绝大多数是5V不兼容的（除了部分标注为FT的引脚），直接接5V信号可能击穿内部电路，而开漏模式是安全的桥梁。

2.2 输入模式：施密特触发器与上下拉电阻

当GPIO被配置为输入模式时，它的任务是“读取”外部电压。STM32的输入引脚内部通常有一个施密特触发器。这不是一个简单的电压比较器，而是一个具有滞回特性的比较器。它有两个阈值电压：VIL（输入低电平最大电压）和VIH（输入高电平最小电压），并且VIH>VIL。

假设VIL是1.0V，VIH是2.0V。当输入电压从0V缓慢上升时，只要电压低于2.0V，触发器都认为它是低电平。一旦电压超过2.0V，触发器立刻翻转为高电平。如果电压随后下降，即使降到1.9V（仍高于VIL），由于滞回特性，它仍然被识别为高电平，直到电压跌破1.0V才会翻转为低电平。这个滞回区间（2.0V - 1.0V = 1.0V）有效地消除了信号在阈值附近抖动带来的噪声，让数字读取非常稳定。这就是为什么按键扫描通常不需要在软件里做复杂的消抖，硬件已经帮你处理了大部分毛刺。

输入模式又分为浮空输入、上拉输入和下拉输入。

• 浮空输入：引脚内部既不上拉也不下拉，完全由外部电路决定其电平。当外部信号为高阻态或断开时，引脚电平是浮空的、不确定的，读取的值会随机跳动。这非常危险，容易导致误操作。
• 上拉/下拉输入：内部通过一个约40kΩ的电阻连接到VDD或VSS。这为引脚提供了一个确定的默认状态。例如，一个按键一端接地，另一端接GPIO引脚。如果将GPIO配置为上拉输入，当按键未按下时，内部上拉电阻将引脚拉至高电平，读取为‘1’；按键按下时，引脚被直接接地，读取为‘0’。这样电路最简单可靠，无需外部电阻。

踩坑记录：我曾经调试一个设备，某个输入引脚偶尔会误触发。查了很久才发现，该引脚连接的外部传感器在初始化完成前输出是高阻态，而我配置的是浮空输入。在传感器初始化这几毫秒内，引脚悬空，受到板子上的噪声干扰，电平乱跳，导致误判。将其改为下拉输入（根据逻辑，默认应为低电平），问题立刻消失。所以，永远不要使用浮空输入，除非你百分百确定外部信号在任何时候都有确定的驱动源。

2.3 GPIO的8种工作模式全解析

结合输出和输入电路，STM32的GPIO通常被总结为8种模式（以标准库为例）：

1. GPIO_Mode_AIN：模拟输入。关闭所有数字电路（施密特触发器、上下拉电阻），信号直接进入ADC或比较器。用于ADC采样或模拟看门狗。
2. GPIO_Mode_IN_FLOATING：浮空输入。如上所述，慎用。
3. GPIO_Mode_IPD：下拉输入。内部下拉电阻使能。
4. GPIO_Mode_IPU：上拉输入。内部上拉电阻使能。
5. GPIO_Mode_Out_OD：开漏输出。可配合外部上拉实现电平转换和线与。
6. GPIO_Mode_Out_PP：推挽输出。最常用的强驱动输出模式。
7. GPIO_Mode_AF_OD：复用功能开漏输出。引脚被连接到片上外设（如I2C的SDA线），工作模式为开漏。
8. GPIO_Mode_AF_PP：复用功能推挽输出。引脚被连接到片上外设（如USART的TX线），工作模式为推挽。

模式选择速查表：

3. 寄存器与HAL库：揭开配置的神秘面纱

无论是标准库、HAL库还是直接操作寄存器，最终都是在配置芯片内部那几个关键的GPIO寄存器。理解它们，能让你在调试时心中有数，甚至在库函数无法满足需求时自己动手。

3.1 核心寄存器一览

每个GPIO端口（如GPIOA, GPIOB）都有一套独立的寄存器，主要的有以下几个：

1. GPIOx_MODER (模式寄存器)：这是最重要的寄存器，2个位控制一个引脚。00=输入，01=输出，10=复用功能，11=模拟模式。上电复位后，所有引脚默认是输入浮空（安全状态）。
2. GPIOx_OTYPER (输出类型寄存器)：1位控制一个引脚。0=推挽输出，1=开漏输出。仅当MODER配置为输出或复用输出时有效。
3. GPIOx_OSPEEDR (输出速度寄存器)：2位控制一个引脚。控制输出驱动器的压摆率（slew rate），即电平翻转的速度。00=低速，01=中速，10=快速，11=高速。速度越高，边沿越陡，噪声和功耗也越大。对于低速的LED、按键，用低速即可；对于高速SPI、USB等，必须用高速。
4. GPIOx_PUPDR (上下拉寄存器)：2位控制一个引脚。00=无上下拉，01=上拉，10=下拉，11=保留。这个寄存器在输入模式和输出模式下都有效！输出模式下配置上拉，可以在输出高阻态时（如开漏输出‘1’）提供上拉。
5. GPIOx_IDR (输入数据寄存器)：只读。直接反映引脚当前的逻辑电平（经过施密特触发器后）。
6. GPIOx_ODR (输出数据寄存器)：可读写。写入的值会锁存，并输出到引脚（在推挽模式下）。读取它返回的是你上次写入的值，而不是引脚的实际电压！
7. GPIOx_BSRR (置位/复位寄存器)：这是一个非常实用的寄存器。写1到低16位（BSy）会置位对应引脚（输出‘1’），写1到高16位（BRy）会复位对应引脚（输出‘0’）。写‘0’无效果。它的最大优点是“读-改-写”操作是原子的。比如你想只把PA5拉高而不影响同一端口其他引脚，用GPIOA->BSRR = GPIO_PIN_5;即可。如果用GPIOA->ODR |= GPIO_PIN_5;，你需要先读取ODR，或运算，再写回，在多线程或中断环境下可能被打断，导致错误。
8. GPIOx_LCKR (配置锁寄存器)：可以锁定GPIO的配置（MODER, OTYPER, OSPEEDR, PUPDR），防止意外修改。主要用于一些关键的安全引脚。

3.2 HAL库配置的底层逻辑

以HAL库配置PA5为推挽输出为例：

GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = GPIO_PIN_5; 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);

这段代码最终会操作哪些寄存器呢？

• MODER[11:10]被设置为01（通用输出）。
• OTYPER[5]被设置为0（推挽）。
• OSPEEDR[11:10]被设置为00（这里对应低速，具体值由GPIO_SPEED_FREQ_LOW宏定义）。
• PUPDR[11:10]被设置为00（无上下拉）。

HAL库帮你封装了这些细节，但当你遇到配置不生效的问题时，通过调试器查看这些寄存器的实际值，是定位问题的终极手段。

调试技巧：在STM32CubeIDE或Keil的调试模式下，打开“Peripherals” -> “GPIO”窗口，你可以实时看到每个端口所有寄存器的值。如果你用代码HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);但灯不亮，首先就该来这里看看MODER是否真的配置成了输出模式，OTYPER是否正确。我无数次靠这个方法发现是因为在别处错误地重配置了引脚，或者时钟没有使能。

3.3 时钟使能：一切操作的前提

STM32的所有外设，包括GPIO端口，都由时钟驱动。在配置GPIO之前，必须开启对应GPIO端口的时钟。这是新手最常忘记的一步，会导致任何配置和操作都无效。

__HAL_RCC_GPIOA_CLK_ENABLE(); // 使能GPIOA时钟

在HAL库中，HAL_GPIO_Init函数内部不会自动帮你使能时钟，你必须手动调用上面的宏。而在STM32CubeMX生成的代码里，这个使能调用通常放在MX_GPIO_Init函数的最开始。请务必检查你的代码。

4. 进阶应用：中断、复用与DMA操作

掌握了基本输入输出，GPIO还能玩出更多花样，这些才是STM32强大功能的体现。

4.1 GPIO外部中断：让MCU主动响应世界

轮询读取按键效率低下且浪费CPU。外部中断（EXTI）允许引脚在电平变化时主动打断CPU，使其立即处理事件。STM32的EXTI控制器支持所有GPIO引脚，但同一时刻每个中断线（EXTI0~EXTI15）只能连接一个端口的一个引脚。例如，EXTI0可以连接PA0、PB0、PC0……中的任意一个，但不能同时连接PA0和PB0。

配置外部中断的关键步骤：

1. 配置GPIO为输入模式，并启用内部上拉或下拉，给一个确定的默认状态。
2. 配置SYSCFG（系统配置控制器），选择将哪个GPIO端口连接到目标EXTI线。例如，将PA0连接到EXTI0。

   __HAL_RCC_SYSCFG_CLK_ENABLE(); // 先使能SYSCFG时钟 HAL_SYSCFG_EXTILineConfig(EXTI_PortSourceGPIOA, EXTI_PinSource0);

3. 配置EXTI线，设置触发边沿（上升沿、下降沿、双边沿）和使能中断。

   EXTI_HandleTypeDef hexti0; hexti0.Line = EXTI_LINE_0; hexti0.Init.Mode = EXTI_MODE_INTERRUPT; hexti0.Init.Trigger = EXTI_TRIGGER_RISING; // 上升沿触发 hexti0.Init.Pull = EXTI_PULL_UP; HAL_EXTI_Init(&hexti0);

4. 配置NVIC（嵌套向量中断控制器），设置中断优先级并使能。

   HAL_NVIC_SetPriority(EXTI0_IRQn, 0, 0); HAL_NVIC_EnableIRQ(EXTI0_IRQn);

5. 编写中断服务函数。函数名是固定的，在启动文件中有向量表定义。

   void EXTI0_IRQHandler(void) { HAL_EXTI_IRQHandler(&hexti0); // 处理中断标志 // 你的用户代码 HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_0); // 例如翻转一个LED }

6. 编写回调函数（如果用HAL库）。HAL_EXTI_IRQHandler会调用一个弱定义的HAL_GPIO_EXTI_Callback函数，你需要重写它。

   void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) { if(GPIO_Pin == GPIO_PIN_0) { // 处理PA0的中断 } }

避坑指南：按键消抖。虽然施密特触发器消除了电气噪声，但机械按键的物理抖动（通常在5-10ms）仍然会被EXTI识别为多次边沿，导致中断多次触发。有几种处理方式：

1. 硬件消抖：在按键两端并联一个0.1uF的电容，简单有效。
2. 软件消抖（在中断中）：进入中断后，先关闭该中断，然后启动一个定时器（比如10ms），在定时器中断里再去读取引脚状态并确认，最后再重新开启外部中断。这是最可靠的方法。
3. 软件消抖（在回调函数中）：在回调函数里用HAL_GetTick()记录时间，与上次中断时间比较，如果间隔小于阈值（如20ms），则认为是抖动，直接返回。 我个人的习惯是采用第二种“中断+定时器”的方式，虽然复杂一点，但响应及时且绝对稳定，适用于对实时性要求高的场合。

4.2 复用功能与重映射：解放PCB布局

STM32的许多外设（如USART、SPI、I2C、定时器）的输入输出信号，可以通过GPIO的复用功能（Alternate Function, AF）连接到特定的引脚。每个引脚可能有多个复用功能可供选择，具体映射关系需要查阅芯片的数据手册（Datasheet）中的“Pinout and pin description”章节或参考手册（Reference Manual）的“Alternate function mapping”表格。

更强大的是重映射功能。对于一些外设，STM32提供了可选的引脚位置。例如，USART1默认TX是PA9，RX是PA10。但通过配置AFIO_MAPR寄存器，可以将其重映射到PB6和PB7。这在PCB布线时非常有用，可以避免走线交叉，优化布局。

在HAL库中，配置复用功能非常简单，只需将GPIO的Mode设置为GPIO_MODE_AF_PP或GPIO_MODE_AF_OD，并指定正确的Alternate（复用功能编号）即可。这个编号不是随便写的，它定义在芯片对应的头文件（如stm32f1xx_hal_gpio_ex.h）中，例如GPIO_AF7_USART1。

// 配置PA9为USART1_TX复用推挽输出 GPIO_InitStruct.Pin = GPIO_PIN_9; GPIO_InitStruct.Mode = GPIO_MODE_AF_PP; GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; GPIO_InitStruct.Alternate = GPIO_AF7_USART1; // 关键！ HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

经验之谈：在开始画PCB之前，一定要先用STM32CubeMX这样的图形化工具进行引脚规划。它会直观地显示引脚冲突（两个外设用了同一个引脚），并自动列出所有可用的重映射选项。这能节省大量后期调试和改板的时间。我曾经因为没规划好，导致一个SPI和一个PWM冲突，最后只能用软件模拟SPI，性能大打折扣。

4.3 用DMA操作GPIO：实现精准时序与“比特轰炸”

这是GPIO应用的一个高级技巧。通常我们改变GPIO输出电平是用HAL_GPIO_WritePin或直接写BSRR寄存器，这都需要CPU参与。对于需要产生非常精确、高速或复杂波形序列的场景（例如软件模拟WS2812B灯带的24bit时序、驱动LCD屏的并行总线、产生特定编码的脉冲串），CPU的介入会带来不可预测的抖动，并且会占用大量计算资源。

此时，DMA（直接存储器访问）就可以大显身手了。你可以将一段预先定义好的电平序列（一个数组）存放在内存中，然后配置DMA，让DMA控制器自动地、按顺序地将这个数组里的每一个值搬运到GPIO的ODR或BSRR寄存器。在这个过程中，CPU完全被解放出来，可以处理其他任务，而GPIO输出的时序则由DMA的传输速率精确控制，通常非常稳定。

一个简化的DMA到GPIO的数据流设置思路：

1. 准备一个uint16_t类型的数组pattern[]，数组的每个元素对应GPIO端口16个引脚（0-15）的期望输出状态。例如，pattern[0] = 0x0001;表示只让PIN0输出高，其他为低。
2. 配置DMA通道，设置源地址为pattern数组的地址，目标地址为GPIOx->ODR的地址（或GPIOx->BSRR）。
3. 配置DMA为存储器到外设模式，数据宽度为半字（16位），并设置自动重载和循环模式（如果需要重复输出波形）。
4. 配置一个定时器（如TIM）来触发DMA请求。定时器的更新频率就决定了你输出每个电平样式的周期，从而精确控制了整个波形的时序。
5. 启动定时器和DMA，然后你就可以不管了，波形会自动、精准地输出。

实战案例：驱动WS2812B。WS2812B是一种智能RGB LED，它需要一根单总线传输24bit的GRB数据，每个bit用高低电平的不同占空比来表示‘0’和‘1’，时序要求非常严格（误差±150ns）。用CPU翻转GPIO来拼时序，极易受中断干扰。高级的做法是用PWM+DMA产生波形，但更直接的一种“比特轰炸”法，就是利用上述的DMA到GPIO。我们预先计算好驱动一整条灯带所有LED所需的所有电平样式的数组（可能长达数千个元素），然后用一个高速定时器（如48MHz系统时钟下，定时器频率设为24MHz）去触发DMA，将数组数据源源不断地“灌”到GPIO引脚。这种方法可以实现极高的刷新率，且CPU占用率几乎为零。虽然实现起来稍复杂，但一旦调通，稳定性和性能是无与伦比的。

5. 常见问题排查与性能优化

即使理解了原理，实际开发中还是会遇到各种奇怪的问题。这里分享几个典型的GPIO相关故障排查思路和优化建议。

5.1 “我的引脚输出没反应！”——系统性排查流程

1. 检查时钟：这是第一位的。用调试器查看RCC_AHBxENR寄存器（对于你的系列，可能是AHB1、AHB2等），确认对应GPIO端口的时钟使能位是否为1。或者检查代码中是否有__HAL_RCC_GPIOx_CLK_ENABLE()。
2. 检查模式寄存器：在调试器Peripheral窗口中查看GPIOx_MODER，确认对应引脚的2位是否被正确设置为输出模式（01）。
3. 检查锁定寄存器：如果之前不小心操作了GPIOx_LCKR并锁定了配置，那么后续对MODER、OTYPER等的修改都会无效。检查或尝试复位该寄存器。
4. 检查复用功能：如果你之前将这个引脚用于其他复用功能（如USART），但没有完全关闭那个外设，或者复用模式没有清除，它可能会和你的通用输出冲突。确保MODER不是复用模式（10），或者如果要用作通用输出，先彻底禁用相关的外设时钟和配置。
5. 检查硬件连接：用万用表测量引脚对地电压。即使软件错了，如果配置成了输出，电压也应该是稳定的0V或3.3V。如果电压是浮动的，可能是引脚配置成了输入模式，或者外部电路有强下拉/上拉。检查PCB是否有短路、虚焊，LED是否接反。
6. 检查代码逻辑：你的HAL_GPIO_WritePin或GPIOx->BSRR真的被执行到了吗？有没有可能被条件判断跳过？在写操作前后加个printf或者翻转一个调试用的LED来验证。

5.2 驱动能力与电平兼容性问题

问题：STM32的GPIO引脚驱动能力是有限的，通常单个引脚最大输出电流在20-25mA，整个端口有最大总电流限制（如80mA）。直接驱动大功率LED、电机或继电器线圈可能会损坏芯片或导致电压跌落，系统不稳定。

解决方案：

• 驱动LED：一定要串联限流电阻。计算公式：R = (Vcc - Vf_led) / I_led。其中Vcc是3.3V，Vf_led是LED正向压降（通常1.8-2.2V），I_led是期望电流（通常3-10mA）。一个470Ω到1kΩ的电阻是常见选择。
• 驱动继电器/电机：必须使用三极管或MOS管作为开关，GPIO仅提供控制信号。同时，继电器线圈两端一定要并联一个续流二极管，防止关断时产生的反向电动势击穿三极管。
• 5V兼容：只有标注为“FT”（5V Tolerant）的引脚才能耐受5V输入。对于输出，最安全的方式是使用开漏模式加外部上拉到5V，或者使用电平转换芯片（如TXS0108E、74LVC4245）。

5.3 开关噪声与去耦电容

当GPIO高速切换（特别是驱动容性负载时），会产生瞬间的大电流，在电源和地线上引起噪声，可能影响ADC采样精度甚至导致系统复位。

优化措施：

1. 就近放置去耦电容：在每个STM32的VDD和VSS引脚附近，尽可能靠近地放置一个100nF的陶瓷电容。这是必须的，用于提供高速切换时的局部电荷。
2. 合理选择输出速度：在满足时序要求的前提下，尽量选择较低的输出速度（GPIO_SPEED_FREQ_LOW）。更慢的压摆率意味着更小的di/dt，产生的噪声更小。
3. 布局布线：GPIO控制线，特别是高速线（如SPI CLK），尽量短，远离模拟信号线（如ADC输入）和晶振电路。

5.4 初始化顺序的坑

有些外设对GPIO的初始化顺序有要求。一个典型的例子是JTAG/SWD调试接口。STM32上电后，PA13(SWDIO)、PA14(SWCLK)、PA15(JTDI)、PB3(JTDO)、PB4(NJTRST)这几个引脚默认是调试复用功能。如果你在初始化代码中，先初始化了PA15或PB3/PB4为普通GPIO，可能会导致调试器无法连接，进而无法下载和调试程序。

正确的做法是，在main函数一开始，就先禁用JTAG（如果不用的话），释放这些引脚。

// 对于STM32F1系列，禁用JTAG，启用SWD __HAL_AFIO_REMAP_SWJ_DISABLE(); // 完全禁用，不推荐，会失去调试功能 // 更推荐：禁用JTAG，但保持SWD启用 __HAL_AFIO_REMAP_SWJ_NOJTAG();

对于其他系列，可能需要操作RCC_APB2ENR中的AFIOEN位，并配置AFIO_MAPR寄存器。最好的参考是CubeMX生成的代码或标准库中的相关例程。

GPIO是STM32世界的大门，它看似简单，却内涵丰富。从最基础的电路原理，到寄存器操作，再到与中断、DMA等高级功能的联动，每一步都考验着开发者对硬件和软件协同工作的理解。我见过太多项目，因为GPIO配置不当导致系统不稳定、功耗异常、通信失败。希望这篇长文能帮你建立起一个系统性的GPIO知识框架。下次当你点亮一个LED，或读取一个按键时，你能清楚地知道电流是如何流动的，寄存器是如何变化的，代码是如何与硅晶片对话的。这才是嵌入式开发真正的乐趣所在。