STM32F1系列PB3/PB4/PA15引脚配置为普通IO的完整指南

1. 项目概述：为什么这三个引脚如此特殊？

在STM32的开发过程中，尤其是对于刚接触F1系列或者从其他单片机转过来的朋友，配置PB3、PB4、PA15这几个引脚作为普通IO口输出高低电平，绝对算得上是一个经典的“新手坑”。你可能兴致勃勃地写好了代码，编译通过，满怀期待地接上LED，结果发现灯死活不亮，或者逻辑完全不对。用万用表一量，电压纹丝不动。这时候，千万别急着怀疑人生，也别觉得是自己的代码功底不行。问题大概率就出在这几个引脚的“特殊身份”上。

简单来说，PB3、PB4、PA15这三个引脚在STM32芯片上，默认情况下并非普通的GPIO，而是被复用为JTAG/SWD调试接口的功能。JTAG和SWD是两种非常重要的芯片调试和程序下载协议。为了保证芯片在上电后能够被调试器（如ST-Link、J-Link）正常识别和连接，芯片内部在上电复位后，会默认将这几个引脚锁定为调试功能。如果你不主动去“解锁”它们，那么无论你在代码里如何配置GPIO的模式和速度，它们都不会响应你的控制，因为它们根本就没工作在GPIO模式下。

这个设计初衷是为了方便：你焊好一块新板子，接上调试器就能直接下载程序、在线调试，无需任何额外的初始化代码。但对于我们开发者，当板子上的IO口资源紧张，需要把这几个引脚也用作普通按键输入、LED驱动、控制继电器时，就必须先完成这个“功能切换”的操作。这个过程，我们通常称之为“引脚重映射”或“调试接口引脚释放”。理解了这一点，你就掌握了解决这个问题的钥匙。

2. 核心原理：JTAG/SWD与AFIO重映射

要彻底搞定这几个引脚，不能只停留在“照着代码敲”的层面，得明白背后的寄存器操作逻辑。这涉及到两个关键的外设：AFIO（Alternate Function I/O，复用功能I/O）和调试端口控制器。

2.1 JTAG与SWD调试接口简析

STM32支持两种主流的调试接口：

• JTAG：使用5根线（TMS、TCK、TDI、TDO、nTRST），功能全面，但占用引脚多。PB3、PB4、PA15以及PB13、PB14都参与其中。
• SWD：一种简化的2线制（SWDIO、SWCLK）调试协议，由ARM公司推出，是目前最常用的方式，它只占用PA13（SWDIO）和PA14（SWCLK）。

芯片复位后，默认是JTAG-DP（调试端口）和SW-DP同时启用的状态。这意味着PA13、PA14、PA15、PB3、PB4都被调试功能占用。我们的目标就是关闭JTAG-DP，释放PA15、PB3、PB4；或者根据情况，进行更灵活的配置。

2.2 AFIO重映射寄存器详解

控制这些调试引脚功能切换的，是AFIO模块下的AFIO_MAPR（复用重映射和调试I/O配置寄存器）。我们操作的核心就是这个寄存器。

AFIO_MAPR寄存器中与调试配置相关的位域主要是SWJ_CFG[2:0]（位于位[26:24]）。这三位组合决定了调试接口的模式：

注意：上表只列出了常用配置，其他组合可能保留或无效。对于我们最常见的“保留SWD调试功能，释放PB3,PB4,PA15”的需求，对应的就是SWJ_CFG[2:0] = 001。

操作的关键步骤：

1. 首先，必须开启AFIO时钟。AFIO是一个独立的外设，它的时钟默认是关闭的，不开启时钟就无法写入其配置寄存器。

   RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE);

2. 然后，通过配置AFIO_MAPR寄存器的SWJ_CFG位域，选择我们需要的调试接口模式。

2.3 标准库与HAL库的差异

理解了寄存器操作，再看库函数就一目了然了。标准库（StdPeriph）和HAL库提供了封装好的函数，但底层逻辑一致。

• 标准库（StdPeriph）：使用GPIO_PinRemapConfig函数。

  // 禁用JTAG，启用SWD（释放PB3,PB4,PA15） GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE);

  这个函数内部会自动帮你开启AFIO时钟并配置AFIO_MAPR寄存器。

• HAL库 / LL库：没有直接封装好的单个函数，需要直接操作寄存器，或者调用__HAL_AFIO_REMAP_SWJ_...宏。更常见的做法是直接写寄存器，代码更清晰。

  // 在HAL库中，通常这样操作 __HAL_RCC_AFIO_CLK_ENABLE(); // 开启AFIO时钟 __HAL_AFIO_REMAP_SWJ_NOJTAG(); // 宏定义，其本质就是设置 SWJ_CFG=001 // 或者直接操作寄存器 // AFIO->MAPR |= AFIO_MAPR_SWJ_CFG_JTAGDISABLE;

3. 完整实操流程：从工程配置到代码实现

下面我们以一个具体的场景为例：在STM32F103C8T6（蓝色pill板）上，将PA15、PB3、PB4配置为推挽输出，驱动LED，并且要保留SWD下载调试功能。

3.1 硬件准备与连接

• MCU：STM32F103C8T6
• 调试器：ST-Link V2
• 目标引脚：
  • PA15 -> LED1（串联限流电阻，如1K）
  • PB3 -> LED2
  • PB4 -> LED3
• 关键点：ST-Link的SWD接口（SWDIO, SWCLK）务必连接到MCU的PA13和PA14。一旦我们禁用JTAG，PB3和PB4就不再是调试引脚，可以放心接LED。

3.2 使用STM32CubeMX图形化配置（HAL库）

对于新手或追求开发效率，CubeMX是绝佳工具，它能可视化地解决这个问题。

1. 新建工程，选择你的芯片型号（STM32F103C8T6）。
2. 引脚分配视图：
   • 找到PA15、PB3、PB4，鼠标点击，选择为GPIO_Output。
   • 你会发现，当你点击它们时，CubeMX可能会弹出警告，提示这些引脚当前被JTDO、NJTRST等功能占用。这是正常的。
3. 系统核心配置：
   • 在左侧分类中找到System Core->SYS。
   • 在Debug下拉菜单中，选择Serial Wire。这一步至关重要！它告诉CubeMX：“我只要SWD调试，不要JTAG”。CubeMX会自动生成代码，将SWJ_CFG配置为001模式。
4. GPIO配置：
   • 进入System Core->GPIO。
   • 分别点击PA15、PB3、PB4，在右侧配置它们的模式为Output Push Pull，输出速度可以选Low（驱动LED足够），并为它们设置一个用户标签，比如LED1、LED2、LED3，这样生成的代码可读性更好。
5. 生成代码：
   • 配置好工程名、路径、IDE（如Keil MDK），然后生成代码。
   • CubeMX生成的main.c中，在main函数初始化部分，你会看到MX_GPIO_Init()函数，里面已经包含了GPIO的初始化代码。更重要的是，在SystemClock_Config等相关初始化流程中，CubeMX已经通过HAL库的机制，正确地配置了调试接口模式。

3.3 标准库（StdPeriph）手动代码实现

如果你在使用标准库，或者想更清晰地理解整个过程，可以手动编写如下代码：

#include "stm32f10x.h" void GPIO_Configuration(void); void Delay_ms(uint32_t nms); // 简单的延时函数，可用SysTick实现 int main(void) { // 1. 开启外设时钟（必须！） // 开启GPIOA和GPIOB的时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOB, ENABLE); // 开启AFIO时钟，这是重映射的前提！ RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE); // 2. 关键一步：禁用JTAG，启用SWD（释放PB3,PB4,PA15） GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE); // 3. 配置PA15, PB3, PB4为推挽输出 GPIO_InitTypeDef GPIO_InitStructure; // 配置PA15 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_15; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; // 推挽输出 GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; // 输出速度 GPIO_Init(GPIOA, &GPIO_InitStructure); // 配置PB3和PB4 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_3 | GPIO_Pin_4; GPIO_Init(GPIOB, &GPIO_InitStructure); // 4. 主循环，LED闪烁 while(1) { GPIO_SetBits(GPIOA, GPIO_Pin_15); // PA15高，LED灭（假设LED阴极接GPIO） GPIO_SetBits(GPIOB, GPIO_Pin_3 | GPIO_Pin_4); Delay_ms(500); GPIO_ResetBits(GPIOA, GPIO_Pin_15); // PA15低，LED亮 GPIO_ResetBits(GPIOB, GPIO_Pin_3 | GPIO_Pin_4); Delay_ms(500); } } // 简单的毫秒延时函数（基于SysTick，此处为示例框架） void Delay_ms(uint32_t nms) { // ... 实现SysTick延时或循环延时 }

代码要点解析：

• 顺序很重要：必须先开启AFIO时钟，再进行重映射配置。如果顺序颠倒，重映射配置将不会生效。
• GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE);这一行就是魔法所在。GPIO_Remap_SWJ_JTAGDisable这个宏定义，对应的就是SWJ_CFG=001的模式。
• 之后的GPIO初始化，就和配置普通IO口没有任何区别了。

3.4 使用寄存器直接操作（理解本质）

对于追求极致控制或学习寄存器的人来说，可以直接操作：

// 开启时钟 RCC->APB2ENR |= RCC_APB2ENR_IOPAEN | RCC_APB2ENR_IOPBEN | RCC_APB2ENR_AFIOEN; // 关键：配置AFIO_MAPR寄存器，禁用JTAG，使能SWD AFIO->MAPR &= ~AFIO_MAPR_SWJ_CFG; // 先清零SWJ_CFG位域 AFIO->MAPR |= AFIO_MAPR_SWJ_CFG_JTAGDISABLE; // 设置为001模式 // 配置GPIO（以PB3为例，推挽输出，50MHz） GPIOB->CRL &= ~(GPIO_CRL_MODE3 | GPIO_CRL_CNF3); // 清零模式与配置位 GPIOB->CRL |= (GPIO_CRL_MODE3_0 | GPIO_CRL_MODE3_1); // 输出模式，最大速度50MHz // CNF位默认为00（推挽输出），所以无需再设置

4. 深度避坑指南与高级应用

掌握了基本操作，下面这些“坑”和扩展知识能让你在项目中更加游刃有余。

4.1 常见问题排查（为什么我的灯还是不亮？）

1. 问题：代码烧录后，LED无反应，但调试器连接正常。

   • 检查1：AFIO时钟开启了吗？这是最容易被忽略的一步。没有时钟，任何对AFIO寄存器的写操作都是无效的。务必在重映射前加上RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE);。
   • 检查2：重映射函数调用位置对吗？重映射配置必须在GPIO初始化之前。如果先初始化了GPIO，再去重映射，GPIO的初始化配置可能因为引脚功能被锁定而未能正确写入。
   • 检查3：你用的是SWD接口吗？确保你的调试器连接的是PA13(SWDIO)和PA14(SWCLK)。如果你错误地连接到了PB3/PB4，在禁用JTAG后，这些引脚不再是调试接口，自然无法下载程序。
   • 检查4：程序真的跑起来了吗？用调试器单步执行，看看程序是否卡在了某个初始化环节（如时钟配置错误）。或者，在GPIO操作后加一个简单的延时，再读取该引脚的电平寄存器（GPIOx->IDR），看看软件层面的控制是否生效。

2. 问题：我想完全释放PA13和PA14用作普通IO，该怎么操作？

   • 方案：将SWJ_CFG配置为100（完全禁用JTAG和SWD）。但务必注意：一旦禁用SWD，你将无法再通过SWD接口下载程序或调试！除非你通过其他方式（如串口ISP、RAM中运行的程序）来重新启用SWD，否则芯片可能“变砖”（无法直接调试）。强烈不建议在产品代码中这样做，除非有非常特殊的硬件设计和完备的恢复方案。
   • 代码（标准库）：GPIO_PinRemapConfig(GPIO_Remap_SWJ_Disable, ENABLE);

3. 问题：我用的不是F1系列，是F4/F7/H7，方法一样吗？

   • 答案：原理类似，但具体寄存器不同。在STM32F4等系列中，调试端口的配置通常不在AFIO模块（F1特有），而是在一个独立的“DBGMCU”（调试MCU）模块中，通过DBGMCU_APBx_FZ或DBGMCU->CR寄存器来控制。例如，在F4中，你需要配置DBGMCU->CR的某些位来禁止调试功能，从而释放引脚。务必查阅对应系列的《参考手册》中“调试支持”章节。

4.2 高级话题：复用功能与重映射的优先级

PB3、PB4、PA15除了默认的调试功能，还可能被重映射为其他外设功能，比如定时器的通道、串口等。这里存在一个优先级问题：

1. 调试功能（最高优先级，复位默认）：如果调试接口启用，则引脚归调试功能。
2. GPIO重映射配置：通过AFIO_MAPR的SWJ_CFG位，可以降级调试功能的优先级，释放引脚。
3. 外设复用功能重映射：引脚被释放为普通IO后，还可以通过AFIO_MAPR的其他位（如USART2_REMAP,TIM2_REMAP等）映射到特定外设。
4. 普通GPIO功能（最低优先级）：当以上功能都未启用时，引脚就是普通IO。

操作顺序：如果你想将PB3用作定时器通道，你需要：先禁用JTAG（释放引脚），再配置该引脚的重映射到对应定时器，最后初始化定时器和GPIO的复用功能模式。

4.3 在RTOS或复杂工程中的注意事项

在基于RTOS或具有复杂初始化流程的工程中，引脚配置的时机需要仔细考量。

• 最佳实践：将调试引脚的释放和GPIO初始化放在同一个初始化函数中，并且确保这个函数在系统时钟初始化之后、任何可能使用这些GPIO的任务启动之前被调用。通常，放在main函数中硬件初始化阶段的最前面部分是比较安全的。
• 避免在中断中动态切换：不要试图在中断服务程序或某个任务运行时，动态地去开启/关闭JTAG功能来切换引脚模式。这可能导致调试会话意外中断，或引发不可预知的行为。
• 库的兼容性：如果你混合使用标准库和HAL库，或者使用第三方中间件，要留意它们是否对AFIO或调试端口有自己的初始化代码。可能存在配置冲突，需要仔细梳理初始化顺序。

4.4 实测心得：示波器与逻辑分析仪是你的好帮手

当代码逻辑没问题，但硬件行为异常时，仪器测量能提供最直接的证据。

• 用示波器：在程序运行后，直接测量PA15、PB3、PB4引脚上的波形。如果能看到按照你代码逻辑变化的方法，说明软件配置完全正确，问题可能出在外部电路（如LED接反、电阻过大、短路等）。
• 用逻辑分析仪：可以同时抓取多个引脚的电平变化，并与你的代码逻辑时序进行对比，非常适合排查复杂的多引脚协同工作问题，比如模拟SPI、I2C通信时，这些引脚作为时钟或数据线是否正常。

5. 项目总结与扩展思考

搞定PB3、PB4、PA15这几个引脚，本质上是对STM32芯片启动和引脚功能管理机制的一次深入理解。它不是一个孤立的技巧，而是反映了嵌入式开发中“资源管理与配置”的核心思想。芯片出厂时为了通用性和易用性，会有一个默认状态；而我们开发者，则需要根据自己产品的具体需求，去精细地配置每一份资源。

从这个点出发，你可以进一步思考：

• 其他系列芯片：尝试在STM32F4、G0等系列上，查找并实践释放调试引脚的方法，对比与F1的异同，加深对ARM Cortex-M内核调试体系的理解。
• 引脚复用规划：在设计产品硬件原理图时，就要提前规划好每个引脚的功能。如果要用到PA15，就要预留SWD接口到PA13/PA14，并避免使用PB3/PB4作为关键的上电初始化信号（因为默认它们不是GPIO）。
• Bootloader与APP的配合：在一些需要Bootloader的应用中，Bootloader和应用程序（APP）对调试引脚、时钟、中断向量表等的配置必须兼容。如果Bootloader禁用了SWD，而APP又依赖它，就会出问题。这需要全局的、系统级的规划。

最后，一个小技巧：当你拿到一款新的STM32芯片，不确定某个引脚默认功能时，第一件事就是打开它的数据手册（Datasheet），查看“Pinouts and pin description”章节，那里会明确列出每个引脚复位后的默认功能（Alternate function）。而对于配置方法，则要查阅参考手册（Reference Manual）中对应的外设（如GPIO、AFIO、DBGMCU）章节。养成查阅官方文档的习惯，是解决一切底层硬件问题的终极法宝。