单片机与物联网 / 系统课时
规划引脚复用并避开接口冲突
规划引脚复用并避开接口冲突
要让 UART、SPI、I2C 和定时器同时工作,不能只看某引脚“支持哪些功能”,还要检查具体封装、复用编号及板载连线。以 NUCLEO-F401RE 开发板为例,做出可直接配置的分配表,并用工具和脚本排除下载、通信及 PWM 冲突。
学习目标
- 找出芯片复用表与开发板原理图中的引脚限制。
- 为 USART2、SPI2、I2C1 和定时器 PWM 分配不重复的引脚。
- 在 CubeMX 中配置并校验分配结果,保留调试与启动能力。
先锁定不能随意复用的资源
示例硬件为 NUCLEO-F401RE(STM32F401RE、LQFP64)。先对照芯片 DS10086 数据手册 的 Alternate function mapping 表,以及开发板 UM1724 用户手册 的连接器、焊桥说明。芯片表证明“能复用”,板级资料才能证明“实际能接”。
- PA13、PA14:分别用于 SWDIO、SWCLK,必须保留在线调试;NRST 和 BOOT0 也按复位、启动用途保留。
- PA5:连着板载用户 LED LD2。它虽然支持 SPI1_SCK(AF5),但不适合作为本方案的 SPI 时钟。
- PC13:接板载按键 B1,不分配给 PWM 或高速通信。
- PA2、PA3:计划留给 USART2 和 ST-LINK 虚拟串口;实际通路应按板卡版本核对相关焊桥。
若设计还启用外部晶振或 LSE,需先锁定对应振荡引脚,不能仅凭 GPIO 空闲状态将其分配出去。
依据 AF 表确定引脚分配
STM32 的 AF(Alternate Function)编号是引脚复用选择值,不是外设编号。同一个焊盘即使列出多个功能,同一时刻也只能配置为其中一种。下面是一份针对这块开发板的可执行方案:
| 外设 | 信号与 MCU 引脚 | 配置 | 板级用途 |
|---|---|---|---|
| USART2 | TX:PA2;RX:PA3 | AF7 | ST-LINK 虚拟串口 |
| I2C1 | SCL:PB8;SDA:PB9 | AF4 | 外部 I2C 设备 |
| SPI2 | SCK:PB13;MISO:PB14;MOSI:PB15 | AF5 | CN10 Morpho 接口 |
| SPI2 片选 | CS:PB12 | GPIO Output,初始高电平 | 由软件拉低选中从设备 |
| TIM3 | CH2:PC7 | AF2 | PWM,Arduino D9 |
这份表共占用 9 个不同的 GPIO。PB12 在此不是 SPI2 的硬件 NSS,而是独立的通用输出;SPI2 需选择软件管理 NSS。I2C1 的 SCL/SDA 为开漏总线,可从 3.3 V 上拉开始设计,例如各用 4.7 kΩ;若外设板已装上拉,应核算等效阻值而非重复添加。

排除“芯片允许、板上冲突”的方案
两类冲突尤其容易漏检。其一,PA5 既是 SPI1_SCK 又接 LD2:在引脚图里选择 SPI1 可能没有红色冲突提示,但外部 LED 电路仍会给信号带来额外负载。因此将该 SPI 通道改用 SPI2 的 PB13、PB14、PB15,并从 CN10 Morpho 引出。
其二,PB8 同时可选 I2C1_SCL(AF4)和 TIM4_CH3(AF2),不能既连接 I2C 时钟又输出该路 PWM。本方案把 PB8 固定给 I2C1,把 PWM 放在 PC7 的 TIM3_CH2。若还要 JTAG、SWO 或其他定时器通道,也应重新核对 PB3、PB4 等调试相关复用资源。
在 CubeIDE 的引脚配置页落实
以带集成 CubeMX 配置页的 STM32CubeIDE 工程为例,打开项目的 .ioc 文件,进入 Pinout & Configuration:
- 在
System Core > SYS将Debug设为Serial Wire,确认 PA13、PA14 被占用。 - 在
Connectivity > USART2选Asynchronous,检查 TX 为 PA2、RX 为 PA3。 - 启用
Connectivity > I2C1,将 PB8 设为I2C1_SCL、PB9 设为I2C1_SDA;初次联调可用标准模式 100 kHz。 - 在
Connectivity > SPI2选择Full-Duplex Master、软件 NSS;确认 SCK/MISO/MOSI 分别落在 PB13/PB14/PB15。把 PB12 设为GPIO_Output,输出初值设为 High。 - 在
Timers > TIM3启用PWM Generation CH2,将通道输出指定到 PC7。 - 保存
.ioc并执行Generate Code,核对最终 Pinout 没有自动换脚、警告或未分配信号。
参数分组位置可能随 CubeMX 版本略有变化,核查应以信号名称和最终 .ioc 配置为准,不能只依赖向导最初的自动选脚。
用脚本复核并进行板级验收
将下列 Python 3 代码保存为 check_pins.py,运行 python3 check_pins.py。capabilities 是依据本示例型号数据手册摘出的允许组合;改用其他 MCU 或封装时必须重新建立表,不得直接沿用。
# 选定信号可用的“引脚、功能”组合;GPIO 表示普通输出而非 AF。
capabilities = {
"USART2_TX": ("PA2", "AF7"), "USART2_RX": ("PA3", "AF7"),
"I2C1_SCL": ("PB8", "AF4"), "I2C1_SDA": ("PB9", "AF4"),
"SPI2_SCK": ("PB13", "AF5"), "SPI2_MISO": ("PB14", "AF5"),
"SPI2_MOSI": ("PB15", "AF5"), "SPI2_CS": ("PB12", "GPIO"),
"TIM3_CH2": ("PC7", "AF2"),
}
# 项目分配表与上方的已核对组合分开保存,便于修改后复查。
plan = [
("USART2_TX", "PA2", "AF7"), ("USART2_RX", "PA3", "AF7"),
("I2C1_SCL", "PB8", "AF4"), ("I2C1_SDA", "PB9", "AF4"),
("SPI2_SCK", "PB13", "AF5"), ("SPI2_MISO", "PB14", "AF5"),
("SPI2_MOSI", "PB15", "AF5"), ("SPI2_CS", "PB12", "GPIO"),
("TIM3_CH2", "PC7", "AF2"),
]
reserved = {"PA13": "SWDIO", "PA14": "SWCLK", "PA5": "LD2", "PC13": "B1"}
used, errors = {}, []
for signal, pin, mode in plan:
if pin in used:
errors.append(f"冲突:{pin} 同时用于 {used[pin]} 和 {signal}")
used[pin] = signal
if pin in reserved:
errors.append(f"板级占用:{pin} 已连接 {reserved[pin]}")
if capabilities.get(signal) != (pin, mode):
errors.append(f"AF 不匹配:{signal} -> {pin} / {mode}")
if errors:
print("\n".join(errors))
else:
print(f"PASS:{len(plan)} 个信号,{len(used)} 个引脚;AF 与保留项检查通过")预期输出:
PASS:9 个信号,9 个引脚;AF 与保留项检查通过脚本用于检查分配表,不能替代电气核验。生成 HAL 代码后,还需查看 stm32f4xx_hal_msp.c 中各接口对应的 GPIO 复用初始化;保持 ST-LINK 可连接,在上电后测量 I2C 空闲电平、SPI2 时钟与片选,以及 PC7 实际 PWM 波形。未启动驱动前测不到波形是正常的;若下载后失去调试连接,先复查 SYS 的 SWD 配置及板上复位、启动条件,不要直接重焊线路。