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

# 通过 Qdemo UI 体验 AI 应用

> 使用 Qdemo 在 Qualcomm Dragonwing IOT 平台上运行 AI 用例

Qualcomm Dragonwing™ 平台预装了 Qdemo,这是一个旨在运行 AI 用例的图形用户界面(GUI)应用。使用 Qdemo 应用探索开发套件的 AI 能力。

下表列出了可以使用 Qdemo 运行的 AI 示例应用。

**Qdemo 支持的示例应用**

| 应用 | 描述 |
| - | - |
| Daisychain Pose | 对来自摄像头的流执行级联的目标检测和姿态检测。 |
| FaceDetection | 处理来自摄像头的输入,并使用 Qualcomm® AI Hub 检测模型进行人脸检测 |
| Multistream | 在来自摄像头或文件的输入流上展示 AI 推理(目标检测)。 |
| ObjectDetection | 对来自摄像头的流执行目标检测。 |
| Parallel-AI-Fusion | 对来自摄像头的输入流执行目标检测、图像分类、姿态检测和图像分割。 |
| DashCamera | 并排显示两个同步的摄像头画面。 |
| Record live video | 从摄像头源录制实时视频,同时显示该视频流并将其保存为 H.264 编码的 MP4 文件(video\_out.mp4)。 |
| VideoTestSrc | 使用 videotestsrc 渲染 GStreamer 测试图案,适用于在没有物理摄像头的情况下验证显示管线。 |
| VideoWall | 以 2×2 平铺网格播放之前使用 Record live video 应用录制的 MP4 文件,实现四画面视频墙显示。 |

有关可用应用的完整列表,请参阅 [Qualcomm IM SDK 示例应用](https://imsdkdocs.qualcomm.com/sample-application/ai-sample-applications)。

<Note>
  `IQ-2390` 和 `CQ-2390` 不支持 `Qdemo` 应用程序。
</Note>

## 前提条件

* **Qualcomm Linux 多媒体镜像**:设备必须刷写预构建的 Qualcomm Linux 多媒体专有镜像(`qcom-multimedia-proprietary-image`),其中包含 Qdemo 和 Qualcomm IM SDK。
* **HDMI 显示器**:连接到设备以查看 Qdemo 输出。
* **鼠标和键盘**:与 Weston 桌面和 Qdemo 应用交互所必需。
* **USB 摄像头(可选)**:基于摄像头的示例应用所必需。如果已连接,请在 Qdemo 的 `Source` 列表中选择它。
* **设置调试 UART**:
  调试 UART 提供对设备的串行控制台访问,使您可以在刷写后登录并验证设备。
  <Note>
    请按照您所用特定设备的 EVK 指南中的调试 UART 设置说明进行操作。例如,请参阅[为 Qualcomm Dragonwing IQ9 设置调试 UART](https://dragonwingdocs.qualcomm.com/Linux/devices/iq9075-evk/set-up-the-device#set-up-the-debug-uart)。
  </Note>
* **连接到 Wi-Fi**:
  AI 示例应用需要 Wi-Fi 连接才能从 GitHub 下载模型和标签。多媒体应用不需要 Wi-Fi。
  <Note>
    请按照您所用特定设备的 EVK 指南中的 Wi-Fi 连接说明进行操作。例如,请参阅[为 Qualcomm Dragonwing IQ9 连接到 Wi-Fi](https://dragonwingdocs.qualcomm.com/Linux/devices/iq9075-evk/set-up-the-device#wi-fi)。
  </Note>
* **验证 GStreamer 安装**:
  点击屏幕上的 `terminal` 图标，启动 `weston terminal`:
  <Frame>
    <img src="https://mintcdn.com/qualcomm-staging/GtnvR5ePww_XRImh/Key-Documents/AI-Developer-Workflow/_images/device-terminal.png?fit=max&auto=format&n=GtnvR5ePww_XRImh&q=85&s=ef973556a4ab7ba02a5a1c5ff1c54021" alt="Qdemo weston terminal" width="384" height="362" data-path="Key-Documents/AI-Developer-Workflow/_images/device-terminal.png" />
  </Frame>
  启动 `weston terminal` 后，运行以下命令验证 GStreamer 安装:
  ```shell theme={null}
  gst-launch-1.0 --version
  ```
* **启用摄像头**:
  要使用基于摄像头的应用,请从主机通过 SSH 登录到目标设备:
  ```shell theme={null}
  ssh root@<IP address of the target device>
  ```
  然后在目标设备上运行以下命令以启用 `qticamsrc`:
  ```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 运行示例应用

<Steps>
  <Step title="连接外设并为设备开机">
    将鼠标、键盘和 HDMI 显示器连接到设备,然后开机。

    设备开机后,显示器上会出现以下屏幕。

    <img src="https://mintcdn.com/qualcomm-staging/1jJHcYa3k8uGjf_G/Key-Documents/AI-Developer-Workflow/_images/startup-screen.png?fit=max&auto=format&n=1jJHcYa3k8uGjf_G&q=85&s=f65d488eb2b9439b81a048ad62fb3f4b" alt="显示器上的 Qdemo 启动屏幕" width="999" height="517" data-path="Key-Documents/AI-Developer-Workflow/_images/startup-screen.png" />
  </Step>

  <Step title="启动 Qdemo 应用">
    点击屏幕上的 `Q` 图标运行 Qdemo 应用。

    <img className="mx-auto" src="https://mintcdn.com/qualcomm-staging/1jJHcYa3k8uGjf_G/Key-Documents/AI-Developer-Workflow/_images/qdemo-icon.png?fit=max&auto=format&n=1jJHcYa3k8uGjf_G&q=85&s=5143401d21ceb87f258cb6f37c35bdc9" alt="显示器上的 Qdemo 图标" width="221" height="221" data-path="Key-Documents/AI-Developer-Workflow/_images/qdemo-icon.png" />

    将显示 **Experience Application Demo** 窗口。

    <img src="https://mintcdn.com/qualcomm-staging/ilIq3aTznuppmk3c/Key-Documents/AI-Developer-Workflow/_images/qdemo-pop-up.jpg?fit=max&auto=format&n=ilIq3aTznuppmk3c&q=85&s=1ce19d7241c5ceec04043ce3e3f23792" alt="显示器上的 Qdemo 启动界面" width="1345" height="972" data-path="Key-Documents/AI-Developer-Workflow/_images/qdemo-pop-up.jpg" />

    <Note>
      `Wi-Fi` 连接已完成。
    </Note>
  </Step>

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

    如果将 USB 摄像头连接到设备,请使用 **Source** 列表选择该 USB 摄像头。默认选择 **On-Device-Camera**。
  </Step>

  <Step title="启动应用">
    在 **Applications** 列表中,选择一个应用并点击 **Start**。

    所选应用开始运行,并在屏幕上弹出窗口显示输出。

    <Note>
      首次运行时,应用可能需要一分多钟才能启动,因为它要从 GitHub 下载 AI 模型和标签。
    </Note>

    下图显示了 Object Detection 应用的示例输出,识别出了两个对象,包括一个人和一只狗:

    <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/AI-Developer-Workflow/_images/rb3-sample-output-object-detection_app.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=a851e02ca7f639706314fa6dc72a95b5" alt="Qdemo 中 ObjectDetection 应用的示例输出" width="975" height="548" data-path="Key-Documents/AI-Developer-Workflow/_images/rb3-sample-output-object-detection_app.png" />
  </Step>

  <Step title="停止示例应用">
    关闭输出窗口以停止示例应用。
  </Step>

  <Step title="退出 Qdemo">
    选择 **Exit** 以关闭 Qdemo 应用。
  </Step>
</Steps>
