> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs-staging.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 模式

设备上电后，按下**音量减**键。串口控制台会显示：

```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)，烧写您的构建并验证
正在运行的内核。