adb 协议

adb通信分为两部分：adb client和adb server，以及adb server和adb daemon。

 client和server之间的通信协议

adb server对本地的tcp 5037号端口进行监听，等待adb client的命令。client的每个命令都会包含两个部分，前一部分固定4个字节，以十六进制方式指定命令部分的长度。后一部分是真正的内容。发送命令的接口为writex，并最终调用_fh_socket_write，通过send发送出去。因此这两部分至少需要发送两个tcp包。

例如想要获取adb server的版本号，client首先连接本机的tcp 5037端口，然后发送“000C”和“host:version”。

server对client回复，分为如下情况

1、 成功，回复四字节串“OKAY”，后面跟的内容根据不同的命令而不同。

2、 失败，回复四字节串“FAIL”，然后跟四字节的十六进制长度，以及失败原因。

3、 对于host:version，回复4个字节的十六进制字串，代表server的内部版本号。

具体的命令如下。

命令	解释
host:version
host:kill	停止server
host:devices
host:track-devies
host:emulator:<port>
host:transport:<serial-number>	连接指定serial-number的设备或者模拟器
host:transport-usb	连接usb上的设备，如果usb上有不止一个设备，会失败。
host:transport-local	通过tcp方式连接模拟器，如果有多个模拟器在运行，会失败。
host:transport-any	连接usb设备或者模拟器都可以，但是如果有超过一个设备或模拟器，会失败。
host-serial:<serial-number>:<request> host-usb:<request> host-local:<request>	向指定的设备发送特定的请求。同样如果存在多个设备的冲突，会失败。
host:<request>	向当前连接的设备发送请求
<host-prefix>:get-serialno	获取设备的serial-number
<host-prefix>:get-state	获取设备状态
<host-prefix>:forward:<local>;<remote>

下面这些命令仅仅用于已经连接到某个设备，即在上面命令使用成功，连接到特定设备后，向特定设备发送命令，操作特定设备。

 

命令	解释
shell:command arg1 arg2 ...	在设备上执行命令行操作
shell:	参见commandline.c中的interactive_shell()
remount:	以读/写模式加载设备的文件系统
dev:<path>	为client打开设备上的特定路径，用于读写问题。有可能由于权限问题而失败。
tcp:<port>	尝试从设备连接本主机的某个tcp端口
tcp:<port>:<server-name>	尝试从设备连接特定主机名的某个tcp端口
local:<path>	尝试连接设备上的特定路径，路径是UNIX域名形式
localreserved:<path> localabstract:<path> localfilesystem:<path>	尝试连接设备上的特定路径。
log:<name>	打开设备上的特定日志文件，以便读取日志
framebuffer:	尝试获取framebuffer的快照。即涉笔的屏幕快照
dns:<server-name>	由serer执行来解析特定设备名
recover:<size>	更新设备的恢复镜像
jdwp:<pid>	连接特定VM进程上面的JDWP线程
track-jdwp
sync:	同步设备和主机上的文件

 

 

关于命令内容以及回复信息的更详细说明，参见adb源码文件夹下的SERVICES.TXT。

 

 Transports

这个名词用于代表server和设备或者模拟器之间的通信协议。包含如下两种情况：

1、 USB transports。通过USB方式和物理设备通信。

2、 Local transports。通过本机的TCP连接方式和模拟器通信。

由此可以想到，其实可以通过TCP方式和其他机器上面的模拟器或者设备进行通信，但是这点还没有实现。

transport层用于处理消息，每个消息包含24个字节的头部，定义如下。

struct message {

   unsigned command;

   unsigned arg0;

   unsigned arg1;

   unsigned data_length;

   unsigned data_crc32;

   unsigned magic;

};

此部分具体内容参见protocol.txt。

参考文献：

1、 adb源码文件夹下OVERVIEW.TXT

2、 adb源码文件夹下SERVICES.TXT

3、 adb源码文件夹下protocol.txt