> ## 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 刷写 Qualcomm Linux
> 使用 Qualcomm Launcher GUI 工具,从任意主机操作系统下载 Qualcomm Linux 并将其刷写到 IQ-8275 EVK。
**Qualcomm® Launcher** 是一款图形化工具,负责将操作系统镜像下载并刷写到 Qualcomm 开发套件。它可在 **Windows、Linux 和 macOS** 上运行,无需任何命令行设置。该工具端到端地管理镜像下载和刷写过程。
如果您偏好 GUI 工作流,请使用此方法。如果您需要完全控制或正在编写自动化设置脚本,请改用 [**使用 QDL 刷写 Qualcomm Linux**](./flash-over-qli)。
刷写会清除设备上的所有数据。开始之前请备份所有重要内容。
## 所需材料
* IQ-8275 EVK 及 12 V 电源
* 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**。
设备启动进入正常模式。您可以通过以下方式确认它**不**在 EDL 模式:
* Qualcomm Launcher 不再显示设备处于 EDL 检测状态。
* Launcher 中的串行终端开始显示启动日志。
启动完成后,Launcher 会显示 **UART Connection Status: Connected**。输入并确认设备的**新密码**,然后点击 **Sign In to Device**。
设备启动进入正常模式。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 设置,请按照那里的手动说明操作。