飞腾FT2000/4 GPIO开发实战：从设备树配置到内核中断驱动

接触飞腾FT2000/4这板子之前我一直在x86和普通ARM SoC上做Linux驱动以为GPIO这种基础外设拿到板子先看原理图再翻芯片手册配置一下寄存器、申请一下中断号半小时就能跑通。真把银河麒麟V10ARM64烧进去、开始调FT2000/4的GPIO时才发现这套东西的坑比想象中多引脚复用、GPIO bank的编号规则、设备树里的pinctrl配置、用户态libgpiod与内核态驱动的选择随便一个环节没理清中断就是不来电平就是读不对。这篇文章就把我从零开始在这块国产处理器上做GPIO输入读取、输出控制、边沿中断的完整过程写出来适合正在飞腾FT2000/4、飞腾D2000等平台上做嵌入式Linux开发的朋友参考。1. 飞腾FT2000/4的GPIO控制器先别急着写代码1.1 它不是树莓派那种“直接怼地址”的玩法很多人第一次拿到飞腾FT2000/4第一反应是像玩树莓派那样找个物理地址mmap一下然后对寄存器一顿操作。FT2000/4确实是标准的ARM架构这么做理论上可行但实际工程里强烈不建议。原因很简单飞腾平台的GPIO控制器不是简单几个寄存器就能打发的它涉及引脚复用Pin Mux、上下拉配置、中断控制器对接等多个层面如果绕过内核的GPIO子系统直接操作物理地址等于把所有适配工作都揽到自己身上而且一旦引脚被其他驱动占用两个驱动打架的问题能把人折磨疯。FT2000/4的GPIO在内部是分成多个bank管理的每个bank有若干路引脚整体挂在某个APB总线上而中断则汇聚到GIC通用中断控制器。应用开发者看到的“GPIO编号”往往是芯片级别的物理引脚序号但内核里操作GPIO口使用的是“控制器分组组内偏移”的方式这两者之间不是直观对应关系。换句话说想靠图形界面看一眼就明白哪个编号对应哪个物理引脚不太现实必须回到原理图和设备树里去找。1.2 先确认你手中板子的设备树状态拿到一块FT2000/4板子第一步不是写代码而是先看系统里到底有哪些GPIO控制器。在终端下敲一行命令ls /sys/bus/platform/devices/ | grep gpio cat /proc/device-tree/soc/gpio*/compatible正常飞腾平台上会出现多个gpio节点每个节点对应一个bank。有些板子的GPIO控制器兼容字段是类似“arm,pl061”的通用PL061控制器有些则是飞腾自定义的控制器具体以板卡厂商提供的设备树为准。这时候再配合原理图找到目标引脚对应的ball名然后在设备树里搜索ball名或者相关gpio节点的偏移才能把物理引脚和软件编号对应上。我实操时踩过一次很尴尬的坑照着某篇网文用/dev/gpiochip0直接操作发现读到的电平和万用表量出来的完全对不上。后来才发现板卡厂商在设备树里把bank的顺序改过/dev/gpiochip0并不是我默认以为的“第一组GPIO”。所以动手前先跑一下gpiodetect看看实际有几个chip每个chip的name是什么gpioinfo再列出偏移对应的引脚名称这一步能省掉后面90%的“为什么读数不对”的困惑。2. 设备树里的GPIO配置绕不开但没你想的那么神秘2.1 你需要的其实是“复用”和“引用”两件事飞腾平台上的GPIO引脚大多数不是独享的同一物理引脚可能同时接UART、I2C、PWM或者其他功能到底跑哪个功能由设备树里的pinctrl决定。这个机制和STM32的GPIO_AF复用功能是同一个道理只是Linux设备树的表达方式更啰嗦而已。在飞腾平台上普通GPIO输入输出其实不需要自己写节点只要确认这个引脚没有被复用成其他功能就行。比如我要接一个按键到某个引脚首先在设备树里确认这个引脚没有出现在UART或者其他外设的pinctrl-0属性里然后就可以通过gpio-keys这类通用节点来声明内核会自动把对应的引脚申请为输入并注册成input设备连驱动都不用写。一个典型的gpio-keys设备树节点大概长这样gpio2 { keyboard_pins: keyboard_pins { pinctrl-single,pins 0x10 0x07 ; }; }; / { gpio-keys { compatible gpio-keys; pinctrl-names default; pinctrl-0 keyboard_pins; status okay; key-power { label KEY_POWER; linux,code 116; gpios gpio2 3 GPIO_ACTIVE_LOW; debounce-interval 20; }; }; };如果是自己写驱动通常会在设备树里给自定义节点引用gpiogpio0 { mydevice_pins: mydevice_pins { pinctrl-single,pins 0x14 0x07 ; }; }; mydevice { compatible vendor,mydevice; pinctrl-names default; pinctrl-0 mydevice_pins; input-gpios gpio0 5 GPIO_ACTIVE_HIGH; output-gpios gpio0 6 GPIO_ACTIVE_LOW; status okay; };2.2 引脚编号到底怎么算设备树里gpio0 5这个“5”是什么意思是很多新手最容易晕的地方。这里的5是相对于该gpio控制器基地址的偏移量不是全局编号。比如全局GPIO号可能是128但在这个bank内它就是编号5。在驱动里用gpiod_get获取struct gpio_desc后操作内核自动处理了全局编号和chip偏移的换算开发者无需关心。但是在用gpiochip_get_base这类老接口或者看/sys/kernel/debug/gpio里的调试信息时会同时看到chip名字和hw偏移需要搞清楚两者关系。建议在实际开发中建立一张自己的映射表列清楚物理ball名、bank名、组内偏移、设备树路径、用途打印出来贴在工位旁边。这招在多人协作的项目里特别有用因为飞腾的引脚编号资料往往分散在几千页的TRM里每次翻pdf效率太低了。3. 用户态快速验证libgpiod是你最便宜的调试工具3.1 银河麒麟V10下离线安装libgpiod飞腾平台最常见的系统就是银河麒麟V10ARM64版在联网环境下安装libgpiod很简单sudo apt install libgpiod2 libgpiod-dev gpiod但很多国产化项目是内网环境、没有软件源这时候就只能离线部署。我的做法是在一台能联网的ARM64机器上下载好deb包包括libgpiod2、gpiod、libgpiod-dev以及依赖的libc6版本信息拷贝到目标板子上用dpkg -i安装。如果连deb包都没有那就需要源码编译git clone https://git.kernel.org/pub/scm/libs/libgpiod/libgpiod.git cd libgpiod ./autogen.sh --enable-toolsyes --prefix/usr make -j4 sudo make install编译时需要注意老版本libgpiod依赖autoconf/automake/libtool缺了哪个configure都会报错。ARM64上编译本身没有坑内存足够的话直接make就行。装好后gpiodetect能列出chip设备就说明内核的GPIO子系统已经正常工作。3.2 用命令行工具先验证引脚编号和电平状态libgpiod带的工具是我在这些年做过所有Linux GPIO开发里觉得最趁手的调试利器比拿万用表去戳引脚高效得多。最常用的四个命令gpiodetect # 查看GPIO chip列表 gpioinfo # 查看每个chip的引脚方向、active state、占用者 gpioget chip offset # 读取某个引脚电平 gpioset chip offset1 # 设置某个引脚输出高电平比如确定目标引脚在gpiochip2的第3号偏移gpioget gpiochip2 3 gpioset gpiochip2 41测量时我会把gpioget、gpioset和示波器配合起来使用先用gpioset把某个空闲引脚拉高再看原理图上对应的网络线电平是否变化这样可以快速确认设备树里引脚编号是否对应正确。如果gpioset设置后电平没变第一反应不是怀疑GPIO坏了而是检查这个引脚是否被某个驱动独占gpioinfo里会显示占用者或者被pinctrl复用到了其他功能上。3.3 在C代码里用gpiod库做输入和输出命令行验证通了之后就可以上libgpiod库写真正的业务代码了。以读取输入为例#include gpiod.h #include stdio.h int main(void) { struct gpiod_chip *chip; struct gpiod_line *line; int val; chip gpiod_chip_open_by_name(gpiochip2); if (!chip) { perror(open gpiochip2 failed); return -1; } line gpiod_chip_get_line(chip, 3); if (!line) { perror(get line 3 failed); gpiod_chip_close(chip); return -1; } if (gpiod_line_request_input(line, myapp-input) 0) { perror(request input failed); gpiod_chip_close(chip); return -1; } val gpiod_line_get_value(line); printf(GPIO2_3 %d\n, val); gpiod_line_release(line); gpiod_chip_close(chip); return 0; }输出控制类似把request_input改成request_output然后调用gpiod_line_set_value即可。需要特别留意的是gpiod_line_request_*函数的第二个参数也就是consumer标签内核的gpio debugfs里会显示这个字符串如果多个进程都抢同一根引脚看这个标签就能快速定位是谁在占用。4. 中断配置这个项目真正值钱的部分4.1 为什么强烈不建议用轮询有些人在GPIO输入上偷懒用while(1)循环不停gpioget或者C代码里while读值。小规模测试无所谓但真正做产品就露馅了轮询间隔太短CPU占用率高得离谱间隔太长又可能漏掉毫秒级的外部事件。更麻烦的是轮询天然处理不了“外部事件发生时CPU正在做别的事情”的情况时延不可控。飞腾FT2000/4的GPIO是支持边沿中断的底层通过GIC把中断分发给CPU。正确做法是把中断能力用起来事件来了内核主动通知应用应用不需要空转。4.2 用户态监听中断gpiomon一行搞定最快速的验证手段是libgpiod自带的gpiomongpiomon --rising-edge --falling-edge gpiochip2 3把引脚接地再松开观察终端是否打印事件。如果事件能打印出来说明硬件链路、中断控制器、GPIO子系统全部正常。实际项目里我会先用万用表或者信号发生器制造一个明确的边沿再用gpiomon确认这样能快速排除板级问题。4.3 在C代码里用events接口接收中断用户态程序监听中断的标准做法是把GPIO line设置为事件模式然后用gpiod_line_event_wait等待事件发生。下面是完整demo#include gpiod.h #include stdio.h #include unistd.h int main(void) { struct gpiod_chip *chip; struct gpiod_line *line; struct gpiod_line_event event; int ret; chip gpiod_chip_open_by_name(gpiochip2); if (!chip) return -1; line gpiod_chip_get_line(chip, 3); if (!line) return -1; /* 请求上升沿和下降沿中断 */ ret gpiod_line_request_rising_edge_events(line, myapp-irq); if (ret 0) { perror(request rising edge failed); return -1; } while (1) { ret gpiod_line_event_wait(line, NULL); if (ret 0) { if (gpiod_line_event_read(line, event) 0) { printf(event type%d time%lld.%06lld\n, event.event_type, event.ts.tv_sec, event.ts.tv_nsec / 1000); } } } gpiod_line_release(line); gpiod_chip_close(chip); return 0; }注意gpiod_line_event_wait的第二个参数是超时时间传NULL表示永久等待。如果要在等待的同时处理其他任务可以把GPIO line的fd取出来丢给select或epoll统一管理这样可以和一个进程里的多个事件源协同工作。gpiod_line_event_get_fd这个接口就是干这个的。4.4 中断消抖不能不提的工程问题机械开关和继电器类外部信号按下和释放的瞬间会产生毫秒级抖动如果直接配置上升沿和下降沿中断一次真实按键可能触发5~10次中断。处理方式不外乎两种硬件上在按键两端并联RC滤波电容软件上记录每次中断时间戳在中断处理里判断“距上次有效事件是否超过N毫秒”小于阈值直接丢弃。我在FT2000/4上做按键检测时用的是软件消抖N秒延时上报的组合方案。中断服务函数里只负责记录当前时间真正处理事件的线程启动一个20毫秒的定时器周期内如果收到连续事件就刷新状态定时器到点后统一上报一次。这个方案能有效过滤抖动代码也好维护比单纯的中断里udelay靠谱得多因为用户态里udelay阻塞还会拖垮整个进程的事件循环。5. 内核态驱动方案什么时候必须上怎么写才稳5.1 用户态libgpiod不是万能药你可能想问既然libgpiod这么爽还要内核驱动干什么答案是用户态方案有硬伤。第一gpiod_line_event_wait在用户态是阻塞等待事件发生后从内核到应用层多了一次上下文切换和事件拷贝时延通常在几十到几百微秒对某些协议时序要求苛刻的场景不够用第二用户态进程可能被杀、被调度延迟对于工业设备来说不可靠第三某些引脚需要在系统启动早期、其他驱动加载前就完成配置用户态根本来不及。所以遇到高实时性、高可靠性的需求老老实实写内核驱动。FT2000/4上最常用的还是gpio-keys、gpio-leds这类成熟驱动只有这些不满足时才自己写。5.2 一个干净的内核驱动骨架自己写驱动时我倾向于使用devmmanaged device resource系列的API好处是资源自动释放probe失败不会留下垃圾状态。一个读取输入GPIO并注册中断的驱动核心代码如下#include linux/module.h #include linux/platform_device.h #include linux/gpio/consumer.h #include linux/interrupt.h #include linux/of.h struct my_gpio_dev { struct gpio_desc *irq_gpio; int irq; }; static irqreturn_t my_gpio_isr(int irq, void *data) { struct my_gpio_dev *dev data; /* 这里务必快速处理重活交给下半部或工作队列 */ dev_info(NULL, GPIO interrupt triggered\n); return IRQ_HANDLED; } static int my_gpio_probe(struct platform_device *pdev) { struct device *dev pdev-dev; struct my_gpio_dev *priv; unsigned long flags 0; int ret; priv devm_kzalloc(dev, sizeof(*priv), GFP_KERNEL); if (!priv) return -ENOMEM; priv-irq_gpio devm_gpiod_get(dev, input, GPIOD_IN); if (IS_ERR(priv-irq_gpio)) { return PTR_ERR(priv-irq_gpio); } priv-irq gpiod_to_irq(priv-irq_gpio); if (priv-irq 0) { return priv-irq; } flags IRQF_TRIGGER_RISING | IRQF_TRIGGER_FALLING; ret devm_request_threaded_irq(dev, priv-irq, NULL, my_gpio_isr, flags | IRQF_ONESHOT, my_gpio_irq, priv); if (ret) { return ret; } platform_set_drvdata(pdev, priv); return 0; } static const struct of_device_id my_gpio_of_match[] { { .compatible vendor,mydevice }, { } }; MODULE_DEVICE_TABLE(of, my_gpio_of_match); static struct platform_driver my_gpio_driver { .probe my_gpio_probe, .driver { .name my_gpio, .of_match_table my_gpio_of_match, }, }; module_platform_driver(my_gpio_driver); MODULE_LICENSE(GPL);代码里用了devm_request_threaded_irq这是我很推荐的一种写法用threaded irq把中断处理自动放到内核线程上下文里主中断处理函数跑在原子上下文而线程部分可以调用msleep、gpiod_set_value等可能睡眠的函数。相比传统的request_irq加tasklet或workqueue代码量少很多而且不容易写出死锁bug。5.3 内核态的坑devm_gpiod_get的命名对应关系devm_gpiod_get(dev, input, ...)里的“input”对应设备树里的input-gpios属性name完全一致才行。如果设备树里写的是irq-gpios代码里就要写devm_gpiod_get(dev, irq, ...)少了后半段返回的一定是ENODEV。这个命名规则经常被忽略报错后又一脸懵。6. 高频踩坑记录中断不触发、读数不对的排查思路6.1 中断死活不来先看复用和占用碰到“代码看着没问题事件就是不来”的情况我建议按这个顺序排查gpioinfo查看引脚current状态看看是否被某个driver占用如果显示sysfs或gpiod之外的名字说明有驱动的probe已经占用了这根引脚你的申请请求会被拒绝或直接拿不到中断号。查看/sys/kernel/debug/gpio需要先挂载debugfs或者用mount -t debugfs none /sys/kernel/debug这里能看到每个引脚的consumer是谁。确认引脚没有复用冲突。很多FT2000/4板子的默认设备树把大多数引脚配置成了UART、I2C等功能设备树里没有pinctrl-0的情况下即使你拿它当GPIO申请硬件引脚的电气连接也可能还在其他外设逻辑上需要检查原理图确认这个引脚在板级上是否真的连到了你的按键/传感器。有一次我在客户机器上排查中断不触发折腾了两小时最后发现那根引脚原理图上接的是一个I2C设备的SCL板子上一版固件把它配置成了I2C功能这版固件虽然改了设备树、把引脚释放出来了但硬件上还连着一个I2C上拉电阻导致电平锁死在低电平永远不出上升沿。所以看中断问题别光盯软件硬件万用表示波器该上就上。6.2 边沿丢失脉冲太窄怎么办如果外部信号是几百纳秒级别的脉冲GPIO控制器可能根本捕获不到因为GPIO模块的采样时钟没有那么快。遇到这种情况先查TRM里GPIO输入滤波器的存在性和可配置性。FT2000/4的GPIO不一定有全局的debounce寄存器可能需要借助芯片的EXTINT模块或者其他输入捕获单元来处理高速信号这已经不是普通GPIO的范畴了。普通应用中如果边沿频率不高我建议在软件侧加一个简单的环形缓冲区中断触发后把事件时间戳存入缓冲区由内核线程单点消费避免高频中断把系统拖垮。6.3 ACTIVE_LOW和上拉下拉别搞混设备树里GPIO_ACTIVE_HIGH和GPIO_ACTIVE_LOW两个flag直接影响逻辑电平到“1/0”的映射。比如按键一端接GPIO一端接GND引脚默认上拉按下时引脚变低。此时声明GPIO_ACTIVE_LOW后读取值为1表示“按下”为0表示“释放”反过来声明GPIO_ACTIVE_HIGH读取值就是反的。很多人读按键读数怪异先检查这里是不是写反了。另外FT2000/4的很多引脚内部有可配置上下拉如果外部没有接电阻必须确认设备树或者pinctrl中上下拉配置正确。引脚浮空时读数抖动会表现为“偶尔触发中断”这个极其恶心。我一般会在原理图阶段就明确每个输入引脚的上下拉方式软件里再通过pinctrl显式配置宁可多写两行不跟硬件扯皮。6.4 /dev/gpiochip0不存在的内核配置问题有些精简内核镜像默认没开GPIO子系统或者没把FT2000/4平台对应的GPIO控制器驱动编进去导致gpiodetect空手而归。检查内核配置这几项CONFIG_GPIOLIBy CONFIG_GPIO_SYSFSy 可选老接口 CONFIG_GPIO_PL061y 或对应飞腾GPIO控制器驱动 CONFIG_GPIO_CDEVy libgpiod依赖的字符设备接口在飞腾平台上CONFIG_GPIO_CDEV尤其重要libgpiod全靠它。如果有/dev/gpiochip0但gpiodetect还是报错再看看/dev目录权限有些系统默认/dev/gpiochip*的权限是root-only普通用户无法访问需要修改udev规则或者用root执行测试。最后再分享一个调试技巧我在飞腾平台上做GPIO调试时最喜欢用一套“三步验证法”第一数据手册和原理图交叉确认ball名、bank、偏移绝不凭感觉猜编号第二在用户态用gpiodetect、gpioinfo把引脚状态摸清楚配合gpiomon验证中断链路第三链路验证通过之后再切换到最终的libgpiod代码或内核驱动方案。这样三层下来绝大多数问题都能在用户态阶段暴露出来不用反复编译内核、重启板子开发的痛苦程度能下降一个量级。飞腾FT2000/4的GPIO开发本质上和任何一款成熟ARM SoC上的GPIO开发没什么区别核心难点在于对设备树和pinctrl机制的理解以及拿到不熟悉的板子时如何快速定位引脚关系。把这套方法论打磨出来以后换到飞腾D2000、或者其他的国产化平台你也能很快上手。