2. GD32V处理器架构基础
GPIO，说白了就是芯片和外界打交道的最基本通道。我刚开始做嵌入式那会儿，觉得 GPIO 不就是个高低电平嘛，有啥好研究的？后来踩了几个坑才明白——GPIO 要是没用好，整个项目都得翻车。
这一节，咱们就把 GD32V 的 GPIO 模块彻底拆开看看。从硬件框图到寄存器配置，一步步来。
GPIO 模块框图：里面到底有啥？
先看整体结构。GD32V 的 GPIO 模块，每个端口（PA、PB、PC...）背后都有一套完整的硬件逻辑。我画了张图，帮你理清脉络。
从图上你能看到，GPIO 不是一根简单的导线。它里面有寄存器组、输出驱动、输入路径，还有复用功能选择器。每个部分都有自己的活要干。
工作模式：推挽、开漏、上拉、下拉
这部分是 GPIO 的核心，也是新手最容易搞混的地方。我一个个说。
推挽输出
推挽输出，就是内部有两个 MOS 管——一个推（输出高），一个挽（输出低）。你写 1，上管导通，引脚直接拉到 VDD；你写 0，下管导通，引脚拉到 GND。
这种模式驱动能力强，输出速度快。我一般用推挽去驱动 LED、蜂鸣器这类负载。但要注意——两个 GPIO 不能直接连在一起做线与，否则一个输出高一个输出低，直接短路。
开漏输出
开漏就不一样了。它只有下管，没有上管。输出 0 时拉低，输出 1 时引脚处于高阻态（相当于断开）。
开漏最大的好处是：多个引脚可以连在一起做线与。I²C 总线就是典型例子。另外，开漏输出可以通过外部上拉电阻接到不同电压，实现电平转换——3.3V 的芯片去驱动 5V 的设备，用开漏加 5V 上拉就行。
我做过一个项目，需要同时控制三个 I²C 从设备，全部挂在一条总线上。开漏模式帮了大忙，不用额外加电平转换芯片。
上拉与下拉
这两个是输入模式下的配置。上拉就是在引脚内部接一个电阻到 VDD，下拉就是接到 GND。
什么时候用？
- 按键输入：没按下时引脚悬空，不上拉的话电平不确定。内部上拉一开，默认就是高电平，按下才变低。
- 开漏输出：前面说了，开漏输出高时是高阻，必须靠上拉电阻把电平拉高。
- 某些通信协议：比如 1-Wire，总线空闲时靠上拉维持高电平。
我的习惯：能开内部上拉就别外接电阻，省 BOM 成本。但驱动能力不够时（比如 I²C 总线太长），还是得外接 4.7kΩ 上拉。
四种模式对比
| 模式 | 输出 0 | 输出 1 | 典型用途 |
|---|---|---|---|
| 推挽输出 | 强下拉到 GND | 强上拉到 VDD | LED、蜂鸣器、普通 GPIO |
| 开漏输出 | 强下拉到 GND | 高阻（需外部上拉） | I²C、多设备线与、电平转换 |
| 浮空输入 | — | — | 外部已有上拉/下拉的场合 |
| 上拉/下拉输入 | — | — | 按键、无外部驱动的信号 |
寄存器映射：你得知道往哪写
GD32V 的 GPIO 寄存器，每个端口占 1KB 地址空间。基地址从 0x4001_0800（PA）开始，依次递增。常用的寄存器就那么几个：
| 寄存器 | 偏移 | 作用 |
|---|---|---|
| CTLx | 0x00 | 控制模式（输入/输出/复用/模拟） |
| OMODE | 0x04 | 输出类型（推挽/开漏） |
| OSPD | 0x08 | 输出速度（2MHz/10MHz/50MHz） |
| PUPD | 0x0C | 上拉/下拉配置 |
| ISTAT | 0x10 | 输入状态（只读） |
| OCTL | 0x14 | 输出控制（写 0/1） |
| BOP | 0x18 | 位操作（原子置位/复位） |
这里有个小技巧——BOP 寄存器。你写 OCTL 的时候，如果只改某一位，得先读再改再写，麻烦还容易出错。BOP 寄存器是原子操作的：低 16 位写 1 对应位置位，高 16 位写 1 对应位复位。一次写入，不影响其他位。
避坑指南：我曾经在中断服务函数里用 OCTL 修改 GPIO 输出，结果因为读-改-写不是原子的，被中断嵌套搞出了毛刺。后来换成 BOP 寄存器，问题立刻解决。
配置流程：三步走
配置一个 GPIO 引脚，其实就三步。我以 PA0 为例，配置成推挽输出，驱动一个 LED。
- 开启时钟：GPIOA 的时钟在 RCU 模块里，默认是关闭的。不开启钟，写寄存器等于白写。
- 配置模式：设置 CTL0 寄存器，把 PA0 设为输出模式；设置 OMODE 为推挽；设置 PUPD 为无上拉/下拉。
- 输出电平：用 BOP 寄存器置位或复位 PA0。
代码长这样：
// 1. 开启 GPIOA 时钟
RCU->APB2EN |= (1 << 2); // GPIOA 在 APB2 总线上，bit2 使能
// 2. 配置 PA0 为推挽输出，50MHz 速度
GPIOA->CTL0 &= ~(0x3 << 0); // 先清空 bit0-1
GPIOA->CTL0 |= (0x1 << 0); // 设为输出模式 (01)
GPIOA->OMODE &= ~(0x1 << 0); // 推挽输出 (0)
GPIOA->OSPD &= ~(0x3 << 0); // 清空速度位
GPIOA->OSPD |= (0x3 << 0); // 50MHz 速度
GPIOA->PUPD &= ~(0x3 << 0); // 无上拉/下拉
// 3. 输出高电平，点亮 LED
GPIOA->BOP = (1 << 0); // 置位 PA0注意：CTL0 寄存器每 4 位控制一个引脚。PA0 对应 bit0-1，PA1 对应 bit4-5，以此类推。写错位会导致配置乱掉。我刚开始就犯过这个错，把 PA1 配成了模拟模式，查了半天才发现是移位算错了。
输入配置：读取按键状态
输出会了，输入也不难。还是 PA0，这次配成上拉输入，读一个按键。
// 1. 开启时钟（同上）
RCU->APB2EN |= (1 << 2);
// 2. 配置 PA0 为上拉输入
GPIOA->CTL0 &= ~(0x3 << 0); // 清空 bit0-1
// CTL0 默认就是 00（输入模式），所以不用再置位
GPIOA->PUPD &= ~(0x3 << 0); // 清空
GPIOA->PUPD |= (0x1 << 0); // 上拉 (01)
// 3. 读取电平
uint8_t key_val = (GPIOA->ISTAT >> 0) & 0x1;
if (key_val == 0) {
// 按键按下（上拉输入，按下为低）
}这里有个细节——上拉输入时，按键按下读到的值是 0。因为内部上拉把引脚拉到 VDD，按键接地后引脚被拉低。逻辑上别搞反了。
关于速度配置
输出速度这个选项，很多人不太在意。我提一嘴：
- 2MHz：适合低频信号，比如按键扫描、LED 控制。功耗低，EMI 也小。
- 10MHz：普通通信，比如 SPI 时钟几 MHz 的场景。
- 50MHz：高速信号，比如外部存储器接口、高速 SPI。
不是越快越好。速度越高，功耗和噪声越大。我一般按实际需求选，能跑起来就行，留点余量但不浪费。