最近有个板子需要使用STM32驱动一个1.3寸的ST7789芯片的TFT彩屏，本来是很简单的事，结果死活不能正常显示，处理器也换过、屏也换过，程序也换了好几家的，始终不行。。。

结果今天突然想起来会不会是IO复用的问题，一查果然是PB3和PA15的默认功能不是GPIO，是JTAG的功能，设置了就好了。。。

时间太久不用STM32了，这么基础的东西都忘了。。。

---------------------------------------------------下为技术详情--------------------------------------------------

STM32引脚复用踩坑记：如何释放被JTAG占用的PA15、PB3驱动TFT屏幕

前言：几天调试的教训

最近在项目中使用STM32F103系列芯片驱动TFT屏幕时，我遭遇了一个棘手的问题：屏幕死活不显示。经过几天的艰苦排查，最终发现问题出在引脚复用功能上——PA15和PB3引脚默认被JTAG调试接口占用，无法直接作为普通GPIO使用。本文将详细记录这一踩坑经历，并分享解决方案，希望对遇到类似问题的开发者有所帮助。

问题现象：TFT屏幕"罢工"

当我将TFT屏幕的引脚连接到STM32F103RCT6的PA15和PB3后，编写了完整的驱动代码，但屏幕始终没有任何显示。最初我怀疑是时序问题、初始化序列错误甚至是硬件连接故障，但逐一排查后均未解决。

直到使用示波器检查信号时，才发现PA15和PB3引脚根本没有输出预期的波形。这才意识到问题可能出在STM32引脚的默认功能配置上。一查手册，果真如此。

问题根源：JTAG调试接口的优先级

STM32F103芯片的多个引脚在上电复位后默认配置为JTAG调试接口功能，具体包括：

引脚	默认功能	注释
PA13	JTMS	SWDIO信号
PA14	JTCK	SWCLK信号
PA15	JTDI	默认非GPIO功能
PB3	JTDO	默认非GPIO功能
PB4	JNTRST	默认非GPIO功能

这意味着，在未进行特殊配置的情况下，PA15和PB3无法作为普通GPIO使用，即使你在代码中将其初始化为GPIO输出模式，实际控制权仍掌握在JTAG接口手中。

解决方案：引脚重映射技术

要释放这些被JTAG占用的引脚，需要使用STM32的引脚重映射功能。以下是完整的解决步骤：

1. 使能AFIO时钟

重映射功能依赖于AFIO（Alternate Function I/O）模块，首先需要使其能时钟：

RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE);

切记：如果忘记使能AFIO时钟，后续的重映射配置将完全无效。

2. 重映射调试接口

根据调试需求，选择适当的重映射方式。大多数情况下，我们希望禁用JTAG但保留SWD调试功能，这样既能释放PA15、PB3和PB4，又能通过SWD接口（使用PA13和PA14）进行程序下载和调试：

GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE);

STM32F103提供了三种重映射选项：

GPIO_Remap_SWJ_JTAGDisable：禁用JTAG，保留SWD（最常用）
GPIO_Remap_SWJ_Disable：禁用JTAG和SWD（危险，不推荐）
GPIO_Remap_SWJ_NoJTRST：禁用JTAG复位，保留其他功能

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
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_3;
GPIO_Init(GPIOB, &GPIO_InitStructure);

关键注意事项

1. 避免完全禁用所有调试功能

绝对不要使用 GPIO_Remap_SWJ_Disable，这会同时禁用JTAG和SWD功能，导致所有5个调试引脚（PA13、PA14、PA15、PB3、PB4）都变成普通IO。一旦程序下载进去，你将无法再通过ST-Link等调试器下载新程序，只能通过串口ISP等方式恢复，给开发带来极大麻烦。

2. 配置顺序很重要

正确的配置顺序应该是：

使能AFIO时钟
执行重映射配置
配置GPIO引脚

有报告指出，如果在重映射之后再次执行开启GPIO端口时钟的操作，可能会意外恢复引脚的调试功能。因此，最稳妥的做法是将重映射和对应GPIO的初始化集中放在一起。

3. 使用STM32CubeMX简化配置

如果你使用STM32CubeMX进行项目初始化，配置会变得非常简单：

在Pinout & Configuration视图中，找到System Core分类下的SYS选项
在Debug下拉菜单中，选择Serial Wire（这等同于禁用JTAG，使能SWD）
生成的代码会自动处理重映射配置

实战代码示例

以下是在STM32标准外设库中完整配置PA15和PB3作为TFT屏幕控制引脚的示例：

void GPIO_Configuration(void)
{
    GPIO_InitTypeDef GPIO_InitStructure;
    
    // 1. 使能GPIO和AFIO时钟
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOB | 
                          RCC_APB2Periph_AFIO, ENABLE);
    
    // 2. 重映射调试接口：禁用JTAG，保留SWD
    GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE);
    
    // 3. 配置PA15和PB3为推挽输出
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
    
    // 配置PA15（例如作为TFT_DC引脚）
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_15;
    GPIO_Init(GPIOA, &GPIO_InitStructure);
    
    // 配置PB3（例如作为TFT_RST引脚）
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_3;
    GPIO_Init(GPIOB, &GPIO_InitStructure);
}

经验总结与建议

经过这次踩坑经历，我总结了以下几点经验：

引脚规划先行：在项目开始前，仔细查阅芯片数据手册的引脚定义表，特别是调试接口的默认功能。
优先使用SWD：对于STM32F103开发，SWD（2线调试）通常已足够，可以安全地禁用JTAG以释放更多GPIO资源。
善用STM32CubeMX：图形化配置工具能自动解决大部分引脚冲突问题，减少人为错误。
添加调试接口恢复机制：在代码中添加检测机制，当需要恢复调试功能时，可以通过特定条件（如按键组合）触发重映射恢复操作。

结语

STM32的引脚复用功能虽然灵活，但也带来了配置复杂性。PA15、PB3等引脚被JTAG默认占用的问题，是STM32F103开发者经常遇到的"坑"。希望通过本文的分享，能帮助大家避免重蹈我的覆辙，顺利驱动TFT屏幕和其他外设。

嵌入式开发的道路上，每一个踩坑的经历都是宝贵的财富。 重要的是从中学习并分享，让技术社区共同进步。

STM32引脚复用踩坑记：如何释放被JTAG占用的PA15、PB3驱动TFT屏幕

STM32引脚复用踩坑记：如何释放被JTAG占用的PA15、PB3驱动TFT屏幕

前言：几天调试的教训

问题现象：TFT屏幕"罢工"

问题根源：JTAG调试接口的优先级

解决方案：引脚重映射技术

1. 使能AFIO时钟

2. 重映射调试接口

3. 配置GPIO为普通输出模式

关键注意事项

1. 避免完全禁用所有调试功能

2. 配置顺序很重要

3. 使用STM32CubeMX简化配置

实战代码示例

经验总结与建议

结语

评论0