Arduino_STM32项目中使用PB3引脚的非JTAG功能配置指南

引言

在使用STM32F103系列芯片进行开发时，开发者经常会遇到一个问题：PB3引脚默认被配置为JTAG功能，导致无法直接用于普通GPIO功能。本文将详细介绍如何在Arduino_STM32项目中正确配置PB3引脚，使其能够作为普通输入/输出引脚使用。

PB3引脚的默认功能

在STM32F103系列芯片中，PB3引脚默认被配置为JTAG功能的一部分。JTAG是一种标准的调试接口协议，用于芯片测试和调试。这种默认配置意味着：

1. PB3引脚在芯片复位后自动被设置为JTAG功能
2. 直接使用pinMode(PB3, INPUT_PULLUP)等操作可能无法正常工作
3. 需要先释放PB3引脚的JTAG功能才能作为普通GPIO使用

解决方案

Arduino_STM32项目提供了两种方法来释放PB3引脚的JTAG功能：

方法一：使用enableDebugPorts()函数

这是官方推荐的最简单方法，只需在setup()函数中添加一行代码：

void setup() {
    enableDebugPorts();  // 释放JTAG占用的引脚
    pinMode(PB3, INPUT_PULLUP);  // 现在可以正常配置PB3了
    // 其他初始化代码...
}

这个函数会：

1. 禁用JTAG功能
2. 保留SWD调试功能
3. 释放PB3、PB4和PA15引脚

方法二：直接寄存器操作（高级用法）

对于需要更精细控制的开发者，可以直接操作相关寄存器：

void setup() {
    // 直接操作AFIO_MAPR寄存器，禁用JTAG但保留SWD
    __IO uint32_t *AFIO_MAPR = (__IO uint32_t *)0x40010004;
    *AFIO_MAPR |= 0x02000000;  // 设置JTAG-DP禁用位，SW-DP使能位
    
    pinMode(PB3, INPUT_PULLUP);
    // 其他初始化代码...
}

这种方法提供了更底层的控制，但需要开发者对STM32的寄存器有基本了解。

注意事项

1. 调试接口选择：如果使用ST-Link进行程序下载和调试，必须保留至少一种调试接口（推荐保留SWD）
2. 引脚冲突：PB3、PB4和PA15这三个引脚默认都与调试接口相关，需要同时处理
3. 上传方式影响：当使用串口上传程序时，这些引脚默认是可用的；只有使用ST-Link时才需要特别处理
4. 调试功能：禁用JTAG后，将无法使用JTAG调试器，但SWD调试器仍可正常工作

扩展知识

STM32的调试端口配置通过AFIO_MAPR寄存器控制，主要选项包括：

• 全功能模式（JTAG+SWD）
• 仅SWD模式
• 无调试模式

在大多数情况下，选择"仅SWD模式"是最佳平衡，因为它：

1. 释放了JTAG占用的引脚
2. 保留了SWD调试功能
3. 只需要2个引脚（SWDIO和SWCLK）即可实现完整调试功能

结论

通过正确配置调试端口，开发者可以充分利用STM32的所有GPIO资源。对于Arduino_STM32项目，推荐使用enableDebugPorts()函数来简化配置过程。这一解决方案不仅适用于PB3引脚，也同样适用于PB4和PA15引脚的配置。

理解这一机制有助于开发者在资源受限的STM32项目中更灵活地使用所有可用引脚，充分发挥芯片的性能潜力。