# USB

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

**Quectel PI M2** 智能主控板提供 **4 个标准 USB 3.0 Type-A** 接口，最高数据传输速率可达 **5 Gbps**：其中 **3 个** 为 **Host** 接口（经板载 USB 3.0 HUB 扩展），**1 个** 为 **OTG** 接口（USB0，可通过软件切换 Host/Device 模式，用于固件烧录与 ADB 调试）。此外板载 **1 个 USB Type-C** 接口，仅用于电源输入，不支持数据传输。

```{image} images/image_EgpRbnu8yoNudVx7wtUcxYupn5r.webp
:width: 1291px
:height: 431px
:align: center
```

**USB0**（OTG 接口）默认为 **Device** 模式，可通过软件配置切换为 **Host** 模式；其余 3 个 **USB** 接口为固定 **Host** 模式。M2 通过软件方式完成模式切换。

# USB 从机模式（Device模式）

**模式配置**：USB0 默认即为 **Device** 模式（固件默认配置），无需拨码或额外设置。

**工作形态**：设备作为 **USB** 从设备，由上位机（电脑、调试主机）识别、供电与管控。

**适用场景**：固件烧录、**ADB** 调试、上位机数据交互。

**功能特性**：此模式下 **USB0**（Type-A OTG 接口）作为从设备接入上位机，无法外接U盘、键鼠等 **USB** 外设，设备自身不输出 **USB** 供电，是设备调试、量产烧录的核心模式。

使用 **USB-A 转 USB-A** 数据线，一端接入 **Quectel PI M2** 的 **USB0**（OTG Type-A 接口），另一端接入 **PC**，即可完成 **ADB** 连接。板载 **USB Type-C** 仅用于供电，不能用于数据传输。

**PC** 端 **ADB** 环境配置参考：[ADB终端](<../设备连接/ADB终端/ADB终端.md>)

## ADB 使用

- 列出所有连接设备

```shell
# 基本设备列表
adb devices
# 详细设备信息列表
adb device -l
```

- 查看设备状态

```shell
# device, offline, unknown
adb get-state 
```

- 重启设备

```shell
adb reboot
```

- 交互式模式(进入设备内部)

```shell
adb shell
```

- 单次命令模式（不进入，直接执行）

```shell
adb shell df -h
```

- 文件传输

```shell
# 上传文件
adb push test.txt /data/

# 拉取文件
adb pull /data/test.txt ./

# 推送文件夹
adb push ./MyPhotos /data/

# 拉取文件夹
adb pull /data/MyPhotos ./
```

# USB 主机模式（Host模式）

**模式配置**：板载 **3 个 USB Type-A** 接口（经 USB 3.0 HUB 扩展）固定为 **Host** 模式；**USB0**（OTG 接口）可通过软件切换为 **Host** 模式。

**工作形态**：设备作为 **USB** 主控主机，主动管控外接 **USB** 设备，向外设供电并发起数据交互

**适用场景**：外接U盘、USB键鼠、USB网卡、传感器等外设，实现数据读取、人机交互、外设拓展。

**功能特性**：此模式下 **USB Type-A** 接口可主动识别、驱动外接USB设备，输出USB供电，承担主控调度功能，满足边缘计算、工控场景的外设拓展需求。

## M2 USB0 host/peripheral 切换

### 功能说明

USB0（`usb_drd0_dwc3`，即 `usb@23000000`）支持在 host 与 peripheral 两种模式间切换。M2 dtsi 默认为 `dr_mode = "peripheral"`，切换到 host 通过 DTBO overlay 覆盖为 `dr_mode = "host"`。**不需要 OTG 模式，仅二选一切换。**

### 用法

```bash
# 切换到 host 模式（重启后生效）
qpi-config usb0 host

# 切回 peripheral 模式（重启后生效，恢复 dtsi 默认）
qpi-config usb0 peripheral
```

## USB 存储

将 U 盘接入 **Quectel PI M2** 的任一 **USB Type-A** 接口（3 个 HOST 接口或 USB0 OTG 接口），系统识别后即可挂载使用。

### 功能使用（GNOME）

登录Debian Gnome桌面，查看文件管理器

```{image} images/image_Au7Bb7arAoG2nexrLaxcDtfnnrf.webp
:width: 1920px
:height: 1080px
:align: center
```

### 功能使用（Weston）

通过 [Debug Uart](<../设备连接/Debug Uart/Debug Uart.md>) 使用 `df -h` 指令查看U盘是否挂载成功

```{image} images/image_Tc9cbFQuoo0L7VxewNJcupvYnsY.webp
:width: 636px
:height: 118px
```