连接设备
扩展支持两种连接协议：ADB
通过 USB 的标准 Android Debug Bridge 连接。设备必须已连接，且必须已配置 udev 规则。
SSH
基于网络的连接。Qualcomm Linux 和 Ubuntu 均支持。可通过 IP 地址添加任何设备 — 适用于无头设置或同一网络中的设备。
可用设备
将设备插入主机后，它会显示在 Available Devices 部分，并附带开发套件类型、序列号、连接状态和模式（USB、WiFi 等）等元数据。
激活设备
- 打开 Dashboard → Devices 部分。
- 在 Available Devices 列表中找到您的设备。
- 点击 Activate。
同一时间只能有一个设备处于活动状态。切换活动设备会自动将所有构建和部署操作重新定位到新目标。
设备连接 — WiFi
要将设备连接到 WiFi，请从活动设备窗格打开连接选项菜单。
通过 IP 地址添加设备（SSH）
- 在 Devices 部分，点击 Add Device。
- 输入设备 IP 地址。
- 选择 SSH 作为连接方式。
- 点击 Connect。
SSH 设置
Ubuntu 和 Qualcomm Linux 设备均支持 SSH 连接。您需要：- 目标设备已开机且可通过网络访问
- 主机上已安装 SSH 客户端
- 两台机器位于同一网络
设备设置
获取设备的 IP 地址和用户名：扩展配置
导航到 Devices 页面，点击 Connect device via SSH 按钮打开对话框。
- 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（默认）
- Private SSH Key File Path — 您现有私钥的路径（例如
~/.ssh/my-ssh） - Private SSH Key Passphrase — 可选的密码短语
- Device Identifier — IP 地址或设备名称
- Device Username — 设备上的用户名
- Device Password — 设备密码
- Port —
22（默认）
烧录设备软件
1
导航到 Downloads
前往 Dashboard → Downloads → Device Software 选项卡。
2
选择镜像
选择与您的开发套件和操作系统匹配的固件镜像。
3
点击 Flash
点击镜像旁的 Flash 按钮。
4
验证 EDL 模式（如果烧录失败）
如果烧录失败，请确认设备处于 EDL 模式：查找以下内容：
Ubuntu 设备设置
对于运行 Ubuntu 操作系统的 Rubik Pi 和 IQ-9075 EVK 设备，烧录后请按以下步骤操作：- 在 Dashboard 中，导航到 Operating Systems 选项卡并点击 Flash 开始烧录操作系统镜像。对话框会引导您查看 EDL 模式说明。
- 设备进入 EDL 模式后，它会显示在 Available Devices 部分。激活它，然后返回 Dashboard 并点击 Flash。
- 烧录完成且设备显示为 Active 后，点击 Downloads 部分中的 SDKs 选项卡，为设备配置所有必需的软件包（约需 15–20 分钟）。
UFS 配置
如果遇到 UFS 相关问题，请查阅针对您特定硬件的配置指南：
CDT 配置
某些硬件配置可能需要自定义设备树（CDT）配置：
更改 Overlay 配置
Change Overlay Configuration 功能可让您在 Qualcomm 开源实现与 Qualcomm 专有实现之间切换活动设备上各硬件子系统的软件 overlay 栈。这在评估开源驱动、测试专有优化栈或复现特定软件路径的问题时非常有用。仅支持运行 Qualcomm Linux 2.0 的设备。仅作用于当前活动设备。应用更改前请确保已将正确的设备设置为活动设备。
访问该功能
Change Overlay Configuration 选项位于 Dashboard 中活动设备卡片上的三点溢出菜单（⋮）中。- 打开 Dashboard 并找到 Active Device 部分。
- 点击活动设备卡片右侧的 ⋮（更多选项）按钮。
- 从下拉菜单中选择 Change Overlay Configuration。
配置对话框
对话框显示当前运行的操作系统以及一个包含三列的表格：
每行当前激活的选项会以可视方式高亮显示。
可用的 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 应用到设备。 活动设备卡片会立即显示进度条：
应用后的状态
**成功：**设备卡片以绿色显示 Overlay configuration applied successful，并恢复为 Active – SSH（或 Active – ADB）状态。通知确认：Overlay configuration applied successfully.
