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

# 使用 QDL 刷写 Qualcomm Linux

> 使用 Qualcomm Device Loader (QDL) 命令行工具,从 Ubuntu、Windows 或 macOS 主机将 Qualcomm Linux 刷写到 IQ-8275 EVK。

**Qualcomm Device Loader (QDL)** 是一款面向 Qualcomm 设备的跨平台命令行刷写工具。当您需要对刷写过程进行完全控制、在无图形界面(headless)环境中运行,或希望编写自动化刷写脚本时,请使用此方法。

如需基于 GUI 的替代方案,请参见 [**使用 Qualcomm Launcher 刷写 Qualcomm Linux**](./flash-using-qualcomm-launcher)。

<Warning>
  刷写会清除设备上的所有数据。开始之前请备份所有重要内容。
</Warning>

## 所需材料

* IQ-8275 EVK 及 12 V 电源
* USB Type-C 线缆(EVK 上的 USB0 端口 → 主机)
* 运行 Ubuntu、Windows 或 macOS 的主机

## 选择您的主机操作系统并按完整流程操作

从 [**Qualcomm Software Center**](https://softwarecenter.qualcomm.com/catalog/item/Qualcomm_Device_Loader) 下载适用于您主机操作系统的 QDL。

<Tabs>
  <Tab title="Ubuntu">
    ### 下载 Qualcomm Linux 镜像

    1. 下载 [**Qualcomm Linux 镜像**](https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/meta-qcom/qcom-distro-sota/iq-8275-evk/qli-2.0-qcom-multimedia-proprietary-image.zip)。

    2. 解压 zip 文件

       ```text theme={null}
       unzip qli-2.0-qcom-multimedia-proprietary-image.zip
       ```

       可刷写的构件位于:

       ```text theme={null}
       <path-to-image>/images/iq-8275-evk/qcom-multimedia-proprietary-image-iq-8275-evk/
       ```

       其中 `<path-to-image>` 是解压镜像 zip 时创建的文件夹。

    ### 下载 QDL

    1. 下载 [适用于 Linux (x64) 的 QDL 工具](https://softwarecenter.qualcomm.com/catalog/item/Qualcomm_Device_Loader) 并解压。解压后的文件夹包含 `qdl` 二进制文件 — 下文中称为 `<qdl_dir>`。

    2. 安装所需的库(如已安装可跳过):

       ```shell theme={null}
       sudo apt-get install libxml2-dev libudev-dev libusb-1.0-0-dev
       ```

           <Note>
             我们建议将镜像和 QDL 解压到同一个父文件夹中。这样所有路径都在同一根目录下,便于在 provision、SAIL 和镜像文件夹之间切换。
           </Note>

    ### 设置 QDL 驱动

    Ubuntu 需要一条 udev 规则,以便设备进入 EDL 模式时内核授予您的用户与设备通信的权限。

    1. 检查该规则是否已存在:
       ```shell theme={null}
       ls /etc/udev/rules.d/51-qcom-usb.rules
       ```

    2. 如果该文件**不**存在,用一条命令创建它:
       ```shell theme={null}
       echo 'SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9008", MODE="0664", GROUP="plugdev"' | sudo tee /etc/udev/rules.d/51-qcom-usb.rules
       ```
       如果该文件**已存在**,请确认规则是否在其中:
       ```shell theme={null}
       cat /etc/udev/rules.d/51-qcom-usb.rules
       ```

    3. 重新加载 udev 以应用规则:
       ```shell theme={null}
       sudo systemctl restart udev
       ```
       如果 USB 线缆已经连接,请断开后重新连接。

    ### 设置 QDL

    1. 使 QDL 可执行:
       ```shell theme={null}
       chmod +x <qdl_dir>/qdl
       ```

    2. 验证 QDL 是否正常工作:
       ```shell theme={null}
       <qdl_dir>/qdl --help
       ```
       您应当看到 QDL 的用法输出。如果出现错误,请检查路径。

    ### 使设备进入 EDL 模式

    1. **打开** SW2-3 DIP 开关 — 将其向上推。

           <img src="https://mintcdn.com/qualcomm-staging/TEuuywLWbysJVmUv/Linux/images/update-software/EDL_mode_dipSwitch.png?fit=max&auto=format&n=TEuuywLWbysJVmUv&q=85&s=3d04fafba2c054b589f4b5688447f678" alt="SW2-3 DIP 开关位置" width="1131" height="318" data-path="Linux/images/update-software/EDL_mode_dipSwitch.png" />

    2. 将 **12 V 电源**连接到 EVK。

    3. 用 **USB Type-C 线缆**将 EVK 上的 **USB0** 连接到主机。

           <img src="https://mintcdn.com/qualcomm-staging/TEuuywLWbysJVmUv/Linux/images/update-software/iq8275-platform-with-cables-plugged-in.png?fit=max&auto=format&n=TEuuywLWbysJVmUv&q=85&s=12eda688ad7b5a23dbdadc0d9ea070cc" alt="刷写连接示意 — USB 和电源连接" width="1114" height="900" data-path="Linux/images/update-software/iq8275-platform-with-cables-plugged-in.png" />

    4. 拨动**电源开关**为设备上电。

    5. 确认设备处于 EDL 模式:
       ```shell theme={null}
       lsusb
       ```
       **预期输出:**
       ```text theme={null}
       Bus 002 Device 014: ID 05c6:9008 Qualcomm, Inc. Gobi Wireless Modem (QDL mode)
       ```
       如果设备未出现,请重新检查 SW2-3 和 USB-C 线缆。

    ### 配置 UFS 分区(Provision UFS)

    UFS(通用闪存存储)分区配置将内部存储划分为多个独立的逻辑单元号(LUN),每个 LUN 专用于某种类型的数据(启动、系统、用户数据等)。这样可以提高访问效率,并使分区布局在多次刷写之间保持一致。

    如果符合以下任一情况,请执行 UFS 分区配置:

    * 这是从未刷写过的**全新板卡**。
    * 您正在**升级到新的镜像版本**。
    * 您正在**切换发行版**(Qualcomm Linux ↔ Ubuntu)。

    1. 下载并解压 provision 文件:
       ```shell theme={null}
       wget https://artifacts.codelinaro.org/artifactory/codelinaro-le/Qualcomm_Linux/QCS8300/provision.zip
       unzip provision.zip
       ```

    2. 从解压后的 provision 目录执行 UFS 分区配置:
       ```shell theme={null}
       cd provision
       <qdl_dir>/qdl --storage ufs prog_firehose_ddr.elf provision_1_3.xml
       ```
       **预期输出:**
       ```text theme={null}
       UFS provisioning succeeded
       ```

    <Note>
      UFS 分区配置完成后,设备会从 USB 断开。请先关闭再打开电源开关,使设备重新进入 EDL 模式后再继续。
    </Note>

    ### 刷写 SAIL 固件

    Safety Island (SAIL) 是 IQ-8275 EVK 上一个独立、隔离的处理器,独立于主应用处理器处理安全关键功能。其固件位于专用的 **spinor** 闪存分区上,必须在主操作系统镜像之前单独刷写。

    1. 进入解压后镜像中的 `sail_nor` 子文件夹:
       ```shell theme={null}
       cd <path-to-image>/images/iq-8275-evk/qcom-multimedia-proprietary-image-iq-8275-evk/sail_nor
       ```

    2. 刷写 SAIL 固件:
       ```shell theme={null}
       <qdl_dir>/qdl --storage spinor prog_firehose_ddr.elf rawprogram0.xml patch0.xml
       ```
       **预期输出:**
       ```text theme={null}
       flashed "SAIL_HYP" successfully
       flashed "SAIL_SW1" successfully
       flashed "SAIL_HYP_BKUP" successfully
       flashed "SAIL_SW1_BKUP" successfully
       flashed "PrimaryGPT" successfully
       flashed "BackupGPT" successfully
       11 patches applied
       ```
       如果刷写失败,请参见[如何排查刷写相关问题](https://docs.qualcomm.com/doc/80-80021-281/topic/iq8-ug-faqs.html#flash-issues)。

    ### 刷写 Qualcomm Linux

    1. 进入主镜像文件夹:
       ```shell theme={null}
       cd <path-to-image>/images/iq-8275-evk/qcom-multimedia-proprietary-image-iq-8275-evk
       ```

    2. 刷写镜像:
       ```shell theme={null}
       <qdl_dir>/qdl --storage ufs prog_firehose_ddr.elf rawprogram*.xml patch*.xml
       ```
       当最后一行显示如下内容时,刷写即完成:
       ```text theme={null}
       partition 1 is now bootable
       ```
       刷写过程中出现的任何扇区截断(sector-truncation)警告都是无害的。
  </Tab>

  <Tab title="Windows">
    ### 下载 Qualcomm Linux 镜像

    1. 下载 [**Qualcomm Linux 镜像**](https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/meta-qcom/qcom-distro-sota/iq-8275-evk/qli-2.0-qcom-multimedia-proprietary-image.zip)

    2. 解压 zip 文件

       ```text theme={null}
       tar -xf qli-2.0-qcom-multimedia-proprietary-image.zip
       ```

       可刷写的构件位于:

       ```text theme={null}
       <path-to-image>\images\iq-8275-evk\qcom-multimedia-proprietary-image-iq-8275-evk\
       ```

       其中 `<path-to-image>` 是解压镜像 zip 时创建的文件夹。

    ### 下载 QDL

    1. 下载 [适用于 Windows 的 QDL 工具](https://softwarecenter.qualcomm.com/#/catalog/item/Qualcomm_Device_Loader) 并解压。

           <Note>
             我们建议将镜像和 QDL 解压到同一个父文件夹中(例如 `C:\Users\you\Downloads\qualcomm-flash\`)。这样所有路径都在同一根目录下,便于在 provision、SAIL 和镜像文件夹之间切换。
           </Note>

    ### 设置 QDL 驱动

    1. 卸载任何现有的 Qualcomm USB 驱动(QUD)— 它们与 QDL 驱动冲突。打开**设备管理器**,找到您的设备,并卸载任何现有驱动。设备**不**应出现在 COM 端口下。

    2. 从解压后的 QDL 文件夹中运行 `install_driver.bat` 以安装 WinUSB 驱动。

           <img src="https://mintcdn.com/qualcomm-staging/TEuuywLWbysJVmUv/Linux/images/update-software/win_bat.png?fit=max&auto=format&n=TEuuywLWbysJVmUv&q=85&s=9a1f6e98279f41858829dd748242f49d" alt="运行 install_driver.bat" width="979" height="512" data-path="Linux/images/update-software/win_bat.png" />

    ### 使设备进入 EDL 模式

    1. **打开** SW2-3 DIP 开关 — 将其向上推。

           <img src="https://mintcdn.com/qualcomm-staging/TEuuywLWbysJVmUv/Linux/images/update-software/EDL_mode_dipSwitch.png?fit=max&auto=format&n=TEuuywLWbysJVmUv&q=85&s=3d04fafba2c054b589f4b5688447f678" alt="SW2-3 DIP 开关位置" width="1131" height="318" data-path="Linux/images/update-software/EDL_mode_dipSwitch.png" />

    2. 将 **12 V 电源**连接到 EVK。

    3. 用 **USB Type-C 线缆**将 EVK 上的 **USB0** 连接到主机。

           <img src="https://mintcdn.com/qualcomm-staging/TEuuywLWbysJVmUv/Linux/images/update-software/iq9075-flashsetup.png?fit=max&auto=format&n=TEuuywLWbysJVmUv&q=85&s=3b80a99305c7da298ff3f63b7320e607" alt="刷写连接示意 — USB 和电源连接" width="926" height="672" data-path="Linux/images/update-software/iq9075-flashsetup.png" />

    4. 拨动**电源开关**为设备上电。

    5. 打开**设备管理器**,确认出现一个 Qualcomm USB 设备(不在 COM 端口下)。

           <img src="https://mintcdn.com/qualcomm-staging/TEuuywLWbysJVmUv/Linux/images/update-software/dm_IQ9075_enum.jpg?fit=max&auto=format&n=TEuuywLWbysJVmUv&q=85&s=a60459398fbc68b17907953afb2529a9" alt="设备管理器 — 已确认 EDL 模式" width="1027" height="848" data-path="Linux/images/update-software/dm_IQ9075_enum.jpg" />

    ### 配置 UFS 分区(Provision UFS)

    UFS(通用闪存存储)分区配置将内部存储划分为多个独立的逻辑单元号(LUN),每个 LUN 专用于某种类型的数据(启动、系统、用户数据等)。这样可以提高访问效率,并使分区布局在多次刷写之间保持一致。

    如果符合以下任一情况,请执行 UFS 分区配置:

    * 这是从未刷写过的**全新板卡**。
    * 您正在**升级到新的镜像版本**。
    * 您正在**切换发行版**(Qualcomm Linux ↔ Ubuntu)。

    1. 下载 [**provision.zip**](https://artifacts.codelinaro.org/artifactory/codelinaro-le/Qualcomm_Linux/QCS8300/provision.zip) 并解压。

    2. 进入解压后的 provision 文件夹:
       ```shell theme={null}
       cd <path-to-provision>
       ```

    3. 执行 UFS 分区配置(将 `<qdl_dir>` 替换为您的 QDL 文件夹路径):

       **命令提示符(Command Prompt):**

       ```shell theme={null}
       "<qdl_dir>\qdl.exe" --storage ufs prog_firehose_ddr.elf provision_1_3.xml
       ```

       **PowerShell:**

       ```shell theme={null}
       & "<qdl_dir>\qdl.exe" --storage ufs prog_firehose_ddr.elf provision_1_3.xml
       ```

       **预期输出:**

       ```text theme={null}
       UFS provisioning succeeded
       ```

    <Note>
      UFS 分区配置完成后,设备会从 USB 断开。请先关闭再打开电源开关,使设备重新进入 EDL 模式后再继续。
    </Note>

    ### 刷写 SAIL 固件

    Safety Island (SAIL) 是 IQ-8275 EVK 上一个独立、隔离的处理器,独立于主应用处理器处理安全关键功能。其固件位于专用的 **spinor** 闪存分区上,必须在主操作系统镜像之前单独刷写。

    1. 进入镜像目录中的 `sail_nor` 子文件夹:
       ```shell theme={null}
       cd <path-to-image>\images\iq-8275-evk\qcom-multimedia-proprietary-image-iq-8275-evk\sail_nor
       ```

    2. 刷写 SAIL 固件(将 `<qdl_dir>` 替换为您的 QDL 文件夹路径):

       **命令提示符(Command Prompt):**

       ```shell theme={null}
       "<qdl_dir>\qdl.exe" --storage spinor prog_firehose_ddr.elf rawprogram0.xml patch0.xml
       ```

       **PowerShell:**

       ```shell theme={null}
       & "<qdl_dir>\qdl.exe" --storage spinor prog_firehose_ddr.elf rawprogram0.xml patch0.xml
       ```

       **预期输出:**

       ```text theme={null}
       flashed "SAIL_HYP" successfully
       flashed "SAIL_SW1" successfully
       flashed "SAIL_HYP_BKUP" successfully
       flashed "SAIL_SW1_BKUP" successfully
       flashed "PrimaryGPT" successfully
       flashed "BackupGPT" successfully
       11 patches applied
       ```

       如果刷写失败,请参见[如何排查刷写相关问题](https://docs.qualcomm.com/doc/80-80021-281/topic/iq8-ug-faqs.html#flash-issues)。

    ### 刷写 Qualcomm Linux

    1. 进入主镜像文件夹:
       ```shell theme={null}
       cd <path-to-image>\images\iq-8275-evk\qcom-multimedia-proprietary-image-iq-8275-evk
       ```

    2. 刷写镜像(将 `<qdl_dir>` 替换为您的 QDL 文件夹路径 — Windows 不支持通配符,需显式列出所有文件):

       **命令提示符(Command Prompt):**

       ```shell theme={null}
       "<qdl_dir>\qdl.exe" prog_firehose_ddr.elf rawprogram0.xml rawprogram1.xml rawprogram2.xml rawprogram3.xml rawprogram4.xml rawprogram5.xml patch0.xml patch1.xml patch2.xml patch3.xml patch4.xml patch5.xml
       ```

       **PowerShell:**

       ```shell theme={null}
       & "<qdl_dir>\qdl.exe" prog_firehose_ddr.elf rawprogram0.xml rawprogram1.xml rawprogram2.xml rawprogram3.xml rawprogram4.xml rawprogram5.xml patch0.xml patch1.xml patch2.xml patch3.xml patch4.xml patch5.xml
       ```

       当最后一行显示如下内容时,刷写即完成:

       ```text theme={null}
       partition 1 is now bootable
       ```
  </Tab>

  <Tab title="macOS">
    ### 下载 Qualcomm Linux 镜像

    1. 下载 [**Qualcomm Linux 镜像**](https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/meta-qcom/qcom-distro-sota/iq-8275-evk/qli-2.0-qcom-multimedia-proprietary-image.zip)。

    2. 解压 zip 文件

       ```text theme={null}
       unzip qli-2.0-qcom-multimedia-proprietary-image.zip
       ```

       可刷写的构件位于:

       ```text theme={null}
       <path-to-image>/images/iq-8275-evk/qcom-multimedia-proprietary-image-iq-8275-evk/
       ```

       其中 `<path-to-image>` 是解压镜像 zip 时创建的文件夹。

    ### 下载 QDL

    1. 下载 [适用于 macOS (Apple Silicon) 的 QDL 工具](https://softwarecenter.qualcomm.com/catalog/item/Qualcomm_Device_Loader) 并解压。解压后的文件夹包含 `qdl` 二进制文件 — 下文中称为 `<qdl_dir>`。有关工具使用详情,请参见该文件夹中的 **QDL\_User\_Guide**。

           <Note>
             我们建议将镜像和 QDL 解压到同一个父文件夹中。这样所有路径都在同一根目录下,便于在 provision、SAIL 和镜像文件夹之间切换。
           </Note>

    ### 设置 QDL 路径

    1. 通过 Homebrew 安装所需的库(如已安装可跳过):
       ```shell theme={null}
       brew install libusb libxml2
       ```

    <Accordion title="brew install 失败?安装 Homebrew 实用工具" icon="triangle-exclamation">
      Brew(正式名称为 Homebrew)是一款软件包管理器,允许您在 Mac 终端中使用文本命令安装、更新和删除程序。请按照以下步骤安装 Homebrew。

      **1. 安装 xcode**

      ```shell theme={null}
      xcode-select --install
      ```

      **2. 运行 Homebrew 安装命令**

      ```shell theme={null}
      /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
      ```

      **3. 将 Homebrew 添加到 shell 的 PATH**

      ```shell theme={null}
      vi ~/.zshrc or vi ~/.bash_profile
      ```

      添加以下行

      ```shell theme={null}
      PATH=/opt/homebrew/bin:$PATH
      ```

      **4. 应用更改**

      ```shell theme={null}
      source ~/.zshrc or source ~/.bash_profile
      ```

      **5. 验证安装**

      ```shell theme={null}
      brew doctor
      ```

      **预期输出:**

      ```text theme={null}
      Your system is ready to brew
      ```
    </Accordion>

    2. 使 QDL 可执行,并清除 macOS 的隔离(quarantine)标记,以便 Gatekeeper 允许其运行:
       ```shell theme={null}
       chmod +x <qdl_dir>/qdl
       sudo xattr -dr com.apple.quarantine <qdl_dir>
       ```
           <Note>
             需要 `sudo`,因为某些捆绑的库是只读的。如果此步骤之后 macOS 仍然阻止该工具运行,请在**系统设置 → 隐私与安全性**中允许它。
           </Note>

    3. 验证 QDL 是否正常工作:
       ```shell theme={null}
       <qdl_dir>/qdl --help
       ```
       您应当看到 QDL 的用法输出。如果出现错误,请检查路径。

    ### 使设备进入 EDL 模式

    1. **打开** SW2-3 DIP 开关 — 将其向上推。

           <img src="https://mintcdn.com/qualcomm-staging/TEuuywLWbysJVmUv/Linux/images/update-software/EDL_mode_dipSwitch.png?fit=max&auto=format&n=TEuuywLWbysJVmUv&q=85&s=3d04fafba2c054b589f4b5688447f678" alt="SW2-3 DIP 开关位置" width="1131" height="318" data-path="Linux/images/update-software/EDL_mode_dipSwitch.png" />

    2. 将 **12 V 电源**连接到 EVK。

    3. 用 **USB Type-C 线缆**将 EVK 上的 **USB0** 连接到主机。

           <img src="https://mintcdn.com/qualcomm-staging/TEuuywLWbysJVmUv/Linux/images/update-software/iq9075-flashsetup.png?fit=max&auto=format&n=TEuuywLWbysJVmUv&q=85&s=3b80a99305c7da298ff3f63b7320e607" alt="刷写连接示意 — USB 和电源连接" width="926" height="672" data-path="Linux/images/update-software/iq9075-flashsetup.png" />

    4. 拨动**电源开关**为设备上电。

    5. 确认设备处于 EDL 模式:
       ```shell theme={null}
       system_profiler SPUSBDataType | grep -A4 -i qualcomm
       ```
       **预期输出:**
       ```text theme={null}
       Product ID: 0x9008
       Vendor ID: 0x05c6  (Qualcomm, Inc)
       Manufacturer: Qualcomm CDMA Technologies MSM
       ```
       `Product ID: 0x9008` 确认设备处于 EDL 模式。如果未出现,请重新检查 SW2-3 和 USB-C 线缆。

    ### 配置 UFS 分区(Provision UFS)

    UFS(通用闪存存储)分区配置将内部存储划分为多个独立的逻辑单元号(LUN),每个 LUN 专用于某种类型的数据(启动、系统、用户数据等)。这样可以提高访问效率,并使分区布局在多次刷写之间保持一致。

    如果符合以下任一情况,请执行 UFS 分区配置:

    * 这是从未刷写过的**全新板卡**。
    * 您正在**升级到新的镜像版本**。
    * 您正在**切换发行版**(Qualcomm Linux ↔ Ubuntu)。

    1. 下载 [**provision.zip**](https://artifacts.codelinaro.org/artifactory/codelinaro-le/Qualcomm_Linux/QCS8300/provision.zip) 并解压:
       ```shell theme={null}
       unzip provision.zip
       ```

    2. 将 provision 文件和 QDL 二进制文件移动到同一文件夹,然后在该文件夹中运行:

           <Note>
             在 macOS 上,`qdl` 二进制文件及其支持库必须与 provision 文件位于同一目录中。请将 provision 文件复制到 `<qdl_dir>` 中,然后在那里运行命令。
           </Note>

       ```shell theme={null}
       ./qdl --storage ufs prog_firehose_ddr.elf provision_1_3.xml
       ```

       **预期输出:**

       ```text theme={null}
       UFS provisioning succeeded
       ```

    <Note>
      UFS 分区配置完成后,设备会从 USB 断开。请先关闭再打开电源开关,使设备重新进入 EDL 模式后再继续。
    </Note>

    ### 刷写 SAIL 固件

    Safety Island (SAIL) 是 IQ-8275 EVK 上一个独立、隔离的处理器,独立于主应用处理器处理安全关键功能。其固件位于专用的 **spinor** 闪存分区上,必须在主操作系统镜像之前单独刷写。

    1. 进入解压后镜像中的 `sail_nor` 子文件夹:
       ```shell theme={null}
       cd <path-to-image>/images/iq-8275-evk/qcom-multimedia-proprietary-image-iq-8275-evk/sail_nor
       ```

    2. 刷写 SAIL 固件:
       ```shell theme={null}
       <qdl_dir>/qdl --storage spinor prog_firehose_ddr.elf rawprogram0.xml patch0.xml
       ```
       **预期输出:**
       ```text theme={null}
       flashed "SAIL_HYP" successfully
       flashed "SAIL_SW1" successfully
       flashed "SAIL_HYP_BKUP" successfully
       flashed "SAIL_SW1_BKUP" successfully
       flashed "PrimaryGPT" successfully
       flashed "BackupGPT" successfully
       11 patches applied
       ```
       如果刷写失败,请参见[如何排查刷写相关问题](https://docs.qualcomm.com/doc/80-80021-281/topic/iq8-ug-faqs.html#flash-issues)。

    ### 刷写 Qualcomm Linux

    1. 进入主镜像文件夹:
       ```shell theme={null}
       cd <path-to-image>/images/iq-8275-evk/qcom-multimedia-proprietary-image-iq-8275-evk
       ```

    2. 刷写镜像:
       ```shell theme={null}
       <qdl_dir>/qdl --storage ufs prog_firehose_ddr.elf rawprogram*.xml patch*.xml
       ```
       当最后一行显示如下内容时,刷写即完成:
       ```text theme={null}
       partition 1 is now bootable
       ```
       刷写过程中出现的任何扇区截断(sector-truncation)警告都是无害的。
  </Tab>
</Tabs>

<Note>
  如果刷写在任何环节失败,请断开 USB 线缆和电源,重新连接后从 EDL 模式步骤开始重试。
</Note>

## 完成

1. **关闭** SW2-3 DIP 开关 — 将其向下推。
2. 重新上电设备。设备将启动进入新刷写的 Qualcomm Linux 镜像。

## 后续步骤

继续阅读 [**设置设备**](../set-up-the-device),连接调试 UART、验证软件版本,并启用网络、SSH 和显示。