> ## 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 烧写 Ubuntu
> 使用 Qualcomm Launcher GUI 工具从任意主机操作系统下载并烧写 Ubuntu 到 IQ-8275 EVK。
**Qualcomm® Launcher** 是一款图形化工具，负责将操作系统镜像下载并烧写到 Qualcomm 开发套件。它可在 **Windows、Linux 和 macOS** 上运行，无需任何命令行设置。该工具端到端地管理镜像下载和烧写过程。
如果您偏好 GUI 工作流程，请使用此方法。如果您需要完全控制或正在编写自动化设置脚本，请改用[**使用 QDL 烧写 Ubuntu**](./flash-using-qdl)。
烧写会擦除设备上的所有数据。开始前请备份所有重要内容。
## 所需物品
* 带 12 V 电源的 IQ-8275 EVK
* USB Type-C 线缆（EVK 上的 USB0 端口 → 主机计算机）
* Micro-USB 线缆（用于烧写后的 UART 设置步骤）
* 运行 Windows、Linux 或 macOS 的主机计算机
* 带供电的 USB 集线器（推荐）：EVK 的两个 Type-C 端口（USB0、USB1）位置很近，如果主机 USB 端口不足，集线器也很有帮助。如果您打算将板卡作为 SBC 使用并连接键盘、鼠标和其他 USB 外设，则需要它。
## 步骤 1：安装 Qualcomm Launcher
1. 前往 Qualcomm Software Center：[**https://softwarecenter.qualcomm.com/catalog/item/Qualcomm\_Launcher**](https://softwarecenter.qualcomm.com/catalog/item/Qualcomm_Launcher)
2. 选择与您主机匹配的**操作系统类型**和**架构**。
3. 下载最新版本并运行安装程序。
安装完成后，打开 **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 会自动检测设备。
## 步骤 2：选择您的开发套件
在 **Choose OS** 界面上，点击 **Select Development Kit**，然后从列表中选择 **IQ-8275 Evaluation Kit Pro**。
## 步骤 3：选择操作系统镜像
选择套件后，**Choose OS** 界面会显示操作系统选项。
1. 在 **Target Operating System** 下，选择 **Ubuntu** 卡片。
2. 保持 **Official** 选中，并从两个下拉菜单中选择镜像（**Ubuntu Server** 或 **Ubuntu Desktop**）和最新可用版本。（若要烧写本地构建的镜像，请使用 **Custom → Select Folder**。）
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 上的 **JTAC** 端口连接到您的主机计算机。
3. 对设备断电重启（使用电源开关关闭再打开）。
4. 点击 **Configure Login**。
Launcher 检测到串口连接并显示 **UART Connection Status: Connected**。为设备输入并确认**新密码**，然后点击 **Sign In to Device**。
此流程会用您在此处设置的密码替换默认的 `ubuntu` / `ubuntu` 凭据。请记住它；您将使用它通过 SSH 登录设备。
## 步骤 7：设置 Wi-Fi
**SSH Access** 界面显示可用的 Wi-Fi 网络。
* 从列表中选择一个网络，或点击 **+ Add network** 手动输入凭据。
* 点击 **Configure Wi-Fi**。
设备连接到网络。
## 步骤 8：设置完成
Wi-Fi 配置完成后，Launcher 显示 **Configuration Summary**，其中包含设备 IP 地址和可直接复制的 SSH 命令。设备将重启一次以应用烧写后的配置。
您现在可以使用在步骤 6 中设置的密码直接 SSH 登录设备：
```shell theme={null}
ssh ubuntu@
```
如果 Qualcomm Launcher 在您的主机上无法运行或无法检测到设备，请使用[**使用 QDL 烧写 Ubuntu**](./flash-using-qdl)作为替代方案。
## 后续步骤
成功设置 Wi-Fi 后，选择以下路径之一以安装其他驱动并进行应用开发：
继续前往[**设置设备**](../set-up-the-device)以验证软件版本、通过 SSH 连接并设置显示。
您可以使用 **Qualcomm® Visual Studio Code 扩展**（一个面向 Qualcomm 开发套件的集成开发环境）在 IQ-8275 EVK 上创建 AI 和多媒体应用。该扩展在 Ubuntu（或带 Ubuntu 的 WSL）上运行，可帮助进行设备配置和软件开发，包括编译、调试和二进制文件烧写。
有关更多信息，请参阅 [**Qualcomm Visual Studio Code 扩展参考指南**](https://docs.qualcomm.com/bundle/publicresource/topics/80-79972-1/quick_start.html)。