> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用 QDemo 应用程序运行

> 使用预装的 Qdemo GUI 在 Qualcomm Dragonwing IQ-9075 评估套件上运行示例应用程序。

<Note>
  目前，Qdemo 应用程序不支持通过 GUI 启动器图标启动。请使用设备终端启动 Qdemo 应用程序。
</Note>

Qualcomm<sup>®</sup> Dragonwing<sup>TM</sup> IQ-9075 评估套件（EVK）预装了 Qdemo，这是一款图形用户界面（GUI）应用程序，可在无需主机设置的情况下运行示例应用程序。通过 Qdemo 应用程序，只需点击几下即可体验开发套件的 AI 和多媒体能力。

Qualcomm Linux<sup>®</sup> 为零售、Qualcomm Edge AI Box 解决方案和 IP 摄像头等使用场景提供以下类型的示例应用程序：

* **多媒体示例应用程序**，展示摄像头、视频和音频功能。
* **AI 示例应用程序**，展示 AI 和机器学习（ML）能力。

下表列出了可使用 Qdemo 运行的示例应用程序。有关可用应用程序的完整列表，请参阅[示例应用程序](https://imsdkdocs.qualcomm.com/sample-application/ai-sample-applications)。

**表：Qdemo 支持的应用程序列表**

| 应用程序               | 说明                                                                              |
| ------------------ | ------------------------------------------------------------------------------- |
| **多媒体应用程序**        |                                                                                 |
| DashCamera         | 同时从两个摄像头传感器进行流式传输，并将画面并排显示在屏幕上。此应用程序适用于行车记录仪或立体摄像头使用场景，这些场景需要从多个摄像头捕获视频以供查看或存档。 |
| Record live video  | 录制摄像头画面并保存最长 30 秒的视频。此应用程序使用支持预览和编码等输出的单个摄像头。                                   |
| VideoWall          | 并发播放 MP4 AVC（H.264）视频并将其合成显示在视频墙上。在运行此应用程序之前，请确保您已有录制的视频，或使用评估套件录制一段视频。         |
| **AI 应用程序**        |                                                                                 |
| Daisychain Pose    | 对来自摄像头的图像流执行级联的目标检测和分类。                                                         |
| FaceDetection      | 处理来自摄像头的输入，并使用 Qualcomm<sup>®</sup> AI Hub 检测模型生成预览。                            |
| Multistream        | 展示对来自摄像头或文件的输入流进行 AI 推理（目标检测）。                                                  |
| ObjectDetection    | 检测摄像头流中的目标。                                                                     |
| Parallel-AI-Fusion | 对来自摄像头输入流的图像进行目标检测和分类、姿态检测以及图像分割。                                               |

## 前提条件

* **Qualcomm Linux 多媒体镜像**：设备必须刷入预构建的 Qualcomm Linux 多媒体镜像（`qcom-multimedia-proprietary-image`），其中包含 Qdemo 和 Qualcomm IM SDK。
* **HDMI 显示器**：连接到设备以查看 Qdemo 输出。
* **鼠标和键盘**：用于与 Weston 桌面和 Qdemo 应用程序交互。
* **Wi-Fi 连接**：AI 示例应用程序需要从 GitHub 下载模型和标签时使用。多媒体应用程序不需要。
* **USB 摄像头（可选）**：基于摄像头的示例应用程序需要。如已连接，请在 Qdemo 的 `Source` 列表中选择它。
  要使用摄像头，请在目标设备上运行以下命令以启用 `camx`：
  ```shell theme={null}
  echo -n "camx" > /var/data
  efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -w -f /var/data
  efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -p
  sync
  reboot
  ```

## 使用 Qdemo 运行示例应用程序

要使用 Qdemo 运行示例应用程序，请执行以下操作：

<Steps>
  <Step title="将外设连接到设备">
    将鼠标、键盘、摄像头、显示器和电源线连接到设备。

    下图显示了显示端口、USB 端口、以太网端口、电源端口和电源开关。将外设设备连接到这些端口，包括 USB 或 MIPI 摄像头。对于显示，将 Mini DisplayPort 线缆的一端连接到 Dragonwing IQ-9075 设备上的 **DisplayPort0**，另一端连接到您的显示器。

    <Note>
      要通过 HDMI 将 EVK 连接到显示器，请使用 HDMI 线缆和适配器，然后将其连接到 EVK 上处于活动状态的 DisplayPort。HDMI 线缆和适配器不随 EVK 提供。
    </Note>

    <Frame>
      <img src="https://mintcdn.com/qualcomm-prod/jy6NQT2Y7J_sAxdX/Linux/images/run-sample-applications/iq9-backview-ports.png?fit=max&auto=format&n=jy6NQT2Y7J_sAxdX&q=85&s=f8f81b1e2658916668c52f60f460cedf" alt="IQ-9075 背面视图，显示各端口" width="699" height="640" data-path="Linux/images/run-sample-applications/iq9-backview-ports.png" />
    </Frame>
  </Step>

  <Step title="为设备上电">
    将电源开关拨到 On 位置。

    设备上电后，显示器上会出现以下屏幕。

    <Frame>
      <img src="https://mintcdn.com/qualcomm-prod/7Y3XfFKj8dDIYFn3/Linux/images/run-sample-applications/startup-screen.png?fit=max&auto=format&n=7Y3XfFKj8dDIYFn3&q=85&s=3147d67a4ca29748e3db6bb8b737f1ee" alt="IQ-9075 启动屏幕" width="999" height="517" data-path="Linux/images/run-sample-applications/startup-screen.png" />
    </Frame>
  </Step>

  <Step title="打开设备 shell">
    通过选择 weston-terminal 图标打开设备 shell。

    下图显示了屏幕上的 weston-terminal 图标。

    <Frame>
      <img src="https://mintcdn.com/qualcomm-prod/7Y3XfFKj8dDIYFn3/Linux/images/run-sample-applications/device-terminal.png?fit=max&auto=format&n=7Y3XfFKj8dDIYFn3&q=85&s=d20b24e7fa88cef8e1a1c22ee2d9fd5c" alt="屏幕上的 Qdemo Q 图标" width="384" height="362" data-path="Linux/images/run-sample-applications/device-terminal.png" />
    </Frame>
  </Step>

  <Step title="以 root 用户登录">
    运行以下命令以 root 用户登录：

    ```bash theme={null}
    su -p
    ```

    当提示输入密码时，输入 `oelinux123`。
  </Step>

  <Step title="启动 Qdemo 应用程序">
    在 weston-terminal 中运行以下命令启动 Qdemo 应用程序：

    ```bash theme={null}
    gst-gui-launcher-app.py
    ```

    此时会出现 **Experience Application Demo** 窗口。
  </Step>

  <Step title="运行示例应用程序">
    在 **Experience Application Demo** 窗口中按如下方式运行示例应用程序：

    <Steps>
      <Step title="连接 Wi-Fi">
        通过选择 **Wi-Fi** 连接到 Wi-Fi 网络。

        <Note>
          仅运行 AI 示例应用程序时需要 Wi-Fi 连接。如果您要运行多媒体应用程序，请跳过此步骤。
        </Note>

        下图展示了 **Experience Application Demo** 窗口的示例：

        <Frame>
          <img src="https://mintcdn.com/qualcomm-prod/7Y3XfFKj8dDIYFn3/Linux/images/run-sample-applications/qdemo-wi-fi.png?fit=max&auto=format&n=7Y3XfFKj8dDIYFn3&q=85&s=1d1acb8277784c65a47847a54d73584e" alt="带有 Wi-Fi 选项的 Experience Application Demo 窗口" width="384" height="362" data-path="Linux/images/run-sample-applications/qdemo-wi-fi.png" />
        </Frame>
      </Step>

      <Step title="选择摄像头来源">
        在 **Source** 下拉列表中，选择所需的摄像头。

        Dragonwing IQ-9075 设备没有内置摄像头，并且并非所有应用程序都需要摄像头。如果您已将外部摄像头连接到设备，请在 **Source** 下拉列表中选择它。默认选择 **On-Device-Camera** 选项。
      </Step>

      <Step title="选择并启动应用程序">
        在 **Applications** 下拉列表中，选择一个应用程序并选择 **Start**。

        所选应用程序开始运行，并会弹出一个窗口在屏幕上显示输出。

        首次运行示例应用程序时，由于设备需要从 GitHub 下载 AI 模型和标签，可能需要一分钟或更长时间才能运行。

        下图展示了 Object Detection 应用程序的示例输出，识别出包括一个人和一只狗在内的两个目标。

        <Frame>
          <img src="https://mintcdn.com/qualcomm-prod/jy6NQT2Y7J_sAxdX/Linux/images/run-sample-applications/sample-output-object-detection-app.png?fit=max&auto=format&n=jy6NQT2Y7J_sAxdX&q=85&s=971426d5e62e6b3c26d4afc2367ce4b2" alt="Object Detection 应用程序的示例输出" width="975" height="548" data-path="Linux/images/run-sample-applications/sample-output-object-detection-app.png" />
        </Frame>
      </Step>

      <Step title="停止应用程序">
        通过关闭输出窗口来停止示例应用程序。
      </Step>
    </Steps>
  </Step>

  <Step title="关闭 Qdemo">
    通过选择 **Exit** 关闭 Qdemo 应用程序。
  </Step>
</Steps>
