简介面向Jetson Nano嵌入式开发者与AI边缘计算爱好者这份GPIO库资源包基于C/C接口解决在NVIDIA Jetson平台上通过GPIO控制传感器、LED等外设的编程需求。资源共68个文件压缩包仅106KB核心包含29个cpp实现与17个h头文件另有md/txt说明文档、cmake与dockerfile构建配置、sh脚本及规则文件结构清晰兼顾源码阅读与工程集成。内容整合了libnvgpio等库的调用方式涵盖GPIO基本概念、引脚结构、读写操作及中断回调等关键点并提供LED点灯、PWM输出、按键中断等示例程序可直接参考或修改使用。对正在学习Jetson Nano硬件控制或需要快速搭建GPIO开发环境的C开发者有较大帮助。目前已有852人在CSDN学习下载属于入门与实战兼顾的轻量级参考资料。 拿到一块Jetson Nano很多人的第一反应是这不就是个加强版树莓派嘛40pin排针摆得整整齐齐Python里操作GPIO应该也差不多吧结果一跑代码就傻眼——RPi.GPIO不认这块板子报错都是英文一长串翻遍全网教程还都是教树莓派的对着Jetson改半天就是点不亮那颗LED。我当年也是这么过来的。后来把Jetson Nano的GPIO折腾明白之后发现其实核心问题就几个库用错了、权限没配、引脚编号搞混了。这篇就把我在Jetson Nano上从零开始玩转GPIO的完整过程写下来包括Jetson.GPIO库的安装、权限配置、核心API用法以及点灯、按键、舵机、超声波这几个典型外设的完整代码最后再列一下我踩过的坑。不管是第一次碰Jetson的小白还是从树莓派迁移过来的老玩家这篇应该都能帮你少走几个弯路。1. 为什么Jetson Nano的GPIO不能照搬树莓派那套玩法1.1 板子长得像底层完全是两家人Jetson Nano和树莓派都有一个40pin的扩展排针外观看着确实挺像但底层完全是两套东西。树莓派用的是Broadcom的SoCGPIO控制器是博通自己那套Linux内核里对应的驱动是pinctrl-bcm2835操作系统里默认就带好了RPi.GPIO这个Python库用户直接import就能用。Jetson Nano用的是NVIDIA的Tegra X1芯片GPU和CPU集成在一块GPIO引脚是由Tegra的GPIO控制器和PINMUX模块管理的。NVIDIA给出的官方Python库叫Jetson.GPIO虽然API风格刻意模仿了RPi.GPIO让你看起来眼熟但安装方式、权限模型、引脚编号规则跟树莓派完全不是一回事。如果你直接把RPi.GPIO的代码拷到Jetson上第一行import RPi.GPIO就会直接报ImportError。就算你强行装了一个RPi.GPIO的兼容版引脚编号也对不上。树莓派物理第7脚对应BCM4Jetson Nano上同一个物理位置的引脚在BCM模式下编号可能是一个两百多号的GPIO编号完全没法兼容。1.2 “8种GPIO模式”这个词在Jetson上别直接用很多从STM32转过来的人会问Jetson Nano支持GPIO的8种工作模式吗这其实是个概念混用。GPIO的8种模式——模拟输入、浮空输入、上下拉输入、开漏输出、推挽输出这些——是STM32这类MCU上寄存器级的概念由寄存器直接配置每个引脚的电气行为。Jetson Nano跑的是完整Linux系统GPIO引脚的工作模式由设备树Device Tree和内核的pinctrl子系统来管不是你在Python里直接调一个函数就能切来切去的。Jetson.GPIO库能设置的是输入、输出、上拉、下拉、PWM仅此而已。至于引脚复用功能比如把某个引脚切成UART或SPI那是另一个层面的配置需要改设备树或者用NVIDIA提供的jetson-io工具。所以如果你在搜索里看到“GPIO的8种工作模式”先搞清楚那是MCU的概念别用那套思维来操作Jetson。2. 先把库装好权限和udev规则是最大的入门门槛2.1 刷完系统后库其实已经在了Jetson Nano刷完官方JetPack镜像之后系统里其实已经带了一份Jetson.GPIO库只不过不在Python默认的搜索路径里。你可以在/opt/nvidia/jetson-gpio目录下找到它里面有编译好的库文件和一份etc/99-gpio.rules规则文件。如果你刷的是一个精简系统或者自己手动裁剪过的镜像可能这个目录不存在那就要用pip装sudo apt-get update sudo apt-get install -y python3-pip sudo pip3 install Jetson.GPIO这里有个容易踩的坑pip安装的时候会现场编译C扩展如果你系统里缺少编译工具链或者Python开发头文件会直接编译失败。报错信息通常是一大堆gcc的error新手很容易懵。这时候先装一下build-essential和python3-dev再重试sudo apt-get install -y build-essential python3-dev sudo pip3 install Jetson.GPIO2.2 权限配置三步走如果你跳过权限配置直接跑GPIO程序会报这样的错误RuntimeError: The GPIO channel has not been set up yet或者更直接的权限拒绝。解决方法是把当前用户加入gpio组并把udev规则文件复制到系统目录sudo groupadd -f -r gpio sudo usermod -a -G gpio $USER sudo cp /opt/nvidia/jetson-gpio/etc/99-gpio.rules /etc/udev/rules.d/ sudo udevadm control --reload-rules sudo udevadm trigger如果/opt/nvidia/jetson-gpio目录不存在可以从GitHub上的NVIDIA/jetson-gpio仓库里把99-gpio.rules文件下载下来再复制到/etc/udev/rules.d/。做完这一步注销重新登录或者直接reboot让用户组和udev规则生效。这一步不做后面所有GPIO操作都会卡在权限上而且报错信息并不直观新手很容易在这里浪费半天。2.3 从pip安装容易踩的编译坑我自己实际遇到过一次比较诡异的情况系统里明明自带了/opt/nvidia/jetson-gpio这个目录但我用pip3 install Jetson.GPIO又装了一份结果两个版本的GPIO库在sys.path里的优先级不一样程序里用的可能是pip装的那份而那份是源码编译的跟几大页的编译报错纠缠在一起反而耽误时间。后来我的习惯是先检查/opt/nvidia/jetson-gpio目录是否存在存在就直接设置PYTHONPATH不重复pip安装export PYTHONPATH/opt/nvidia/jetson-gpio/lib/python:$PYTHONPATH或者干脆用pip装但装之前用pip3 show Jetson.GPIO看一下有没有残留版本避免混用。同一个环境里出现两份Jetson.GPIO是会有一些奇怪问题的。3. 核心API实测和RPi.GPIO神似但细节别想当然3.1 BOARD/BCM编号最坑的一个点Jetson.GPIO同样支持GPIO.BOARD和GPIO.BCM两种编号模式但注意BCM编号跟树莓派完全不通用。GPIO.BOARD使用物理排针的编号1到40这个和树莓派的物理编号是一致的因为40pin排针的物理位置是行业标准照着一块板子设计物理位置都一样。GPIO.BCM使用Tegra芯片内部的GPIO编号比如GPIO216这种不同引脚对应的编号需要在NVIDIA官方引脚图上查。我个人的建议是除非你有特殊原因否则一律用GPIO.BOARD模式。物理引脚号最直观对着板子数就行不用查表也不容易出错。BCM编号在Jetson上没有任何优势而且极易混淆网上很多教程用的是BCM模式但针对的板子型号一换定义就全变了。设置模式必须在所有操作之前调用import Jetson.GPIO as GPIO GPIO.setmode(GPIO.BOARD)3.2 输入输出、上下拉、事件检测初始化一个引脚为输出GPIO.setup(11, GPIO.OUT, initialGPIO.LOW)初始化一个引脚为输入并开启上拉GPIO.setup(13, GPIO.IN, pull_up_downGPIO.PUD_UP)读取输入value GPIO.input(13)事件检测用法也跟RPi.GPIO差不多GPIO.add_event_detect(13, GPIO.FALLING, callbackmy_callback, bouncetime200)需要说明的是Jetson.GPIO的事件检测底层实现跟树莓派不完全一样。树莓派的RPi.GPIO是依赖Broadcom芯片的硬件中断延迟低且稳定。Jetson.GPIO的事件检测走的是内核的gpio事件接口加用户态轮询实际使用中我发现它对高频信号处理能力偏弱。我用它读一个5Hz的方波信号做计数偶尔会丢事件调低了回调里的耗时之后才稳定一些。所以如果你要拿GPIO做高频计数或者实时性要求很高的采集别指望这个库要么写C扩展要么直接操作/sys/class/gpio或者用jetson-io把引脚切成SPI/I2C等硬件外设来用。3.3 PWM只有两路硬件PWMJetson Nano的40pin排针上硬件PWM只有两路对应物理引脚32和33BOARD模式。这是芯片引脚复用功能决定的不是所有GPIO都能输出PWM。用法GPIO.setup(32, GPIO.OUT) pwm GPIO.PWM(32, 50) # 50Hz pwm.start(0) pwm.ChangeDutyCycle(7.5) # 占空比7.5% pwm.ChangeFrequency(60) # 改频率 pwm.stop()要注意Jetson.GPIO库的PWM是基于内核的PWM子系统做的只用32和33这两个引脚时是硬件PWM输出稳定。如果你想把其他GPIO引脚当PWM用这个库不支持没有任何软件PWM的回退方案。这一点比树莓派弱一些树莓派可以用软件方式在任意GPIO上模拟PWM。如果你确实需要更多路PWM推荐外接一个PCA9685的I2C舵机驱动板16路PWM够你用。3.4 cleanup别指望完全释放GPIO.cleanup()在树莓派上可以释放所有占用的GPIO资源但在Jetson上表现没那么彻底。实际测试中我程序退出后执行了cleanup再跑下一个程序偶尔会遇到引脚状态还停留在上次电平的情况尤其是输出模式下LED可能保持常亮。更彻底的办法是手动操作/sys/class/gpio来复位引脚或者干脆重启板子。如果你的应用场景是长时间运行的守护进程建议程序里多做异常保护确保退出时能把对应引脚设为低电平不要指望cleanup一劳永逸。4. 三个外设实测点灯、按键、舵机的完整代码4.1 点灯输出——验证环境最快路径装好库、配好权限之后第一个程序永远是点灯。我习惯用物理引脚11对应芯片GPIO50作为测试引脚因为它在排针上位置靠中方便用杜邦线接面包板。import Jetson.GPIO as GPIO import time GPIO.setmode(GPIO.BOARD) led_pin 11 GPIO.setup(led_pin, GPIO.OUT, initialGPIO.LOW) try: while True: GPIO.output(led_pin, GPIO.HIGH) time.sleep(0.5) GPIO.output(led_pin, GPIO.LOW) time.sleep(0.5) except KeyboardInterrupt: GPIO.cleanup()这段代码跑通说明环境没问题。如果在这一步就卡住90%是权限问题——检查你是否在gpio组里、是否重启过、udev规则是否生效。4.2 按键输入上拉和消抖Jetson Nano的GPIO内部有上拉和下拉电阻可以配置这对按键输入很重要。我用物理引脚13接一个按键到GND启用内部上拉按键按下时引脚读到低电平import Jetson.GPIO as GPIO import time GPIO.setmode(GPIO.BOARD) btn_pin 13 GPIO.setup(btn_pin, GPIO.IN, pull_up_downGPIO.PUD_UP) def on_press(channel): print(Button pressed, channel:, channel) GPIO.add_event_detect(btn_pin, GPIO.FALLING, callbackon_press, bouncetime200) try: while True: time.sleep(1) except KeyboardInterrupt: GPIO.cleanup()这个例子里有几个细节。bouncetime200是软件消抖单位毫秒意思是事件触发后200毫秒内忽略同引脚的其他触发防抖效果在机械按键上足够但注意它也意味着你按键再快两次有效触发的最小间隔也是200毫秒。另外事件回调函数是在独立线程里跑的不要在回调里做太耗时的操作否则会阻塞后续事件处理。4.3 舵机控制硬件PWM引脚舵机是PWM最常见的应用。我用的是SG90舵机控制信号就是50Hz的PWM占空比范围大约2.5%到12.5%对应0到180度。Jetson Nano的两路硬件PWM在物理引脚32和33这里用引脚32import Jetson.GPIO as GPIO import time GPIO.setmode(GPIO.BOARD) pwm_pin 32 GPIO.setup(pwm_pin, GPIO.OUT) pwm GPIO.PWM(pwm_pin, 50) pwm.start(0) try: while True: pwm.ChangeDutyCycle(2.5) # 0度 time.sleep(1) pwm.ChangeDutyCycle(7.5) # 90度 time.sleep(1) pwm.ChangeDutyCycle(12.5) # 180度 time.sleep(1) except KeyboardInterrupt: pwm.stop() GPIO.cleanup()实际测试中SG90在Jetson上用硬件PWM驱动转动平稳没有明显抖动。有一点值得注意如果你的舵机在上电瞬间会猛跳一下那是PWM信号还没建立、舵机内部检测到异常电平导致的。可以在程序启动时先把占空比设为0再慢慢往上加或者给舵机单独做一个上电延迟控制。4.4 超声波测距的延时坑HC-SR04超声波模块用GPIO触发和读取回波看起来很简单但在Jetson上有个隐藏问题。HC-SR04的测量原理是Trig引脚给一个10us以上的高电平触发信号模块自动发出超声波然后把Echo引脚拉高高电平持续的时间就是超声波往返的时间。你需要精确测量Echo引脚高电平的持续时间然后除以声速得到距离。树莓派上用time.time()测这个时间还够用但Jetson上如果你用Python的time.time()去计时误差会大得离谱——因为Jetson的Linux系统调度、Python解释器开销加上USB/HDMI等设备可能抢占CPU测出来的时间脉冲很容易偏。我第一次在Jetson上跑超声波距离读数飘来飘去最夸张的时候能差出十几厘米。我用time.perf_counter_ns()改成纳秒级计时后好了很多但依然比在树莓派上差。如果你要做精确的超声波避障更靠谱的做法是用一个能输出中断的引脚配合内核事件或者干脆用I2C接口的激光测距模块。这个案例算是Jetson上GPIO应用的一个典型提醒Python操作GPIO虽然方便但涉及精密时间测量时Jetson的实时性其实是不如树莓派加RPi.GPIO的硬件中断方案稳的。5. 比树莓派更容易踩的坑引脚复用、硬件限制和排查清单5.1 引脚功能复用jetson-io.py 干什么用很多人在Jetson上用GPIO遇到“引脚不工作”的诡异问题其实不是代码问题而是引脚被复用成了别的外设功能。Jetson Nano的40pin排针上不少引脚同时连接着I2C、SPI、UART等控制器。系统默认情况下一部分引脚已经分配给了UART或I2C你想把它们当普通GPIO用必须先解除复用。NVIDIA提供了一个交互式工具sudo /opt/nvidia/jetson-io/config-by-pin.py运行后会出现一个文本界面可以查看每个引脚的当前功能并把引脚配置成GPIO或者其他外设。配置完成写回设备树后需要重启生效。这个工具对应了Linux里设备树 overlay 的概念跟树莓派的dtoverlay类似但在Jetson上用起来更笨重一些。我的经验是在项目的早期阶段先把你要用的所有引脚功能规划好一次性配置到位别做一半再改因为改完要重启而重启一次Jetson Nano的时间够你喝两杯水。5.2 电平与电源3.3V逻辑别接5VJetson Nano的GPIO引脚是3.3V逻辑电平不兼容5V输入。如果你拿一个5V输出的传感器直接怼到Jetson的GPIO引脚上短期内可能没事长期用很容易把引脚烧掉。Jetson的GPIO不像某些单片机引脚那样有5V容忍能力。模块电源倒是可以通过40pin排针上的5V引脚供电但注意板载5V引脚能提供的电流有限别指望靠它驱动大功率设备。我之前接了一个5V的超声波模块到5V引脚供电顺便接了三个舵机结果跑了一会儿Jetson自动关机了检查后发现是板载5V输出过流把电源回路拉崩了。后面改成外部独立5V电源给模块供电Jetson只负责信号线问题才解决。5.3 常见问题排查表这里把我在Jetson Nano上玩GPIO遇到过的典型问题整理成一张表排查的时候对着看比重新翻文档快很多。现象可能原因解决方案运行报错找不到Jetson.GPIO模块库没装或PYTHONPATH没配pip安装或export PYTHONPATH指向/opt/nvidia/jetson-gpio/lib/python运行报错channel has not been set up当前用户没有GPIO权限加入gpio组复制udev规则重启引脚输出一直是高/低程序改不了上次程序未cleanup引脚状态残留手动操作/sys/class/gpio导出后再导出或重启引脚不工作但代码没报错引脚被复用成UART/SPI/I2C用config-by-pin.py检查并切换功能PWM输出没波形用了非32/33的引脚或模式不对改用硬件PWM引脚并确认使用BOARD模式按键事件漏触发或抖动没配置上下拉或消抖参数太小设置PUD_UP/PUD_DOWN调大bouncetime接的传感器读数跳变信号线过长或电平不匹配缩短线缆加逻辑电平转换还有一点Jetson.GPIO库主要适配的是Jetson Nano这款板子。如果你用的是更新一些的Jetson Orin Nano同样可以用这套库但引脚定义图有变化40pin排针上部分引脚的编号和复用功能不一样别直接把Nano的引脚表套上去。拿到板子第一件事先查对应型号的官方引脚图再把GPIO模式设成BOARD对着物理引脚号来操作这套流程无论在Nano还是Orin上用都不会出大偏差。GPIO这种东西看着简单真要在特定的板子上跑起来一堆环境层面的小问题能把人磨到怀疑人生。Jetson Nano的GPIO库总体上是个好用的库API设计也照顾了从树莓派迁过来的人但它毕竟跑在完整的Linux系统上权限、设备树、引脚复用这些树莓派帮你隐藏掉的复杂度在Jetson上全部会暴露出来。把上面这几个环节理顺后续不管是接传感器、做小车还是搞边缘计算的联动控制都能省下大量排查时间。本文还有配套的精品资源点击获取 Jetson Nano GPIO实战指南：从库安装到外设驱动全解析
简介面向Jetson Nano嵌入式开发者与AI边缘计算爱好者这份GPIO库资源包基于C/C接口解决在NVIDIA Jetson平台上通过GPIO控制传感器、LED等外设的编程需求。资源共68个文件压缩包仅106KB核心包含29个cpp实现与17个h头文件另有md/txt说明文档、cmake与dockerfile构建配置、sh脚本及规则文件结构清晰兼顾源码阅读与工程集成。内容整合了libnvgpio等库的调用方式涵盖GPIO基本概念、引脚结构、读写操作及中断回调等关键点并提供LED点灯、PWM输出、按键中断等示例程序可直接参考或修改使用。对正在学习Jetson Nano硬件控制或需要快速搭建GPIO开发环境的C开发者有较大帮助。目前已有852人在CSDN学习下载属于入门与实战兼顾的轻量级参考资料。 拿到一块Jetson Nano很多人的第一反应是这不就是个加强版树莓派嘛40pin排针摆得整整齐齐Python里操作GPIO应该也差不多吧结果一跑代码就傻眼——RPi.GPIO不认这块板子报错都是英文一长串翻遍全网教程还都是教树莓派的对着Jetson改半天就是点不亮那颗LED。我当年也是这么过来的。后来把Jetson Nano的GPIO折腾明白之后发现其实核心问题就几个库用错了、权限没配、引脚编号搞混了。这篇就把我在Jetson Nano上从零开始玩转GPIO的完整过程写下来包括Jetson.GPIO库的安装、权限配置、核心API用法以及点灯、按键、舵机、超声波这几个典型外设的完整代码最后再列一下我踩过的坑。不管是第一次碰Jetson的小白还是从树莓派迁移过来的老玩家这篇应该都能帮你少走几个弯路。1. 为什么Jetson Nano的GPIO不能照搬树莓派那套玩法1.1 板子长得像底层完全是两家人Jetson Nano和树莓派都有一个40pin的扩展排针外观看着确实挺像但底层完全是两套东西。树莓派用的是Broadcom的SoCGPIO控制器是博通自己那套Linux内核里对应的驱动是pinctrl-bcm2835操作系统里默认就带好了RPi.GPIO这个Python库用户直接import就能用。Jetson Nano用的是NVIDIA的Tegra X1芯片GPU和CPU集成在一块GPIO引脚是由Tegra的GPIO控制器和PINMUX模块管理的。NVIDIA给出的官方Python库叫Jetson.GPIO虽然API风格刻意模仿了RPi.GPIO让你看起来眼熟但安装方式、权限模型、引脚编号规则跟树莓派完全不是一回事。如果你直接把RPi.GPIO的代码拷到Jetson上第一行import RPi.GPIO就会直接报ImportError。就算你强行装了一个RPi.GPIO的兼容版引脚编号也对不上。树莓派物理第7脚对应BCM4Jetson Nano上同一个物理位置的引脚在BCM模式下编号可能是一个两百多号的GPIO编号完全没法兼容。1.2 “8种GPIO模式”这个词在Jetson上别直接用很多从STM32转过来的人会问Jetson Nano支持GPIO的8种工作模式吗这其实是个概念混用。GPIO的8种模式——模拟输入、浮空输入、上下拉输入、开漏输出、推挽输出这些——是STM32这类MCU上寄存器级的概念由寄存器直接配置每个引脚的电气行为。Jetson Nano跑的是完整Linux系统GPIO引脚的工作模式由设备树Device Tree和内核的pinctrl子系统来管不是你在Python里直接调一个函数就能切来切去的。Jetson.GPIO库能设置的是输入、输出、上拉、下拉、PWM仅此而已。至于引脚复用功能比如把某个引脚切成UART或SPI那是另一个层面的配置需要改设备树或者用NVIDIA提供的jetson-io工具。所以如果你在搜索里看到“GPIO的8种工作模式”先搞清楚那是MCU的概念别用那套思维来操作Jetson。2. 先把库装好权限和udev规则是最大的入门门槛2.1 刷完系统后库其实已经在了Jetson Nano刷完官方JetPack镜像之后系统里其实已经带了一份Jetson.GPIO库只不过不在Python默认的搜索路径里。你可以在/opt/nvidia/jetson-gpio目录下找到它里面有编译好的库文件和一份etc/99-gpio.rules规则文件。如果你刷的是一个精简系统或者自己手动裁剪过的镜像可能这个目录不存在那就要用pip装sudo apt-get update sudo apt-get install -y python3-pip sudo pip3 install Jetson.GPIO这里有个容易踩的坑pip安装的时候会现场编译C扩展如果你系统里缺少编译工具链或者Python开发头文件会直接编译失败。报错信息通常是一大堆gcc的error新手很容易懵。这时候先装一下build-essential和python3-dev再重试sudo apt-get install -y build-essential python3-dev sudo pip3 install Jetson.GPIO2.2 权限配置三步走如果你跳过权限配置直接跑GPIO程序会报这样的错误RuntimeError: The GPIO channel has not been set up yet或者更直接的权限拒绝。解决方法是把当前用户加入gpio组并把udev规则文件复制到系统目录sudo groupadd -f -r gpio sudo usermod -a -G gpio $USER sudo cp /opt/nvidia/jetson-gpio/etc/99-gpio.rules /etc/udev/rules.d/ sudo udevadm control --reload-rules sudo udevadm trigger如果/opt/nvidia/jetson-gpio目录不存在可以从GitHub上的NVIDIA/jetson-gpio仓库里把99-gpio.rules文件下载下来再复制到/etc/udev/rules.d/。做完这一步注销重新登录或者直接reboot让用户组和udev规则生效。这一步不做后面所有GPIO操作都会卡在权限上而且报错信息并不直观新手很容易在这里浪费半天。2.3 从pip安装容易踩的编译坑我自己实际遇到过一次比较诡异的情况系统里明明自带了/opt/nvidia/jetson-gpio这个目录但我用pip3 install Jetson.GPIO又装了一份结果两个版本的GPIO库在sys.path里的优先级不一样程序里用的可能是pip装的那份而那份是源码编译的跟几大页的编译报错纠缠在一起反而耽误时间。后来我的习惯是先检查/opt/nvidia/jetson-gpio目录是否存在存在就直接设置PYTHONPATH不重复pip安装export PYTHONPATH/opt/nvidia/jetson-gpio/lib/python:$PYTHONPATH或者干脆用pip装但装之前用pip3 show Jetson.GPIO看一下有没有残留版本避免混用。同一个环境里出现两份Jetson.GPIO是会有一些奇怪问题的。3. 核心API实测和RPi.GPIO神似但细节别想当然3.1 BOARD/BCM编号最坑的一个点Jetson.GPIO同样支持GPIO.BOARD和GPIO.BCM两种编号模式但注意BCM编号跟树莓派完全不通用。GPIO.BOARD使用物理排针的编号1到40这个和树莓派的物理编号是一致的因为40pin排针的物理位置是行业标准照着一块板子设计物理位置都一样。GPIO.BCM使用Tegra芯片内部的GPIO编号比如GPIO216这种不同引脚对应的编号需要在NVIDIA官方引脚图上查。我个人的建议是除非你有特殊原因否则一律用GPIO.BOARD模式。物理引脚号最直观对着板子数就行不用查表也不容易出错。BCM编号在Jetson上没有任何优势而且极易混淆网上很多教程用的是BCM模式但针对的板子型号一换定义就全变了。设置模式必须在所有操作之前调用import Jetson.GPIO as GPIO GPIO.setmode(GPIO.BOARD)3.2 输入输出、上下拉、事件检测初始化一个引脚为输出GPIO.setup(11, GPIO.OUT, initialGPIO.LOW)初始化一个引脚为输入并开启上拉GPIO.setup(13, GPIO.IN, pull_up_downGPIO.PUD_UP)读取输入value GPIO.input(13)事件检测用法也跟RPi.GPIO差不多GPIO.add_event_detect(13, GPIO.FALLING, callbackmy_callback, bouncetime200)需要说明的是Jetson.GPIO的事件检测底层实现跟树莓派不完全一样。树莓派的RPi.GPIO是依赖Broadcom芯片的硬件中断延迟低且稳定。Jetson.GPIO的事件检测走的是内核的gpio事件接口加用户态轮询实际使用中我发现它对高频信号处理能力偏弱。我用它读一个5Hz的方波信号做计数偶尔会丢事件调低了回调里的耗时之后才稳定一些。所以如果你要拿GPIO做高频计数或者实时性要求很高的采集别指望这个库要么写C扩展要么直接操作/sys/class/gpio或者用jetson-io把引脚切成SPI/I2C等硬件外设来用。3.3 PWM只有两路硬件PWMJetson Nano的40pin排针上硬件PWM只有两路对应物理引脚32和33BOARD模式。这是芯片引脚复用功能决定的不是所有GPIO都能输出PWM。用法GPIO.setup(32, GPIO.OUT) pwm GPIO.PWM(32, 50) # 50Hz pwm.start(0) pwm.ChangeDutyCycle(7.5) # 占空比7.5% pwm.ChangeFrequency(60) # 改频率 pwm.stop()要注意Jetson.GPIO库的PWM是基于内核的PWM子系统做的只用32和33这两个引脚时是硬件PWM输出稳定。如果你想把其他GPIO引脚当PWM用这个库不支持没有任何软件PWM的回退方案。这一点比树莓派弱一些树莓派可以用软件方式在任意GPIO上模拟PWM。如果你确实需要更多路PWM推荐外接一个PCA9685的I2C舵机驱动板16路PWM够你用。3.4 cleanup别指望完全释放GPIO.cleanup()在树莓派上可以释放所有占用的GPIO资源但在Jetson上表现没那么彻底。实际测试中我程序退出后执行了cleanup再跑下一个程序偶尔会遇到引脚状态还停留在上次电平的情况尤其是输出模式下LED可能保持常亮。更彻底的办法是手动操作/sys/class/gpio来复位引脚或者干脆重启板子。如果你的应用场景是长时间运行的守护进程建议程序里多做异常保护确保退出时能把对应引脚设为低电平不要指望cleanup一劳永逸。4. 三个外设实测点灯、按键、舵机的完整代码4.1 点灯输出——验证环境最快路径装好库、配好权限之后第一个程序永远是点灯。我习惯用物理引脚11对应芯片GPIO50作为测试引脚因为它在排针上位置靠中方便用杜邦线接面包板。import Jetson.GPIO as GPIO import time GPIO.setmode(GPIO.BOARD) led_pin 11 GPIO.setup(led_pin, GPIO.OUT, initialGPIO.LOW) try: while True: GPIO.output(led_pin, GPIO.HIGH) time.sleep(0.5) GPIO.output(led_pin, GPIO.LOW) time.sleep(0.5) except KeyboardInterrupt: GPIO.cleanup()这段代码跑通说明环境没问题。如果在这一步就卡住90%是权限问题——检查你是否在gpio组里、是否重启过、udev规则是否生效。4.2 按键输入上拉和消抖Jetson Nano的GPIO内部有上拉和下拉电阻可以配置这对按键输入很重要。我用物理引脚13接一个按键到GND启用内部上拉按键按下时引脚读到低电平import Jetson.GPIO as GPIO import time GPIO.setmode(GPIO.BOARD) btn_pin 13 GPIO.setup(btn_pin, GPIO.IN, pull_up_downGPIO.PUD_UP) def on_press(channel): print(Button pressed, channel:, channel) GPIO.add_event_detect(btn_pin, GPIO.FALLING, callbackon_press, bouncetime200) try: while True: time.sleep(1) except KeyboardInterrupt: GPIO.cleanup()这个例子里有几个细节。bouncetime200是软件消抖单位毫秒意思是事件触发后200毫秒内忽略同引脚的其他触发防抖效果在机械按键上足够但注意它也意味着你按键再快两次有效触发的最小间隔也是200毫秒。另外事件回调函数是在独立线程里跑的不要在回调里做太耗时的操作否则会阻塞后续事件处理。4.3 舵机控制硬件PWM引脚舵机是PWM最常见的应用。我用的是SG90舵机控制信号就是50Hz的PWM占空比范围大约2.5%到12.5%对应0到180度。Jetson Nano的两路硬件PWM在物理引脚32和33这里用引脚32import Jetson.GPIO as GPIO import time GPIO.setmode(GPIO.BOARD) pwm_pin 32 GPIO.setup(pwm_pin, GPIO.OUT) pwm GPIO.PWM(pwm_pin, 50) pwm.start(0) try: while True: pwm.ChangeDutyCycle(2.5) # 0度 time.sleep(1) pwm.ChangeDutyCycle(7.5) # 90度 time.sleep(1) pwm.ChangeDutyCycle(12.5) # 180度 time.sleep(1) except KeyboardInterrupt: pwm.stop() GPIO.cleanup()实际测试中SG90在Jetson上用硬件PWM驱动转动平稳没有明显抖动。有一点值得注意如果你的舵机在上电瞬间会猛跳一下那是PWM信号还没建立、舵机内部检测到异常电平导致的。可以在程序启动时先把占空比设为0再慢慢往上加或者给舵机单独做一个上电延迟控制。4.4 超声波测距的延时坑HC-SR04超声波模块用GPIO触发和读取回波看起来很简单但在Jetson上有个隐藏问题。HC-SR04的测量原理是Trig引脚给一个10us以上的高电平触发信号模块自动发出超声波然后把Echo引脚拉高高电平持续的时间就是超声波往返的时间。你需要精确测量Echo引脚高电平的持续时间然后除以声速得到距离。树莓派上用time.time()测这个时间还够用但Jetson上如果你用Python的time.time()去计时误差会大得离谱——因为Jetson的Linux系统调度、Python解释器开销加上USB/HDMI等设备可能抢占CPU测出来的时间脉冲很容易偏。我第一次在Jetson上跑超声波距离读数飘来飘去最夸张的时候能差出十几厘米。我用time.perf_counter_ns()改成纳秒级计时后好了很多但依然比在树莓派上差。如果你要做精确的超声波避障更靠谱的做法是用一个能输出中断的引脚配合内核事件或者干脆用I2C接口的激光测距模块。这个案例算是Jetson上GPIO应用的一个典型提醒Python操作GPIO虽然方便但涉及精密时间测量时Jetson的实时性其实是不如树莓派加RPi.GPIO的硬件中断方案稳的。5. 比树莓派更容易踩的坑引脚复用、硬件限制和排查清单5.1 引脚功能复用jetson-io.py 干什么用很多人在Jetson上用GPIO遇到“引脚不工作”的诡异问题其实不是代码问题而是引脚被复用成了别的外设功能。Jetson Nano的40pin排针上不少引脚同时连接着I2C、SPI、UART等控制器。系统默认情况下一部分引脚已经分配给了UART或I2C你想把它们当普通GPIO用必须先解除复用。NVIDIA提供了一个交互式工具sudo /opt/nvidia/jetson-io/config-by-pin.py运行后会出现一个文本界面可以查看每个引脚的当前功能并把引脚配置成GPIO或者其他外设。配置完成写回设备树后需要重启生效。这个工具对应了Linux里设备树 overlay 的概念跟树莓派的dtoverlay类似但在Jetson上用起来更笨重一些。我的经验是在项目的早期阶段先把你要用的所有引脚功能规划好一次性配置到位别做一半再改因为改完要重启而重启一次Jetson Nano的时间够你喝两杯水。5.2 电平与电源3.3V逻辑别接5VJetson Nano的GPIO引脚是3.3V逻辑电平不兼容5V输入。如果你拿一个5V输出的传感器直接怼到Jetson的GPIO引脚上短期内可能没事长期用很容易把引脚烧掉。Jetson的GPIO不像某些单片机引脚那样有5V容忍能力。模块电源倒是可以通过40pin排针上的5V引脚供电但注意板载5V引脚能提供的电流有限别指望靠它驱动大功率设备。我之前接了一个5V的超声波模块到5V引脚供电顺便接了三个舵机结果跑了一会儿Jetson自动关机了检查后发现是板载5V输出过流把电源回路拉崩了。后面改成外部独立5V电源给模块供电Jetson只负责信号线问题才解决。5.3 常见问题排查表这里把我在Jetson Nano上玩GPIO遇到过的典型问题整理成一张表排查的时候对着看比重新翻文档快很多。现象可能原因解决方案运行报错找不到Jetson.GPIO模块库没装或PYTHONPATH没配pip安装或export PYTHONPATH指向/opt/nvidia/jetson-gpio/lib/python运行报错channel has not been set up当前用户没有GPIO权限加入gpio组复制udev规则重启引脚输出一直是高/低程序改不了上次程序未cleanup引脚状态残留手动操作/sys/class/gpio导出后再导出或重启引脚不工作但代码没报错引脚被复用成UART/SPI/I2C用config-by-pin.py检查并切换功能PWM输出没波形用了非32/33的引脚或模式不对改用硬件PWM引脚并确认使用BOARD模式按键事件漏触发或抖动没配置上下拉或消抖参数太小设置PUD_UP/PUD_DOWN调大bouncetime接的传感器读数跳变信号线过长或电平不匹配缩短线缆加逻辑电平转换还有一点Jetson.GPIO库主要适配的是Jetson Nano这款板子。如果你用的是更新一些的Jetson Orin Nano同样可以用这套库但引脚定义图有变化40pin排针上部分引脚的编号和复用功能不一样别直接把Nano的引脚表套上去。拿到板子第一件事先查对应型号的官方引脚图再把GPIO模式设成BOARD对着物理引脚号来操作这套流程无论在Nano还是Orin上用都不会出大偏差。GPIO这种东西看着简单真要在特定的板子上跑起来一堆环境层面的小问题能把人磨到怀疑人生。Jetson Nano的GPIO库总体上是个好用的库API设计也照顾了从树莓派迁过来的人但它毕竟跑在完整的Linux系统上权限、设备树、引脚复用这些树莓派帮你隐藏掉的复杂度在Jetson上全部会暴露出来。把上面这几个环节理顺后续不管是接传感器、做小车还是搞边缘计算的联动控制都能省下大量排查时间。本文还有配套的精品资源点击获取