> ## 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® 开发套件 — 通过 ADB 或 SSH 激活、烧录和通信。
## 连接设备
扩展支持两种连接协议：
通过 USB 的标准 Android Debug Bridge 连接。设备必须已连接，且必须已配置 [udev 规则](../setup/udev-rules)。
基于网络的连接。Qualcomm Linux 和 Ubuntu 均支持。可通过 IP 地址添加任何设备 — 适用于无头设置或同一网络中的设备。
## 可用设备
将设备插入主机后，它会显示在 **Available Devices** 部分，并附带开发套件类型、序列号、连接状态和模式（USB、WiFi 等）等元数据。
## 激活设备
1. 打开 **Dashboard → Devices** 部分。
2. 在 **Available Devices** 列表中找到您的设备。
3. 点击 **Activate**。
激活的设备成为**活动设备** — 即构建、部署、烧录和调试会话的目标。它会显示连接模式（ADB 或 EDL）和可用的示例应用程序。
同一时间只能有一个设备处于活动状态。切换活动设备会自动将所有构建和部署操作重新定位到新目标。
## 设备连接 — WiFi
要将设备连接到 WiFi，请从活动设备窗格打开连接选项菜单。
扩展会列出按信号强度排序的可用 WiFi 网络。
选择一个网络并输入凭据。连接后，连接状态会显示在设备旁边。
## 通过 IP 地址添加设备（SSH）
1. 在 Devices 部分，点击 **Add Device**。
2. 输入设备 IP 地址。
3. 选择 **SSH** 作为连接方式。
4. 点击 **Connect**。
## SSH 设置
Ubuntu 和 Qualcomm Linux 设备均支持 SSH 连接。您需要：
* 目标设备已开机且可通过网络访问
* 主机上已安装 SSH 客户端
* 两台机器位于同一网络
### 设备设置
获取设备的 IP 地址和用户名：
```bash theme={null}
ip addr show # Ubuntu devices via UART
adb shell ip addr show # QLI devices via ADB
```
默认用户名：**ubuntu**（Ubuntu 操作系统）或 **root**（Qualcomm Linux）。
### 扩展配置
导航到 Devices 页面，点击 **Connect device via SSH** 按钮打开对话框。
有两个选项卡：
**Generate New SSH Key** — 在主机上创建新的密钥对：
* **SSH Key Name** — 生成的密钥文件的名称
* **SSH Key Folder** — 保存密钥的目录（默认为 `~/.ssh`）
* **Private SSH Key Passphrase** — 可选的密码短语
* **Device Identifier** — 输入 IP 地址（例如 `10.92.162.215`）或设备名称（例如 `mydevice.local`）
* **Device Username** — 设备上的用户名（例如 `ubuntu`）
* **Device Password** — 设备密码（用于复制公钥）
* **Port** — `22`（默认）
点击 **Create and Connect** 生成密钥、将其复制到设备并建立连接。
**Use Existing SSH Key** — 使用主机上已有的密钥连接：
* **Private SSH Key File Path** — 您现有私钥的路径（例如 `~/.ssh/my-ssh`）
* **Private SSH Key Passphrase** — 可选的密码短语
* **Device Identifier** — IP 地址或设备名称
* **Device Username** — 设备上的用户名
* **Device Password** — 设备密码
* **Port** — `22`（默认）
点击 **Connect** 建立 SSH 连接。
成功的连接如下所示：
激活设备以将其设置为活动目标：
## 烧录设备软件
前往 **Dashboard → Downloads → Device Software 选项卡**。
选择与您的开发套件和操作系统匹配的固件镜像。
点击镜像旁的 **Flash** 按钮。
\*\*烧录期间请勿断开设备连接。\*\*烧录中断可能导致设备不稳定。恢复可能需要多次重新上电 + 手动进入 EDL + 重新烧录。
如果烧录失败，请确认设备处于 EDL 模式：
```bash theme={null}
lsusb
```
查找以下内容：
```text theme={null}
Bus 002 Device 002: ID 05c6:9008 Qualcomm, Inc. Gobi Wireless Modem (QDL mode)
```
## Ubuntu 设备设置
对于运行 Ubuntu 操作系统的 Rubik Pi 和 IQ-9075 EVK 设备，烧录后请按以下步骤操作：
1. 在 Dashboard 中，导航到 **Operating Systems** 选项卡并点击 **Flash** 开始烧录操作系统镜像。对话框会引导您查看 EDL 模式说明。
2. 设备进入 EDL 模式后，它会显示在 Available Devices 部分。激活它，然后返回 Dashboard 并点击 **Flash**。
3. 烧录完成且设备显示为 **Active** 后，点击 Downloads 部分中的 **SDKs** 选项卡，为设备配置所有必需的软件包（约需 15–20 分钟）。
如果烧录失败，设备可能需要恢复。烧录期间请勿断开设备连接。
### UFS 配置
如果遇到 UFS 相关问题，请查阅针对您特定硬件的配置指南：
### CDT 配置
某些硬件配置可能需要自定义设备树（CDT）配置：
## 更改 Overlay 配置
**Change Overlay Configuration** 功能可让您在 Qualcomm 开源实现与 Qualcomm 专有实现之间切换活动设备上各硬件子系统的软件 overlay 栈。这在评估开源驱动、测试专有优化栈或复现特定软件路径的问题时非常有用。
仅支持运行 **Qualcomm Linux 2.0** 的设备。仅作用于当前**活动**设备。应用更改前请确保已将正确的设备设置为活动设备。
### 访问该功能
**Change Overlay Configuration** 选项位于 Dashboard 中活动设备卡片上的三点溢出菜单（⋮）中。
1. 打开 **Dashboard** 并找到 **Active Device** 部分。
2. 点击活动设备卡片右侧的 **⋮**（更多选项）按钮。
3. 从下拉菜单中选择 **Change Overlay Configuration**。
### 配置对话框
对话框显示当前运行的操作系统以及一个包含三列的表格：
| 列 | 描述 | 示例值 |
| ------------------------ | --------------------------- | ---------------------------------------------------------- |
| **Overlay** | 正在配置的硬件子系统 | Graphics、Video、Camera、Audio、Sensors |
| **Qualcomm Open Source** | 开源驱动/栈。点击可选择。短横线（–）表示无可用选项。 | Freedreno Graphics、Video、Libcamera Camera、ASoC Audio |
| **Qualcomm Proprietary** | Qualcomm 优化的专有栈。点击可选择。 | Adreno Graphics、Video、CamX Camera、AudioReach Audio、Sensors |
每行当前激活的选项会以可视方式高亮显示。
**可用的 overlay 行：**
* **Graphics** — *Freedreno*（开源 Mesa/DRM）与 *Adreno*（Qualcomm 专有 GPU 驱动）
* **Video** — 开源与 Qualcomm 专有视频栈
* **Camera** — *Libcamera*（开源）与 *CamX*（Qualcomm 专有管线）
* **Audio** — *ASoC*（Linux ALSA/ASoC）与 *AudioReach*（Qualcomm 专有音频）
* **Sensors** — 无开源选项（显示为 –）；仅有 Qualcomm 专有栈
表格底部的**批量选择快捷方式**：
* **All Qualcomm Open Source** — 将每个可配置的 overlay 设置为其开源变体
* **All Qualcomm Proprietary** — 将每个可配置的 overlay 设置为其 Qualcomm 专有变体
### 应用配置
完成选择后，点击右下角的 **Apply Configuration**。对话框关闭，扩展开始将 overlay 应用到设备。
活动设备卡片会立即显示进度条：
此步骤进行期间，请勿断开设备连接或关闭 VS Code。
根据更改的 overlay 数量和网络状况，此过程可能需要几分钟。
### 应用后的状态
\*\*成功：\*\*设备卡片以绿色显示 **Overlay configuration applied successful**，并恢复为 **Active – SSH**（或 **Active – ADB**）状态。通知确认：*Overlay configuration applied successfully.*
overlay 应用成功后，设备可能会自动重启。如果重启，设备会从活动设备卡片中消失。请通过 SSH 重新连接，并在 Available Devices 部分重新激活它。要验证已应用哪些 overlay，请从 ⋮ 菜单重新打开 **Change Overlay Configuration** 对话框。
\*\*应用失败：\*\*如果安装后无法验证 overlay，设备卡片会以红色显示 **Overlay apply failed**：
弹出通知会提供更多详细信息：*Overlay installation successful! Failed to verify Overlay(s).*
## 验证设备处于 EDL 模式
```bash theme={null}
lsusb
```
处于 EDL / QDL 模式时的预期输出：
```text theme={null}
Bus 002 Device 002: ID 05c6:9008 Qualcomm, Inc. Gobi Wireless Modem (QDL mode)
```