> ## 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 刷写 Ubuntu
> 使用 Qualcomm Launcher GUI 工具从任何主机操作系统下载并刷写 Ubuntu 到 IQ-9075 EVK。
**Qualcomm® Launcher** 是一款图形化工具，可处理将 OS 映像下载并刷写到 Qualcomm 开发工具包的过程。它运行于 **Windows、Linux 和 macOS**，无需命令行设置。该工具端到端管理映像下载和刷写过程。
如果您偏好 GUI 工作流，请使用此方法。如果您需要完全控制或正在编写自动化设置脚本，请使用[**使用 QDL 刷写 Ubuntu**](./flash-using-qdl)。
刷写会擦除设备上的所有数据。开始之前请备份任何重要内容。
## 您需要什么
* IQ-9075 EVK 及 12 V 电源适配器
* USB Type-C 电缆（EVK 上的 USB0 端口 → 主机计算机）
* Micro-USB 电缆（用于刷写后的 UART 设置步骤）
* 运行 Windows、Linux 或 macOS 的主机计算机
* 带电源的 USB 集线器（推荐）：EVK 的两个 Type-C 端口 (USB0, USB1) 紧挨在一起，如果您的主机 USB 端口不足，集线器也会有帮助。如果您计划将该板用作带键盘、鼠标和其他 USB 外设的 SBC，则需要此设备。
## 第 1 步：安装 Qualcomm Launcher
1. 前往 Qualcomm Software Center：[**https://softwarecenter.qualcomm.com/catalog/item/Qualcomm\_Launcher**](https://softwarecenter.qualcomm.com/catalog/item/Qualcomm_Launcher)
2. 选择与您的主机匹配的 **OS 类型**和**架构**。
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 步：选择您的开发套件
在**选择 OS**屏幕上，单击**选择开发套件**，然后从列表中选择 **IQ-9075 Evaluation Kit**。
## 第 3 步：选择 OS 映像
选择套件后，**选择 OS**屏幕将显示操作系统选项。
1. 在**目标操作系统**下，选择 **Ubuntu** 卡片。
2. 使用 **Variant** 下拉菜单选择映像类型（**Ubuntu Server** 或 **Ubuntu Desktop**），然后使用 **Version** 下拉菜单选择版本。（如需刷写本地构建的映像，请使用 **Custom → Select Folder**。）
3. 将**下载位置**保留为默认值，或选择一个有足够空间的自定义文件夹。
## 第 4 步：将设备置于 EDL 模式
紧急下载 (EDL) 模式告诉设备通过 USB 接受新的固件映像。在检测到设备之前，**选择 OS**屏幕会显示*未检测到兼容设备*，并且**刷写**按钮保持禁用状态。
1. 通过将 SW2-3 DIP 开关向上推来**打开**它。
2. 将 **12 V 电源**连接到 EVK。
3. 将 **USB Type-C 电缆**从 EVK 上的 **USB0** 连接到您的主机计算机。
4. 切换**电源开关**以打开设备。
一旦设备在 EDL 模式下枚举，**刷写**按钮就会激活。
## 第 5 步：刷写
单击**刷写**按钮。Launcher 首先下载 OS 映像，然后分两个阶段刷写设备。
**第 1 阶段：附加固件。** Launcher 配置 UFS 存储并写入 CDT，然后进入 OS 映像。此阶段完成后，它会暂停并要求您将设备重新置于 EDL 模式：
SW2-3 DIP 开关仍处于向上位置，因此只需**关闭再打开电源开关**即可。设备重新进入 EDL 模式，Launcher 自动继续。
**第 2 阶段：OS 映像。** Launcher 下载操作系统映像并将其写入设备。在整个过程中保持电源和 USB 连接。
如果 Launcher 似乎挂起等待设备，请关闭再打开电源开关；它将重新连接并继续。
刷写完成时，状态显示 **OS image Flash completed successfully**，**Configure Login** 按钮变为激活状态。
## 第 6 步：配置登录
Launcher 可以自动引导您完成串口和网络设置。您可以在此完成此步骤，也可以跳过并按照[**设置设备**](../set-up-the-device)中的手动说明操作。
**要使用 Launcher 继续：**
1. 通过将 **SW2-3 DIP 开关**向**下**推来关闭它。将开关向下推后，设备将正常启动进入 OS 而不是进入 EDL 模式。
2. 将 **micro-USB 电缆**从 EVK 上的 **micro-USB (调试) 端口**连接到您的主机计算机。
3. 给设备重新加电（使用电源开关关闭，然后打开）。
4. 单击**配置登录**。
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 会显示带有设备 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 Extension** 在 IQ-9075 EVK 上创建 AI 和多媒体应用程序，这是一个用于 Qualcomm 开发套件的集成开发环境。该扩展在 Ubuntu（或带 Ubuntu 的 WSL）上运行，可促进设备配置、软件开发（包括编译、调试和二进制刷写）。
有关更多信息，请参阅 [**Qualcomm Visual Studio Code Extension Reference Guide**](https://dragonwingdocs-staging.qualcomm.com/Tools/QVSCE/introduction)。