STM32 HAL库实战：释放PB3-5和PA13-15引脚做I2C，别再被SWD/JTAG坑了

STM32 HAL库实战：释放PB3-5和PA13-15引脚做I2C，别再被SWD/JTAG坑了

刚接触STM32开发时，很多人都遇到过这样的困惑：明明按照手册配置了PB3-5或PA13-15引脚作为I2C接口，但无论如何调试都无法正常工作。这往往是因为忽略了这些引脚的默认功能——它们被设计为SWD/JTAG调试接口。本文将深入解析HAL库中相关配置的底层逻辑，提供可直接复用的代码方案，并分享几个实际项目中的避坑经验。

1. 问题根源：调试接口与GPIO的冲突

STM32微控制器在设计时，为了节省引脚资源，将调试功能与普通GPIO功能复用在了同一组引脚上。具体来说：

• PB3：默认作为JTAG的TDO（Test Data Out）
• PB4：默认作为JTAG的NTRST（JTAG Reset）
• PB5：默认作为JTAG的TDI（Test Data In）
• PA13：默认作为SWDIO（Serial Wire Debug I/O）
• PA14：默认作为SWCLK（Serial Wire Debug Clock）
• PA15：默认作为JTAG的TMS（Test Mode Select）

这些引脚在芯片复位后默认启用调试功能，如果不进行特殊配置，直接将其作为普通GPIO使用会导致功能异常。常见症状包括：

• 引脚电平无法正常控制
• I2C通信无响应
• 系统异常复位
• 调试器无法连接（如果完全禁用调试接口）

2. HAL库的配置关键：AFIO重映射

与标准库不同，HAL库提供了更抽象的接口来管理这些特殊功能。核心在于stm32f1xx_hal_gpio_ex.h头文件中定义的几个宏：

#define __HAL_AFIO_REMAP_SWJ_ENABLE() // 启用完整SWJ（JTAG+SWD） #define __HAL_AFIO_REMAP_SWJ_NONJTRST() // 启用SWJ但不使用NJTRST #define __HAL_AFIO_REMAP_SWJ_NOJTAG() // 禁用JTAG，保留SWD #define __HAL_AFIO_REMAP_SWJ_DISABLE() // 完全禁用SWJ（JTAG+SWD）

关键区别：

实际项目中常见的错误是只调用了__HAL_AFIO_REMAP_SWJ_NOJTAG()，这会导致PA13和PA14仍然被SWD占用。正确的做法是根据需求选择：

• 如果不需要调试功能：使用__HAL_AFIO_REMAP_SWJ_DISABLE()
• 如果需要保留SWD调试：使用__HAL_AFIO_REMAP_SWJ_NOJTAG()，并避免使用PA13-14

3. 完整实现方案

下面是一个完整的I2C引脚初始化示例，假设我们使用PB6(SCL)和PB7(SDA)作为主I2C接口，同时释放PB3-5作为普通GPIO：

void GPIO_Init(void) { // 启用时钟 __HAL_RCC_GPIOB_CLK_ENABLE(); __HAL_RCC_AFIO_CLK_ENABLE(); // 关键配置：完全禁用调试接口 __HAL_AFIO_REMAP_SWJ_DISABLE(); // 配置I2C引脚 GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = GPIO_PIN_6 | GPIO_PIN_7; GPIO_InitStruct.Mode = GPIO_MODE_AF_OD; GPIO_InitStruct.Pull = GPIO_PULLUP; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOB, &GPIO_InitStruct); // 配置PB3-5为普通输出 GPIO_InitStruct.Pin = GPIO_PIN_3 | GPIO_PIN_4 | GPIO_PIN_5; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Pull = GPIO_NOPULL; HAL_GPIO_Init(GPIOB, &GPIO_InitStruct); }

几个实用技巧：

1. 调试接口的取舍：

   • 开发阶段建议保留NOJTAG配置，以便通过SWD调试
   • 量产版本可以使用DISABLE释放全部引脚

2. 初始化顺序：

   // 正确顺序示例 HAL_Init(); SystemClock_Config(); __HAL_RCC_AFIO_CLK_ENABLE(); __HAL_AFIO_REMAP_SWJ_DISABLE(); // 其他外设初始化

3. CubeMX配置：

   • 在Pinout视图禁用SWJ
   • 或在代码生成后手动添加重映射代码

4. 常见问题排查

即使按照上述步骤配置，仍可能遇到一些问题。以下是几个典型场景的解决方案：

问题1：下载程序后无法再次调试

这是因为完全禁用了SWD接口。解决方法：

• 按住复位键点击下载，在释放复位键的瞬间完成下载
• 使用串口ISP模式重新烧录带调试接口的固件

问题2：PB4无法正常控制

检查是否误用了NONJTRST模式。该模式仅释放PB4(NJTRST)，其他调试引脚仍被占用。

问题3：I2C通信不稳定

确保在禁用调试接口后：

• 正确配置了GPIO的复用功能
• 上拉电阻已启用（硬件或软件）
• 时钟配置正确

// 典型I2C初始化 hi2c1.Instance = I2C1; hi2c1.Init.ClockSpeed = 100000; hi2c1.Init.DutyCycle = I2C_DUTYCYCLE_2; hi2c1.Init.OwnAddress1 = 0; hi2c1.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT; hi2c1.Init.DualAddressMode = I2C_DUALADDRESS_DISABLE; hi2c1.Init.OwnAddress2 = 0; hi2c1.Init.GeneralCallMode = I2C_GENERALCALL_DISABLE; hi2c1.Init.NoStretchMode = I2C_NOSTRETCH_DISABLE; HAL_I2C_Init(&hi2c1);

5. 进阶应用：动态切换调试接口

在一些特殊场景下，可能需要运行时切换引脚功能。这需要更谨慎的处理：

void EnableDebugInterface(bool enable) { __HAL_RCC_AFIO_CLK_ENABLE(); if(enable) { __HAL_AFIO_REMAP_SWJ_NOJTAG(); // 恢复SWD功能 // 重新配置PA13,PA14为调试引脚 GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = GPIO_PIN_13 | GPIO_PIN_14; GPIO_InitStruct.Mode = GPIO_MODE_AF_PP; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOA, &GPIO_InitStruct); } else { __HAL_AFIO_REMAP_SWJ_DISABLE(); // 配置PA13,PA14为普通GPIO GPIO_InitStruct.Pin = GPIO_PIN_13 | GPIO_PIN_14; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; HAL_GPIO_Init(GPIOA, &GPIO_InitStruct); } }

注意事项：

• 动态切换可能导致调试器断开连接
• 切换期间避免引脚冲突
• 某些型号可能需要额外配置

通过以上方案，开发者可以灵活地管理这些特殊引脚，在调试需求和功能引脚之间取得平衡。实际项目中，建议在硬件设计阶段就规划好这些引脚的使用方式，避免后期麻烦。