> ## 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.

# 设置设备

> 烧写 Ubuntu 后，在 IQ-9075 EVK 上连接串行控制台、验证版本，并启用网络、SSH 和显示。

在[烧写 Ubuntu](./update-software/overview) 之后，使用本页内容将设备启动起来：连接调试串行控制台、验证软件版本、接入网络，并通过 SSH 和显示器进行连接。

<Note>
  如果你**尚未**烧写设备，请先从[**更新软件**](./update-software/overview)开始。
</Note>

## 为设备上电

* Dragonwing IQ-9075 板卡通过 2.10 mm 圆形电源插孔连接器（JPWR，JACK-C-PC-10A-RA(R)）接收主电源，支持 **12 V 至 36 V** 的输入电压范围。为方便使用，EVK 还附带了 Type-C 转圆形插头适配器。连接 +12 V 电源适配器为板卡供电。
* 将线缆的 USB Type-C 端连接到 **USB0**，另一端（Type-A 或 Type-C）连接到**主机设备**。此连接用于烧写软件。

## 设置调试 UART

调试 UART 显示诊断消息，并通过 UART shell 提供对设备的访问。设置调试 UART 的步骤如下：

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

<img src="https://mintcdn.com/qualcomm-prod/tRWO8v_Df_ujnDuD/Ubuntu/images/device-setup/iq9075-evk-microUSBport.png?fit=max&auto=format&n=tRWO8v_Df_ujnDuD&q=85&s=31ec49bd22b3ea6480aee19161087993" alt="Micro-USB 端口位置" width="926" height="709" data-path="Ubuntu/images/device-setup/iq9075-evk-microUSBport.png" />

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

<Tabs>
  <Tab title="Ubuntu 主机">
    运行以下命令在 Ubuntu 主机上安装 Screen 应用：

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

    运行以下命令验证 USB 端口连接：

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

    **示例输出：**

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

    IQ-9075 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>
      设备运行两个控制台域：**SAIL**（常开的安全与启动岛）和**主域（Main Domain）**（运行 Linux 的应用处理器，你在此登录）。你需要的是主域控制台。

      FTDI 适配器会暴露多个 COM 端口。Converter B（**第二个**功能端口）承载主域控制台。右键单击每个 COM 端口 → **属性** → 查看 **位置** 字段来识别。

      Converter A（ADBUS0:7）分配给 SAIL 调试 UART。Converter B（BDBUS0:7）承载主域 UART。
    </Note>

    在安装驱动之前，适配器通常出现在设备管理器的**其他设备**下（具体名称各异，例如 Qualcomm 命名的或未知设备），而不是在\*\*端口（COM 和 LPT）\*\*下。在此处右键单击设备以安装驱动。

    如果未检测到 UART 端口，请安装 FTDI 驱动：

    * x86：[USB 转 UART 串口驱动](https://ftdichip.com/wp-content/uploads/2023/09/CDM-v2.12.36.4-WHQL-Certified.zip)
    * Arm：[FTDI VCP 驱动](https://oemdrivers.com/usb-ft232r-usb-uart-arm64)

          <img src="https://mintcdn.com/qualcomm-prod/tRWO8v_Df_ujnDuD/Ubuntu/images/device-setup/Selection-of_correct-comport.png?fit=max&auto=format&n=tRWO8v_Df_ujnDuD&q=85&s=27c2d2275bc0e3e0e72dc86f0354e2a5" alt="COM 端口选择" width="667" height="624" data-path="Ubuntu/images/device-setup/Selection-of_correct-comport.png" />

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

  <Tab title="macOS 主机">
    列出串行设备：

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

    <img src="https://mintcdn.com/qualcomm-prod/tRWO8v_Df_ujnDuD/Ubuntu/images/device-setup/Mac_serial_port_details.png?fit=max&auto=format&n=tRWO8v_Df_ujnDuD&q=85&s=1f27883dd47e846302604ef2edd6d555" alt="macOS 串口列表" width="560" height="80" data-path="Ubuntu/images/device-setup/Mac_serial_port_details.png" />

    找到你的设备节点（例如 `/dev/cu.usbserial-DM03SDQQ`）并以 115200 波特率打开：

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

4. 按 **Enter** 调出登录提示符，然后登录：

   * **用户名：** `ubuntu`
   * **密码：** `ubuntu`

   首次登录时会提示你设置新密码。

## 验证软件版本

确认设备正在运行 Ubuntu：

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

**预期输出：**

```text theme={null}
PRETTY_NAME="Ubuntu 24.04.3 LTS"
NAME="Ubuntu"
VERSION_ID="24.04"
VERSION="24.04.3 LTS (Noble Numbat)"
```

检查内核版本：

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

**预期输出：**

```text theme={null}
Linux ubuntu 6.8.0-1057-qcom #58-Ubuntu SMP PREEMPT_DYNAMIC ... aarch64 GNU/Linux
```

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

## 连接网络

使用以下方法之一建立互联网连接。

### Wi-Fi

设备以站点模式运行 Wi-Fi。使用 `nmcli` 连接：

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

**示例** — 网络 `QualcommWiFi`，密码 `1234567890`：

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

**示例输出：**

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

验证连接并获取 IP 地址：

```shell theme={null}
nmcli -p device
ip addr show wlp1s0
```

<img src="https://mintcdn.com/qualcomm-prod/tRWO8v_Df_ujnDuD/Ubuntu/images/device-setup/iq9075-evk-wlan0_ipaddress.png?fit=max&auto=format&n=tRWO8v_Df_ujnDuD&q=85&s=04bc6fb3b80c1404694aae0794c3a6ca" alt="Wi-Fi IP 地址" width="847" height="159" data-path="Ubuntu/images/device-setup/iq9075-evk-wlan0_ipaddress.png" />

确认互联网访问：

```shell theme={null}
ping qualcomm.com
```

### Ethernet

用 Ethernet 线缆将 EVK 上的 RJ45 端口连接到网络路由器。

<img src="https://mintcdn.com/qualcomm-prod/tRWO8v_Df_ujnDuD/Ubuntu/images/device-setup/iq9075-evk-ethernetport.png?fit=max&auto=format&n=tRWO8v_Df_ujnDuD&q=85&s=d7edf480559e43e9f4f2e279e66ffdf0" alt="Ethernet 端口位置" width="701" height="554" data-path="Ubuntu/images/device-setup/iq9075-evk-ethernetport.png" />

读取 IP 地址：

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

<img src="https://mintcdn.com/qualcomm-prod/tRWO8v_Df_ujnDuD/Ubuntu/images/device-setup/iq9075-evk-eth0_ipaddress.png?fit=max&auto=format&n=tRWO8v_Df_ujnDuD&q=85&s=2c5482457f1eff3849263fe831a9bca0" alt="Ethernet IP 地址" width="808" height="134" data-path="Ubuntu/images/device-setup/iq9075-evk-eth0_ipaddress.png" />

## 通过 SSH 连接

SSH 让你可以从主机计算机通过网络终端访问设备。

<Note>
  确保你的主机计算机与设备处于同一网络。
</Note>

1. 获取设备 IP 地址（来自上面的网络步骤）：
   * Ethernet：`ip addr show end0`
   * Wi-Fi：`ip addr show wlp1s0`
2. 从主机连接：
   ```shell theme={null}
   ssh ubuntu@<ip-address>
   ```
   **示例：**
   ```shell theme={null}
   ssh ubuntu@192.168.0.222
   ```
3. 出现提示时输入密码。

## 连接显示器

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

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

<img src="https://mintcdn.com/qualcomm-prod/tRWO8v_Df_ujnDuD/Ubuntu/images/device-setup/Miniport_to_HDMI_adapter.png?fit=max&auto=format&n=tRWO8v_Df_ujnDuD&q=85&s=c303d5f28e376d2271721029a01bdf0b" alt="有源 Mini-DisplayPort 转 HDMI 适配器" width="867" height="537" data-path="Ubuntu/images/device-setup/Miniport_to_HDMI_adapter.png" />

下图展示了设备上 DisplayPort0 的位置：

<img src="https://mintcdn.com/qualcomm-prod/tRWO8v_Df_ujnDuD/Ubuntu/images/device-setup/iq9075-evk-eth0_HDMI_port.png?fit=max&auto=format&n=tRWO8v_Df_ujnDuD&q=85&s=a5f9143d1f44e342329f36429487ba70" alt="DisplayPort 位置" width="701" height="548" data-path="Ubuntu/images/device-setup/iq9075-evk-eth0_HDMI_port.png" />

为设备上电并验证显示。你应该会看到以下之一：

**服务器版：**

<img src="https://mintcdn.com/qualcomm-prod/tRWO8v_Df_ujnDuD/Ubuntu/images/device-setup/hdmi_monitor_Server.png?fit=max&auto=format&n=tRWO8v_Df_ujnDuD&q=85&s=5c4661fb6a7fa56b8f1405ee3fdc0e17" alt="Ubuntu 服务器显示" width="700" height="393" data-path="Ubuntu/images/device-setup/hdmi_monitor_Server.png" />

**桌面版：**

<img src="https://mintcdn.com/qualcomm-prod/kAKe9NmJg3DGZBpB/Ubuntu/images/update-software/hdmi_monitor_Desktop.png?fit=max&auto=format&n=kAKe9NmJg3DGZBpB&q=85&s=7940db938b6d5d9acfc4f59a9e1e58e9" alt="Ubuntu 桌面显示" width="2601" height="1435" data-path="Ubuntu/images/update-software/hdmi_monitor_Desktop.png" />

<Note>
  请在设备上电**之前**连接显示器。如果在设备启动后才连接或更换显示器且屏幕保持黑屏，请对设备重新上电以恢复显示。
</Note>

## SBC（单板计算机）模式

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

<img src="https://mintcdn.com/qualcomm-prod/tRWO8v_Df_ujnDuD/Ubuntu/images/device-setup/iq9075_evk_sbc.png?fit=max&auto=format&n=tRWO8v_Df_ujnDuD&q=85&s=5643ca02927b10a9cddc53d04324c747" alt="SBC 连接示例" width="714" height="536" data-path="Ubuntu/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 适配器。

## 后续步骤

* [探索外设与接口](./peripherals-interfaces/peripheral_interface_overview)
