嵌入式Linux开发板通过USB Gadget配置实现ADB调试-开发者社区

1. 嵌入式Linux开发板ADB调试的必要性

在嵌入式Linux开发过程中，调试工具的选择直接影响开发效率。ADB（Android Debug Bridge）作为Android生态中的调试利器，其实同样适用于嵌入式Linux开发场景。想象一下，当你需要快速传输文件、执行远程命令或实时查看日志时，ADB能像瑞士军刀一样提供一站式解决方案。

传统调试方式如串口终端虽然稳定，但传输速度慢且功能单一。而ADB基于USB协议，不仅传输速度快，还支持丰富的功能：

文件传输：adb push/pull命令实现双向文件传输
远程Shell：adb shell直接操作开发板终端
端口转发：adb forward实现TCP端口映射
日志查看：adb logcat实时获取系统日志

我曾在多个项目中使用ADB调试嵌入式设备，实测文件传输速度可达12MB/s，比串口快了近百倍。特别是在需要频繁更新测试固件的场景，ADB大大缩短了开发迭代周期。

2. USB Gadget框架解析

2.1 内核中的角色扮演

Linux内核的USB Gadget框架就像个"变形金刚"，能让设备在主机（Host）和设备（Device）模式间切换。当开发板作为USB设备时，通过Gadget框架可以模拟成各种USB设备类型：大容量存储、网卡、串口，当然也包括ADB设备。

关键组件包括：

UDC驱动：硬件控制器驱动（如dwc2、dwc3）
Function驱动：实现具体设备功能（如f_fs、f_mass_storage）
Composite驱动：组合多个Function形成复合设备

2.2 ConfigFS的魔法

传统Gadget配置需要重新编译内核，而ConfigFS（配置文件系统）的出现改变了这一局面。它允许我们通过文件系统接口动态配置USB设备：

# 挂载configfs mount -t configfs none /sys/kernel/config # 创建gadget实例 mkdir /sys/kernel/config/usb_gadget/g1 cd /sys/kernel/config/usb_gadget/g1

这种配置方式就像搭积木，开发者可以随时调整USB设备描述符、配置字符串和功能组合，无需重启设备。我在调试时经常通过修改/sys下的文件实时调整参数，比重新编译内核方便太多。

3. 完整配置实战指南

3.1 内核配置准备

首先确保内核包含必要选项（以Linux 5.10为例）：

make menuconfig

关键配置项路径：

Device Drivers → USB support → USB Gadget Support → [*] USB Gadget Driver <M> USB Functions configurable through configfs <M> Function Filesystem (FunctionFS)

建议勾选以下模块：

CONFIG_USB_CONFIGFS
CONFIG_USB_CONFIGFS_F_FS
CONFIG_USB_LIBCOMPOSITE
CONFIG_USB_FUNCTIONFS

3.2 Buildroot集成adbd

在Buildroot配置中添加adb工具：

make menuconfig

路径：

Target packages → System tools → [*] adb

编译后会生成以下关键文件：

/usr/bin/adbd（守护进程）
/etc/init.d/S50adbd（启动脚本）

3.3 动态配置ADB功能

创建配置脚本/etc/init.d/S99usb_adb：

#!/bin/sh case "$1" in start) # 挂载configfs mount -t configfs none /sys/kernel/config # 创建gadget实例 mkdir -p /sys/kernel/config/usb_gadget/g1 cd /sys/kernel/config/usb_gadget/g1 # 设置基本描述符 echo 0x1d6b > idVendor # Linux Foundation echo 0x0104 > idProduct # Multifunction Composite Gadget echo 0x0100 > bcdDevice # v1.0.0 echo 0x0200 > bcdUSB # USB2.0 # 字符串描述符 mkdir strings/0x409 echo "fedcba9876543210" > strings/0x409/serialnumber echo "My Company" > strings/0x409/manufacturer echo "ADB Composite Device" > strings/0x409/product # 创建配置 mkdir configs/c.1 echo 500 > configs/c.1/MaxPower echo "ADB Config" > configs/c.1/strings/0x409/configuration # 创建ADB功能 mkdir functions/ffs.adb ln -s functions/ffs.adb configs/c.1 # 准备FunctionFS mkdir -p /dev/usb-ffs/adb mount -t functionfs adb /dev/usb-ffs/adb # 启动adbd adbd & # 绑定UDC udc=$(ls /sys/class/udc) echo $udc > UDC ;; stop) echo "" > /sys/kernel/config/usb_gadget/g1/UDC umount /dev/usb-ffs/adb rm -rf /sys/kernel/config/usb_gadget/g1 ;; esac

给脚本添加执行权限：

chmod +x /etc/init.d/S99usb_adb

4. 常见问题排查

4.1 设备未识别问题

当PC无法识别ADB设备时，按以下步骤排查：

检查内核日志：

dmesg | grep gadget

查看是否有UDC绑定错误或枚举失败信息

验证USB连接：

lsusb -t

确认设备是否出现在USB设备树中

描述符检查：

cat /sys/kernel/config/usb_gadget/g1/strings/0x409/*

确认厂商、产品信息是否正确

4.2 ADB连接不稳定

遇到间歇性断开连接时，可以：

调整USB供电：

echo 500 > /sys/kernel/config/usb_gadget/g1/configs/c.1/MaxPower

更换USB线缆（推荐使用带屏蔽的短线）
检查USB控制器负载：

cat /proc/interrupts | grep dwc

5. 高级应用技巧

5.1 复合设备配置

ADB可以与其他功能组合使用，比如同时实现ADB+串口：

# 添加串口功能 mkdir functions/gser.0 ln -s functions/gser.0 configs/c.1 # 更新UDC绑定 echo "" > UDC echo $udc > UDC

5.2 自动重连机制

创建/etc/udev/rules.d/51-android.rules实现自动连接：

SUBSYSTEM=="usb", ATTR{idVendor}=="1d6b", MODE="0666"

然后在PC端配置~/.android/adb_usb.ini：

0x1d6b

5.3 性能优化建议

提升传输速度：

echo 4096 > /sys/kernel/config/usb_gadget/g1/functions/ffs.adb/eps_out echo 4096 > /sys/kernel/config/usb_gadget/g1/functions/ffs.adb/eps_in

启用USB高速模式（需硬件支持）：

echo hs > /sys/kernel/config/usb_gadget/g1/udc

在实际项目中，我曾通过调整端点缓冲区大小将传输速度从8MB/s提升到15MB/s。不同硬件平台可能需要尝试不同的参数组合才能达到最佳性能。

嵌入式Linux开发板通过USB Gadget配置实现ADB调试