USB¶

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 接口，仅用于电源输入，不支持数据传输。

../../_images/image_EgpRbnu8yoNudVx7wtUcxYupn5r.webp

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 devices
# 详细设备信息列表
adb device -l

查看设备状态

# device, offline, unknown
adb get-state 

重启设备

adb reboot

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

adb shell

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

adb shell df -h

文件传输

# 上传文件
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 模式，仅二选一切换。

用法¶

# 切换到 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桌面，查看文件管理器

../../_images/image_Au7Bb7arAoG2nexrLaxcDtfnnrf.webp

功能使用（Weston）¶

通过 Debug Uart 使用 df -h 指令查看U盘是否挂载成功

../../_images/image_Tc9cbFQuoo0L7VxewNJcupvYnsY.webp