支持的目标设备和开发主机 教程：使用启动到 Qt 部署您的第一个项目

C

托拉得斯快速入门指南

Qt 提供了所有必需的工具来设计、开发、构建和部署您的应用程序到目标。

本指南描述了如何使用 Qt 工具的 GUI 来在 Toradex 设备上开发 Linux 应用程序。它描述了总体过程，并提供以下任务的逐步说明

  • 使用 Qt 设计工作室 设计简单的用户界面。
  • 在 Qt Creator 中创建一个项目，并利用 Toradex 设备的准备好的启动到 Qt 系统镜像。
  • 在目标硬件上构建和调试项目。

注意：Qt for Device Creation 需要许可证。如果您没有许可证，您可以请求一个 免费试用。

概述

以下图示说明了您使用 Qt 工具和启动到 Qt 软件栈时的软件开发基本概念。

  • 开发主机 是在 Windows、Linux 或 macOS 上运行 Qt 工具的开发计算机。
  • Qt 工具 包括 Qt Creator 和 Qt 设计工作室等开发工具，以及 Squish 等质量保证 (QA) 工具。
  • QBSP SDK 包含一个跨编译工具链，该工具链集成到 Qt Creator 中，以及可以用于使用启动到 Qt 软件栈启动设备的设备镜像。
  • 目标设备 是运行您的嵌入式 Linux 应用程序的开发目标。
  • 上传和调试应用程序（通过以太网、Wi-Fi 或 USB）。使用 Qt Creator 将您的应用程序上传到目标设备并对其进行调试。
  • 闪存 QBSP 镜像 表示安装 Linux 到目标设备的方法（例如 SD 卡）。

适用的 Toradex 目标设备

本指南中的说明适用于以下 Toradex 目标设备

  • 托拉得斯 Apalis iMX6
  • 托拉得斯 Apalis iMX8
  • 托拉得斯 Colibri iMX6 ULL

注意：有关支持的目标设备和开发主机的更多详细信息，请参阅 支持的目标设备和开发主机。

安装 Qt

按照本指南中的程序，获取所有必需的资源，包括 Qt Creator 和 Qt 设计工作室。

  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软件堆栈

要为Toradex Apalis iMX6安装Boot to Qt软件堆栈，请按照以下操作执行

  1. 打开Qt维护工具。
  2. 继续到选择组件并打开顶级的Boot to Qt软件堆栈下拉菜单。
  3. 选择Toradex Apalis iMX6。
  4. 继续到准备安装并选择更新。

在目标设备上安装Boot to Qt

在您可以在目标设备上测试Qt应用之前，您必须将带有Boot to Qt软件堆栈的镜像烧录到目标设备中。在成功烧录设备后，当您开机时，Boot to Qt演示启动器将出现在屏幕上。

您可以使用Toradex Easy Installer或从Qt Creator的烧录向导来烧录镜像。

使用Toradex Easy Installer，镜像首先被烧录到SD卡或U盘上，然后转移到设备的内部eMMC闪存中。

使用烧录向导，您可以将SD卡烧录用于启动设备，或者您可以使用USB连接直接烧录镜像到设备的内部eMMC闪存。烧录向导不会更新设备的启动加载程序（U-Boot），如果您启动设备时遇到问题，您可能需要使用Easy Installer来更新启动加载程序。

使用Toradex Easy Installer烧录

当Toradex Easy Installer连接到互联网时，它会自动在其镜像列表中提供Boot to Qt镜像。然而，此镜像不一定与您的Boot to Qt安装兼容。当您使用Toradex Easy Installer烧录时，您必须使用包含在Boot to Qt安装中的*.tezi.tar包。

按照以下步骤使用Toradex Easy Installer烧录Boot to Qt镜像

  1. 如果您的目标设备没有预安装的Toradex Easy Installer，请按照加载Toradex Easy Installer中的说明加载Toradex Easy Installer。
  2. 您的Boot to Qt安装包含在<Qt安装目录>//Boot2Qt/<目标>/images下的*.tezi.tar包。将此包提取到SD卡或USB闪存驱动器上。
  3. 使用Toradex Easy Installer从SD卡或USB闪存驱动器烧录镜像。请参阅使用Toradex Easy Installer安装镜像。

使用Qt的烧录向导烧录

按照以下步骤使用烧录向导将Boot to Qt镜像烧录到SD卡

注意： 请确保SD卡大小至少为8 GB。

  1. 将microSD卡插入您的宿主机PC。
  2. 打开Qt Creator。
  3. 选择工具>烧录Boot to Qt设备。
  4. 选择下一步。

还可以直接将 Boot to Qt 图像闪烁到设备的内部 eMMC 闪存。

  1. 使用 RS-232 或 USB 线缆访问目标设备上的串行终端。
  2. 打开您的设备，并按任意键停止自动启动。
  3. 为了通过 USB 使 eMMC 可用，在 U-Boot 中运行以下命令
    ums 0 mmc 0
  4. 使用 USB OTG（即插即用）将设备连接到开发主机。
  5. 使用闪烁向导将映像闪烁到设备上
    • 启动 Qt Creator。
    • 选择 工具 > 将 Boot 和 Qt 闪烁到设备，并按照闪烁向导中的说明操作。
  6. 在 U-Boot 控制台中按 Ctrl+C 并运行 reset 命令。

设置设备

Boot to Qt 设备可以通过 USB、以太网或 Wi-Fi 连接。下面的部分提供了如何使用 USB、以太网或 Wi-Fi 连接设置设备的说明。

通过 USB 设置设备

目标设备可以通过 USB OTG（即插即用）连接到主机。一旦通过 USB 网络连接，设备将自动添加到 Qt Creator 中的 设备。

对目标设备的 USB 访问支持两种不同的 USB 协议。当将目标设备连接到 Linux 或 Windows 主机时，可以使用默认的 RNDIS 协议。当您想将目标设备连接到 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. 输入 设备地址（Toradex 设备的 IP 地址）。
    3. 选择 完成。
  5. 在 设备 选项卡上
    • 选择 确定。

注意：您也可以从 Boot to Qt 入门说明中设置 Wi-Fi 连接

注意：Qt Creator 通过 IP 网络上传应用程序，因此 Toradex 设备必须与您的开发主机 PC 在同一个网络中。

在 Qt 设计工作室中创建应用程序 UI

您可以使用 Qt 设计工作室创建跨平台用户界面，也可以用于嵌入式 Linux 应用程序。

  1. 打开 Qt 设计工作室。
  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. 在 配置项目 窗口中
    • 选择您的Toradex套件。
    • 选择 配置项目。

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

在设备上运行应用程序

设置好您的设备后，您可以在Toradex Apalis iMX6设备上上传并启动您的应用程序。

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

注意：要更改您的应用程序，可以通过再次运行它在设备上简单更新它。

有关如何使用Boot to Qt将Qt项目部署到设备的更多信息，请参阅教程：使用Boot to Qt部署您的第一个项目。

调试应用程序

有关如何使用Qt Creator调试应用程序的更多信息，请参阅调试。

故障排除

如果您遇到任何Toradex设备问题，例如如何设置启动开关或连接调试终端，请访问Toradex开发者中心获取更多信息。

有关Boot to Qt的故障排除的更多信息，请参阅故障排除。

支持的目标设备和开发主机 教程：使用Boot to Qt部署您的第一个项目

在特定Qt许可下提供。
了解更多信息。