> ## 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 刷写 Qualcomm Linux
> 在任意主机操作系统上，使用 Qualcomm Launcher GUI 工具下载 Qualcomm Linux 并刷写到 IQ-8275 EVK。
**Qualcomm® Launcher** 是一款图形化工具，可处理向 Qualcomm 开发套件下载并刷写操作系统镜像的全过程。它可在 **Windows、Linux 和 macOS** 上运行，无需任何命令行设置。该工具端到端地管理镜像下载和刷写流程。
如果您偏好 GUI 工作流程，请使用此方法。如果您需要完全控制或正在编写自动化设置脚本，请改用[**使用 QDL 刷写 Qualcomm Linux**](./flash-over-qli)。
刷写会擦除设备上的所有数据。开始之前请备份所有重要内容。
## 所需条件
* 配有 12 V 电源的 IQ-8275 EVK
* USB Type-C 数据线（EVK 上的 USB0 端口 → 主机）
* Micro-USB 数据线（用于刷写后的 UART 设置步骤）
* 运行 Windows、Linux 或 macOS 的主机
## 步骤 1：安装 Qualcomm Launcher
1. 访问 Qualcomm Software Center：[**https://softwarecenter.qualcomm.com/catalog/item/Qualcomm\_Launcher**](https://softwarecenter.qualcomm.com/catalog/item/Qualcomm_Launcher)
2. 下载最新版本并运行安装程序。
安装完成后，打开 **Qualcomm Launcher** 应用程序。
在 Ubuntu 上，内核需要一条 udev 规则，以便当设备进入 EDL 模式时授予与其通信的权限。如果没有这条规则，即使设备已连接并通电，Launcher 也不会检测到设备。
**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 线已连接，请断开并重新连接。
此操作只需执行一次。之后，Launcher 将自动检测设备。
安装 Qualcomm Launcher 之前，请确保卸载任何现有的 Qualcomm USB 驱动（QUD）——它们会与 QDL 驱动冲突。
打开**设备管理器**，找到您的设备，如已安装 QUD 请将其卸载。设备**不**应出现在 COM 端口下。
否则，通过 Qualcomm Launcher 执行的刷写操作将会失败。
## 步骤 2：选择您的开发套件
在 **Choose OS** 界面上，点击 **Select Development Kit**，并从列表中选择 **IQ-8275 Evaluation Kit**。
## 步骤 3：选择操作系统镜像
选择套件后，**Choose OS** 界面会显示操作系统选项。
1. 在 **Target Operating System** 下，选择 **Qualcomm Linux** 卡片。
2. 选择加载构建版本的方式：
使用 **Variant** 下拉菜单选择镜像类型（**Qualcomm Linux Proprietary** 或 **Qualcomm Linux Open Source**），然后使用 **Version** 下拉菜单选择版本。
使用此选项刷写本地构建或下载的镜像。
1. 在源切换开关中选择 **Custom**。
2. 解压构建输出或下载得到的镜像归档文件（`.zip` 或 `.tar.gz`）。
3. 点击 **Select Folder**，选择包含刷写描述文件（`rawprogram*.xml`、`patch*.xml`）和分区镜像（`.bin` / `.img`）的文件夹。
对于官方 Qualcomm Linux 镜像，该文件夹通常位于解压后归档中的：
`images/iq-8275-evk/qcom-multimedia-proprietary-image-iq-8275-evk`
3. 将 **Download Location** 保持为默认值，或选择一个具有足够空间的自定义文件夹。
## 步骤 4：使设备进入 EDL 模式
紧急下载（EDL）模式使设备可以通过 USB 接受新的固件镜像。在检测到设备之前，**Choose OS** 界面会显示 *No compatible device detected*，并且 **Flash** 按钮保持禁用状态。
1. 将 SW2-3 DIP 开关向上推以**打开**它。
2. 将 **12 V 电源**连接到 EVK。
3. 用 **USB Type-C 数据线**将 EVK 上的 **USB0** 连接到主机。
4. 拨动**电源开关**打开设备。
一旦设备以 EDL 模式枚举，**Flash** 按钮就会变为可用状态。
## 步骤 5：刷写
点击 **Flash** 按钮。Launcher 会先下载操作系统镜像，然后分两个阶段刷写设备。
**阶段 1：附加固件。** Launcher 会配置 UFS 存储并写入 CDT，然后进入操作系统镜像阶段。此阶段完成后，它会暂停并要求您将设备重新置于 EDL 模式：
SW2-3 DIP 开关仍处于向上位置，因此只需**将电源开关关闭再打开**。设备会重新进入 EDL 模式，Launcher 将自动继续。
**阶段 2：操作系统镜像。** Launcher 会写入操作系统镜像。整个过程中请保持电源和 USB 连接。如果 Launcher 看起来在等待设备时卡住，请将电源开关关闭再打开；它会重新连接并继续。
刷写完成后，状态会显示 **OS image Flash completed successfully**，且 **Configure Login** 按钮变为可用状态。
## 步骤 6：配置登录
Launcher 可以自动引导您完成串口和网络设置。您可以在此完成该步骤，也可以跳过它，按照[**设置设备**](../set-up-the-device)中的手动说明操作。
**若要继续使用 Launcher：**
1. 将 **SW2-3 DIP 开关**向**下**推以将其关闭。开关向下时，设备会正常引导进入操作系统，而不是进入 EDL 模式。
2. 用 **micro-USB 数据线**将 EVK 上的 **micro-USB（调试）端口**连接到主机。
3. 重新上电设备（使用电源开关先关闭再打开）。
4. 点击 **Configure Login**。
设备将引导进入正常模式。Launcher 会自动检测 UART 连接并显示 **UART Connection Status: Connected**。点击 **Sign In to Device**。
## 步骤 7：设置 Wi-Fi
**SSH Access** 界面会显示可用的 Wi-Fi 网络。
* 从列表中选择一个网络，或点击 **+ Add network** 手动输入凭据。
* 点击 **Configure Wi-Fi**。
设备将连接到该网络。
## 步骤 8：设置完成
配置好 Wi-Fi 后，Launcher 会显示 **Configuration Summary**，其中包含设备 IP 地址和可直接复制的 SSH 命令。设备会重启一次以应用刷写后的配置。
现在您可以使用默认凭据（`root` / `oelinux123`）直接通过 SSH 登录设备：
```shell theme={null}
ssh root@
```
如果 Qualcomm Launcher 在您的主机上无法运行或未检测到设备，请使用[**使用 QDL 刷写 Qualcomm Linux**](./flash-over-qli)作为替代方案。
## 后续步骤
* [**设置设备**](../set-up-the-device)。如果您跳过了上述 UART/Wi-Fi 设置，请按照该页中的手动说明操作。