设置设备 - Qualcomm Dragonwing Documentation

在烧录 Qualcomm Linux 之后,使用本页面来启动设备。首先通过调试串行控制台登录并验证软件版本。之后,根据您的环境选择以下连接方式之一:

选项	适用场景
USB(ADB)	无可用网络;主机通过 USB 线缆直接连接设备
Wi-Fi	无线访问;通过网络 SSH 连接设备
以太网	有线网络访问;通过网络 SSH 连接设备

如果您尚未烧录设备,请先阅读更新软件。

设置调试 UART

调试 UART 为您提供进入设备的串行控制台,是烧录后登录和检查设备的主要方式。

将 micro-USB 线缆的一端连接到 IQ-8275 EVK 上的 micro-USB 端口。
将另一端连接到主机计算机。

根据主机操作系统打开串行控制台:

Ubuntu
Windows
macOS

安装 screen:

sudo apt update
sudo apt install screen

列出串行设备:

ls /dev/ttyUSB*

示例输出:

/dev/ttyUSB0  /dev/ttyUSB1  /dev/ttyUSB2  /dev/ttyUSB3

IQ-8275 EVK 的板载适配器会暴露四个串行设备;主控制台是第二个(/dev/ttyUSB1)。以 115200 波特率打开:

sudo screen /dev/ttyUSB1 115200

列出串行设备:

ls /dev/cu.*

找到您的设备节点(例如 /dev/cu.usbserial-DM03SDQQ),并以 115200 波特率打开:

screen /dev/cu.usbserial-DM03SDQQ 115200

按 Enter 调出登录提示符,然后登录:
- 用户名:root
- 密码:oelinux123

验证软件版本

确认设备正在运行 Qualcomm Linux:

cat /etc/os-release

预期输出:

ID=qcom-distro-sota
NAME="Qualcomm Linux Reference Distro(OTA-enabled)"
VERSION="2.0"
PRETTY_NAME="Qualcomm Linux Reference Distro (OTA-enabled) 2.0"

检查内核版本:

uname -a

预期输出:

Linux iq-8275-evk 6.18.30-... #1 SMP PREEMPT ... aarch64 GNU/Linux

如果版本不匹配,或者根本无法进入登录提示符,说明镜像缺失或过期。请返回更新软件并烧录最新的 Qualcomm Linux。

连接到设备

从以下选项中选择一种。三种方式都需要通过 UART 控制台执行初始设置命令(参见设置调试 UART)。首次设置后,USB(ADB)可提供直接的 USB shell;Wi-Fi 和以太网则可通过 SSH 连接。

USB(ADB)
Wi-Fi
以太网

ADB(Android 调试桥)为您提供进入设备的 USB shell。由于 adbd 默认被禁用,您需要先通过 UART 启用它一次,ADB 才能工作。1. 在主机上安装 ADB:

sudo apt install android-tools-adb android-tools-fastboot

验证:

adb --version

2. 在设备上启用 adbd(一次性,通过 UART 控制台):

touch /etc/usb-debugging-enabled
systemctl enable --now android-tools-adbd

3. 连接并打开 shell:将 USB Type-C 线缆从主机连接到设备。

adb devices
adb shell

示例输出:

List of devices attached
68f592a device

1. 连接到 Wi-Fi 网络(通过 UART 控制台):

nmcli dev wifi list
nmcli dev wifi connect <WiFi-SSID> password <WiFi-password>

示例 — 网络 QualcommWiFi,密码 1234567890:

nmcli dev wifi connect QualcommWiFi password 1234567890

示例输出:

Device 'wlp1s0' successfully activated with 'd7b990bd-3b77-4b13-b239-b706553abaf8'.

2. 获取设备 IP 地址:

ip addr show wlp1s0

3. 从主机 SSH 连接(必须在同一网络):

ssh root@<ip-address>

在提示时输入密码 oelinux123。

使用以太网线缆将 EVK 上的 RJ45 端口连接到网络路由器。套件中不包含以太网线缆。1. 获取设备 IP 地址(通过 UART 控制台):

ip addr show end0

输出中 inet 的值即为设备 IP 地址。2. 从主机 SSH 连接(必须在同一网络):

ssh root@<ip-address>

示例:

ssh root@192.168.0.222

在提示时输入密码 oelinux123。

连接显示器

使用有源 Mini DisplayPort 转 DisplayPort 线缆(包装内附带)或有源 Mini DisplayPort 转 HDMI 适配器(不包含),将显示器连接到 EVK 上的 DisplayPort0(JEDP0) 或 JEDP1。

显示输出仅通过 DisplayPort 连接器工作。USB Type-C 端口没有显示输出。

为设备上电并确认显示器显示预期的启动画面。

连接蓝牙外设

使用 bluetoothctl 配对并连接蓝牙键盘或鼠标。

打开蓝牙管理器:
bluetoothctl
开启电源并开始扫描:
power on scan on
等待您的设备出现并记下其 MAC 地址:
[NEW] Device F8:7D:76:9D:9B:6B MyKeyboard

配对、信任并连接:

pair F8:7D:76:9D:9B:6B
trust F8:7D:76:9D:9B:6B
connect F8:7D:76:9D:9B:6B

停止扫描并退出:
scan off exit

设备在未来启动时会自动重新连接。有关 Wi-Fi 和蓝牙的完整详细信息,请参阅 Wi-Fi 和蓝牙。

SBC(单板计算机)模式

要将 EVK 作为带键盘、鼠标和显示器的独立计算机使用:

**电源:**连接 12 V 适配器。
**串行控制台:**通过 micro-USB 连接到主机以获取 UART 日志(设置完成后可选)。
**USB 集线器:**将带电源的 USB 集线器连接到 USB Type-C 端口,以支持多个外设。
**键盘和鼠标:**插入 USB 集线器。
**USB 摄像头:**连接到 USB 集线器(必须符合 UVC 标准)。
**MIPI 摄像头:**连接到板上的 MIPI CSI 连接器。
**显示器:**Mini DisplayPort 转 DisplayPort 线缆,或有源 Mini DisplayPort 转 HDMI 适配器。

IQ8275-AC(20 TOPS)模拟

AC SKU 模拟功能允许 IQ8275 AA SKU 硬件平台以 IQ8275 AC SKU 的频率和特性配置运行。通过 QTEE devcfg 文件中的单个 OEM 配置属性即可启用该模拟 — 无需修改固件源码,也无需重新构建 TZ 核心组件。 何时使用此功能:

在 AC SKU 芯片可用之前,在 AA SKU 硬件板上进行 IQ8275 AC SKU 软件的启动调试和验证。
在预生产环境中测试 AC SKU 的频率和特性配置。

支持的模拟:

模拟	属性值	说明
禁用(默认)	`0`	硬件 SKU 检测 — 正常生产行为
IQ8275 AC SKU	`3`	在 AA 硬件上应用 IQ8275 AC 的频率和特性配置

注意此功能仅适用于预生产环境。所有生产设备上必须将其禁用(0)。

使用方法

步骤 1:打开 OEM 配置文件

trustzone_images/ssg/securemsm/trustzone/qsee/mink/oem/config/monaco/oem_config.xml

步骤 2:找到 `OEM_softsku_sim_config` 属性

该属性位于 /tz/oem 设备节点下:

<props name="OEM_softsku_sim_config" type=DALPROP_ATTR_TYPE_UINT32>
  0
</props>

步骤 3:启用 AC SKU 模拟

将值从 0 更改为 3 以启用 IQ8275 AC SKU 模拟:

<props name="OEM_softsku_sim_config" type=DALPROP_ATTR_TYPE_UINT32>
  3
</props>

步骤 4:重新构建并烧录

为 IQ8275 重新构建 DevCfg 镜像并烧录到目标板:

Build cmd: python3 trustzone_images/build/ms/build_all.py CHIPSET=monaco devcfg_iot

DevCfg 镜像的构建说明请参阅 https://dragonwingdocs.qualcomm.com/System/Security/enable-device-configurations-from-qualcomm-tee。烧录更新后的 DevCfg 二进制文件: 更新后的 DevCfg 镜像可以使用 fastboot 命令烧录

fastboot flash devcfg_a trustzone_images/build/ms/bin/FAQAANAA/devcfg_iot.mbn

完整的构建烧录说明请参阅 https://dragonwingdocs.qualcomm.com/Key-Documents/Flash-Guide/flash-with-qdl。 禁用模拟(生产环境) 要禁用模拟并恢复正常的硬件 SKU 检测,请将属性设置回 0:

<props name="OEM_softsku_sim_config" type=DALPROP_ATTR_TYPE_UINT32>
  0
</props>

重新构建并重新烧录。如果文件中缺少该属性,驱动会自动默认为 0 — 不会应用任何模拟。 重要提示

**生产设备上必须将此属性设置为 0。**在生产硬件上启用模拟可能导致错误的频率/特性配置。
此功能仅适用于 IQ8275。本版本不支持其他平台。
本版本仅支持值 3(IQ8275 AC SKU)。其他非零值保留供未来版本使用,不会产生任何效果。

后续步骤

了解外设和接口

​设置调试 UART

​验证软件版本

​连接到设备

​连接显示器

​连接蓝牙外设

​SBC(单板计算机)模式

​IQ8275-AC(20 TOPS)模拟

​步骤 1:打开 OEM 配置文件

​步骤 2:找到 OEM_softsku_sim_config 属性

​步骤 3:启用 AC SKU 模拟

​步骤 4:重新构建并烧录

​后续步骤

设置调试 UART

验证软件版本

连接到设备

连接显示器

连接蓝牙外设

SBC(单板计算机)模式

IQ8275-AC(20 TOPS)模拟

步骤 1:打开 OEM 配置文件

步骤 2:找到 `OEM_softsku_sim_config` 属性

步骤 3:启用 AC SKU 模拟

步骤 4:重新构建并烧录

后续步骤