别再踩坑了！STM32F103C8T6的PB3/PB4/PA15引脚当普通IO口用的完整配置流程（附MDK设置截图）-编程阁

STM32F103C8T6特殊引脚配置全攻略：从原理到实践的深度解析

第一次点亮STM32开发板上的LED时，那种成就感令人难忘。但当你把LED连接到PB3、PB4或PA15引脚时，却发现无论如何修改代码，LED都固执地保持黑暗——这种挫败感同样令人印象深刻。这不是你的代码有问题，而是遇到了STM32开发中最经典的"新手陷阱"之一：调试引脚复用问题。

1. 问题根源：为什么这些引脚如此特殊？

STM32F103C8T6的PB3、PB4和PA15引脚在芯片设计时被赋予了双重身份。上电复位后，它们默认作为JTAG/SWD调试接口的功能引脚：

PB3：JTDO/TRACESWO（JTAG数据输出/异步跟踪输出）
PB4：NJTRST（JTAG复位）
PA15：JTDI（JTAG数据输入）

这种设计带来了一个开发中的矛盾：调试接口对于程序下载和调试至关重要，但开发者也希望充分利用所有GPIO资源。当你在原理图上将这些引脚连接为普通I/O时，实际上它们仍然被锁定在调试功能上，这就是导致"引脚无反应"的根本原因。

提示：即使你不使用JTAG调试器，这些引脚的调试功能默认也是启用的，必须显式关闭才能作为GPIO使用。

2. 完整配置流程：从时钟初始化到功能切换

2.1 基础环境准备

在开始配置前，确保你的开发环境已经正确设置：

安装MDK-ARM（Keil）或STM32CubeIDE
准备一个基于STM32F103C8T6的开发板
连接好ST-Link或其他调试器
创建一个新的工程，包含必要的启动文件和库

2.2 关键配置步骤

完整的引脚功能切换需要以下步骤：

启用AFIO时钟：
```
RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE);
```
这是第一步也是容易被忽略的一步，没有AFIO时钟，后续的重映射操作将无法生效。
关闭JTAG功能：
```
GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE);
```
这行代码将禁用JTAG功能，但保留SWD调试功能（这对大多数开发者来说已经足够）。
处理PB3的特殊情况： PB3除了作为JTDO外，还可能用于异步跟踪功能。要完全释放PB3，需要额外操作：
```
DBGMCU->CR &= ~DBGMCU_CR_TRACE_IOEN;
```
或者通过MDK设置关闭跟踪功能（后文详细介绍）。

2.3 GPIO初始化示例

完成上述配置后，这些引脚就可以像普通GPIO一样初始化和使用了：

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);

3. MDK开发环境中的关键设置

除了代码层面的配置，MDK-ARM中的一些设置也会影响这些引脚的行为：

关闭异步跟踪功能：
- 进入"Options for Target"对话框
- 选择"Debug"选项卡
- 点击"Settings"按钮
- 在"Trace"选项卡中，确保"Enable"复选框未被选中
调试器选择：如果你完全不需要JTAG，可以在"Debug"设置中选择"SW"而非"JTAG"模式，这可以避免一些潜在的冲突。
下载后复位行为：建议设置为"Reset and Run"，这样每次下载后芯片会重新初始化，确保配置生效。

4. 常见问题与高级技巧

4.1 为什么配置后引脚仍然不工作？

如果按照上述步骤配置后引脚仍然无响应，可以按以下顺序排查：

确认AFIO时钟确实已开启（检查RCC->APB2ENR寄存器）
验证重映射配置是否生效（查看AFIO->MAPR寄存器）
检查GPIO初始化代码是否正确
确保硬件连接没有问题（特别是上拉/下拉电阻配置）
确认没有其他外设占用了这些引脚

4.2 性能优化建议

当把这些引脚用作高速GPIO时，可以考虑以下优化：

将GPIO速度设置为最高（GPIO_Speed_50MHz）
如果用作输入，根据外部电路情况配置合适的上拉/下拉电阻
避免在同一个端口混合高速和低速引脚配置

4.3 多开发环境兼容方案

如果你需要在不同开发环境（如Keil、IAR、STM32CubeIDE）间切换，可以考虑使用条件编译来保证代码兼容性：

#if defined(__CC_ARM) || defined(__GNUC__) // Keil或GCC环境下的特殊配置 DBGMCU->CR &= ~DBGMCU_CR_TRACE_IOEN; #elif defined(__ICCARM__) // IAR环境下的等效配置 *(uint32_t*)0xE0042004 &= ~0x20; #endif

5. 实际应用案例：构建一个三色LED控制器

让我们通过一个实际项目来巩固这些知识。假设我们需要使用PA15、PB3和PB4控制一个RGB LED：

硬件连接：
- PA15 连接 LED的红色通道
- PB3 连接 LED的绿色通道
- PB4 连接 LED的蓝色通道

初始化代码：

void LED_GPIO_Init(void) { // 开启时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOB | RCC_APB2Periph_AFIO, ENABLE); // 关闭JTAG功能 GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE); // 关闭异步跟踪 DBGMCU->CR &= ~DBGMCU_CR_TRACE_IOEN; // 配置GPIO GPIO_InitTypeDef GPIO_InitStructure; // PA15 (Red) 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 (Green) 和 PB4 (Blue) GPIO_InitStructure.GPIO_Pin = GPIO_Pin_3 | GPIO_Pin_4; GPIO_Init(GPIOB, &GPIO_InitStructure); }

使用示例：

void SetLEDColor(uint8_t red, uint8_t green, uint8_t blue) { GPIO_WriteBit(GPIOA, GPIO_Pin_15, red ? Bit_SET : Bit_RESET); GPIO_WriteBit(GPIOB, GPIO_Pin_3, green ? Bit_SET : Bit_RESET); GPIO_WriteBit(GPIOB, GPIO_Pin_4, blue ? Bit_SET : Bit_RESET); }

通过这个案例，你可以看到，一旦正确配置，这些"特殊"引脚完全可以像普通GPIO一样可靠工作。