> ## 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<sup>®</sup> Linux 开发套件建立两个物理连接：用于 fastboot 和 ADB 的 USB 连接，以及用于捕获早期启动日志的串行控制台连接。

## 所需硬件

| 项目                     | 用途                                             |
| ---------------------- | ---------------------------------------------- |
| USB-C 线缆               | Fastboot 刷写和 ADB 访问                            |
| USB 转串口适配器（3.3 V UART） | 用于早期启动输出的串行控制台                                 |
| 运行 Ubuntu 22.04 的主机    | 由[前提条件与主机设置](./prerequisites-and-host-setup)确认 |

## 设置串行控制台

Qualcomm<sup>®</sup> Linux 开发套件通过 USB 转串口适配器暴露调试 UART。在网络栈可用之前，串行控制台是检查早期启动消息、内核 panic 以及 U-Boot/UEFI 输出的主要通道。

### 安装终端仿真器

```bash theme={null}
sudo apt install minicom
```

### 连接 USB 转串口适配器

将适配器插入主机并识别设备节点：

```bash theme={null}
ls /dev/ttyUSB*
# or, for CP210x/CH340 adapters:
ls /dev/ttyACM*
```

如果权限被拒绝，请将您的用户添加到 `dialout` 组：

```bash theme={null}
sudo usermod -aG dialout $USER
newgrp dialout
```

### 打开串行控制台

Qualcomm Linux 开发套件使用 **115200 波特、8N1、无硬件流控**：

```bash theme={null}
minicom -D /dev/ttyUSB0 -b 115200
```

<Note>
  要退出 minicom，请按 **Ctrl-A** 然后按 **X**。要禁用硬件流控，请使用 **Ctrl-A O → Serial port setup** 打开 minicom 设置，并将 Hardware Flow Control 设置为 **No**。
</Note>

或者使用 `picocom`：

```bash theme={null}
sudo apt install picocom
picocom -b 115200 /dev/ttyUSB0
```

有关特定开发板的 UART 引脚分配和适配器接线，请参阅您的开发套件的硬件文档。

## 设置 fastboot 和 ADB

Fastboot 用于刷写内核镜像；ADB 在设备启动后提供 shell 访问。

### 安装平台工具

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

### 进入 fastboot 模式

设备开机后，按下**音量减（Volume Down）**。串行控制台会显示：

```text theme={null}
Fastboot mode...
```

<Note>
  确切的按键组合因开发板而异。如果上述方法无效，请参阅您的开发套件的硬件文档。
</Note>

### 验证 fastboot 连接

```bash theme={null}
fastboot devices
```

预期输出（序列号因开发板而异）：

```text theme={null}
1234567890abcdef  fastboot
```

如果未显示设备，请检查 USB 线缆，确认设备处于 fastboot 模式，并验证 USB 权限：

```bash theme={null}
# Add a udev rule if fastboot requires sudo
echo 'SUBSYSTEM=="usb", ATTR{idVendor}=="18d1", MODE="0666", GROUP="plugdev"' \
    | sudo tee /etc/udev/rules.d/51-android.rules
sudo udevadm control --reload-rules && sudo udevadm trigger
```

### 验证 ADB 连接（启动后）

设备完全启动后，ADB 应通过同一根 USB 线缆枚举：

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

预期输出：

```text theme={null}
List of devices attached
1234567890abcdef  device
```

打开 shell：

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

## 后续步骤

在确认串行控制台和 fastboot 正常后，请继续阅读[安装并启动内核](./install-and-boot-the-kernel)，刷写您的构建并验证正在运行的内核。