当前位置：首页 > news >正文

【C/C++】libusb实战：从零构建ADB USB通信框架

news 2026/5/15 11:04:24

1. 为什么需要自己实现ADB USB通信？

很多开发者第一次接触ADB时，都是直接使用官方提供的adb命令行工具。这个工具确实方便，但当你需要深度定制Android设备调试流程，或者开发自动化测试框架时，官方工具就显得不够灵活了。比如：

你想在嵌入式设备上实现轻量级的ADB服务端
需要绕过某些系统限制直接与设备通信
希望完全掌控USB通信的每个字节

我在开发智能家居中控系统时就遇到过这种情况。官方ADB工具在批量管理多个设备时效率低下，而且无法满足实时性要求。这时候用libusb自己实现通信协议就派上用场了。

2. 环境搭建与libusb入门

2.1 跨平台开发环境配置

libusb的强大之处在于跨平台支持。我在Windows、Linux和macOS上都成功部署过，这里以Windows+VS2019为例：

从libusb官网下载最新release版本
解压后找到vs2019目录下的解决方案文件
编译生成libusb-1.0.lib和.dll
在你的工程中添加头文件路径：

#include <libusb-1.0/libusb.h> #pragma comment(lib, "libusb-1.0.lib")

注意：32位和64位程序需要对应不同版本的dll，这是新手常踩的坑。

2.2 libusb核心API速成

这些是使用频率最高的几个函数：

// 初始化库 libusb_init(NULL); // 获取设备列表 libusb_device **devs; ssize_t cnt = libusb_get_device_list(NULL, &devs); // 打开设备 libusb_device_handle *handle = libusb_open_device_with_vid_pid(NULL, vid, pid); // 声明接口 libusb_claim_interface(handle, 0); // 批量传输 libusb_bulk_transfer(handle, endpoint, data, length, &actual_length, timeout); // 释放资源 libusb_free_device_list(devs, 1); libusb_exit(NULL);

3. ADB协议深度解析

3.1 协议帧结构剖析

ADB协议的数据包由头部和数据两部分组成，具体结构如下：

struct amessage { uint32_t command; // 命令类型 uint32_t arg0; // 参数1 uint32_t arg1; // 参数2 uint32_t data_length; // 数据长度 uint32_t data_check; // 数据校验和 uint32_t magic; // 魔数(固定为0xFFFFFFFF) }; struct apacket { struct amessage msg; uint8_t data[MAX_PAYLOAD]; // 最大负载通常为1024字节 };

常见命令类型包括：

A_CNXN：连接请求
A_AUTH：认证请求
A_OPEN：打开会话
A_OKAY：操作成功响应

3.2 USB接口识别技巧

Android设备的ADB接口有固定的特征码：

#define ADB_CLASS 0xFF #define ADB_SUBCLASS 0x42 #define ADB_PROTOCOL 0x01

在实际项目中，我总结出一个可靠的设备枚举方法：

遍历所有USB设备
检查接口描述符的class/subclass/protocol
确认端点数量为2（输入+输出）
验证端点类型为BULK传输模式

4. 从零构建通信框架

4.1 设备发现与连接

完整的设备初始化流程应该包含以下步骤：

int init_adb_device(adb_handle *h) { // 1. 初始化libusb if(libusb_init(&h->ctx) < 0) return -1; // 2. 枚举设备 libusb_device **devs; ssize_t cnt = libusb_get_device_list(h->ctx, &devs); // 3. 查找ADB接口 for(int i=0; i<cnt; i++) { struct libusb_device_descriptor desc; libusb_get_device_descriptor(devs[i], &desc); // 检查接口配置 struct libusb_config_descriptor *config; libusb_get_config_descriptor(devs[i], 0, &config); // 接口匹配逻辑... } // 4. 打开设备 h->dev_handle = libusb_open_device_with_vid_pid(h->ctx, vid, pid); // 5. 声明接口 return libusb_claim_interface(h->dev_handle, interface_num); }

4.2 数据传输实战

实现可靠的BULK传输需要注意这些细节：

正确处理零长度包(ZLP)：当数据长度是端点最大包大小的整数倍时，需要发送一个零长度包表示传输结束
设置合理的超时时间：通常500-1000ms比较合适
处理传输错误：LIBUSB_ERROR_TIMEOUT等需要特殊处理

int adb_bulk_write(adb_handle *h, void *data, int len) { int transferred; int ret = libusb_bulk_transfer(h->dev_handle, h->out_ep, data, len, &transferred, 1000); // 检查是否需要发送ZLP if((len & h->zero_mask) == 0 && len != 0) { libusb_bulk_transfer(h->dev_handle, h->out_ep, NULL, 0, NULL, 1000); } return ret; }

5. 高级功能实现

5.1 调试授权处理

Android 4.2.2之后引入了RSA密钥认证机制。实现自动化授权需要：

生成RSA密钥对
处理A_AUTH协议交换
解析设备返回的认证请求

int handle_auth(adb_handle *h) { apacket *p = get_apacket(); // 1. 发送公钥 p->msg.command = A_AUTH; p->msg.arg0 = ADB_AUTH_RSAPUBLICKEY; strcpy(p->data, public_key); send_packet(p); // 2. 等待设备响应 while(1) { recv_packet(p); if(p->msg.command == A_CNXN) { break; // 认证成功 } else if(p->msg.command == A_AUTH) { // 需要签名验证 sign_token(p->data, p->msg.data_length); send_packet(p); } } put_apacket(p); return 0; }

5.2 常用ADB命令实现

封装几个实用命令的发送函数：

// 执行shell命令 int adb_shell(adb_handle *h, const char *cmd) { apacket *p = get_apacket(); p->msg.command = A_OPEN; p->msg.arg0 = 1; // 标准输出 snprintf(p->data, MAX_PAYLOAD, "shell:%s", cmd); p->msg.data_length = strlen(p->data)+1; send_packet(p); put_apacket(p); return 0; } // 文件推送 int adb_push(adb_handle *h, const char *local, const char *remote) { // 实现文件分片传输逻辑... } // 屏幕截图 int adb_screencap(adb_handle *h, const char *filename) { adb_shell(h, "screencap -p > /sdcard/screen.png"); // 实现文件拉取逻辑... }

6. 实战案例：实现设备监控系统

分享一个真实项目中的应用场景：我们需要实时监控多台Android设备的运行状态。使用libusb实现的方案比传统ADB效率提升3倍以上。

核心架构：

每个设备一个独立线程
轮询设备状态（CPU、内存、温度）
异常状态自动触发抓取日志

关键代码片段：

void device_monitor(adb_handle *h) { while(1) { // 获取CPU使用率 adb_shell(h, "cat /proc/stat"); parse_cpu_usage(recv_packet()); // 获取内存信息 adb_shell(h, "cat /proc/meminfo"); parse_mem_info(recv_packet()); // 温度监控 if(check_overheat()) { adb_shell(h, "dmesg > /sdcard/crash.log"); adb_pull(h, "/sdcard/crash.log"); } Sleep(1000); // 1秒间隔 } }

7. 性能优化技巧

经过多次性能测试，我总结了这些优化经验：

双缓冲技术：准备两个apacket缓冲区交替使用，避免内存分配开销
批量请求：合并多个小数据包一起发送
异步传输：使用libusb的异步API提高吞吐量
连接复用：保持长连接而不是每次重新建立

异步传输示例：

void async_callback(struct libusb_transfer *transfer) { // 处理完成的数据包 } int async_transfer(adb_handle *h) { struct libusb_transfer *transfer = libusb_alloc_transfer(0); libusb_fill_bulk_transfer(transfer, h->dev_handle, h->in_ep, buffer, length, async_callback, NULL, 1000); return libusb_submit_transfer(transfer); }

8. 常见问题排查

问题1：设备无法识别

检查USB调试是否开启
确认驱动安装正确（Linux不需要额外驱动）
尝试不同的USB接口

问题2：传输速度慢

调整端点包大小（wMaxPacketSize）
增加传输超时时间
检查是否有其他进程占用USB带宽

问题3：随机断开连接

实现心跳机制定期检查连接
添加自动重连逻辑
检查USB线材质量

一个健壮的错误处理示例：

int send_with_retry(adb_handle *h, void *data, int len, int retries) { while(retries-- > 0) { int ret = adb_bulk_write(h, data, len); if(ret == 0) return 0; if(ret == LIBUSB_ERROR_NO_DEVICE) { reconnect_device(h); } Sleep(100); } return -1; }

9. 扩展应用场景

这个框架经过适当修改可以用于：

IoT设备管理：批量配置智能硬件参数
自动化测试：与uiautomator结合实现UI自动化
数据采集：定期从设备拉取日志和性能数据
定制恢复工具：实现类似TWRP的功能

比如实现一个自动化测试框架的核心逻辑：

void run_test_case(adb_handle *h, const char *apk_path) { // 安装测试APK adb_install(h, apk_path); // 启动测试 adb_shell(h, "am instrument -w com.example.test/androidx.test.runner.AndroidJUnitRunner"); // 监控测试结果 while(1) { char *log = adb_logcat(h); if(strstr(log, "Test finished")) { parse_test_result(log); break; } } // 卸载APK adb_uninstall(h, "com.example.test"); }

10. 安全注意事项

在实现这类底层通信时要注意：

数据校验：对所有接收到的数据都要验证magic和checksum
缓冲区安全：严格检查data_length防止溢出
权限控制：关键操作需要二次确认
连接加密：敏感数据建议额外加密

一个安全的报文检查函数应该包含：

int validate_packet(apacket *p) { // 检查魔数 if(p->msg.magic != 0xFFFFFFFF) return -1; // 检查数据长度 if(p->msg.data_length > MAX_PAYLOAD) return -1; // 校验和验证 if(calc_checksum(p->data, p->msg.data_length) != p->msg.data_check) return -1; return 0; }

在开发过程中，建议先用官方ADB工具抓取正常通信数据包作为参考，再对比自己实现的数据包格式。WireShark的USB抓包功能也非常有用，可以实时监控USB通信流量。

查看全文

http://www.jsqmd.com/news/821269/