一、寄存器基础说明
1. 名词释义
AFR:Alternate Function Register,GPIO 复用功能寄存器。
STM32 每组 GPIO 包含 Pin0~Pin15 共 16 个引脚,单个引脚支持 AF0~AF15 共 16 种外设复用功能,因此每个引脚需要4bit存储复用编号。
一组 GPIO 总占用位宽:\(16 \times 4 = 64\mathrm{bit}\),拆分为两个 32 位寄存器:
GPIOx_AFRL:复用低寄存器,管理 Pin0 ~ Pin7,寄存器偏移地址0x20GPIOx_AFRH:复用高寄存器,管理 Pin8 ~ Pin15,寄存器偏移地址0x24
2. 4bit 复用编码规则
4 位二进制对应 AF 编号,取值范围 0000 ~ 1111:
| 复用功能 | 4 位二进制编码 |
|---|---|
| AF0 | 0000 |
| AF1 | 0001 |
| AF2 | 0010 |
| AF3 | 0011 |
| AF4 | 0100 |
| AF5 | 0101 |
| AF6 | 0110 |
| AF7 | 0111 |
| AF8 | 1000 |
| AF9 | 1001 |
| AF10 | 1010 |
| AF11 | 1011 |
| AF12 | 1100 |
| AF13 | 1101 |
| AF14 | 1110 |
| AF15 | 1111 |
3. 寄存器位分布规则
GPIOx_AFRL:Pin n (0≤n≤7) 占用寄存器bit[4n+3 : 4n]GPIOx_AFRH:Pin n (8≤n≤15) 占用寄存器bit[4(n-8)+3 : 4(n-8)]- 掩码
0x0F(二进制 1111),用于选中单个引脚对应的 4 个配置位。
二、地址计算示例(以 GPIOF 为例)
GPIOF 外设基地址:0x40021400
- GPIOF_AFRL 地址 = 基地址 + 0x20 =
0x40021420 - GPIOF_AFRH 地址 = 基地址 + 0x24 =
0x40021424
寄存器指针定义:
volatile unsigned long *pAFRL = (volatile unsigned long *)0x40021420;
volatile unsigned long *pAFRH = (volatile unsigned long *)0x40021424;
volatile 防止编译器优化硬件寄存器读写,unsigned long 匹配 32 位寄存器宽度。
三、位操作配置逻辑
需求:将 GPIOF 引脚 PFn (n∈0~15) 配置为复用功能 AFk (k∈0~15)
分支 1:引脚 0 ≤ n ≤ 7,操作 AFRL
- 计算 4 位起始偏移:
bit_offset = 4 * n - 清零目标 4 位:
*pAFRL &= ~(0x0F << bit_offset); - 写入复用编号:
*pAFRL |= (unsigned long)k << bit_offset;
分支 2:引脚 8 ≤ n ≤ 15,操作 AFRH
- 内部索引:
idx = n - 8 - 计算 4 位起始偏移:
bit_offset = 4 * idx - 清零目标 4 位:
*pAFRH &= ~(0x0F << bit_offset); - 写入复用编号:
*pAFRH |= (unsigned long)k << bit_offset;
四、完整封装函数
#include <stdint.h>
/**
* @brief 配置GPIOF引脚复用功能
* @param n 引脚号 0~15
* @param k AF复用编号 0~15
* @retval 无
*/
void GPIOF_SetAlternateFunc(uint8_t n, uint8_t k)
{
volatile unsigned long *pAFRL = (volatile unsigned long *)0x40021420;
volatile unsigned long *pAFRH = (volatile unsigned long *)0x40021424;
uint8_t bit_offset;
// 参数合法性校验
if(n > 15 || k > 15)
return;
if(n <= 7)
{
bit_offset = 4 * n;
*pAFRL &= ~(0x0F << bit_offset);
*pAFRL |= (unsigned long)k << bit_offset;
}
else
{
bit_offset = 4 * (n - 8);
*pAFRH &= ~(0x0F << bit_offset);
*pAFRH |= (unsigned long)k << bit_offset;
}
}
调用示例
GPIOF_SetAlternateFunc(0, 5); // PF0配置为AF5
GPIOF_SetAlternateFunc(9, 7); // PF9配置为AF7
GPIOF_SetAlternateFunc(15, 15); // PF15配置为AF15
五、关键注意事项
- 操作硬件寄存器必须加 volatile,否则编译器会优化读写,配置失效;
- k 移位前强制转为 unsigned long,避免 8 位变量移位溢出;
- 操作顺序为先清目标 4 位,再写入新值,防止旧数据干扰;
- n、k 取值仅限 0~15,超出范围会篡改其他引脚配置。
六、快速记忆总结
- Pin0~7 对应 AFRL (0x20),Pin8~15 对应 AFRH (0x24);
- 单个引脚占用 4bit,移位偏移直接乘 4;
- 引脚 8~15 计算偏移前需要减 8;
- 配置步骤:清除对应 4 位 → 写入 AF 编号。