> ## 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-9075 EVK。
**Qualcomm® Launcher** 是一款图形化工具，负责将操作系统镜像下载并烧录到 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 端口不足时集线器也很有帮助。如果您计划将开发板作为 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-9075 Evaluation Kit**。
## 步骤 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 Extension**（面向 Qualcomm 开发套件的集成开发环境）在 IQ-9075 EVK 上创建 AI 和多媒体应用。该扩展可在 Ubuntu（或带 Ubuntu 的 WSL）上运行，可协助进行设备配置以及包括编译、调试和二进制烧录在内的软件开发。
有关更多信息，请参阅 [**Qualcomm Visual Studio Code Extension 参考指南**](https://docs.qualcomm.com/bundle/publicresource/topics/80-79972-1/quick_start.html)。