ADB终端

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

---

ADB 是 Android Debug Bridge（Android调试桥） 的缩写，是一套用于主机电脑与设备之间通信的命令行工具。通过 ADB，用户可以在电脑端查看设备连接状态、进入设备 Shell、传输文件、重启设备以及执行调试命令。

在 Quectel Pi M1 / L1 Debian 系统中，ADB 主要用于开发阶段的本地调试和快速文件传输。电脑端通过 USB Type-C 线连接开发板后，即可使用 adb devices、adb shell、adb push、adb pull 等命令管理设备。

💡 注：L1 的 adb shell 默认进入 root 用户，可直接用于查看系统状态、启动服务和修改配置。执行高权限命令时通常不需要再额外添加 sudo。

准备工作

1. 准备一条 USB 转 Type-C 连接线，将 Type-C 端接入 Quectel Pi M1 / L1 的 USB-C 接口，另一端接入主机电脑。

1. 在电脑端下载 platform-tools 工具，并解压到本地目录。

2. 打开 platform-tools 工具所在文件夹，在顶部路径框中输入 cmd，按回车键打开 ADB 终端。

软件安装

电脑端需要安装或解压 platform-tools，其中包含 adb 命令。

Quectel Pi L1 / M1 Debian 系统中已集成 ADB 服务，服务名称为 adbd.service，程序路径为 /sbin/adbd。通常无需额外安装软件包。

可在开发板端查看 ADB 服务状态：

systemctl status adbd.service --no-pager -l

软件配置

ADB 服务由 adbd.service 管理，常用配置和管理方式如下：

配置项	说明
服务名称	adbd.service
依赖服务	usb.service
连接方式	USB Type-C 连接主机电脑和开发板
典型用途	Shell 调试、文件传输、设备状态查看

如需限制 ADB 使用，可停止或禁用 ADB 服务。禁用后建议重启系统，使状态保持一致：

sudo systemctl stop adbd.service
sudo systemctl disable adbd.service
sudo reboot

如需重新开启 ADB 服务，可执行：

sudo systemctl start adbd.service
sudo systemctl enable adbd.service
sudo reboot

软件启动

启动 ADB 服务：

sudo systemctl start adbd.service

设置开机自启：

sudo systemctl enable adbd.service

查看当前状态：

systemctl status adbd.service --no-pager -l
systemctl is-active adbd.service

重启服务：

sudo systemctl restart adbd.service

ADB调试

查看连接设备

在电脑端 ADB 终端中执行：

adb devices

若列表中出现设备序列号，且状态为 device，表示电脑已识别开发板。

进入设备 Shell

在电脑端执行：

adb shell

进入 Shell 后，即可在开发板系统中执行常用 Linux 命令。L1 当前 ADB Shell 默认为 root 用户，可先执行以下命令确认：

id
whoami

若需退出 Shell，请输入：

exit

从电脑传输文件到设备

# 用法：adb push <电脑文件路径> <设备存放路径>
adb push ./test.txt /data/local/tmp/

从设备传输文件到电脑

# 用法：adb pull <设备文件路径> <电脑存放路径>
adb pull /data/local/tmp/test.txt ./

其中 ./ 表示保存到当前 ADB 终端所在目录。

重启设备

adb reboot

疑难解答

问题现象	排查方法
adb devices 无设备	检查 USB 线是否支持数据传输；确认线缆已接入 L1 / M1 的 USB-C 接口；重新插拔后再次执行 adb devices。
设备状态为 offline	执行 adb kill-server 和 adb start-server 后重新连接。
电脑端无 adb 命令	确认已解压 platform-tools，并在该目录打开终端，或将 platform-tools 加入系统环境变量。
开发板端服务未运行	在开发板端执行 systemctl status adbd.service --no-pager -l 查看服务状态，并按需执行 sudo systemctl restart adbd.service。
文件传输失败	检查目标路径是否存在、是否有写入权限，建议先使用 /data/local/tmp/ 目录进行测试。