STM32F1引脚资源紧张？安全复用SWD引脚的工程实践指南
在嵌入式开发中，STM32F1系列因其性价比优势广受欢迎，但GPIO资源紧张的问题也时常困扰开发者。当项目需要更多I2C、SPI或普通GPIO时，那些被SWD/JTAG占用的引脚（PA13-PA15, PB3-PB5）就成了"看得见却用不了"的资源。本文将从实际工程角度，分享如何在不影响后续调试和固件更新的前提下，安全地复用这些宝贵引脚。
1. 理解SWD引脚复用的核心挑战
STM32F1的调试接口默认占用PA13(SWDIO)、PA14(SWCLK)、PA15(JTDI)、PB3(JTDO)和PB4(JTRST)等引脚。许多开发者尝试直接将这些引脚配置为GPIO时，会遇到两个典型问题：
- 硬件层面：即使代码中将引脚设置为GPIO模式，实际测量发现引脚状态异常
- 开发流程：禁用调试接口后，如何继续烧录和调试程序
问题的根源在于STM32的引脚复用优先级机制。调试接口的优先级高于普通GPIO，必须通过AFIO(Alternate Function I/O)寄存器明确配置才能释放这些引脚。
关键提示：在项目初期不建议立即禁用调试接口，应保留SWD功能直到主要功能开发完成
2. HAL库中的配置选项解析
HAL库提供了四个关键的宏定义来控制调试接口配置：
#define __HAL_AFIO_REMAP_SWJ_ENABLE() // 默认状态，启用全部JTAG+SWD #define __HAL_AFIO_REMAP_SWJ_NONJTRST() // 禁用NJTRST引脚(PB4) #define __HAL_AFIO_REMAP_SWJ_NOJTAG() // 禁用JTAG但保留SWD #define __HAL_AFIO_REMAP_SWJ_DISABLE() // 完全禁用JTAG和SWD这些宏对应的实际配置如下表所示：
| 配置选项 | JTAG-DP | SW-DP | 释放引脚 | 适用场景 |
|---|---|---|---|---|
| ENABLE | 启用 | 启用 | 无 | 默认状态，完整调试功能 |
| NONJTRST | 启用(无NJTRST) | 启用 | PB4 | 需要PB4作GPIO时 |
| NOJTAG | 禁用 | 启用 | PA15,PB3,PB4 | 需要JTAG引脚但保留SWD调试 |
| DISABLE | 禁用 | 禁用 | 全部 | 需要最大GPIO资源时 |
实际项目选择建议：
- 开发阶段使用
NOJTAG模式，保留SWD调试能力 - 量产固件可使用
DISABLE模式，但必须确保留有其他更新方式
3. 分阶段实施的工程实践
3.1 开发阶段：保留调试能力
在功能开发期间，建议采用以下配置：
void GPIO_Init(void) { __HAL_RCC_AFIO_CLK_ENABLE(); __HAL_AFIO_REMAP_SWJ_NOJTAG(); // 禁用JTAG但保留SWD // 配置PA15,PB3,PB4为所需功能 GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = GPIO_PIN_15; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; HAL_GPIO_Init(GPIOA, &GPIO_InitStruct); // 其他初始化代码... }这种配置下：
- 仍可通过SWD接口(PA13,PA14)进行调试
- PA15,PB3,PB4可用作普通GPIO
- 开发流程不受影响
3.2 稳定阶段：完全释放引脚
当功能稳定准备量产时，可考虑完全释放所有调试引脚：
void GPIO_FullRelease(void) { __HAL_RCC_AFIO_CLK_ENABLE(); __HAL_AFIO_REMAP_SWJ_DISABLE(); // 完全禁用调试接口 // 配置所有原调试引脚 GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = GPIO_PIN_13 | GPIO_PIN_14 | GPIO_PIN_15; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; HAL_GPIO_Init(GPIOA, &GPIO_InitStruct); // PB3-PB4配置 GPIO_InitStruct.Pin = GPIO_PIN_3 | GPIO_PIN_4; HAL_GPIO_Init(GPIOB, &GPIO_InitStruct); }重要注意事项：
- 执行此操作后，常规SWD调试将不可用
- 必须确保留有其他固件更新方式，如：
- 通过UART的Bootloader
- 预留硬件复位进入系统存储区的方式
- 使用NRST引脚强制进入编程模式
3.3 固件更新策略
禁用SWD后，可靠的固件更新机制尤为关键。以下是几种常用方案对比：
| 更新方式 | 所需资源 | 速度 | 可靠性 | 实现复杂度 |
|---|---|---|---|---|
| UART Bootloader | UART+特定引脚 | 慢 | 高 | 低 |
| USB DFU | USB接口 | 中 | 高 | 中 |
| IAP(应用内编程) | 任意通信接口 | 取决于接口 | 中 | 高 |
| SPI Flash编程 | SPI接口+外部存储 | 快 | 高 | 中 |
推荐组合方案：
- 主应用程序通过UART实现IAP功能
- 备份Bootloader存储在系统存储区
- 通过特定引脚组合触发更新模式
4. 常见问题与调试技巧
4.1 引脚状态异常排查
当复用引脚不按预期工作时，建议按以下步骤排查：
确认时钟配置：
__HAL_RCC_AFIO_CLK_ENABLE(); // 必须开启AFIO时钟 __HAL_RCC_GPIOx_CLK_ENABLE(); // 开启对应GPIO组时钟检查复用优先级：
- 调试接口 > GPIO
- 确保已调用正确的
__HAL_AFIO_REMAP_SWJ_xxx宏
验证硬件连接：
- 确认没有外部电路影响引脚状态
- 检查复位电路是否正常工作
4.2 开发调试技巧
条件编译管理：使用宏控制不同阶段的配置
#define DEVELOPMENT_MODE 1 void Init_DebugPins(void) { #if DEVELOPMENT_MODE __HAL_AFIO_REMAP_SWJ_NOJTAG(); #else __HAL_AFIO_REMAP_SWJ_DISABLE(); #endif }版本回退机制：在代码中保留硬件复位恢复SWD的功能
if(HAL_GPIO_ReadPin(BUTTON_GPIO_Port, BUTTON_Pin) == GPIO_PIN_RESET) { // 长按按键时恢复默认调试配置 __HAL_AFIO_REMAP_SWJ_ENABLE(); NVIC_SystemReset(); // 系统复位 }
5. 工程实例：复用SWD引脚实现多路I2C
以下是一个实际项目中复用PA15和PB3作为I2C接口的完整示例：
// i2c_sw.c #include "stm32f1xx_hal.h" #define USE_DEBUG_PINS_AS_I2C 1 void I2C_Init(void) { GPIO_InitTypeDef GPIO_InitStruct = {0}; // 1. 启用必要时钟 __HAL_RCC_GPIOA_CLK_ENABLE(); __HAL_RCC_GPIOB_CLK_ENABLE(); __HAL_RCC_AFIO_CLK_ENABLE(); // 2. 根据模式配置调试引脚 #if USE_DEBUG_PINS_AS_I2C __HAL_AFIO_REMAP_SWJ_NOJTAG(); // 开发阶段保留SWD // 3. 配置PA15(SCL)和PB3(SDA)为开漏输出 GPIO_InitStruct.Pin = GPIO_PIN_15; GPIO_InitStruct.Mode = GPIO_MODE_AF_OD; GPIO_InitStruct.Pull = GPIO_PULLUP; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOA, &GPIO_InitStruct); GPIO_InitStruct.Pin = GPIO_PIN_3; HAL_GPIO_Init(GPIOB, &GPIO_InitStruct); #endif // 软件I2C初始化代码... } // 量产版本切换为完全释放模式 void I2C_ReleaseFull(void) { __HAL_AFIO_REMAP_SWJ_DISABLE(); // 重新初始化所有引脚 I2C_Init(); }在项目开发中，我们通过这种分阶段的方式，既保证了开发效率，又能在最终产品中最大化利用GPIO资源。实际测试发现，复用后的I2C接口稳定性与常规GPIO实现的I2C无明显差异，通信速率可达400kHz。
