Jetson Orin Nano 上手指南：用C++控制GPIO的保姆级教程（从库安装到点亮LED）

Jetson Orin Nano 上手指南：用C++控制GPIO的保姆级教程（从库安装到点亮LED）

第一次拿到Jetson Orin Nano开发板时，最让人兴奋的莫过于通过代码直接控制硬件。想象一下，用几行C++代码就能让LED灯按你的指令闪烁，这种软硬件结合的成就感是纯软件开发难以比拟的。本教程专为硬件编程新手设计，从零开始带你完成GPIO控制的完整流程，避开那些官方文档没明说的坑。

1. 环境准备与硬件连接

在开始编程前，我们需要确保开发环境就绪。首先通过SSH或直接连接显示器登录到Jetson Orin Nano系统，建议使用Ubuntu 20.04或更新版本。打开终端，更新软件包列表：

sudo apt update sudo apt upgrade -y

接下来准备硬件。将LED的正极（长脚）通过杜邦线连接到Orin Nano的GPIO引脚（例如物理引脚7），负极（短脚）连接到GND引脚（例如物理引脚9）。为保护LED，建议串联一个220Ω电阻。不同型号的Jetson开发板引脚布局可能不同，Orin Nano的引脚排列如下：

注意：操作GPIO需要root权限，所有示例程序都需要用sudo运行

2. 安装JetsonGPIO库

我们将使用社区维护的JetsonGPIO库，它提供了类似RPi.GPIO的接口。打开终端执行以下命令：

git clone https://github.com/pjueon/JetsonGPIO cd JetsonGPIO mkdir build cd build

编译安装时有几个关键选项需要注意：

• -DCMAKE_INSTALL_PREFIX=/usr将库安装到系统目录
• -DBUILD_EXAMPLES=ON同时编译示例程序

完整编译命令：

cmake -DCMAKE_INSTALL_PREFIX=/usr -DBUILD_EXAMPLES=ON .. make -j$(nproc) sudo make install

安装完成后，验证是否成功：

ls /usr/include/JetsonGPIO.h

如果看到头文件，说明安装正确。接下来配置动态链接库：

sudo ldconfig

3. 引脚编号模式详解

JetsonGPIO支持四种引脚编号模式，新手最容易在这里混淆：

1. BOARD模式：使用物理引脚编号（最直观）
2. BCM模式：使用Broadcom SOC通道编号（树莓派兼容）
3. TEGRA_SOC模式：使用NVIDIA芯片原生编号
4. CVM模式：旧版兼容模式（不推荐）

建议初学者使用BOARD模式，对应开发板上的物理引脚号。模式设置代码：

#include <JetsonGPIO.h> int main() { GPIO::setmode(GPIO::BOARD); // 使用物理引脚编号 // 其他代码... }

4. 第一个LED控制程序

让我们创建一个完整的LED闪烁项目。首先建立项目目录结构：

led_blink/ ├── CMakeLists.txt └── src └── main.cpp

main.cpp内容如下：

#include <iostream> #include <JetsonGPIO.h> #include <chrono> #include <thread> const int LED_PIN = 7; // 物理引脚7 void cleanup(int signal) { GPIO::cleanup(); std::cout << "程序终止，清理GPIO" << std::endl; exit(signal); } int main() { // 注册中断信号处理 signal(SIGINT, cleanup); try { GPIO::setmode(GPIO::BOARD); GPIO::setup(LED_PIN, GPIO::OUT, GPIO::LOW); std::cout << "按下Ctrl+C停止程序" << std::endl; while(true) { GPIO::output(LED_PIN, GPIO::HIGH); std::cout << "LED亮" << std::endl; std::this_thread::sleep_for(std::chrono::seconds(1)); GPIO::output(LED_PIN, GPIO::LOW); std::cout << "LED灭" << std::endl; std::this_thread::sleep_for(std::chrono::seconds(1)); } } catch (const std::exception& e) { std::cerr << "错误: " << e.what() << std::endl; cleanup(1); } return 0; }

对应的CMakeLists.txt：

cmake_minimum_required(VERSION 3.10) project(led_blink) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) add_executable(led_blink src/main.cpp) target_link_libraries(led_blink JetsonGPIO)

编译并运行：

mkdir build && cd build cmake .. make sudo ./led_blink

5. 常见问题排查

即使按照步骤操作，新手仍可能遇到这些问题：

1. 权限问题：

   • 错误：Could not open /sys/class/gpio/export
   • 解决：确保使用sudo运行程序

2. 引脚模式混淆：

   • 现象：程序运行但LED不亮
   • 检查：确认使用的引脚编号与设置的模式匹配

3. 库链接错误：

   • 错误：undefined reference to 'GPIO::setmode'
   • 解决：确保CMake中正确链接JetsonGPIO库

4. LED接线错误：

   • 现象：LED微亮或不亮
   • 检查：确认LED正负极连接正确，电阻值合适

6. 进阶技巧

掌握基础后，可以尝试这些进阶应用：

• PWM调光：通过软件模拟PWM控制LED亮度
• 中断检测：配置GPIO引脚为输入并设置中断回调
• 多线程控制：安全地在多线程环境中操作GPIO
• 系统服务：将GPIO程序注册为系统服务开机自启

一个简单的PWM实现示例：

void softwarePWM(int pin, int dutyCycle, int durationMs) { const int period = 20; // 50Hz int onTime = period * dutyCycle / 100; int offTime = period - onTime; auto start = std::chrono::steady_clock::now(); while(std::chrono::steady_clock::now() - start < std::chrono::milliseconds(durationMs)) { GPIO::output(pin, GPIO::HIGH); std::this_thread::sleep_for(std::chrono::milliseconds(onTime)); GPIO::output(pin, GPIO::LOW); std::this_thread::sleep_for(std::chrono::milliseconds(offTime)); } }

7. 项目实战：交通灯模拟

将所学知识综合应用，我们可以模拟一个简单的交通灯系统。需要三个LED（红、黄、绿）分别连接到引脚7、11、13：

const int RED = 7, YELLOW = 11, GREEN = 13; void setLights(int r, int y, int g) { GPIO::output(RED, r); GPIO::output(YELLOW, y); GPIO::output(GREEN, g); } void trafficLightSequence() { while(true) { // 绿灯亮5秒 setLights(LOW, LOW, HIGH); std::this_thread::sleep_for(std::chrono::seconds(5)); // 黄灯闪烁3次 for(int i=0; i<3; i++) { setLights(LOW, HIGH, LOW); std::this_thread::sleep_for(std::chrono::milliseconds(500)); setLights(LOW, LOW, LOW); std::this_thread::sleep_for(std::chrono::milliseconds(500)); } // 红灯亮5秒 setLights(HIGH, LOW, LOW); std::this_thread::sleep_for(std::chrono::seconds(5)); } }

这个项目可以扩展加入按钮控制的人行横道信号灯，真正体验嵌入式开发的乐趣。