> ## 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.
# 设置
> 分步指南：为 Dragonwing IQ-9075 EVK 开发板上电、烧录、连接和配置。
本章为开发者提供了在 Ubuntu、Windows® 和 macOS® 环境下设置 IQ-9075 EVK 开发板的全面分步指南。它涵盖了确保顺利入门的基本任务，包括：
* 首次**为设备上电**。
* **配置调试 UART** 以访问串行控制台。
* **验证软件版本**，并在需要时执行软件升级，以确保获得最新的功能和安全补丁。
* 通过以太网或 Wi-Fi **建立网络连接**。
* **设置安全的 SSH 访问**以进行远程管理。
* **连接显示输出**以实现应用程序可视化。
* **启用 SBC 模式**以连接键盘和鼠标等外设，将 EVK 转变为功能完备的单板计算机（Single Board Computer），用于交互式开发。
无论您是烧录软件、通过 UART 日志排查问题、升级操作系统还是连接外设，本节都为您提供清晰的说明和最佳实践，帮助您快速可靠地搭建开发环境。
### Dragonwing IQ-9075 EVK 的设置工作流程
## 为设备上电
要为设备上电，请执行以下操作：
* 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，请执行以下操作：
* 将 micro-USB 电缆的一端连接到 Dragonwing IQ-9075 设备上的 micro-USB 端口。
* 将 micro-USB 电缆的另一端连接到主机计算机。
* 下图显示了设备上的端口位置：
* 请在下方选择主机计算机的操作系统以查看详细说明。
在 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
```
运行以下命令打开调试 UART 端口：
```shell theme={null}
sudo screen
```
**参数详情**\
serial\_port：您的设备串行端口连接。\
baud\_rate：合适的波特率，默认为 115200。
**示例**
* IQ9-EVK 控制台通常会枚举为 /dev/ttyUSB1。这是因为板载串行适配器总共暴露了 4 个串行设备，而控制台呈现在其中的第二个设备上。
* 要打开调试 UART 端口，请运行以下命令：
```shell theme={null}
sudo screen /dev/ttyUSB1 115200
```
1. 为您的 Windows 主机下载 [**🔗PuTTY**](https://putty.software/)。请确保为您的 Windows 主机选择正确的版本（32 位或 64 位）。
2. 运行安装向导，按照提示完成 PuTTY 安装。
3. 从"开始"菜单或在任务栏搜索框中搜索并打开 PuTTY 应用程序。
4. 通过 PuTTY Configuration 对话框为端口启动 PuTTY 会话，步骤如下：
* 选择 Serial。
* 根据 Windows 设备管理器中检测到的 UART 端口指定 Serial line。
**注意：**\
如果未检测到 UART 端口，请按如下方式下载并更新驱动程序：对于 x86：访问 [**USB-to-UART 串行驱动程序**](https://ftdichip.com/wp-content/uploads/2023/09/CDM-v2.12.36.4-WHQL-Certified.zip)页面。驱动程序会自动下载。通过设备管理器更新驱动程序。
对于 Arm®：访问 [**FTDI USB 转串行驱动程序**](https://oemdrivers.com/usb-ft232r-usb-uart-arm64)页面。在 Drivers 部分，选择 FTDI CDM VCP Drivers。驱动程序开始下载。通过设备管理器更新驱动程序。
**COM 端口选择步骤**
* 连接基于 FTDI 的接口时，设备管理器中可能会出现 2 个或 4 个 COM 端口。
* 只有前两个端口用于功能性用途。
* 识别正确的端口：右键单击每个 COM 端口 → Properties → 查看 Location 字段。\
示例：on USB Serial Converter B。
**硬件设计详情（FTDI 芯片）**\
Converter A（ADBUS0:7）分配给 SAIL 调试 UART，用于收集 SAIL（Safety Island）域日志。
Converter B（BDBUS0:7）分配给主域 UART，用于收集串行提示符日志。
* 将波特率设置为 115200。
* 选择 Open。
* 串行端口的 PuTTY 会话即会启动。下图显示了一个 PuTTY 配置对话框示例。
运行以下命令验证连接到 macOS 主机的串行设备：
```shell theme={null}
ls /dev/cu.*
```
此时会显示连接到 macOS 主机的串行设备列表。您的设备名称应出现在列表中。
从列出的串行设备中找到您的串行设备。
以下屏幕显示了连接到 macOS 主机的串行设备示例列表。例如，以串行设备 `cu.usbserial-DM03SDQQ at node /dev/cu.usbserial-DM03SDQQ` 为例。
运行以下命令打开您的串行设备：
```shell theme={null}
screen
```
**参数详情**\
serial\_device\_node：您的设备节点名称。\
baud\_rate：合适的波特率。
**示例**\
设备节点名称为 /dev/cu.usbserial-DM03SDQQ，波特率为 115200。要打开该串行设备，请运行以下命令：
```shell theme={null}
screen /dev/cu.usbserial-DM03SDQQ 115200
```
## 验证软件版本
使用 **ubuntu** 作为用户名和密码登录 Dragonwing IQ-9075 EVK 的 Ubuntu UART 控制台。首次登录后，您可以在命令终端中重置密码。
在终端中运行以下命令来验证版本：
```shell theme={null}
cat /etc/os-release
```
**输出：**
```json theme={null}
PRETTY_NAME="Ubuntu 24.04.3 LTS"
NAME="Ubuntu"
VERSION_ID="24.04"
VERSION="24.04.3 LTS (Noble Numbat)"
VERSION_CODENAME=noble
ID=ubuntu
ID_LIKE=debian
HOME_URL="https://www.ubuntu.com/"
SUPPORT_URL="https://help.ubuntu.com/"
BUG_REPORT_URL="https://bugs.launchpad.net/ubuntu/"
PRIVACY_POLICY_URL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy"
UBUNTU_CODENAME=noble
LOGO=ubuntu-logo
```
运行以下命令检查 Linux 版本：
```shell theme={null}
uname -a
```
**输出：**
```json theme={null}
Linux ubuntu 6.8.0-1057-qcom #58-Ubuntu SMP PREEMPT_DYNAMIC Tue Nov 25 14:21:46 UTC 2025 aarch64 aarch64 aarch64 GNU/Linux
```
**注意：** 如果您的 IQ9-EVK 当前未运行 Ubuntu 或未处于 EDL 模式，可以参考[**🔗"将 Ubuntu 烧录到设备"**](./update-software/overview)章节中的说明。
## 连接网络
**前提条件：**\
使用 **ubuntu** 作为用户名和密码登录 Dragonwing IQ-9075 EVK 的 Ubuntu UART 控制台。
使用以下方法之一建立互联网连接以获取设备 IP 地址：
#### 使用 Wi-Fi 连接
设备以 Station 模式运行 Wi-Fi。设备启动时会初始化 Wi-Fi 主机驱动程序并进行网络管理身份验证。请按照以下步骤建立无线连接。
1. 运行以下命令连接到无线接入点（Wi-Fi 路由器）：
```shell theme={null}
sudo nmcli dev wifi connect password
```
**参数详情**\
WiFi-SSID：Wi-Fi 网络的名称。\
WiFi-password：Wi-Fi 网络的密码。
**示例**\
Wi-Fi 网络的名称为 QualcommWi-Fi，密码为 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’.
```
2. 运行以下命令验证已连接的设备及其状态：
```shell theme={null}
nmcli -p device
```
**示例输出**\
以下示例输出显示已连接设备的列表和状态。
```shell theme={null}
=================
Status of devices
=================
DEVICE TYPE STATE CONNECTION
wlp1s0 wifi connected QualcommWiFi
eth0 ethernet unavailable –
eth1 ethernet unavailable –
can0 can unmanaged –
lo loopback unmanaged –
```
3. 运行以下命令验证 WLAN 连接状态并获取 IP 地址：
```shell theme={null}
ip addr show wlp1s0
```
**示例输出**\
以下示例输出显示 Wi-Fi 网络的 IP 地址。
4. 通过 ping 某个网站（例如 yahoo.com）来确认连接处于活动状态：
```shell theme={null}
ping yahoo.com
```
#### 使用以太网连接
将以太网电缆的一端插入 Dragonwing IQ-9075 设备的以太网端口（RJ45）。将以太网电缆的另一端连接到您的网络路由器。
下图显示了 Dragonwing IQ-9075 设备上以太网端口的位置。
在 UART 串行控制台上运行以下命令获取设备的 IP 地址：
```shell theme={null}
ip addr show end0
```
下图显示了从 UART 串行控制台获取的 IP 地址示例。
## 连接 SSH
SSH 可在主机计算机与 Dragonwing IQ-9075 设备之间通过网络实现安全的终端访问。
在连接 SSH 之前，请确保您的设备已通过以太网或 Wi-Fi 建立网络连接。
**注意：** 请确保远程主机计算机与设备连接到同一个 Wi-Fi 接入点。
要连接 SSH，请先根据网络连接类型，在主机计算机的 UART 控制台上运行相应的命令，查找 Dragonwing IQ-9075 的 IP 地址：
对于以太网：
```shell theme={null}
ip addr show end0
```
对于 Wi-Fi：
```shell theme={null}
ip addr show wlp1s0
```
此命令会显示 Dragonwing IQ-9075 设备的 IP 地址。
在主机计算机上运行以下命令，与设备建立 SSH 连接：
```shell theme={null}
ssh ubuntu@ip-address
```
**参数详情**\
ip-address 是 eth0 或 wlan0 接口的 IP 地址。
**示例**\
要连接 IP 地址为 192.168.0.222 的设备，请运行以下命令：
```shell theme={null}
ssh ubuntu@192.168.0.222
```
输入 *ubuntu* 用户的密码进行登录。
## 连接显示器
要将显示器连接到 IQ-9075 EVK 上的 DisplayPort JEDP0 或 JEDP1，请使用\_有源（Active）\_ mini-DisplayPort 转 DisplayPort 电缆（例如包装盒内附带的那根），或使用\_有源（Active）\_ mini-DisplayPort 转 HDMI 适配器（此部件不包含在 EVK 套件中）。
**mini-DisplayPort 转 DisplayPort 电缆**
**有源 mini-DisplayPort 转 HDMI 适配器**\
**它支持：**
* 内含有源转换芯片
* 将原生 DisplayPort 信号转换为 HDMI
* 不依赖 DP++ 支持
这使您可以在显示器上查看示例应用程序的输出或 Ubuntu 桌面（如已安装）。下图显示了 Dragonwing IQ-9075 设备上 DisplayPort0 的位置。
为 Dragonwing IQ-9075 设备上电并检查显示。
当 IQ-9075 EVK 运行预烧录的 Canonical Ubuntu 版本时，显示器上将显示以下内容。\
**Server：**
**Desktop：**
## 单板计算机（SBC）模式
**连接示例：**
**电源：**\
将 EVK 连接到推荐的 DC 电源适配器。上电前请确认电压和极性正确。
**Micro USB 电缆：**\
使用 micro-USB 端口进行串行控制台访问或调试。连接到主机 PC 以获取 UART 日志。
**USB 集线器：**\
将带供电的 USB 集线器连接到 EVK 的 USB Type-C，以连接多个外设。
**键盘和鼠标：**\
插入 USB 集线器。
**USB 摄像头：**\
连接到 USB 集线器。请确保摄像头符合 UVC 标准，以保证 Linux 兼容性。
**MIPI 摄像头：**\
连接到 EVK 板上指定的 MIPI CSI 连接器。
**显示器：**\
使用 mini-DisplayPort 转 DisplayPort 电缆，或使用 HDMI 电缆加 mini-DisplayPort 转 HDMI 适配器，将 EVK 连接到显示器。