# ADB终端

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

---

**ADB** 是 **Android Debug Bridge (Android调试桥)** 的缩写，它是一个命令行工具套件，是 **Android** 开发和调试的多功能工具。

简单来说，**ADB** 就像是连接电脑与设备（或模拟器）之间的“万能数据线”，让您能够直接在电脑上控制和深度管理设备。

**Quectel Pi H1** 智能主控板的 **ADB** 端口如下图所示：

```{image} images/image_IpurbFVroo9lYSxsEJ0cOfHznge.webp
:width: 904px
:height: 506px
```

# 准备工作

1. 准备一条 **USB** 转 **type-C** 连接线连接电脑和 **Quectel Pi H1** 智能主控板；

2. 在电脑上下载 [platform-tools](<https://www.quectel.com.cn/wp-content/uploads/2026/08/platform-tools.zip>) 工具，并解压。

# 开启和禁用ADB

系统中 **ADB** 服务默认处于开启状态，若要禁用 **ADB** 服务，可执行以下命令：

```bash
sudo systemctl stop android-tools-adbd
sudo systemctl disable android-tools-adbd
sudo reboot
```

若禁用后想重新开启 **ADB** 服务，可执行以下命令：

```bash
sudo systemctl start android-tools-adbd
sudo systemctl enable android-tools-adbd
sudo reboot
```

# 使用方法

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

```{image} images/image_MPp0bAkNfoeBL5xcwZHcfweOnLc.webp
:width: 1293px
:height: 833px
```

```{image} images/image_NUhBb2DVHowq6WxQShpcgZ5MnJh.webp
:width: 1291px
:height: 837px
```

```{image} images/image_WXhjbtxzWoeeHtxb1G2cl2lWnRd.webp
:width: 972px
:height: 505px
```

2. 在终端输入 **adb** 命令进行操作；

查看连接的设备：

```bash
adb devices
```

从电脑传输文件到设备：

```bash
# 例如 adb push C:\Users\james.liu\Desktop\11.txt /data/local/tmp/
adb push <电脑文件路径> <设备存放路径>
```

- 您可以用鼠标拖拽电脑上的文件至 **adb** 终端获取<电脑文件路径>。

从设备传输文件到电脑：

```bash
# 例如 adb pull /data/local/tmp/11.txt .
adb pull <设备文件路径> <电脑存放路径>
```

- .表示拉取文件到当前 **adb** 终端文件夹，即 **platform-tools** 文件夹中。

进入设备 **shell** 终端：

```bash
adb shell
```

```{image} images/image_V445bvypyoWMi2xqt0FcmIwqnpb.webp
:width: 974px
:height: 507px
```

- 进入 **shell** 终端后，用户身份默认为 **root**。

- 若需退出 **shell** 终端，请输入 *exit*。