3、GPIO输出控制：使用Jetson.GPIO库控制LED灯、PWM输出与呼吸灯实现、GPIO输出电流限制与保护

各位同学，今天我们聊点实在的——怎么让Jetson的GPIO真正“动起来”。

很多初学者拿到Jetson开发板，第一件事就是点个灯。这听起来简单，但背后涉及的东西其实不少。我个人习惯把GPIO输出控制分成三个层次：开关控制、PWM调光、以及安全保护。咱们一个一个来。

3.1 使用Jetson.GPIO库控制LED灯

Jetson.GPIO库是NVIDIA官方维护的Python库，专门用来操作Jetson系列开发板的GPIO引脚。它的API设计跟树莓派的RPi.GPIO非常像，但底层实现完全不同。

先看一个最简单的例子——点亮一个LED灯。

import Jetson.GPIO as GPIO
import time

# 设置引脚编号模式
GPIO.setmode(GPIO.BOARD)  # 使用物理引脚编号

# 定义LED引脚（以Jetson Nano为例，物理引脚12）
LED_PIN = 12

# 设置引脚为输出模式
GPIO.setup(LED_PIN, GPIO.OUT, initial=GPIO.LOW)

try:
    while True:
        GPIO.output(LED_PIN, GPIO.HIGH)  # 点亮
        time.sleep(1)
        GPIO.output(LED_PIN, GPIO.LOW)   # 熄灭
        time.sleep(1)
except KeyboardInterrupt:
    GPIO.cleanup()  # 清理资源

这里有个细节要注意：GPIO.setmode()有两种编号方式——GPIO.BOARD和GPIO.BCM。我个人建议新手用BOARD模式，因为直接对应物理引脚位置，不容易搞错。我在项目中遇到过有人用BCM模式，结果接错线烧了引脚，嗯，那滋味不好受。

小提示： 运行完程序一定要调用 GPIO.cleanup()，否则下次运行时会报警告。我习惯在 try...finally 里写 cleanup，确保异常退出也能释放资源。

3.2 PWM输出与呼吸灯实现

点灯太简单了？那我们来做呼吸灯。呼吸灯的本质就是PWM（脉冲宽度调制），通过改变占空比来控制LED的亮度。

Jetson.GPIO库原生支持硬件PWM，但要注意——不是所有GPIO引脚都支持PWM。以Jetson Nano为例，只有物理引脚32和33支持硬件PWM。其他引脚想用PWM？那就得软件模拟了，但精度和稳定性会差一些。

import Jetson.GPIO as GPIO
import time

GPIO.setmode(GPIO.BOARD)
PWM_PIN = 32  # 硬件PWM引脚

GPIO.setup(PWM_PIN, GPIO.OUT)

# 创建PWM对象，频率1000Hz
pwm = GPIO.PWM(PWM_PIN, 1000)
pwm.start(0)  # 初始占空比0%

try:
    while True:
        # 渐亮
        for duty in range(0, 101, 1):
            pwm.ChangeDutyCycle(duty)
            time.sleep(0.01)
        # 渐暗
        for duty in range(100, -1, -1):
            pwm.ChangeDutyCycle(duty)
            time.sleep(0.01)
except KeyboardInterrupt:
    pwm.stop()
    GPIO.cleanup()

为什么频率选1000Hz？说白了，人眼对100Hz以上的闪烁就不敏感了。1000Hz足够平滑，也不会给CPU带来太大负担。你想想看，如果频率太低，LED会一闪一闪的，那就不叫呼吸灯了，叫闪光灯。

核心要点： PWM的占空比范围是0~100，对应0%到100%的亮度。但实际电路中，LED在占空比低于5%时可能完全不亮，高于95%时亮度变化也不明显。我一般把范围限制在10%~90%之间，效果更线性。

3.3 GPIO输出电流限制与保护

这部分是很多新手容易忽略的，但恰恰是最重要的。Jetson的GPIO引脚能承受的电流非常有限——单个引脚最大输出电流通常只有3mA~8mA，具体取决于型号。直接驱动一个普通LED（20mA）都可能烧坏引脚。

我曾经在调试一个项目时，为了省事直接拿GPIO驱动了一个小继电器，结果……嗯，那个引脚再也没醒过来。从那以后，我养成了一个习惯：任何负载都要先查电流。

那么怎么保护GPIO？常见做法有几种：

保护方式 适用场景 注意事项
串联限流电阻 直接驱动LED（5~20mA） 电阻值 = (Vcc - Vf) / I，一般用220Ω~1kΩ
三极管/MOS管开关 驱动继电器、电机等大电流负载 需要加续流二极管（感性负载）
光耦隔离 需要电气隔离的场景 注意光耦的响应速度
ULN2003/ULN2803 多路驱动（达林顿阵列） 内置续流二极管，非常方便

拿最常见的LED来说，Jetson的GPIO输出3.3V，LED正向压降约2V，电流限制在5mA。那么限流电阻就是：

R = (3.3V - 2V) / 0.005A = 260Ω

实际中我一般用330Ω或470Ω，留点余量。别为了追求亮度把电阻选太小，得不偿失。

警告： 绝对不要用GPIO直接驱动电机、电磁阀、继电器线圈等感性负载！感性负载断电时会产生反向电动势，电压可能高达几十伏，瞬间击穿GPIO引脚。必须使用MOS管或继电器模块，并加续流二极管。

3.4 实战建议与避坑指南

最后，分享几个我这些年总结的经验：

  • 上电顺序很重要：先接好外设电路，再给Jetson上电。反过来操作，GPIO引脚在初始化时可能输出不确定电平，导致外设误动作。
  • 用万用表测一下：每次焊接完电路，先别急着跑程序。用万用表量一下GPIO引脚对地电阻，确保没有短路。我曾经因为焊锡丝搭锡，烧了三个引脚才反应过来。
  • 加个TVS管：如果外设工作在工业环境，建议在GPIO引脚上加一个TVS管（比如SMAJ5.0A），能吸收静电和浪涌。成本才几毛钱，但能救你一块几百块的Jetson。
  • 软件上做保护：代码里加个超时机制，防止PWM占空比卡在100%导致过热。我习惯在循环里加一个timeout检测，超过设定时间自动恢复。

好了，这一章的内容就到这里。GPIO输出控制看似简单，但做好安全防护才是真功夫。下一章我们会讲GPIO输入检测，包括按键消抖、中断处理等，到时候见。

← 上一章 📖 返回目录 下一章 →