> ## 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.

# 升级 QIR SDK 工件

> 本信息介绍如何在不重新构建整个 QIR SDK 的情况下升级 QIR SDK 工件。

使用以下步骤，在已运行受支持 robotics 镜像的设备上升级 QIR SDK 工件，而无需重新构建或重新烧录整个 QIR SDK。

<Note>
  不适用于 `qcom-robotics-distro-catchall` 发行版。
</Note>

<Warning>
  **警告**

  Qualcomm Linux 2.0 版本（`qli-2.0`）中包含的以下预构建 robotics 镜像仅与同一发布包中提供的 QIR SDK 工件进行过验证。建议在生产部署中使用经过验证的组合。

  * Qualcomm robotics 镜像：`qcom-robotics-image`。
  * Qualcomm robotics 专有镜像：`qcom-robotics-proprietary-image`。

  在主机系统上更新、替换或混用来自不同版本的 QIR SDK 工件不属于经过验证的配置，可能导致兼容性、性能或稳定性问题。
</Warning>

## 前提条件

* 设备已开机并成功启动。
* 设备可通过 SSH 访问（在以下命令中将 `[ip-addr]` 替换为设备 IP 地址）。

## 步骤

1. 从以下位置获取 QIR SDK 工件：[下载预构建软件包](./download-the-prebuilt-packages)，并解压软件包。
2. 将解压后的 QIR 工件推送到设备：
   ```powershell theme={null}
   scp -r <path>/qirp-sdk_<version>/qirp-sdk/. root@[ip-addr]:/opt/runtime/qirp-sdk/
   ```
3. 在设备上运行升级脚本：
   ```powershell theme={null}
   ssh root@[ip-addr] "chmod +x /opt/runtime/qirp-sdk/scripts/*.sh"
   ssh root@[ip-addr] "/opt/runtime/qirp-sdk/scripts/qirp-upgrade*.sh"
   ```

<Note>
  **可选：使用 `adb` 代替 SSH**

  设备上默认禁用 `adb`。要启用它，请在设备上运行以下命令：

  ```bash theme={null}
  touch /etc/usb-debugging-enabled
  systemctl start android-tools-adbd
  ```

  启用 `adb` 后，你可以在主机上运行等效命令：

  ```powershell theme={null}
  adb push <path>/qirp-sdk_<version>/qirp-sdk/. /opt/runtime/qirp-sdk/
  adb shell "chmod +x /opt/runtime/qirp-sdk/scripts/*.sh"
  adb shell "/opt/runtime/qirp-sdk/scripts/qirp-upgrade*.sh"
  ```
</Note>

## 结果

升级完成后，设备上的 QIR SDK 工件即被更新，而无需重新构建完整的 SDK。