Rockchip平台RK3566/3568 GPIO驱动开发实战：从原理到代码实现

原创

于 2026-02-28 12:06:09 发布 · 404 阅读

文章标签：

1. 从原理图到引脚编号：理解RK3566/3568的GPIO世界

大家好，我是老张，一个在嵌入式圈子里摸爬滚打了十多年的老码农。最近在做一个基于瑞芯微RK3568的智能摄像头项目，核心功能之一就是通过GPIO控制红外补光灯和IRCUT滤光片，实现日夜切换。说实话，刚开始接触Rockchip平台时，我也被它那套独特的GPIO命名规则绕得有点晕，但搞明白之后，发现其实挺有规律的。今天，我就把自己踩过的坑和总结的经验，掰开揉碎了跟大家聊聊，希望能帮你少走点弯路。

首先，你得明白一个核心概念：在嵌入式世界里，GPIO就是你和硬件对话的“嘴巴”和“耳朵”。你想让一个LED亮起来，或者读取一个按键的状态，都得通过它。RK3566和RK3568这对兄弟芯片，在GPIO架构上基本一致，它们都有5个GPIO控制器（也叫Bank），从GPIO0到GPIO4。每个控制器能管理32个引脚，所以理论上最多有160个GPIO可供你使用。

关键来了，Rockchip的GPIO命名不是简单的数字递增，而是采用“控制器+端口+索引”的三段式。举个例子，你会在原理图上看到 GPIO1_A4 这样的标识。这怎么理解呢？GPIO1 表示它是第1组控制器（Bank 1）。A 表示端口号，端口固定为A、B、C、D四个，分别对应数字0、1、2、3。最后的 4 就是在这个端口内的索引序号，范围是0到7。所以，GPIO1_A4 翻译过来就是：第1组控制器，A端口，第4号引脚。

那么，这个看起来有点复杂的名字，怎么转换成Linux系统里那个简单的数字编号呢？这里有个万能公式：全局引脚编号 = Bank编号 × 32 + 端口号 × 8 + 索引号。我们套用一下：GPIO1_A4 的 Bank 是1，端口A对应0，索引是4。计算就是：1 × 32 + 0 × 8 + 4 = 36。这个“36”就是你在写代码或者用命令行操作时需要用到的那个数字。我当初的项目里，控制红外滤光片的两个引脚 GPIO3_D2 和 GPIO3_D3，就是这么算出来分别是122和123的。自己动手算一算，比死记硬背强多了。

2. 两种武器库：Sysfs接口与Libgpiod实战选择

搞清楚了引脚是谁，接下来就得决定怎么跟它“说话”。在Linux用户空间，控制GPIO主要有两套方法：经典的 Sysfs接口 和较新的 Libgpiod库。我两种都用过，它们各有各的适用场景。

Sysfs接口，我觉得是最直观、最适合新手快速上手的方法。它的原理很简单，就是把GPIO的操作“文件化”了。你不需要写复杂的驱动，直接像读写普通文件一样，通过 /sys/class/gpio/ 目录下的几个虚拟文件就能完成所有操作。这个方法在Shell脚本里尤其方便。它的操作流程就像一套固定的“拳法”：

导出（Export）：告诉系统你要用哪个GPIO。比如要用36号引脚，就在终端输入 echo 36 > /sys/class/gpio/export。执行成功后，目录下就会多出一个 gpio36 的文件夹。
设置方向（Direction）：告诉这个引脚是听你指挥（输出）还是向你汇报（输入）。输出就 echo out > /sys/class/gpio/gpio36/direction，输入就改成 in。
读写数值（Value）：如果是输出，想让它输出高电平就 echo 1 > /sys/class/gpio/gpio36/value，低电平就 echo 0。如果是输入，想看看它现在是高是低，就用 cat /sys/class/gpio/gpio36/value 读取。
取消导出（Unexport）：用完了，记得“还回去”，输入 echo 36 > /sys/class/gpio/unexport，对应的 gpio36 文件夹就会消失。

我在项目前期硬件调试阶段，就全靠这套“拳法”。通过串口登录到开发板，写几个简单的Shell脚本，就能快速验证红外补光灯和滤光片的电路连接是否正确，电平逻辑有没有搞反，非常高效。

而 Libgpiod 则是更现代、更推荐在生产代码中使用的方式。从Linux内核4.8开始，社区就逐渐推荐用它来替代Sysfs。它通过操作 /dev/gpiodchip0 这样的字符设备文件来实现，提供了更规范的C库和命令行工具。安装很简单，在基于Debian的系统上 sudo apt install gpiod 就行。它的命令行工具用起来和Sysfs思路不同，是以控制器（Bank）为单位的。比如，要控制刚才的 GPIO1_A4（全局编号36），你需要先换算：Bank是1，在Bank内的偏移量是 端口号(A=0)*8 + 索引号(4) = 4。那么设置高电平的命令就是 gpioset 1 4=1。gpiodetect 可以列出所有GPIO控制器，gpioinfo 可以查看某个控制器下所有引脚的状态。

我最终在C项目代码里选择了Sysfs，主要是因为当时项目SDK里已有一些相关封装，集成起来快。但如果你是新项目，特别是需要考虑多线程安全、更精细的控制（比如中断）时，我强烈建议你直接上Libgpiod。它的API更健壮，而且是未来的方向。