树莓派上使用libgpiod是否会丢失边沿事件？

可能的原因 #

尽管GPIO边沿触发由硬件完成，但从硬件到用户态程序的事件传递链路中，仍有多个环节可能导致事件丢失：

• 内核事件队列溢出：libgpiod依赖内核GPIO子系统的事件队列，当事件产生速度超过内核向用户态推送的速度时，队列会溢出。即便100-200Hz的频率看似不高，但若内核调度延迟、用户态处理逻辑存在阻塞，或者队列默认长度不足以应对突发峰值，新事件就会被丢弃。
• 用户态事件处理延迟：如果你的程序在处理event_wait()返回的事件时存在耗时操作（比如同步IO、锁等待），会导致下一次event_wait()调用被延迟。这段窗口内产生的事件可能因队列溢出被丢弃。
• libgpiod 1.6的版本缺陷：该版本的C++封装存在部分事件处理逻辑问题：
  • 当event_wait()超时返回后，内核队列中可能残留未处理事件，但后续调用未正确读取这些事件，导致新事件无法触发event_wait()返回。
  • 部分场景下，C++封装未正确处理内核文件描述符的状态变化，导致监听逻辑失效。
• 硬件层面的微小概率问题：树莓派GPIO控制器在高频切换下可能存在信号抖动或触发遗漏，但逻辑分析仪已确认边沿存在，因此该可能性极低，更倾向于软件链路问题。

排查与解决建议 #

• 调整内核事件队列长度：修改对应引脚的内核参数/sys/class/gpio/gpioX/edge_queue_length（将X替换为你的引脚号），增大队列容量，降低溢出风险。
• 优化事件处理逻辑：确保事件处理代码尽可能轻量化，避免阻塞操作；必要时将事件处理放到独立线程，保证event_wait()能被及时调用。
• 升级libgpiod版本：libgpiod 2.x及后续版本修复了多个事件处理相关bug，建议升级到最新稳定版后测试。
• 主动清理残留事件：在event_wait()超时后，主动调用read_event()尝试读取队列中可能残留的事件，避免队列堵塞。
• 查看内核统计数据：检查/sys/class/gpio/gpioX/edge_events和/sys/class/gpio/gpioX/edge_overruns文件，确认是否存在事件溢出的统计记录，这能直接验证队列是否已满。

内容的提问来源于stack exchange，提问作者Richard W