# 开始使用 Qualcomm IM SDK
本节介绍了如何使用 Qualcomm IM SDK 开始软件开发。
Tab Qualcomm Linux
Tab Ubuntu
- *class* tabincludedirectiv
- ## Qualcomm IM SDK 工作流
下图显示从搭建设备到开发第一个应用程序的 SDK 工作流。有关详细信息，请点击每个组件。
**图：Qualcomm IM SDK 工作流**
## 前提条件
- 确保您的开发套件包含最新版的 Qualcomm Linux 软件。
[验证 Qualcomm Linux 版本](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-251/set_up_the_device.html#verify-the-qualcomm-linux-version)，如果不是最新软件，则[更新软件](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-251/upgrade-rb3gen2-software.html)。
否则，请按照[搭建设备](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-251/set_up_the_device.html)中所述的步骤升级开发套件。
- 在开始 AI/ML 开发之前，请确保已将匹配的 SDK 下载到主机。
本指南中的示例应用程序和 AI 程序与[支持的组件版本](https://docs.qualcomm.com/doc/80-70022-51SC/topic/introduction.html#section-supported-component-versions)。
## 探索示例应用程序
您可以使用 Qdemo 应用程序探索示例应用程序，该应用程序是软件安装的一部分。您可以直接在目标设备上运行此基于 GUI 的应用程序，而无须设置主机。有关更多详细信息，请参阅[运行示例应用程序](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-253/run-sample-apps-qdemo.html)。
## 探索 eSDK 用法
运行 Qualcomm IM SDK 软件包中的[示例应用程序](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-50/example-applications.html)和 [GStreamer 命令行用例](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-50/gstreamer-application-use-cases.html)，以了解 eSDK 功能。
## 下载并安装 eSDK
Note
对于 Qualcomm Dragonwing^TM^ IQ-8275，目前没有可供下载的 eSDK。但是，如果您是有权访问 Dragonwing IQ-8275 软件的注册用户，您可以选择[创建自定义 eSDK](https://docs.qualcomm.com/doc/80-70022-51SC/topic/build-the-platfrom-esdk.html#build-the-platfrom-esdk)。
将开发套件升级到最新版的 Qualcomm Linux 软件后，下载相应的 eSDK。
此版本支持 Qualcomm Dragonwing^TM^ RB3 Gen 2 机器视觉开发套件、Qualcomm Dragonwing^TM^ RB3 Gen 2 核心开发套件和 Qualcomm Dragonwing^TM^ IQ-9075 评估套件 (EVK) 的单独 eSDK。您可以下载与您的特定开发套件对应的 eSDK。
**前提条件**
- 一台具有至少 100 GB 可用空间的 Ubuntu 22.04 主机。要在 Microsoft Windows 或 Apple^®^ Mac^®^ 上搭建运行 Ubuntu 22.04 操作系统的虚拟机，请参阅[搭建 Qualcomm Linux 虚拟机](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-41/vm-landing-page.html)。
- `sudo` 权限用于运行命令。
- 确保运行以下命令配置 Git 用户名和电子邮件：
git config --global user.name
Copy to clipboard
git config --global user.email
Copy to clipboard
- 确保主机上已安装[系统要求](https://docs.yoctoproject.org/scarthgap/ref-manual/system-requirements.html)的所有软件包。
**步骤**
1. 从 [Qualcomm 公共存档](https://artifacts.codelinaro.org/ui/native/qli-ci/flashable-binaries/qimpsdk/)下载 eSDK。
1. 创建目录：
mkdir
Copy to clipboard
2. 更改目录：
cd
Copy to clipboard
3. 下载压缩文件：
- 对于 Dragonwing RB3 Gen 2 机器视觉开发套件：
>
>
> - 基于 Ubuntu x86 架构的主机：
>
>
>
> >
> >
> > wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-vision-kit/x86-qcom-6.6.97-QLI.1.6-Ver.1.2.1_qim-product-sdk-esdk-2.1.1.zip
> > Copy to clipboard
> - 基于 Arm^®^ 架构的主机：
>
>
> wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-vision-kit/arm-qcom-6.6.97-QLI.1.6-Ver.1.2.1_qim-product-sdk-esdk-2.1.1.zip
> Copy to clipboard
- 对于 Dragonwing IQ-9075 EVK：
>
>
> - 基于 Ubuntu x86 架构的主机：
>
>
>
> >
> >
> > wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs9075-iq-9075-evk/x86-qcom-6.6.97-QLI.1.6-Ver.1.2.1_qim-product-sdk-esdk-2.1.1.zip
> > Copy to clipboard
> - 基于 Arm 架构的主机：
>
>
>
> >
> >
> > wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs9075-iq-9075-evk/arm-qcom-6.6.97-QLI.1.6-Ver.1.2.1_qim-product-sdk-esdk-2.1.1.zip
> > Copy to clipboard
4. 将 Qualcomm IM SDK 解压到您选择的目录：
unzip x86-qcom-6.6.97-QLI.1.6-Ver.1.2.1_qim-product-sdk-esdk-2.1.1.zip
Copy to clipboard
5. 确保 eSDK 安装程序位于 `/target/qcs6490-rb3gen2-vision-kit/sdk/` 以下屏幕截图仅作为示例提供；版本号可能与您安装的版本号不同。
6. 如果您没有在目录中安装 eSDK 所需的写入权限，安装程序会提醒您然后终止安装。确保在目录中设置所需的权限，然后重新运行安装程序。
umask a+rx
Copy to clipboard
2. 要安装 eSDK，请从 `/target/qcs6490-rb3gen2-vision-kit/sdk/` 运行安装脚本：
sh ./qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a--toolchain-ext-1.6-ver.1.2.1.sh
Copy to clipboard
例如：
sh ./qcom-wayland-x86\_64-qcom-multimedia-image-armv8-2a-qcs6490-rb3gen2-vision-kit-toolchain-ext-1.6-ver.1.2.1.sh
3. 如需在主机中安装 eSDK，请按照控制台上的说明操作。
- 控制台会提示您指定 eSDK 安装目录路径。如果接受默认路径，则 eSDK 将安装在用户目录下，如下图所示：
- 或者，如果您指定自定义路径，例如 `/local/mnt/workspace/Platform_eSDK_plus_QIM`，eSDK 将安装在该目录中。
Note
如果在 eSDK 安装过程中缺少 diffstat、gawk、gcc 和 g++ 等软件包，请安装[使用 GitHub 编译（未注册用户）](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-254/github_workflow_unregistered_users.html#build-with-standalone-commands)中提及的所有依赖项。
4. 要验证安装是否成功，请检查 Qualcomm IM SDK 层是否在 `/layers` 中可用。
Note
如果您想添加新软件或使用其他库和组件自定义 SDK，请参阅[创建用于应用程序开发的自定义 eSDK](https://docs.qualcomm.com/doc/80-70022-51SC/topic/build-the-platfrom-esdk.html#build-the-platfrom-esdk)。
5. 设置 `ESDK_ROOT` 变量。
export ESDK_ROOT=
Copy to clipboard
例如：
export ESDK\_ROOT=/local/mnt/workspace/Platform\_eSDK\_plus\_QIM
您已成功安装 Qualcomm IM SDK。现在，[使用 Qualcomm IM SDK 创建示例应用程序](https://docs.qualcomm.com/doc/80-70022-51SC/topic/content-develop-your-first-application.html#content-develop-your-first-application)。
## 后续步骤
- [Qualcomm IM SDK 概述](https://docs.qualcomm.com/doc/80-70022-51SC/topic/introduction.html#introduction)
- [编译多媒体应用程序](https://docs.qualcomm.com/doc/80-70022-51SC/topic/application-development.html#application-development)
- [运行示例应用程序](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-253/run-sample-apps-qdemo.html)
- [搭建虚拟机](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-41/vm-landing-page.html)
- [编译自定义 eSDK](https://docs.qualcomm.com/doc/80-70022-51SC/topic/build-the-platfrom-esdk.html#build-the-platfrom-esdk)
- [Qualcomm 公共存档](https://artifacts.codelinaro.org/ui/native/qli-ci/flashable-binaries/qimpsdk/)
- [系统要求](https://docs.yoctoproject.org/scarthgap/ref-manual/system-requirements.html)
- [使用 GitHub 编译（未注册用户）](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-254/github_workflow_unregistered_users.html#build-with-standalone-commands)
- [创建示例应用程序](https://docs.qualcomm.com/doc/80-70022-51SC/topic/content-develop-your-first-application.html#content-develop-your-first-application)
- *class* tabincludedirectiv
- ## Qualcomm IM SDK 工作流
下图显示从搭建设备到开发第一个应用程序的 SDK 工作流。
此 SDK 工作流目前仅在 [Ubuntu Server](https://ubuntu.com/server) 版本上受支持。在 [Ubuntu Desktop](https://ubuntu.com/desktop) 版本上不可用。
Ubuntu Server 版本在没有图形用户界面的情况下运行；所有交互都通过命令行界面执行，通常通过 SSH 访问。SDK 中包含的示例应用程序使用 Wayland 来渲染和显示内容。
**图：Qualcomm IM SDK 工作流**
## 前提条件
- 确保您的开发套件拥有最新版本的兼容 [Ubuntu Server 镜像](https://people.canonical.com/~platform/images/qualcomm-iot/ubuntu-24.04/ubuntu-24.04-x04/ubuntu-server-24.04/)。
否则，请按照[将软件镜像刷写到设备](https://docs.qualcomm.com/bundle/publicresource/topics/80-90441-1/Integrate_and_flash_software_2.html)中所述的步骤升级开发套件。
- 在开始 AI/ML 开发之前，请确保已将匹配的 SDK 下载到主机。
本指南中的示例应用程序和 AI 程序与[支持的组件版本](https://docs.qualcomm.com/doc/80-70022-51SC/topic/introduction.html#supported-component-versions-ubuntu) 兼容。
## 搭建环境
1. 按照[验证重启并登录 RB3 Gen 2 Ubuntu 控制台](https://docs.qualcomm.com/bundle/publicresource/topics/80-90441-1/Use_Ubuntu_on_RB3_Gen2_3.html#verify-reboot-and-sign-in-to-the-rb3-gen-2-ubuntu-console)中提供的步骤重启设备并登录串行控制台。
连接后，可通过配置的 IP 地址访问设备。
2. 通过 SSH shell 连接到设备：
ssh ubuntu@
Copy to clipboard
Note
刷写后首次启动设备时，输入 `ubuntu` 作为 SSH 密码。
3. 运行以下命令安装 GStreamer 工具、QIM SDK 以及原生 (C/C++) 和 Python 示例应用程序：
sudo su
Copy to clipboard
sudo apt-add-repository ppa:ubuntu-qcom-iot/qcom-ppa
Copy to clipboard
apt update
Copy to clipboard
apt install gstreamer1.0-tools
Copy to clipboard
apt install tensorflow-lite-qcom-apps
Copy to clipboard
apt install gstreamer1.0-qcom-sample-apps
Copy to clipboard
apt install gstreamer1.0-qcom-python-examples
Copy to clipboard
apt install weston-autostart
Copy to clipboard
QIM SDK 和示例应用程序的安装现已完成。
## 探索示例应用程序
Qualcomm IM SDK 示例应用程序展示了如何使用 SDK 以及如何开发端到端的边缘分析用例。有关 Ubuntu 示例应用程序的更多信息，请参阅[示例应用程序](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-50/example-applications.html)
## 后续步骤
- [探索并运行示例应用程序](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-50/example-applications.html)
Last Published: Dec 22, 2025
[Previous Topic
Qualcomm IM SDK 概述](https://docs.qualcomm.com/bundle/publicresource/80-70022-51SC/topics/introduction.md) [Next Topic
使用 Qualcomm IM SDK 编译多媒体应用程序](https://docs.qualcomm.com/bundle/publicresource/80-70022-51SC/topics/application-development.md)