跳到主要内容

ADB 功能使用指南

本章节将讲解如何在 DShanPi-R1 上测试 ADB (Android Debug Bridge) 功能。

准备工作​

项目名称数量说明
硬件DShanPi-R1 开发板1-
Type-C 数据线1需支持数据传输
USB 转串口模块1-
电源适配器1-
软件MobaXterm-串口终端工具

ADB 简介​

什么是 ADB？

ADB (Android Debug Bridge) 是一个用于与设备进行通信的通用命令行工具。虽然名字中带有 "Android"，但在嵌入式 Linux 开发中（如 Rockchip 平台），ADB 也是非常常用的调试工具，支持通过 USB 或网络进行 shell 登录、文件传输等操作。

硬件连接​

使用 Type-C 数据线连接开发板的 OTG 接口（通常用于 ADB 调试）和电脑。

硬件连接示意图

连接 ADB 终端​

1. 连接设备至虚拟机​

打开 VMware，确保开发板通过 USB 连接到虚拟机中的 Ubuntu 系统。

  1. 点击虚拟机菜单栏的 "可移动设备"。
  2. 找到开发板对应的 ADB 设备（通常显示为 Google 或 Rockchip 设备）。
  3. 选择 "连接 (断开与主机的连接)"。

连接至虚拟机

2. 安装 ADB 工具​

在 Ubuntu 终端中执行以下指令安装 ADB：

sudo apt update
sudo apt install adb

验证安装是否成功：

adb version
# 输出示例: Android Debug Bridge version 1.0.39 ...

3. 验证连接与登录​

查看已连接的设备：

adb devices

输出示例：

List of devices attached
cca7b8659f061daf	device

如果显示 device，则表示连接正常。执行以下指令登录系统：

adb shell

登录成功

ADB 文件互传​

ADB 提供了强大的文件传输功能，主要通过 push 和 pull 命令实现。

1. 推送文件 (PC -> 开发板)​

使用 adb push 将本地文件发送到开发板。

语法：

adb push <本地路径> <设备路径>

示例：

# 将当前目录下的 demo.txt 发送到开发板的 /sdcard/ 目录
adb push demo.txt /sdcard/

# 将 my.apk 发送到 /data/local/tmp/
adb push ./my.apk /data/local/tmp/

2. 拉取文件 (开发板 -> PC)​

使用 adb pull 将开发板上的文件复制到本地。

语法：

adb pull <设备路径> <本地路径>

示例：

# 将开发板 /sdcard/demo.txt 复制到当前目录 (.)
adb pull /sdcard/demo.txt .

# 将日志文件复制到本地 logs 目录
adb pull /data/logs/log.txt ./logs/