# 使用 QSC CLI 编译

使用 Qualcomm^®^ Software Center 命令行界面 (QSC-CLI) 下载和编译 QIR SDK。然后，使用各种工具或命令刷写镜像。

**前提条件**

- 确保您已按照[安装 QSC-CLI](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-254/build_frm_source_qsc_cli.html#install-qsc-cli) 中的说明安装 QSC CLI。
- QSC CLI 需要 Docker。如果尚未安装 Docker，请在主机上安装。

Note

不建议在 Mac UTM 环境中使用 QSC Launcher 或 QSC-CLI 编译 QIR SDK。使用此方法可能需要在出现错误时多次手动重试。

## 下载

要下载 QIR SDK 软件发行版，请按照以下步骤操作：

**步骤**

1. 登录 `qpm-cli`。

    1. 使用以下命令登录。

qpm-cli --login
            Copy to clipboard
    2. 验证 `qpm-cli` 登录是否成功。

qpm-cli --product-list
            Copy to clipboard

2. 使用以下命令下载 QIR SDK 的特定软件版本。要确定命令参数的适当值，请参阅下表。

qsc-cli download --workspace-path '<absolute_workspace_path>' --product '<Product_ID>' --release '<Release_ID>' --distribution '<Distro>'
        Copy to clipboard

Note

`--release` 和 `--build` 选项都可以单独使用来下载软件包。如果同时提供两个选项，则将使用 `--release` 参数启动下载。

表： qsc-cli download 参数

    | 参数 | 说明 | QSC-CLI 命令 |
    | --- | --- | --- |
    | `--workspace-path` | 绝对/完整工作区路径 | 自定义值 |
    | `--product` | 产品 ID | 容许的产品 ID<br><br><br><br>> <br>> <br>> QCM6490.LE.1.0<br>>         Copy to clipboard<br>> <br>> <br>> QCS9100.LE.1.0<br>>         Copy to clipboard<br>> <br>> <br>> QCS8300.LE.1.0<br>>         Copy to clipboard |
    | `--release` | 发行版本 ID | <ul><br><li><p>QCM6490.LE.1.0</p><br><p>请参阅 <a href="https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-260" rel="noopener noreferrer" target="_blank" class="xref cursorpointer" onclick="Window.BookmapComponent.navigateExternalFile('https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-260')">Qualcomm Intelligent Robotics SDK (QIR SDK) 2.0 发布说明</a>。例如，<code class="docutils literal notranslate"><span class="pre">r00376.1</span></code>。</p><br></li><br><li><p>QCS9100.LE.1.0</p><br><p>请参阅 <a href="https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-260" rel="noopener noreferrer" target="_blank" class="xref cursorpointer" onclick="Window.BookmapComponent.navigateExternalFile('https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-260')">Qualcomm Intelligent Robotics SDK (QIR SDK) 2.0 发布说明</a>。例如，<code class="docutils literal notranslate"><span class="pre">r00243.1</span></code>。</p><br></li><br><li><p>QCS8300.LE.1.0</p><br><p>请参阅 <a href="https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-260" rel="noopener noreferrer" target="_blank" class="xref cursorpointer" onclick="Window.BookmapComponent.navigateExternalFile('https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-260')">Qualcomm Intelligent Robotics SDK (QIR SDK) 2.0 发布说明</a>。例如，<code class="docutils literal notranslate"><span class="pre">r00137.1</span></code>。</p><br></li><br></ul> |
    | `--build` | 编译 ID | <ul><br><li><p>QCM6490.LE.1.0</p><br><p>请参阅 <a href="https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-260" rel="noopener noreferrer" target="_blank" class="xref cursorpointer" onclick="Window.BookmapComponent.navigateExternalFile('https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-260')">Qualcomm Intelligent Robotics SDK (QIR SDK) 2.0 发布说明</a>。例如：</p><br><div class="highlight-default notranslate"><div class="highlight"><pre class="pre codeblock"><code>QCM6490.LE.1.0-00376-STD.PROD-1<br></code><span class="copyclip"><svg xmlns="http://www.w3.org/2000/svg" class="copyclipicon" width="25px" height="25px" viewbox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect><title>Copy to clipboard</title><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path></svg></span></pre></div><br></div><br></li><br><li><p>QCS9100.LE.1.0</p><br><p>请参阅 <a href="https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-260" rel="noopener noreferrer" target="_blank" class="xref cursorpointer" onclick="Window.BookmapComponent.navigateExternalFile('https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-260')">Qualcomm Intelligent Robotics SDK (QIR SDK) 2.0 发布说明</a>。例如：</p><br><div class="highlight-default notranslate"><div class="highlight"><pre class="pre codeblock"><code>QCS9100.LE.1.0-00243-STD.PROD-1<br></code><span class="copyclip"><svg xmlns="http://www.w3.org/2000/svg" class="copyclipicon" width="25px" height="25px" viewbox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect><title>Copy to clipboard</title><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path></svg></span></pre></div><br></div><br></li><br><li><p>QCS8300.LE.1.0</p><br><p>请参阅 <a href="https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-260" rel="noopener noreferrer" target="_blank" class="xref cursorpointer" onclick="Window.BookmapComponent.navigateExternalFile('https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-260')">Qualcomm Intelligent Robotics SDK (QIR SDK) 2.0 发布说明</a>。例如：</p><br><div class="highlight-default notranslate"><div class="highlight"><pre class="pre codeblock"><code>QCS8300.LE.1.0-00137-STD.PROD-1<br></code><span class="copyclip"><svg xmlns="http://www.w3.org/2000/svg" class="copyclipicon" width="25px" height="25px" viewbox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect><title>Copy to clipboard</title><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path></svg></span></pre></div><br></div><br></li><br></ul> |
    | `--distribution` | 发行版 | 请参阅[表：发行版和访问级别](https://docs.qualcomm.com/doc/80-70020-265Y/topic/qsc_cli.html#table-distros)。 |

> 
> 
> 表： 分发和访问级别
> 
> 
> | 访问级别 | `Distro` | Yocto 层 |
> | --- | --- | --- |
> | 使用任意电子邮件地址注册的开发者（仅二进制文件，不包含 modem 和 GPS） | `Qualcomm_Linux.SPF.1.0|TEST|DEVICE|PB_QIRPSDK` | meta-qcom<br>    meta-qcom-hwe<br>    meta-ros<br>    meta-qcom-robotics<br>    meta-qcom-robotics-distro<br>    meta-qcom-robotics-sdk<br>    meta-qcom-qim-product-sdk<br>    Copy to clipboard |
> | 经过验证的组织的注册开发者（二进制文件和用于编译特定固件镜像的源代码，不包括 modem 和 GPS） | `Qualcomm_Linux.SPF.1.0|AP|Standard|OEM|NM_QIRPSDK` | meta-qcom<br>    meta-qcom-hwe<br>    meta-qcom-extras<br>    meta-qcom-robotics-extras<br>    meta-ros<br>    meta-qcom-robotics<br>    meta-qcom-robotics-distro<br>    meta-qcom-robotics-sdk<br>    meta-qcom-qim-product-sdk<br>    Copy to clipboard |

Note

有关访问级别的信息，包括 `public`、 和 `authorized`，请参阅[Working with Qualcomm](https://www.qualcomm.com/support/working-with-qualcomm)。

Note

编译和刷写的步骤遵循 [Qualcomm^®^ Linux 编译指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-254)。

## 使用 QSC-CLI 下载编译 QIR

要编译 QIR SDK，请参阅 *Qualcomm Linux 编译指南*中的[编译默认配置 - 编译](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-254/build_frm_source_qsc_cli.html#compile)。

**输出**

Note

`<Workspace_Path>` 是提供给[下载命令](https://docs.qualcomm.com/doc/80-70020-265Y/topic/qsc_cli.html#step-download-with-qsccli)的参数 `--workspace-path` 的值。

Tab RB3 Gen 2 机器视觉开发套件
Tab IQ-9075 评估套件
Tab IQ-8 Beta 评估套件

- 机器人镜像：`<Workspace_Path>/DEV/LE.QCROBOTICS.1.0.r1/build-qcs6490-custom/tmp-glibc/deploy/images/qcs6490-rb3gen2-vision-kit/qcom-robotics-full-image/*`
- QIR SDK：`<Workspace_Path>/DEV/LE.QCROBOTICS.1.0.r1/build-qcs6490-custom/tmp-glibc/deploy/qirpsdk_artifacts/qcs6490-rb3gen2-vision-kit/qirp-sdk_<version>.tar.gz`

- 机器人镜像：`<Workspace_Path>/DEV/LE.QCROBOTICS.1.0.r1/build-qcs9075-custom/tmp-glibc/deploy/images/qcs9075-iq-9075-evk/qcom-robotics-full-image/*`
- QIR SDK：`<Workspace_Path>/DEV/LE.QCROBOTICS.1.0.r1/build-qcs9075-custom/tmp-glibc/deploy/qirpsdk_artifacts/qcs9075-iq-9075-evk/qirp-sdk_<version>.tar.gz`

- 机器人镜像：`<Workspace_Path>/DEV/LE.QCROBOTICS.1.0.r1/build-qcs8300-custom/tmp-glibc/deploy/images/qcs8300-ride-sx/qcom-robotics-full-image/*`
- QIR SDK：`<Workspace_Path>/DEV/LE.QCROBOTICS.1.0.r1/build-qcs8300-custom/tmp-glibc/deploy/qirpsdk_artifacts/qcs8300-ride-sx/qirp-sdk_<version>.tar.gz`

## 将机器人镜像刷入设备

要将机器人镜像刷入设备，请参阅使用 [使用 QSC-CLI 下载编译 QIR](https://docs.qualcomm.com/doc/80-70020-265Y/topic/qsc_cli.html#section-build-qir-with-qsc-cli) 中生成的 `qcom-robotics-full-image` [刷写机器人镜像](https://docs.qualcomm.com/doc/80-70020-265Y/topic/flash_the_robotics_image.html#flash-and-install)。

Last Published: Oct 13, 2025

[Previous Topic
使用 QSC Launcher 编译](https://docs.qualcomm.com/bundle/publicresource/80-70020-265Y/topics/qsc_launcher_gui.md) [Next Topic
使用 GitHub 工作流进行编译](https://docs.qualcomm.com/bundle/publicresource/80-70020-265Y/topics/github_workflow.md)