> ## 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 应用程序运行
> 使用预装的 Qdemo GUI 在 Qualcomm Dragonwing IQ-8275 评估套件上运行示例应用程序。
目前，Qdemo 应用程序不支持通过 GUI 启动器图标启动。请使用设备终端启动 Qdemo 应用程序。
Qualcomm® DragonwingTM IQ-8275 评估套件（EVK）预装了 Qdemo，这是一款图形用户界面（GUI）应用程序，无需主机设置即可运行示例应用程序。通过 Qdemo 应用程序，您只需点击几下即可体验开发套件的 AI 和多媒体功能。
Qualcomm Linux® 为零售、Qualcomm Edge AI Box Solutions 和 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® 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
```
**已知问题：** 由于已知问题，IQ-8275 上的摄像头基本用例无法正常工作。要解决此问题，请在运行摄像头用例之前运行以下命令：
```shell theme={null}
cp /usr/share/qcom/sa8775p/Qualcomm/SA8775P-RIDE/dsp/cdsp/libbitml_nsp_73nb_skel.so /usr/share/qcom/qcs8300/Qualcomm/IQ8275-EVK/dsp/cdsp/.
```
## 使用 Qdemo 运行示例应用程序
要使用 Qdemo 运行示例应用程序，请执行以下操作：
将鼠标、键盘、摄像头、显示器和电源线连接到设备。
下图显示了显示端口、USB 端口、以太网端口、电源端口和电源开关。将外设设备连接到这些端口，包括 USB 或 MIPI 摄像头。对于显示，将 Mini DisplayPort 线缆的一端连接到 Dragonwing IQ-8275 设备上的 **DisplayPort0**，另一端连接到您的显示器。
要通过 HDMI 将 EVK 连接到显示器，请使用 HDMI 线缆和适配器，然后将其连接到 EVK 上的可用 DisplayPort。HDMI 线缆和适配器不随 EVK 提供。
将电源开关拨到 On 位置。
设备通电后，显示器上会出现以下屏幕。
通过选择 weston-terminal 图标打开设备 shell。
下图显示了屏幕上的 weston-terminal 图标。
运行以下命令以 root 用户身份登录：
```bash theme={null}
su -p
```
当提示输入密码时，输入 `oelinux123`。
在 weston-terminal 中运行以下命令启动 Qdemo 应用程序：
```bash theme={null}
gst-gui-launcher-app.py
```
此时会出现 **Experience Application Demo** 窗口。
在 **Experience Application Demo** 窗口中按如下方式运行示例应用程序：
通过选择 **Wi-Fi** 连接到 Wi-Fi 网络。
仅运行 AI 示例应用程序需要 Wi-Fi 连接。如果您要运行多媒体应用程序，请跳过此步骤。
下图显示了 **Experience Application Demo** 窗口的示例：
在 **Source** 下拉列表中，选择所需的摄像头。
Dragonwing IQ-8275 设备没有内置摄像头，并且并非所有应用程序都需要摄像头。如果您已将外部摄像头连接到设备，请在 **Source** 下拉列表中选择它。默认情况下，选中 **On-Device-Camera** 选项。
在 **Applications** 下拉列表中，选择一个应用程序并选择 **Start**。
所选应用程序开始运行，屏幕上会出现一个弹出窗口显示输出。
首次运行示例应用程序时，由于设备需要从 GitHub 下载 AI 模型和标签，运行可能需要一分钟或更长时间。
下图显示了 Object Detection 应用程序的示例输出，识别出两个物体，包括一个人和一只狗。
通过关闭输出窗口来停止示例应用程序。
通过选择 **Exit** 关闭 Qdemo 应用程序。