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

C

STM32MP1 快速入门指南

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

本指南描述了如何使用 Qt 工具的 GUI 在 STM32MP157F-DK2 或 STM32MP157F-EV1 上开发 Linux 应用程序。它描述了整个过程概述，并为以下任务提供逐步说明

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

概述

以下插图说明了使用 Qt 工具和 Boot to Qt 软件堆栈时的软件开发过程的基本概念。

  • 开发主机 是运行在 Windows、Linux 或 macOS 上的 Qt 工具的开发计算机。
  • Qt 工具 包括 Qt Creator 和 Qt Design Studio 这样的开发工具，以及 Squish 这样的质量保证 (QA) 工具。
  • QBSP SDK 包含一个集成到 Qt Creator 中的交叉编译工具链，以及可以用于使用 Boot to Qt 软件堆栈引导设备的镜像。
  • 目标设备 是您的开发目标，它运行您的嵌入式 Linux 应用程序。
  • 上传和调试应用程序（通过以太网、Wi-Fi 或 USB）。使用 Qt Creator 在目标设备上上传和调试您的应用程序。
  • 擦写 QBSP 镜像 代表了在目标设备上安装 Linux 的各种方式（例如 SD 卡）。

适用的 STM32MP1 目标设备

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

  • STM32MP157F-DK2（探索套件）
  • STM32MP157F-EV1（评估板）

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

安装 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软件栈

要为STM32MP157F-DK2（探索套件）安装Boot to Qt软件栈，请按照以下步骤操作

  1. 打开Qt维护工具。
  2. 继续到选择组件，并打开顶层Boot to Qt软件栈下拉菜单。
  3. 打开针对正确的Qt版本特定的Boot to Qt软件栈下拉菜单。
  4. 选择STM32MP15探索。
  5. 继续到准备安装并选择安装。

注意：您也可以自行开发所需的QBSP文件。有关详细信息，请参阅如何创建Boot to Qt镜像。

在目标设备上安装Boot to Qt

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

将Boot to Qt镜像烧录到microSD卡

Boot to Qt镜像包含STM32MP1设备所需的Boot to Qt软件栈。按照以下步骤将镜像烧录到microSD卡

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

将镜像烧录到microSD卡后，将卡插入您的目标硬件并开启您的设备。

STM32MP1设备默认以Boot to Qt演示启动器应用程序启动。如果您想检查设备的IP地址，请通过Boot to Qt演示启动器开始使用Boot to Qt。如果设备连接到以太网或WiFi网络，或者通过USB OTG连接到宿主机，则会显示IP地址。

注意：如果您的目标硬件没有启动，请检查是否已将micoSD卡定义为启动模式。

设置设备

Boot to Qt设备可以通过USB、以太网或WiFi连接。下面的章节将提供使用USB、以太网或WiFi连接设置设备的说明。

通过USB设置设备

目标设备可以通过USB On-the-Go (OTG)连接到宿主机。一旦通过USB网络连接，设备会自动添加到Qt Creator中的设备。

目标设备的USB访问支持两种不同的USB协议。默认的RNDIS协议在连接目标设备到Linux或Windows宿主机时可以使用。当您想要将目标设备连接到macOS宿主机时，您需要切换到CDC-ECM协议。

注意：您可以从Get Started with Boot to Qt中更改协议。

有关通过USB连接设备的更多信息，请参阅在目标设备上设置USB和以太网。

通过以太网或WiFi设置设备

目标设备可以通过以太网或Wi-Fi连接到网络。目标设备连接并获得IP地址后，您可以按照以下步骤将其设置到Qt Creator中

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

注意：您还可以从“启动至Qt”开始设置Wi-Fi连接

注意：Qt Creator通过IP网络上传应用程序，因此STM32MP1设备必须与您的开发主机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. 选择您的STM32MP15套件。
    2. 选择 配置项目。

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

在设备上运行应用程序

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

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

注意：要更改您的应用程序，您只需再次运行它即可在设备上更新它。

调试应用程序

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

使用QBSP的STM32MP1设备

您可以使用Qt维护工具为STM32MP1设备安装最新的Qt和QBSP发布版。

注意：您还可以从您的Qt帐户页面下载QBSP。

有关如何从源代码中自定义和构建QBSP的详细信息，请参见 如何自定义启动至Qt镜像。

有关如何为新的硬件添加QBSP支持的更多信息，请参阅 如何添加对新设备的支持。

故障排除

如果您在使用STM32MP1设备时遇到任何问题，例如如何设置启动开关或连接调试终端，请参阅ST社区获取更多信息。

有关故障排除引导到Qt的更多信息，请参阅故障排除。

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

在特定的Qt许可证下提供。
了解详情。