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

# 烧写操作系统

> 选择开发套件、选择目标操作系统，并使用 Qualcomm® Launcher 进行烧写。

<Info>
  本指南使用 **IQ-8275 Evaluation Kit Pro**，目标操作系统为 **Ubuntu Server
  24.04-x08**。
</Info>

## 前提条件

<CardGroup cols={2}>
  <Card title="已安装 Launcher" icon="download">
    在继续之前，请先完成[安装指南](./installation)。
  </Card>

  <Card title="备好 USB 线缆" icon="usb">
    准备两根 USB 线缆：一根 **USB Type-C** 线缆用于连接设备进行烧写，一根 **USB Type-B** 线缆用于串口连接以配置 Wi-Fi。
  </Card>
</CardGroup>

***

## 烧写步骤

<Steps>
  <Step title="打开 Qualcomm® Launcher">
    从您的主机启动 Qualcomm® Launcher 应用程序。
  </Step>

  <Step title="选择您的开发套件">
    点击 **Select Development Kit**，从可用列表中选择您的套件。
    可使用搜索框按名称筛选。

    <Frame caption="开发套件选择对话框">
      <img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/Qualcomm-Launcher/images/kit-selection-dialog.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=162e42feaa008e6e64d47ae00db33eda" alt="Select Development Kit 对话框" width="1200" height="1100" data-path="Tools/Qualcomm-Launcher/images/kit-selection-dialog.png" />
    </Frame>
  </Step>

  <Step title="选择目标操作系统">
    选择开发套件后，选择一个 **Target Operating System**。

    <Tabs>
      <Tab title="官方发布版">
        使用 **Variant** 和 **Version** 下拉菜单选择官方操作系统发布版。
      </Tab>

      <Tab title="自定义镜像">
        选择 **Custom** 并指向包含您镜像的本地文件夹。
      </Tab>
    </Tabs>

    您还可以更改默认的 **Download Location** 路径。

    <Frame caption="目标操作系统选择 — 已选择 Ubuntu，未连接设备">
      <img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/Qualcomm-Launcher/images/target-os-no-device.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=312264d4aa9f3e94e9e2a7e0b39ac249" alt="未检测到设备的目标操作系统选择" width="1200" height="1100" data-path="Tools/Qualcomm-Launcher/images/target-os-no-device.png" />
    </Frame>

    <Warning>
      如果未检测到兼容设备，屏幕会显示：*"No compatible device detected. Connect your device via USB and ensure it is in EDL mode."* 应用内提供了 **Steps to Enter EDL Mode** 链接。
    </Warning>

    <Frame caption="目标操作系统选择 — 检测到设备后 Flash 按钮变为可用">
      <img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/Qualcomm-Launcher/images/target-os-device-detected.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=941d14630152ddeb55ea9dc390bbd97a" alt="Flash 按钮可用的目标操作系统选择" width="1200" height="1100" data-path="Tools/Qualcomm-Launcher/images/target-os-device-detected.png" />
    </Frame>
  </Step>

  <Step title="将设备置于 EDL 模式">
    在烧写之前，将设备置于 **EDL（Emergency Download，紧急下载）模式**。
    针对您具体设备的分步说明可通过应用内的 **Steps to Enter EDL Mode** 链接获取。

    进入 EDL 模式后，设备会被自动检测到。
  </Step>

  <Step title="点击 Flash">
    点击 **Flash** 按钮开始烧写过程。
  </Step>

  <Step title="监控烧写进度">
    进度屏幕显示实时烧写状态：平台镜像下载、后台烧写活动以及实时日志。

    <Frame caption="烧写进行中 — 请勿中断">
      <img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/Qualcomm-Launcher/images/flash-in-progress.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=e6d5825ee77050570a4b660150952300" alt="烧写进行中屏幕" width="1200" height="1100" data-path="Tools/Qualcomm-Launcher/images/flash-in-progress.png" />
    </Frame>

    <Warning>
      此过程可能需要几分钟。烧写进行期间，**请勿关闭应用程序或断开设备连接**。
    </Warning>

    <Note>
      如果在 Windows 上烧写反复失败并出现 `qdl: unable to open USB device` 错误，可能是由于 USB 驱动冲突。请参阅[解决 USB 驱动冲突](./troubleshooting/usb-driver-conflict)来解决此问题。
    </Note>
  </Step>

  <Step title="处理 EDL 重新进入提示（如出现）">
    某些固件更新需要在烧写中途**第二次进入 EDL 模式**。如果这适用于您的设备，将出现提示：

    > **Put Device in EDL Mode to Continue**
    > 附加固件烧写步骤已成功完成。要继续烧写操作系统，必须再次将设备置于 EDL 模式。

    <Frame caption="EDL 模式重新进入提示 — 等待设备">
      <img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/Qualcomm-Launcher/images/edl-reentry-prompt.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=54fa4315cc0139ca277639598c4da63a" alt="需要 EDL 模式的提示" width="1200" height="1100" data-path="Tools/Qualcomm-Launcher/images/edl-reentry-prompt.png" />
    </Frame>

    按提示重新进入 EDL 模式。检测到设备后，烧写会自动恢复。
  </Step>

  <Step title="确认烧写完成">
    当操作系统镜像成功烧写后，状态会变为 **"OS image Flash completed successfully"**，并且 **Configure Login** 按钮变为可用。

    <Frame caption="烧写完成 — 可以进行设备配置">
      <img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/Qualcomm-Launcher/images/flash-complete.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=5108371ca1d71c8f90ab2eb7475283cd" alt="烧写完成屏幕" width="1200" height="1100" data-path="Tools/Qualcomm-Launcher/images/flash-complete.png" />
    </Frame>

    <Check>
      操作系统烧写已完成。设备已准备好进行初始配置。
    </Check>
  </Step>
</Steps>

## 下一步

点击 **Configure Login**，或继续阅读[配置设备](./configure-device)指南。