第一章 GPIO驱动开发：从寄存器到点亮LED
各位同学，今天我们来聊聊MTK平台GPIO驱动开发。说实话，GPIO是嵌入式开发里最基础也最常用的外设。你想想看，从点亮一个LED到控制一个传感器，哪样离得开GPIO？
我个人习惯把GPIO驱动分成三个层次：寄存器映射、模式配置、电气特性设置。咱们一个一个来啃。
1.1 寄存器映射——找到GPIO的“门牌号”
在MTK平台上，GPIO的控制寄存器都映射在固定的内存地址上。说白了，就是芯片设计时给每个GPIO分配了一组“门牌号”，你往这个地址写数据，就能控制对应的引脚。
我记得第一次接触MTK的GPIO寄存器时，被那密密麻麻的地址表吓了一跳。后来发现，其实规律很简单：
- GPIO模式寄存器（GPIO_MODE）：决定引脚是普通GPIO还是复用功能
- GPIO方向寄存器（GPIO_DIR）：设置输入还是输出
- GPIO数据寄存器（GPIO_DOUT/GPIO_DIN）：读写引脚电平
- GPIO上拉/下拉寄存器（GPIO_PULLEN/GPIO_PULLSEL）：控制内部电阻
- GPIO驱动能力寄存器（GPIO_DRV）：设置输出电流强度
来看一个实际的寄存器映射示例：
// MTK GPIO寄存器基地址（以MT6765为例）
#define GPIO_BASE 0x10005000
// 各寄存器偏移量
#define GPIO_MODE_OFFSET 0x0000 // 模式配置
#define GPIO_DIR_OFFSET 0x0400 // 方向控制
#define GPIO_DOUT_OFFSET 0x0500 // 输出数据
#define GPIO_DIN_OFFSET 0x0600 // 输入数据
#define GPIO_PULLEN_OFFSET 0x0700 // 上拉/下拉使能
#define GPIO_PULLSEL_OFFSET 0x0800 // 上拉/下拉选择
#define GPIO_DRV_OFFSET 0x0900 // 驱动能力
// 访问宏定义
#define GPIO_REG(offset) (*(volatile uint32_t *)(GPIO_BASE + offset))这里有个坑，我刚开始做项目时踩过——volatile关键字绝对不能省。编译器优化会把你对寄存器的读写操作给“优化”掉，到时候你写半天代码，引脚纹丝不动，那才叫崩溃。
1.2 模式配置——GPIO模式 vs 功能模式
MTK的每个引脚都有多种功能。比如GPIO0，它可以是普通IO，也可以是UART的TX，或者I2C的SCL。怎么切换？靠的就是GPIO_MODE寄存器。
每个引脚占用4位（bit），可以配置0-15种模式：
| 模式值 | 功能描述 | 典型用途 |
|---|---|---|
| 0 | GPIO模式 | 普通输入/输出 |
| 1 | 功能模式1 | UART、SPI等 |
| 2 | 功能模式2 | I2C、PWM等 |
| 3 | 功能模式3 | EINT、JTAG等 |
写代码时，我习惯这样配置：
// 将GPIO0配置为普通GPIO模式（模式0）
#define GPIO0_MODE_BITPOS 0 // 引脚0在寄存器中的起始位
void gpio_set_mode(uint32_t pin, uint32_t mode) {
uint32_t reg_val;
uint32_t bit_pos = pin * 4; // 每个引脚占4位
reg_val = GPIO_REG(GPIO_MODE_OFFSET);
reg_val &= ~(0xF << bit_pos); // 先清零
reg_val |= (mode & 0xF) << bit_pos; // 再设置
GPIO_REG(GPIO_MODE_OFFSET) = reg_val;
}
// 使用示例：将GPIO0设为普通GPIO
gpio_set_mode(0, 0); // 模式0 = GPIO模式重点提醒：配置模式前，一定要先确认该引脚没有被其他外设占用。我在项目中遇到过，GPIO0同时被UART和LED驱动使用，结果一开串口，LED就乱闪。查了半天才发现是模式冲突。
1.3 上下拉与驱动能力——让信号更稳定
嗯，这里要注意。GPIO的上下拉配置，说白了就是给引脚一个“默认电平”。
- 上拉（Pull-Up）：引脚默认高电平，适合按键检测（按下拉低）
- 下拉（Pull-Down）：引脚默认低电平，适合某些传感器
- 浮空（No Pull）：引脚电平不确定，容易受干扰
驱动能力呢？就是引脚能输出多大电流。MTK平台通常支持2mA、4mA、6mA、8mA四档。驱动LED的话，4mA就够了。驱动蜂鸣器？我建议至少6mA。
// 上下拉配置
#define GPIO_PULL_ENABLE 1
#define GPIO_PULL_DISABLE 0
#define GPIO_PULL_UP 1
#define GPIO_PULL_DOWN 0
void gpio_set_pull(uint32_t pin, uint8_t enable, uint8_t pull_up) {
uint32_t reg_val;
// 配置上拉/下拉使能
reg_val = GPIO_REG(GPIO_PULLEN_OFFSET);
if (enable) {
reg_val |= (1 << pin);
} else {
reg_val &= ~(1 << pin);
}
GPIO_REG(GPIO_PULLEN_OFFSET) = reg_val;
// 配置上拉还是下拉
reg_val = GPIO_REG(GPIO_PULLSEL_OFFSET);
if (pull_up) {
reg_val |= (1 << pin);
} else {
reg_val &= ~(1 << pin);
}
GPIO_REG(GPIO_PULLSEL_OFFSET) = reg_val;
}
// 驱动能力配置（0-3对应2mA/4mA/6mA/8mA）
void gpio_set_drive(uint32_t pin, uint32_t level) {
uint32_t reg_val;
uint32_t bit_pos = pin * 2; // 每个引脚占2位
reg_val = GPIO_REG(GPIO_DRV_OFFSET);
reg_val &= ~(0x3 << bit_pos);
reg_val |= (level & 0x3) << bit_pos;
GPIO_REG(GPIO_DRV_OFFSET) = reg_val;
}我的经验：做按键检测时，一定要开启内部上拉。否则按键没按下时，引脚电平是浮空的，读到的值随机跳变。我曾经因为这个原因，调试了一个下午才发现是上拉没开。
1.4 实战：点亮一个LED
好了，理论说完了，咱们来点实际的。点亮一个LED，需要几步？
- 配置GPIO模式为普通GPIO（模式0）
- 配置方向为输出
- 设置输出高电平
- （可选）配置驱动能力，确保电流足够
// 完整的LED初始化函数
#define LED_PIN 10 // 假设LED接在GPIO10
void led_init(void) {
// 1. 设为GPIO模式
gpio_set_mode(LED_PIN, 0);
// 2. 设为输出方向
uint32_t reg_val = GPIO_REG(GPIO_DIR_OFFSET);
reg_val |= (1 << LED_PIN); // 1=输出
GPIO_REG(GPIO_DIR_OFFSET) = reg_val;
// 3. 默认熄灭（低电平）
reg_val = GPIO_REG(GPIO_DOUT_OFFSET);
reg_val &= ~(1 << LED_PIN);
GPIO_REG(GPIO_DOUT_OFFSET) = reg_val;
// 4. 设置驱动能力为4mA（够用了）
gpio_set_drive(LED_PIN, 1); // 1 = 4mA
}
void led_on(void) {
uint32_t reg_val = GPIO_REG(GPIO_DOUT_OFFSET);
reg_val |= (1 << LED_PIN);
GPIO_REG(GPIO_DOUT_OFFSET) = reg_val;
}
void led_off(void) {
uint32_t reg_val = GPIO_REG(GPIO_DOUT_OFFSET);
reg_val &= ~(1 << LED_PIN);
GPIO_REG(GPIO_DOUT_OFFSET) = reg_val;
}警告：千万不要直接用GPIO驱动大功率负载（比如电机、继电器）。GPIO的驱动能力有限，强行驱动会烧坏引脚。我见过有人用GPIO直接驱动一个5V继电器，结果芯片冒烟了。记住：GPIO只负责控制信号，功率驱动请加三极管或MOS管。
1.5 调试小技巧
最后分享几个调试技巧：
- 读回验证：写完寄存器后，马上读回来看看是不是写进去了。有些芯片的寄存器有写保护，你写了但没生效。
- 示波器是好朋友：别光看代码，用示波器量一下引脚电平，比什么都直观。
- 分步测试：先配置模式，测一下；再配置方向，测一下；最后输出电平。这样出问题能快速定位。
好了，第一章就到这里。GPIO看似简单，但它是所有外设驱动的基础。把这一章吃透了，后面学UART、I2C、SPI都会轻松很多。下一章我们讲UART驱动，到时候见。
公众号:蓝海资料掘金营，微信deep3321