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

# 烧录操作系统

> 选择开发套件、选择目标操作系统,并使用 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-staging/spyZ30ICw4vv_ioE/Tools/Qualcomm-Launcher/images/kit-selection-dialog.png?fit=max&auto=format&n=spyZ30ICw4vv_ioE&q=85&s=ed9e08dcf885208a62f6d1c8e68fa0b3" 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-staging/spyZ30ICw4vv_ioE/Tools/Qualcomm-Launcher/images/target-os-no-device.png?fit=max&auto=format&n=spyZ30ICw4vv_ioE&q=85&s=aa739d32cb94a8870953c6f6f6001330" 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-staging/spyZ30ICw4vv_ioE/Tools/Qualcomm-Launcher/images/target-os-device-detected.png?fit=max&auto=format&n=spyZ30ICw4vv_ioE&q=85&s=9986877d9f3d0f074dd9745de2e9ad44" 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-staging/spyZ30ICw4vv_ioE/Tools/Qualcomm-Launcher/images/flash-in-progress.png?fit=max&auto=format&n=spyZ30ICw4vv_ioE&q=85&s=3ddd8035a7b1868420c070fbfdf1aa33" 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**
    > The additional firmware flash step completed successfully. To proceed with flashing the operating system, the device must be placed in EDL mode again.

    <Frame caption="EDL 模式重新进入提示 — 等待设备">
      <img src="https://mintcdn.com/qualcomm-staging/spyZ30ICw4vv_ioE/Tools/Qualcomm-Launcher/images/edl-reentry-prompt.png?fit=max&auto=format&n=spyZ30ICw4vv_ioE&q=85&s=7d370b8036d5ffc4476347c58f45570b" 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-staging/spyZ30ICw4vv_ioE/Tools/Qualcomm-Launcher/images/flash-complete.png?fit=max&auto=format&n=spyZ30ICw4vv_ioE&q=85&s=359ad83e96286d2e874a63836d91d05b" alt="烧录完成界面" width="1200" height="1100" data-path="Tools/Qualcomm-Launcher/images/flash-complete.png" />
    </Frame>

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

## 下一步

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