1. 初识全志T113-S3的GPIO世界

第一次拿到全志T113-S3开发板时，我盯着那个小小的LED灯发呆。作为嵌入式开发者，点亮LED就像程序员的"Hello World"，但这个简单的动作背后却藏着整个硬件控制的奥秘。T113-S3的GPIO系统就像一座精密的钟表，而寄存器就是控制齿轮转动的发条。

全志T113-S3采用ARM Cortex-A7架构，GPIO控制器是其外设中的重要组成部分。与常见的STM32不同，全志芯片的GPIO管理更接近Linux标准设计。每个GPIO组（PB、PC等）都有自己独立的配置寄存器、数据寄存器和上下拉寄存器。以PB组为例，它的寄存器地址空间从0x02000000开始，通过偏移量访问不同功能寄存器。

记得我第一次查手册时，被各种寄存器名称搞得头晕。后来发现规律：PB_CFG0负责引脚功能选择，PB_DAT控制电平输出，PB_PULL0设置上下拉模式。这三个寄存器就是控制GPIO的"三剑客"。比如要控制PB4引脚，就需要同时配置这三个寄存器才能正常工作。

2. 寄存器地址计算的正确姿势

计算寄存器地址是硬件编程的基本功。全志手册给出的地址都是偏移量（Offset），需要加上GPIO控制器的基地址。这里有个坑我踩过：T113-S3的GPIO基地址是0x02000000，不是0x03000000（这是某些全志其他芯片的基地址）。

具体到PB4引脚，我们需要操作的三个寄存器地址分别是：

• PB_CFG0: 0x02000000 + 0x0030 = 0x02000030
• PB_DAT: 0x02000000 + 0x0040 = 0x02000040
• PB_PULL0: 0x02000000 + 0x0054 = 0x02000054

在Linux驱动中，我们会用ioremap把这些物理地址映射到虚拟地址空间。这里特别要注意ioremap的大小参数，通常设为4字节（32位寄存器）。我曾经错误地设置为1字节，结果导致驱动运行异常，调试了半天才发现问题。

3. 寄存器配置的魔鬼细节

配置寄存器就像在玩数字拼图，每个bit位都有特定含义。以PB_CFG0为例，它控制PB0-PB7共8个引脚的功能模式。PB4对应的是第16-19位（4个bit），需要设置为0001表示输出模式。

这里有个易错点：修改寄存器时应该先读取当前值，然后只修改需要的位段，最后写回寄存器。直接写入新值可能会影响其他引脚的配置。我常用的操作模板是：

u32 val = readl(reg_addr);  // 读取当前值
val &= ~(mask);             // 清除目标位
val |= (new_value << shift); // 设置新值
writel(val, reg_addr);      // 写回寄存器

PB_PULL0寄存器的配置也很有意思。它控制每个引脚的上下拉电阻，PB4对应的是第8-9位。设置为00表示浮空，01表示上拉，10表示下拉。对于LED控制，通常选择上拉模式更可靠。

4. 从寄存器到驱动代码

有了寄存器知识，编写驱动就水到渠成了。Linux字符设备驱动的框架是固定的，关键是如何在驱动中操作寄存器。我的经验是封装三个层次的函数：

1. 硬件操作层：直接读写寄存器

static void led_hw_set(int state)
{
    u32 val = readl(PB_DAT);
    val = (state) ? (val | (1<<4)) : (val & ~(1<<4));
    writel(val, PB_DAT);
}

2. 驱动功能层：实现open/read/write等标准接口

static ssize_t led_write(struct file *filp, const char __user *buf, size_t count, loff_t *ppos)
{
    char val;
    copy_from_user(&val, buf, 1);
    led_hw_set(val);
    return 1;
}

3. 设备管理层：注册字符设备，创建设备节点

static int __init led_init(void)
{
    // 寄存器映射和初始化
    PB_DAT = ioremap(PB_DAT_BASE, 4);
    
    // 注册字符设备
    major = register_chrdev(0, DEVICE_NAME, &led_fops);
    
    // 创建设备节点
    device_create(cls, NULL, MKDEV(major, 0), NULL, DEVICE_NAME);
}

在编写驱动时，我习惯用printk输出调试信息，特别是在ioremap和寄存器配置的关键步骤。这能帮助快速定位问题，比如我曾经因为忘记调用ioremap就直接访问寄存器地址导致内核oops。

5. 用户空间的控制艺术

驱动写好之后，用户空间的测试程序就简单多了。主要流程就是打开设备文件，写入控制命令：

int fd = open("/dev/led", O_RDWR);
write(fd, "1", 1);  // 点亮LED
write(fd, "0", 1);  // 熄灭LED
close(fd);

这里有个实用技巧：可以用shell命令直接测试驱动，不用每次都编译测试程序：

echo 1 > /dev/led  # 点亮
echo 0 > /dev/led  # 熄灭

Makefile的编写也需要注意交叉编译工具链的设置。我推荐在Makefile中自动检测内核路径：

KERNELDIR ?= /lib/modules/$(shell uname -r)/build

6. 调试技巧与常见问题

在开发过程中，我总结了一些调试经验：

1. 检查设备节点权限：有时候驱动工作正常，但用户程序无法访问，可能是/dev/led的权限问题

2. 使用dmesg查看内核日志：驱动中的printk信息都会在这里显示

3. 确认寄存器配置：可以用devmem工具直接读取寄存器值，验证配置是否正确

devmem 0x02000040  # 读取PB_DAT寄存器

4. 检查物理连接：曾经有一次调试半天，最后发现是LED焊点虚焊

常见的问题包括：

• 忘记调用ioremap导致段错误
• 寄存器位操作错误（比如移位方向搞反）
• 设备树冲突（如果同时存在设备树和寄存器操作）
• 内存对齐问题（访问未对齐的寄存器地址）

7. 深入理解GPIO子系统

通过这个实战项目，我们可以更深入理解Linux GPIO子系统的设计。全志T113-S3的GPIO控制器遵循标准的GPIO框架，每个引脚都可以通过sysfs接口控制：

echo 40 > /sys/class/gpio/export  # PB4对应GPIO40
echo out > /sys/class/gpio/gpio40/direction
echo 1 > /sys/class/gpio/gpio40/value

寄存器操作虽然原始，但能让我们理解框架背后的实现原理。在实际项目中，我更推荐使用GPIO子系统或者设备树来配置GPIO，这样代码更易维护，也更容易移植到其他平台。

记得第一次成功点亮LED时的兴奋，虽然现在看起来很简单，但这种从底层理解系统的经历非常宝贵。建议大家在掌握寄存器操作后，可以对比研究GPIO子系统的实现，这样对Linux驱动框架会有更全面的认识。