> ## 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 Linux 后,连接串行控制台,验证软件版本,然后选择 USB(ADB)、Wi-Fi 或以太网,在 IQ-8275 EVK 上建立主机到设备的持续连接。

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

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

<Note>
  如果您**尚未**烧录设备,请先阅读[**更新软件**](./update-software/overview)。
</Note>

## 设置调试 UART

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

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

<img src="https://mintcdn.com/qualcomm-prod/Nk4BLiVahY8YQrsL/Linux/images/device-setup/iq8275-platform-with-cables-plugged-in.png?fit=max&auto=format&n=Nk4BLiVahY8YQrsL&q=85&s=5c7f08cb432e0fb85ae5df434a7bb25c" alt="Micro-USB 端口位置" width="1114" height="900" data-path="Linux/images/device-setup/iq8275-platform-with-cables-plugged-in.png" />

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

<Tabs>
  <Tab title="Ubuntu">
    安装 `screen`:

    ```shell theme={null}
    sudo apt update
    sudo apt install screen
    ```

    列出串行设备:

    ```shell theme={null}
    ls /dev/ttyUSB*
    ```

    **示例输出:**

    ```shell theme={null}
    /dev/ttyUSB0  /dev/ttyUSB1  /dev/ttyUSB2  /dev/ttyUSB3
    ```

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

    ```shell theme={null}
    sudo screen /dev/ttyUSB1 115200
    ```
  </Tab>

  <Tab title="Windows">
    1. 下载 [**PuTTY**](https://putty.software/) 并完成安装。
    2. 打开 PuTTY 并选择 **Serial**。
    3. 将 **Serial line** 设置为**设备管理器**中检测到的 COM 端口,速度设置为 **115200**。

    <Note>
      FTDI 适配器会暴露多个 COM 端口。Converter B(**第二个**功能端口)对应主域控制台。右键单击每个 COM 端口 → **属性** → 查看 **Location** 字段来识别它。
    </Note>

    如果未检测到 UART 端口,请安装 FTDI 驱动:

    * x86 和 Arm:[FTDI VCP 驱动](https://ftdichip.com/drivers/vcp-drivers/)

          <img src="https://mintcdn.com/qualcomm-prod/T1k4QQ7G3l_dE-rX/Linux/images/device-setup/Putty_serialport_setup.png?fit=max&auto=format&n=T1k4QQ7G3l_dE-rX&q=85&s=3fa840a98481753b0a079b255eb8df6f" alt="PuTTY 串口设置" width="445" height="425" data-path="Linux/images/device-setup/Putty_serialport_setup.png" />
  </Tab>

  <Tab title="macOS">
    列出串行设备:

    ```shell theme={null}
    ls /dev/cu.*
    ```

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

    ```shell theme={null}
    screen /dev/cu.usbserial-DM03SDQQ 115200
    ```
  </Tab>
</Tabs>

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

## 验证软件版本

确认设备正在运行 Qualcomm Linux:

```shell theme={null}
cat /etc/os-release
```

**预期输出:**

```text theme={null}
ID=qcom-distro-sota
NAME="Qualcomm Linux Reference Distro(OTA-enabled)"
VERSION="2.0"
PRETTY_NAME="Qualcomm Linux Reference Distro (OTA-enabled) 2.0"
```

检查内核版本:

```shell theme={null}
uname -a
```

**预期输出:**

```text theme={null}
Linux iq-8275-evk 6.18.30-... #1 SMP PREEMPT ... aarch64 GNU/Linux
```

<Note>
  如果版本不匹配,或者根本无法进入登录提示符,说明镜像缺失或过期。请返回[**更新软件**](./update-software/overview)并烧录最新的 Qualcomm Linux。
</Note>

## 连接到设备

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

<Tabs>
  <Tab title="USB(ADB)">
    ADB(Android 调试桥)为您提供进入设备的 USB shell。由于 `adbd` 默认被禁用,您需要先通过 UART 启用它一次,ADB 才能工作。

    **1. 在主机上安装 ADB:**

    ```shell theme={null}
    sudo apt install android-tools-adb android-tools-fastboot
    ```

    验证:

    ```shell theme={null}
    adb --version
    ```

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

    ```shell theme={null}
    touch /etc/usb-debugging-enabled
    systemctl enable --now android-tools-adbd
    ```

    **3. 连接并打开 shell:**

    将 USB Type-C 线缆从主机连接到设备。

    <img src="https://mintcdn.com/qualcomm-prod/Nk4BLiVahY8YQrsL/Linux/images/device-setup/iq8275-platform-with-cables-plugged-in.png?fit=max&auto=format&n=Nk4BLiVahY8YQrsL&q=85&s=5c7f08cb432e0fb85ae5df434a7bb25c" alt="USB Type-C 端口位置" width="1114" height="900" data-path="Linux/images/device-setup/iq8275-platform-with-cables-plugged-in.png" />

    ```shell theme={null}
    adb devices
    adb shell
    ```

    **示例输出:**

    ```text theme={null}
    List of devices attached
    68f592a device
    ```
  </Tab>

  <Tab title="Wi-Fi">
    **1. 连接到 Wi-Fi 网络**(通过 UART 控制台):

    ```shell theme={null}
    nmcli dev wifi list
    nmcli dev wifi connect <WiFi-SSID> password <WiFi-password>
    ```

    **示例** — 网络 `QualcommWiFi`,密码 `1234567890`:

    ```shell theme={null}
    nmcli dev wifi connect QualcommWiFi password 1234567890
    ```

    **示例输出:**

    ```text theme={null}
    Device 'wlp1s0' successfully activated with 'd7b990bd-3b77-4b13-b239-b706553abaf8'.
    ```

    **2. 获取设备 IP 地址:**

    ```shell theme={null}
    ip addr show wlp1s0
    ```

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

    ```shell theme={null}
    ssh root@<ip-address>
    ```

    在提示时输入密码 `oelinux123`。
  </Tab>

  <Tab title="以太网">
    使用以太网线缆将 EVK 上的 RJ45 端口连接到网络路由器。套件中不包含以太网线缆。

    **1. 获取设备 IP 地址**(通过 UART 控制台):

    ```shell theme={null}
    ip addr show end0
    ```

    输出中 `inet` 的值即为设备 IP 地址。

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

    ```shell theme={null}
    ssh root@<ip-address>
    ```

    **示例:**

    ```shell theme={null}
    ssh root@192.168.0.222
    ```

    在提示时输入密码 `oelinux123`。
  </Tab>
</Tabs>

## 连接显示器

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

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

<img src="https://mintcdn.com/qualcomm-prod/T1k4QQ7G3l_dE-rX/Linux/images/device-setup/Miniport_to_displayport_cable.png?fit=max&auto=format&n=T1k4QQ7G3l_dE-rX&q=85&s=285ec9ebb8289506838eabcf0f1deb3b" alt="Mini-DisplayPort 转 DisplayPort 线缆" width="849" height="926" data-path="Linux/images/device-setup/Miniport_to_displayport_cable.png" />

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

## 连接蓝牙外设

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

1. 打开蓝牙管理器:

   ```shell theme={null}
   bluetoothctl
   ```

2. 开启电源并开始扫描:

   ```shell theme={null}
   power on
   scan on
   ```

3. 等待您的设备出现并记下其 MAC 地址:

   ```text theme={null}
   [NEW] Device F8:7D:76:9D:9B:6B MyKeyboard
   ```

4. 配对、信任并连接:

   ```shell theme={null}
   pair F8:7D:76:9D:9B:6B
   trust F8:7D:76:9D:9B:6B
   connect F8:7D:76:9D:9B:6B
   ```

5. 停止扫描并退出:

   ```shell theme={null}
   scan off
   exit
   ```

设备在未来启动时会自动重新连接。有关 Wi-Fi 和蓝牙的完整详细信息,请参阅 [**Wi-Fi 和蓝牙**](./peripherals-interfaces/WiFi-BT)。

## SBC(单板计算机)模式

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

<img src="https://mintcdn.com/qualcomm-prod/T1k4QQ7G3l_dE-rX/Linux/images/device-setup/iq9075_evk_sbc.png?fit=max&auto=format&n=T1k4QQ7G3l_dE-rX&q=85&s=64ab3cc225e01edb8ea8f6f4bc234b7b" alt="SBC 连接示例" width="714" height="536" data-path="Linux/images/device-setup/iq9075_evk_sbc.png" />

* \*\*电源:\*\*连接 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 的频率和特性配置 |

<Note>
  **注意**

  此功能仅适用于**预生产环境**。所有生产设备上必须将其禁用(`0`)。
</Note>

**使用方法**

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

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

### 步骤 2:找到 `OEM_softsku_sim_config` 属性

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

```xml theme={null}
<props name="OEM_softsku_sim_config" type=DALPROP_ATTR_TYPE_UINT32>
  0
</props>
```

### 步骤 3:启用 AC SKU 模拟

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

```xml theme={null}
<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。](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。](https://dragonwingdocs.qualcomm.com/Key-Documents/Flash-Guide/flash-with-qdl。)

**禁用模拟(生产环境)**

要禁用模拟并恢复正常的硬件 SKU 检测,请将属性设置回 `0`:

```xml theme={null}
<props name="OEM_softsku_sim_config" type=DALPROP_ATTR_TYPE_UINT32>
  0
</props>
```

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

**重要提示**

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

## 后续步骤

* [了解外设和接口](./peripherals-interfaces/peripheral_interface_overview)