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。

  1. 登录到 Qt 客户门户 下载 Qt 在线安装程序
  2. 安装程序适用于以下宿主机:
    • ARM 上的 Linux
    • Linux x86
    • macOS
    • Windows

    下载与您的宿主机匹配的安装包。

  3. 打开安装程序。
  4. 继续到安装文件夹,并选择自定义安装
  5. 选择下一步
  6. 选择组件中,选择Qt 6.7.2。所需的开发人员和设计师工具(如Qt Creator和Qt Design Studio)在安装程序中已预选。
  7. 选择下一步
  8. 继续到准备安装并选择安装

注意:如果您已经安装了Qt,请使用Qt维护工具安装缺失的工具。

使用Qt维护工具安装Boot to Qt软件堆栈

为了安装NVIDIA Jetson AGX Xavier开发者套件的Boot to Qt软件堆栈,请执行以下操作

  1. 打开Qt维护工具。
  2. 继续到选择组件并打开最顶层的Boot to Qt软件堆栈下拉菜单。
  3. 打开与正确的Qt版本对应的Boot to Qt软件堆栈下拉菜单。
  4. 选择NVIDIA Jetson AGX Xavier开发者套件
  5. 继续到准备安装并选择安装

在目标设备上安装Boot to Qt

在您可以在目标设备上测试您的Qt应用程序之前,您必须将包含Boot to Qt软件堆栈的镜像烧录到目标设备上。成功烧录设备后,在设备启动时,将显示Boot to Qt演示启动器。

此设备可以从内部eMMC或SD卡启动。但是,Boot to Qt镜像仅支持内部eMMC。

注意:Qt闪存向导不适用于此设备。

将Boot to Qt镜像烧录到系统内部eMMC中

  1. 使用合适的USB-C电缆将目标设备连接到PC。

    注意:通过USB集线器连接设备将显著降低烧录期间的传输速度。

  2. 将目标设备置于工厂恢复模式。
    1. 按下并保持工厂恢复按钮。
    2. 如果设备未开启,请按下并释放电源按钮。如果设备已经开启,请按下并释放复位按钮。
    3. 释放工厂恢复按钮。
  3. 运行以下脚本来将镜像烧录到系统内部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

  1. 打开 Qt Creator
  2. 选择 编辑 > 首选项
  3. 首选项 窗口中
    1. 选择 设备
    2. 选择 添加 > Boot2Qt 设备 > 启动向导
  4. Boot2Qt 网络设备设置 窗口中
    1. 输入 设备名称
    2. 输入 设备地址(NVIDIA Jetson设备的IP地址)。
    3. 选择 完成
  5. 设备 选项卡上
    • 选择 确定

注意: 您还可以从“Boot到Qt入门”设置Wi-Fi连接

注意: 当Qt Creator通过IP网络上传应用程序时,NVIDIA Jetson设备必须与您的开发主机PC在同一网络中。

在Qt Design Studio中创建应用程序UI

您可以使用Qt Design Studio创建跨平台UI,还包括嵌入式Linux应用程序。

  1. 打开 Qt Design Studio
  2. 选择 创建项目
  3. 预置 中,选择 通用
    • 命名您的项目(注意项目路径,以便使用Qt Creator打开)。
    • 调整显示分辨率和方向以适应您的显示。
  4. 确保您的 目标Qt版本 与机器上安装的Qt版本匹配。
  5. 选择 创建

现在您可以根据需要修改UI。完成后,选择 全部保存,以确保您可以在Qt Creator中打开您的UI项目。

在Qt Creator中配置和构建应用程序

  1. 打开 Qt Creator
  2. 导航到您使用Qt Design Studio创建的项目。
  3. 选择 CMakeLists.txt 以打开项目。
  4. 配置项目 窗口中
    1. 选择您的新兴NVIDIA Jetson套件。
    2. 选择 配置项目

最后,选择 构建 > 构建项目 以构建您配置的项目。

在设备上运行应用程序

配置您的设备后,您可以在NVIDIA Jetson设备上上传和启动您的应用程序。

  1. 打开 Qt Creator
  2. 选择 文件 > 打开文件或项目
  3. 导航到您之前配置的项目并选择 打开
  4. 项目 窗口中
    1. 如有必要,编辑 运行设置
    2. 选择 运行

注意: 要更改应用程序,您只需再次运行它即可简单地在设备上更新。

有关将Qt项目部署到设备的详细信息,请参阅教程:使用Boot to Qt部署您的第一个项目

调试应用程序

有关使用Qt Creator调试应用程序的更多信息,请参阅调试

故障排除

如果您有任何与NVIDIA Jetson设备相关的问题(例如如何设置引导开关或连接调试终端),请参阅NVIDIA Jetson平台NVIDIA开发者论坛以获取更多信息。

有关对 Boot to Qt 进行故障排除的更多信息,请参阅 故障排除

适用于某些 Qt 许可证。
了解详细信息。