1. 为什么需要解锁调试引脚在STM32开发中PB3、PB4和PA15这三个引脚比较特殊。它们默认被设计为调试接口功能比如JTAG和SWD。但在实际项目中我们经常会遇到PCB空间紧张的情况有时候不得不把这些引脚当作普通GPIO来使用。比如我最近做的一个智能家居项目因为PCB尺寸限制不得不把PA15用作LED控制引脚。这里有个关键点需要注意直接把这些引脚当普通IO用是不行的。上电后它们默认处于调试模式如果不进行特殊配置你会发现怎么设置GPIO都没反应。这就是为什么我们需要解锁这些引脚的功能。我在第一次尝试时也踩过这个坑明明代码里配置了PA15为输出模式但LED就是不亮后来才发现是调试功能没关闭。2. 硬件设计前的注意事项在画原理图之前有几点需要特别注意。首先如果项目需要完整的调试功能建议尽量避免使用这三个引脚作为GPIO。因为一旦关闭了JTAG功能就只能使用SWD模式进行调试了这会给开发带来一些限制。其次PB3这个引脚有个特殊之处它还与异步跟踪功能相关。这意味着即使关闭了JTAG如果异步跟踪功能还开着PB3仍然不能正常工作。我在一个电机控制项目中就遇到过这个问题当时花了好几个小时才找到原因。最后要考虑的是复位后的引脚状态。这些引脚在复位时会短暂处于调试模式如果连接的设备对电平敏感可能需要额外的硬件设计来确保安全。3. 软件配置详细步骤3.1 开启AFIO时钟第一步必须要开启AFIO的时钟这是很多人容易忽略的地方。AFIO(Alternate Function I/O)时钟控制着引脚复用功能不开启它后续的配置都不会生效。代码很简单RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE);这一步相当于给引脚复用功能上电。我在早期项目中经常忘记这行代码结果配置总是不生效后来养成了在初始化代码最前面就加上它的习惯。3.2 关闭JTAG功能接下来要关闭JTAG功能释放PB3、PB4和PA15。这里有个选项需要注意我们可以选择完全关闭JTAG或者保留SWD功能。大多数调试器都支持SWD模式所以通常我们选择只关闭JTAGGPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE);执行这行代码后PB4和PA15就可以正常作为GPIO使用了。但PB3还需要额外处理因为它还涉及到异步跟踪功能。3.3 处理PB3的异步跟踪功能PB3比较特殊即使关闭了JTAG如果异步跟踪功能还开着它仍然不能作为普通GPIO使用。关闭异步跟踪有两种方法第一种是通过寄存器直接操作DBGMCU-CR ~((uint32_t)15);第二种方法是在MDK开发环境中设置。在Options for Target - Debug - Trace选项卡中取消勾选Trace Enable。这个方法更适合不想修改代码的情况。我在实际项目中发现第一种方法更可靠因为它不依赖于开发环境设置代码移植性更好。4. 完整配置示例下面给出一个完整的配置示例以STM32F103C8T6为例将PA15配置为推挽输出PB3和PB4配置为输入void DebugPin_GPIO_Init(void) { // 1. 开启AFIO时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE); // 2. 关闭JTAG保留SWD GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE); // 3. 关闭异步跟踪功能 DBGMCU-CR ~((uint32_t)15); // 4. 配置GPIO GPIO_InitTypeDef GPIO_InitStructure; // 配置PA15为推挽输出 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); 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为输入 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); GPIO_InitStructure.GPIO_Pin GPIO_Pin_3 | GPIO_Pin_4; GPIO_InitStructure.GPIO_Mode GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOB, GPIO_InitStructure); }这个配置我在多个项目中都使用过稳定性很好。需要注意的是GPIO配置一定要在关闭JTAG和异步跟踪之后进行否则不会生效。5. 常见问题排查在实际使用中可能会遇到各种问题。下面分享几个我遇到过的典型问题及解决方法问题1配置后引脚仍然不工作检查顺序是否正确必须先开启AFIO时钟然后关闭JTAG最后配置GPIO。我曾经因为把GPIO配置放在最前面导致配置无效。问题2PB3工作不稳定这很可能是异步跟踪功能没有完全关闭。除了代码中关闭还要检查开发环境设置确保没有其他地方又开启了跟踪功能。问题3无法使用JTAG调试因为关闭了JTAG功能只能使用SWD模式调试。确认你的调试器支持SWD并且连线正确。SWD只需要四根线VCC、GND、SWDIO和SWCLK。问题4复位后引脚状态异常这些引脚在复位瞬间会短暂处于调试模式。如果连接的设备对电平敏感可以在硬件上加下拉电阻或者在软件初始化时尽快配置引脚状态。6. 不同STM32系列的注意事项虽然基本原理相同但不同系列的STM32在细节上有些差异。以STM32F1和STM32F4为例在STM32F4系列中配置方法略有不同。AFIO时钟的概念被取消了取而代之的是直接配置调试寄存器和复用功能。关闭JTAG的代码变为RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOB, ENABLE); GPIO_PinAFConfig(GPIOA, GPIO_PinSource15, GPIO_AF_0); GPIO_PinAFConfig(GPIOB, GPIO_PinSource3, GPIO_AF_0); GPIO_PinAFConfig(GPIOB, GPIO_PinSource4, GPIO_AF_0);对于HAL库用户可以使用以下代码__HAL_RCC_AFIO_CLK_ENABLE(); __HAL_AFIO_REMAP_SWJ_NOJTAG();建议在使用前查阅对应型号的参考手册确认具体的寄存器配置方法。我在移植F1项目到F4平台时就遇到过这个问题花了不少时间才找到正确的配置方式。7. 实际项目中的应用技巧经过多个项目的实践我总结出几个实用技巧引脚分配规划在项目初期就规划好引脚使用尽量避免使用调试引脚。如果必须使用优先考虑PA15因为它不涉及异步跟踪问题。代码封装把调试引脚的配置代码封装成单独的函数方便在不同项目中复用。我在自己的代码库中就维护了这样一个模块大大提高了开发效率。文档记录在原理图和代码中明确标注这些特殊引脚的使用情况。我曾经接手过一个项目因为前任工程师没有标注PA15的特殊配置导致我浪费了一天时间排查问题。测试验证在硬件测试阶段要特别测试这些引脚的功能。我习惯在初始化完成后立即进行引脚测试比如让LED闪烁几次确认配置成功。备用方案在设计时考虑备用方案万一这些引脚不能正常工作可以有替代方案。比如在PCB布局时预留其他引脚的位置或者设计跳线选择。
解锁STM32调试引脚：PB3/PB4/PA15配置为通用GPIO的实战指南
发布时间：2026/6/11 21:38:52
1. 为什么需要解锁调试引脚在STM32开发中PB3、PB4和PA15这三个引脚比较特殊。它们默认被设计为调试接口功能比如JTAG和SWD。但在实际项目中我们经常会遇到PCB空间紧张的情况有时候不得不把这些引脚当作普通GPIO来使用。比如我最近做的一个智能家居项目因为PCB尺寸限制不得不把PA15用作LED控制引脚。这里有个关键点需要注意直接把这些引脚当普通IO用是不行的。上电后它们默认处于调试模式如果不进行特殊配置你会发现怎么设置GPIO都没反应。这就是为什么我们需要解锁这些引脚的功能。我在第一次尝试时也踩过这个坑明明代码里配置了PA15为输出模式但LED就是不亮后来才发现是调试功能没关闭。2. 硬件设计前的注意事项在画原理图之前有几点需要特别注意。首先如果项目需要完整的调试功能建议尽量避免使用这三个引脚作为GPIO。因为一旦关闭了JTAG功能就只能使用SWD模式进行调试了这会给开发带来一些限制。其次PB3这个引脚有个特殊之处它还与异步跟踪功能相关。这意味着即使关闭了JTAG如果异步跟踪功能还开着PB3仍然不能正常工作。我在一个电机控制项目中就遇到过这个问题当时花了好几个小时才找到原因。最后要考虑的是复位后的引脚状态。这些引脚在复位时会短暂处于调试模式如果连接的设备对电平敏感可能需要额外的硬件设计来确保安全。3. 软件配置详细步骤3.1 开启AFIO时钟第一步必须要开启AFIO的时钟这是很多人容易忽略的地方。AFIO(Alternate Function I/O)时钟控制着引脚复用功能不开启它后续的配置都不会生效。代码很简单RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE);这一步相当于给引脚复用功能上电。我在早期项目中经常忘记这行代码结果配置总是不生效后来养成了在初始化代码最前面就加上它的习惯。3.2 关闭JTAG功能接下来要关闭JTAG功能释放PB3、PB4和PA15。这里有个选项需要注意我们可以选择完全关闭JTAG或者保留SWD功能。大多数调试器都支持SWD模式所以通常我们选择只关闭JTAGGPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE);执行这行代码后PB4和PA15就可以正常作为GPIO使用了。但PB3还需要额外处理因为它还涉及到异步跟踪功能。3.3 处理PB3的异步跟踪功能PB3比较特殊即使关闭了JTAG如果异步跟踪功能还开着它仍然不能作为普通GPIO使用。关闭异步跟踪有两种方法第一种是通过寄存器直接操作DBGMCU-CR ~((uint32_t)15);第二种方法是在MDK开发环境中设置。在Options for Target - Debug - Trace选项卡中取消勾选Trace Enable。这个方法更适合不想修改代码的情况。我在实际项目中发现第一种方法更可靠因为它不依赖于开发环境设置代码移植性更好。4. 完整配置示例下面给出一个完整的配置示例以STM32F103C8T6为例将PA15配置为推挽输出PB3和PB4配置为输入void DebugPin_GPIO_Init(void) { // 1. 开启AFIO时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE); // 2. 关闭JTAG保留SWD GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE); // 3. 关闭异步跟踪功能 DBGMCU-CR ~((uint32_t)15); // 4. 配置GPIO GPIO_InitTypeDef GPIO_InitStructure; // 配置PA15为推挽输出 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); 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为输入 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); GPIO_InitStructure.GPIO_Pin GPIO_Pin_3 | GPIO_Pin_4; GPIO_InitStructure.GPIO_Mode GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOB, GPIO_InitStructure); }这个配置我在多个项目中都使用过稳定性很好。需要注意的是GPIO配置一定要在关闭JTAG和异步跟踪之后进行否则不会生效。5. 常见问题排查在实际使用中可能会遇到各种问题。下面分享几个我遇到过的典型问题及解决方法问题1配置后引脚仍然不工作检查顺序是否正确必须先开启AFIO时钟然后关闭JTAG最后配置GPIO。我曾经因为把GPIO配置放在最前面导致配置无效。问题2PB3工作不稳定这很可能是异步跟踪功能没有完全关闭。除了代码中关闭还要检查开发环境设置确保没有其他地方又开启了跟踪功能。问题3无法使用JTAG调试因为关闭了JTAG功能只能使用SWD模式调试。确认你的调试器支持SWD并且连线正确。SWD只需要四根线VCC、GND、SWDIO和SWCLK。问题4复位后引脚状态异常这些引脚在复位瞬间会短暂处于调试模式。如果连接的设备对电平敏感可以在硬件上加下拉电阻或者在软件初始化时尽快配置引脚状态。6. 不同STM32系列的注意事项虽然基本原理相同但不同系列的STM32在细节上有些差异。以STM32F1和STM32F4为例在STM32F4系列中配置方法略有不同。AFIO时钟的概念被取消了取而代之的是直接配置调试寄存器和复用功能。关闭JTAG的代码变为RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOB, ENABLE); GPIO_PinAFConfig(GPIOA, GPIO_PinSource15, GPIO_AF_0); GPIO_PinAFConfig(GPIOB, GPIO_PinSource3, GPIO_AF_0); GPIO_PinAFConfig(GPIOB, GPIO_PinSource4, GPIO_AF_0);对于HAL库用户可以使用以下代码__HAL_RCC_AFIO_CLK_ENABLE(); __HAL_AFIO_REMAP_SWJ_NOJTAG();建议在使用前查阅对应型号的参考手册确认具体的寄存器配置方法。我在移植F1项目到F4平台时就遇到过这个问题花了不少时间才找到正确的配置方式。7. 实际项目中的应用技巧经过多个项目的实践我总结出几个实用技巧引脚分配规划在项目初期就规划好引脚使用尽量避免使用调试引脚。如果必须使用优先考虑PA15因为它不涉及异步跟踪问题。代码封装把调试引脚的配置代码封装成单独的函数方便在不同项目中复用。我在自己的代码库中就维护了这样一个模块大大提高了开发效率。文档记录在原理图和代码中明确标注这些特殊引脚的使用情况。我曾经接手过一个项目因为前任工程师没有标注PA15的特殊配置导致我浪费了一天时间排查问题。测试验证在硬件测试阶段要特别测试这些引脚的功能。我习惯在初始化完成后立即进行引脚测试比如让LED闪烁几次确认配置成功。备用方案在设计时考虑备用方案万一这些引脚不能正常工作可以有替代方案。比如在PCB布局时预留其他引脚的位置或者设计跳线选择。
