重映射（Remap）机制：为什么要重映射、部分重映射与完全重映射区别、AFIO时钟使能
各位做嵌入式开发的同行，肯定遇到过这种情况：画好PCB板子，焊好芯片，一调试发现某个外设的默认引脚被别的功能占用了。或者，你为了布线方便，想把USART的TX/RX换到另一组引脚上。这时候，重映射（Remap）机制就派上用场了。
说白了，重映射就是STM32给开发者留的一条“后路”——允许你把某些外设的引脚功能，重新分配到其他GPIO端口上。我刚开始接触这个功能时，觉得它就是个“引脚切换开关”，后来在项目中踩过几次坑，才发现里面的门道不少。
3.1 为什么要重映射？
先问个问题：STM32的引脚为什么不能像FPGA那样随便定义？
原因很简单——芯片内部的外设模块（比如USART、SPI、定时器）在硬件设计时，就已经固定连接到某些GPIO引脚上了。但ST的工程师也考虑到实际布线的灵活性，所以给部分外设设计了多个可选的引脚映射表。
重映射的核心价值就三点：
- PCB布线优化：把信号线换到更顺路的引脚上，减少过孔和走线长度。我在一个四层板项目中，就是靠重映射把SPI的SCK/MOSI/MISO换到了芯片同一侧，省掉了3个过孔。
- 功能冲突解决：当两个外设默认共用同一个引脚时，把其中一个重映射到其他引脚。比如TIM2的CH1和USART1的TX默认都在PA9，你两个都要用？那就把TIM2_CH1重映射到PA15。
- 引脚资源复用：某些封装（比如LQFP48）引脚少，重映射能让你在有限引脚里塞进更多功能。
核心原则：重映射不是万能的。只有数据手册里明确标注了“Remap”功能的外设才能重映射。不是所有外设都能随便换引脚，这点一定要先查手册。
3.2 部分重映射与完全重映射区别
ST把重映射分成了两种模式：部分重映射（Partial Remap）和完全重映射（Full Remap）。这个区分很多初学者容易搞混，我当年也在这上面吃过亏。
| 对比项 | 部分重映射 | 完全重映射 |
|---|---|---|
| 引脚变动范围 | 只改变部分引脚（通常是1~2个） | 所有相关引脚全部换到新位置 |
| 典型应用 | USART1只重映射TX，RX保持默认 | USART1的TX/RX/CK全部换到另一组 |
| 配置方式 | AFIO_MAPR寄存器的对应位设为01 | AFIO_MAPR寄存器的对应位设为10 |
| 适用场景 | 只冲突了部分引脚，其他引脚位置满意 | 整组引脚都需要重新规划 |
| 风险等级 | 较低，只影响个别引脚 | 较高，所有引脚位置都变了，容易搞混 |
举个例子，STM32F103的USART3：
- 默认映射：TX=PB10, RX=PB11, CK=PB12, CTS=PB13, RTS=PB14
- 部分重映射：TX=PC10, RX=PC11, CK=PC12, CTS=PB13, RTS=PB14（只变了TX/RX/CK）
- 完全重映射：TX=PD8, RX=PD9, CK=PD10, CTS=PD11, RTS=PD12（全部变了）
我个人习惯是：能用部分重映射就别用完全重映射。因为完全重映射后，所有引脚都换了位置，调试时查原理图特别容易看走眼。我曾经在一个项目里用了完全重映射，结果焊接时把TX和RX接反了，查了半天才发现是引脚搞错了。
避坑指南：配置重映射前，一定要先看数据手册的“Alternate function mapping”表格。有些外设只有部分重映射，没有完全重映射；有些则两种都有。别想当然。
3.3 AFIO时钟使能
这是重映射配置里最容易忽略的一步，也是我见过最多人踩的坑。
AFIO（Alternate Function I/O）是一个辅助功能模块，负责管理：
- 外设引脚的重新映射
- 外部中断/事件线的映射
- 某些特殊功能（如SWJ调试接口的配置）
关键点：AFIO模块默认是关闭的。你要使用重映射功能，必须先使能AFIO时钟。否则，你往AFIO_MAPR寄存器里写再多值，芯片也不会理你。
使能代码很简单（以STM32F1系列为例）：
// 使能AFIO时钟
RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE);
// 配置USART1完全重映射：TX/RX从PA9/PA10换到PB6/PB7
GPIO_PinRemapConfig(GPIO_Remap_USART1, ENABLE);注意：AFIO时钟挂在APB2总线上。如果你用的是STM32F4/H7系列，AFIO被整合到了SYSCFG模块里，使能方式略有不同：
// STM32F4系列使能SYSCFG时钟
RCC_APB2PeriphClockCmd(RCC_APB2Periph_SYSCFG, ENABLE);警告：AFIO时钟使能后，会略微增加芯片功耗。在低功耗项目中，建议只在需要重映射的期间使能AFIO时钟，配置完成后立即关闭。但要注意——关闭AFIO时钟后，重映射配置会失效，引脚恢复默认映射。
我记得有个同事调试一个串口通信项目，代码逻辑完全正确，但就是发不出数据。他查了GPIO配置、波特率、中断，折腾了两天。最后我过去一看——AFIO时钟没开。就这一行代码的事。从那以后，我每次配置重映射，第一件事就是检查AFIO时钟有没有使能。
3.4 重映射配置完整流程
总结一下，配置重映射的标准步骤：
- 查手册：确认外设支持重映射，找到目标引脚映射表
- 使能AFIO时钟：RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE)
- 配置GPIO模式：将目标引脚设为复用推挽输出（AF_PP）或复用开漏输出（AF_OD）
- 调用重映射函数：GPIO_PinRemapConfig()，传入对应的重映射宏
- 使能外设时钟：比如RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1, ENABLE)
- 初始化外设：配置波特率、数据位等参数
这里有个小技巧：重映射配置要在外设初始化之前完成。因为外设初始化时，会根据当前引脚映射状态来配置内部路由。如果你先初始化外设再重映射，可能会导致外设找不到正确的引脚。
经验之谈：我习惯把重映射配置放在外设初始化函数的最前面，紧跟在AFIO时钟使能之后。这样代码结构清晰，也避免忘记顺序。
3.5 重映射知识体系
下面这张图把重映射的核心逻辑串起来了，建议保存下来对照着看：
这张图把重映射的三个核心维度串在了一起：为什么需要、两种模式的区别、以及AFIO时钟这个“开关”。你配置的时候，按图索骥就行。
嗯，重映射这部分内容就讲到这里。记住一句话：重映射是STM32给你的“后悔药”，但吃药前一定要看说明书（数据手册）。AFIO时钟别忘了开，引脚映射别搞混，顺序别弄反——做到这三点，重映射基本不会出问题。