树莓派4使用Node.js控制GPIO遇EINVAL错误求助

问题背景 #

使用onoff库通过Node.js控制树莓派4 GPIO引脚，在Debian 11.9设备上正常运行，但移植到Debian 12.5的树莓派后触发EINVAL: invalid argument, write错误。Python的RPi.GPIO库可正常工作，且已尝试删除node_modules重新安装依赖，问题仍存在。

测试代码 #

var GPIO = require('onoff').Gpio;

var lightPin = new GPIO(23, 'out');

lightPin.writeSync(1)

报错信息 #

node:internal/fs/utils:353
    throw err;
    ^

Error: EINVAL: invalid argument, write
    at Object.writeSync (node:fs:939:3)
    at Object.writeFileSync (node:fs:2355:26)
    at exportGpio (/home/pi4b/API/node_modules/onoff/onoff.js:18:8)
    at new Gpio (/home/pi4b/API/node_modules/onoff/onoff.js:172:36)
    at Object.<anonymous> (/home/pi4b/API/helper.js:3:16)
    at Module._compile (node:internal/modules/cjs/loader:1369:14)
    at Module._extensions..js (node:internal/modules/cjs/loader:1427:10)
    at Module.load (node:internal/modules/cjs/loader:1201:32)
    at Module._load (node:internal/modules/cjs/loader:1017:12)
    at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:122:12) {
  errno: -22,
  syscall: 'write',
  code: 'EINVAL'
}

Node.js v21.0.0

环境版本 #

• Node.js: 21.0.0（两台设备一致）
• npm: 10.5.0（两台设备一致）
• onoff: 6.0.3（两台设备一致）
• Debian: 新设备12.5，旧设备11.9

解决方法 #

1. 明确GPIO编号模式 #

Debian 12默认采用libgpiod作为GPIO底层驱动，onoff库可能需要显式指定编号模式。修改初始化代码：

// 明确指定BCM编号模式
var lightPin = new GPIO(23, 'out', {numbering: 'bcm'});

2. 升级onoff库版本 #

onoff 6.0.3对Debian 12的兼容性不足，升级到最新版本：

npm install onoff@latest

3. 修复GPIO访问权限 #

将当前用户加入gpio组，确保Node.js进程有权限操作GPIO：

sudo usermod -aG gpio $USER

执行后需重新登录系统使权限生效。

4. 启用sysfs GPIO接口 #

Debian 12默认禁用sysfs GPIO接口，编辑/boot/firmware/config.txt添加配置：

dtoverlay=gpio-no-irq

保存后重启树莓派。

5. 切换到libgpiod兼容库 #

如果onoff库仍无法适配，可改用基于libgpiod的gpiod库：

npm install gpiod

示例代码：

const gpiod = require('gpiod');

const chip = gpiod.openChip(0);
const line = chip.getLine(23);
line.requestOutputMode();
line.setValue(1);

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