C
NVIDIA Jetson 快速入门指南
Qt 提供了设计、开发、构建和部署应用程序到目标所需的所有必要工具。
本指南描述了如何使用 Qt 工具的 GUI 开发 NVIDIA Jetson 设备上的 Linux 应用程序。它描述了整体流程,并提供了以下任务的逐步说明:
- 使用 Qt Design Studio 设计简单的用户界面。
- 在 Qt Creator 中创建项目并利用为 NVIDIA Jetson 设备准备的现成 Boot to Qt 图像。
- 在目标硬件上构建和调试项目。
注意:Qt for Device Creation 需要许可证。如果您没有许可证,您可以请求 免费试用。
概述
以下图示显示了使用 Qt 工具和 Boot to Qt 软件栈时软件开发过程的基本概念。
- 开发宿主机 是运行在 Windows、Linux 或 macOS 上的开发计算机,上面运行了 Qt 工具。
- Qt 工具 包括开发工具(例如 Qt Creator 和 Qt Design Studio)以及质量保证(QA)工具(例如 Squish)。
- QBSP SDK 包含一个集成到 Qt Creator 中的交叉编译工具链,以及可以用于用 Boot to Qt 软件堆栈启动设备的设备镜像。
- 目标设备 是运行您的嵌入式 Linux 应用程序的开发目标。
- 上传和调试应用程序(通过以太网、Wi-Fi 或 USB)。使用 Qt Creator 上传和调试目标设备上的应用程序。
- 闪存 QBSP 镜像 代表(例如 SD 卡)在目标设备上安装 Linux 的方法。
适用的 NVIDIA Jetson 目标设备
本指南中的说明适用于以下 NVIDIA Jetson 目标设备:
- NVIDIA Jetson AGX Xavier 开发套件
- NVIDIA Jetson AGX Orin 开发套件
注意:有关支持的目标设备和开发宿主机的更多详细信息,请参阅 支持的目标设备和开发宿主机。
安装 Qt
按照本指南中的说明获取所有必需的资源,包括 Qt Creator 和 Qt Design Studio。
- 登录到 Qt 客户门户 下载 Qt 在线安装程序。
- 安装程序适用于以下宿主机:
- ARM 上的 Linux
- Linux x86
- macOS
- Windows
下载与您的宿主机匹配的安装包。
- 打开安装程序。
- 继续到安装文件夹,并选择自定义安装。
- 选择下一步。
- 在选择组件中,选择Qt 6.7.2。所需的开发人员和设计师工具(如Qt Creator和Qt Design Studio)在安装程序中已预选。
- 选择下一步。
- 继续到准备安装并选择安装。
注意:如果您已经安装了Qt,请使用Qt维护工具安装缺失的工具。
使用Qt维护工具安装Boot to Qt软件堆栈
为了安装NVIDIA Jetson AGX Xavier开发者套件的Boot to Qt软件堆栈,请执行以下操作
- 打开Qt维护工具。
- 继续到选择组件并打开最顶层的Boot to Qt软件堆栈下拉菜单。
- 打开与正确的Qt版本对应的Boot to Qt软件堆栈下拉菜单。
- 选择NVIDIA Jetson AGX Xavier开发者套件。
- 继续到准备安装并选择安装。
在目标设备上安装Boot to Qt
在您可以在目标设备上测试您的Qt应用程序之前,您必须将包含Boot to Qt软件堆栈的镜像烧录到目标设备上。成功烧录设备后,在设备启动时,将显示Boot to Qt演示启动器。
此设备可以从内部eMMC或SD卡启动。但是,Boot to Qt镜像仅支持内部eMMC。
注意:Qt闪存向导不适用于此设备。
将Boot to Qt镜像烧录到系统内部eMMC中
- 使用合适的USB-C电缆将目标设备连接到PC。
注意:通过USB集线器连接设备将显著降低烧录期间的传输速度。
- 将目标设备置于工厂恢复模式。
- 按下并保持工厂恢复按钮。
- 如果设备未开启,请按下并释放电源按钮。如果设备已经开启,请按下并释放复位按钮。
- 释放工厂恢复按钮。
- 运行以下脚本来将镜像烧录到系统内部eMMC
cd <INSTALL_DIR>/<Qt version>/Boot2Qt/jetson-agx-xavier-devkit/images mkdir tegraflash cd tegraflash tar xf ../b2qt-embedded-qt6-image-jetson-agx-xavier-devkit.tegraflash.tar.gz sudo ./doflash.sh
有关更多信息,请参阅烧录Jetson开发者套件。
注意:内部eMMC的烧录仅支持Linux宿主机。
设置设备
Boot to Qt设备可以通过USB、以太网或Wi-Fi连接。以下各节提供了使用USB、以太网或Wi-Fi连接设置设备的方法。
通过USB设置设备
目标设备可以通过USB OTG与宿主机连接。连接到USB网络后,设备将自动添加到Qt Creator中的设备。
目标设备的USB访问支持两种不同的USB协议。默认的RNDIS协议可以在连接目标设备到Linux或Windows宿主机时使用。当您想要将目标设备连接到macOS宿主机时,您需要切换到CDC-ECM协议。
注意:您可以在“启动Boot to Qt”中更改协议。
有关通过USB连接设备的更多信息,请参阅在目标设备上设置USB和以太网。
通过以太网或Wi-Fi设置设备
目标设备可以通过以太网或Wi-Fi连接网络。目标设备连接并分配IP地址后,可以使用以下步骤将其配置到Qt Creator
- 打开 Qt Creator。
- 选择 编辑 > 首选项。
- 在 首选项 窗口中
- 选择 设备。
- 选择 添加 > Boot2Qt 设备 > 启动向导。
- 在 Boot2Qt 网络设备设置 窗口中
- 输入 设备名称。
- 输入 设备地址(NVIDIA Jetson设备的IP地址)。
- 选择 完成。
- 在 设备 选项卡上
- 选择 确定。
注意: 您还可以从“Boot到Qt入门”设置Wi-Fi连接
注意: 当Qt Creator通过IP网络上传应用程序时,NVIDIA Jetson设备必须与您的开发主机PC在同一网络中。
在Qt Design Studio中创建应用程序UI
您可以使用Qt Design Studio创建跨平台UI,还包括嵌入式Linux应用程序。
- 打开 Qt Design Studio。
- 选择 创建项目。
- 在 预置 中,选择 通用。
- 命名您的项目(注意项目路径,以便使用Qt Creator打开)。
- 调整显示分辨率和方向以适应您的显示。
- 确保您的 目标Qt版本 与机器上安装的Qt版本匹配。
- 选择 创建。
现在您可以根据需要修改UI。完成后,选择 全部保存,以确保您可以在Qt Creator中打开您的UI项目。
在Qt Creator中配置和构建应用程序
- 打开 Qt Creator。
- 导航到您使用Qt Design Studio创建的项目。
- 选择 CMakeLists.txt 以打开项目。
- 在 配置项目 窗口中
- 选择您的新兴NVIDIA Jetson套件。
- 选择 配置项目。
最后,选择 构建 > 构建项目 以构建您配置的项目。
在设备上运行应用程序
配置您的设备后,您可以在NVIDIA Jetson设备上上传和启动您的应用程序。
- 打开 Qt Creator。
- 选择 文件 > 打开文件或项目。
- 导航到您之前配置的项目并选择 打开。
- 在 项目 窗口中
- 如有必要,编辑 运行设置。
- 选择 运行。
注意: 要更改应用程序,您只需再次运行它即可简单地在设备上更新。
有关将Qt项目部署到设备的详细信息,请参阅教程:使用Boot to Qt部署您的第一个项目。
调试应用程序
有关使用Qt Creator调试应用程序的更多信息,请参阅调试。
故障排除
如果您有任何与NVIDIA Jetson设备相关的问题(例如如何设置引导开关或连接调试终端),请参阅NVIDIA Jetson平台和NVIDIA开发者论坛以获取更多信息。
有关对 Boot to Qt 进行故障排除的更多信息,请参阅 故障排除。
适用于某些 Qt 许可证。
了解详细信息。