STM32 复用功能(AF)配置的常见误区

问题

USART 配好了、SPI 也配好了,代码调了 HAL_UART_Transmit 但引脚没波形,示波器量是 0V 或 3.3V 不动。

大概率:GPIO 没有配置成对应的复用功能(AF)。

什么是复用功能

STM32 的每个 GPIO 引脚可以干很多事:

复制代码
PA9 可以是:
- 普通 GPIO 输出
- 普通 GPIO 输入
- USART1_TX(复用 AF7)
- TIM1_CH2(复用 AF1)
- SPI2_SCK(复用 AF5)

想让引脚做 USART 的 TX,需要在 GPIO 寄存器中选择对应的复用号。

典型错误

错误一:配成了普通输出

复制代码
// ❌ CubeMX 里 PA9 选 GPIO_Output
// 然后代码里 HAL_UART_Transmit...
// 引脚只能手动高低,UART 外设控制不了它

错误二:复用号选错了

CubeMX 自动配对的,不会错。但如果你手写寄存器:

复制代码
// ❌ 想配 USART1_TX(AF7),却写成了 AF1(TIM)
GPIOA->AFR[1] |= (0x01 << 4);  // AFRH 的 bit 4~7 = 0001 → AF1
// 实际上应该写 0111(AF7)
// ✅ 正确做法——先清零再赋值:
GPIOA->AFR[1] &= ~(0x0F << 4);   // 先清零目标字段
GPIOA->AFR[1] |= (0x07 << 4);    // 再写入 AF7

CubeMX 里的操作

选中 PA9 → 选 USART1_TX(不是 GPIO_Output)→ CubeMX 自动配好 AF。

验证:在 Pinout 视图里,PA9 旁边会显示 USART1_TX 字样,引脚颜色也会变成复用功能的绿色。

常用复用功能速查

外设 引脚 AF 号 AF 名称
USART1_TX PA9 AF7 AF7_USART1
USART1_RX PA10 AF7 AF7_USART1
SPI1_SCK PA5 AF5 AF5_SPI1
SPI1_MOSI PA7 AF5 AF5_SPI1
I2C1_SCL PB6 AF4 AF4_I2C1
I2C1_SDA PB7 AF4 AF4_I2C1
TIM2_CH1 PA0 AF1 AF1_TIM2
TIM3_CH3 PB0 AF2 AF2_TIM3

每个引脚的可用 AF 怎么看:

方法一:CubeMX 点中引脚,弹出的菜单只显示可用的功能。

方法二:查 STM32F407 的 datasheet(不是参考手册)→ Pinouts 章节 → 那几张巨大的引脚功能表。

代码层面验证

初始化后检查寄存器:

复制代码
// 检查 PA9 的 MODER
uint32_t moder = (GPIOA->MODER >> (9 * 2)) & 0x03;
printf("PA9 MODER = %lu (2=Alternate)\r\n", moder);
​
// 检查 PA9 的 AFRH
uint32_t afr = (GPIOA->AFR[1] >> ((9 - 8) * 4)) & 0x0F;
printf("PA9 AF = %lu (7=USART1)\r\n", afr);

如果 MODER 不是 2(Alternate Function)或者 AF 不是 7,引脚就起不到 USART1_TX 的作用。

总结

一句话
GPIO 要做外设功能,必须配成 Alternate Function + 正确的 AF 编号
CubeMX 会自动配好,不要手动改成 GPIO_Output/Input
如果怀疑引脚功能不对,读 MODER 和 AFR 寄存器确认
相关推荐
Flying Bear9 小时前
Keithley 2450 SourceMeter源表上位机开发笔记
笔记·单片机·嵌入式硬件
无敌贵点大王12 小时前
从寄存器层面重学STM32(11)——ADC理论
stm32·单片机·嵌入式硬件
Zw-awa13 小时前
卡尔曼到底在算什么:从一维到它的变式以及工程版卡尔曼滤波算法C语言实现
stm32
希和202717 小时前
代码讲解:STM32F103C8T6 驱动 HC-SR04 超声波测距
stm32·单片机·嵌入式硬件
编程小白菜12318 小时前
STM32L0 ADC串扰揭秘:充电电压如何“伪造”压力数据
stm32·单片机·嵌入式硬件
Zw-awa1 天前
两路信号,两种滤波:角速度走低通滤波,加速度走卡尔曼滤波
stm32
橘为己有4411 天前
STM32:USART 串口(2)
stm32·单片机·嵌入式硬件
少司府1 天前
嵌入式外设篇(一)GPIO·一:认识GPIO
linux·单片机·嵌入式硬件·mcu·系统·rtos·嵌入式软件
jianqiang.xue1 天前
1颗NPU分时复用:鸿蒙把轻AI塞进了MCU
人工智能·单片机·mcu·嵌入式·harmonyos·鸿蒙·端侧ai
国科安芯2 天前
星载姿轨控单元RISC-V MCU的存储、时基与辐射韧性——AS32S601ZIT2在商业卫星控制与配电单元中的应用
单片机·嵌入式硬件·mcu·risc-v·低轨卫星·抗辐射