嵌入式Linux下USB Gadget驱动开发:把ARM设备模拟成虚拟串口与U盘
ARM板走OTG/Device口对接PC,最实用是ConfigFS搭复合Gadget:同一个USB枚举出CDC-ACM串口和Mass Storage U盘。相比老式g_serial/g_mass_storage独立加载,ConfigFS可在运行期自由组合功能、改VID/PID、加热插拔逻辑,工业调试“一根线同时看日志+拷配置”很省事。
一、内核与DTS底座
menuconfig至少开:
CONFIG_CONFIGFS_FS=y
CONFIG_USB_GADGET=y
CONFIG_USB_CONFIGFS=y
CONFIG_USB_CONFIGFS_ACM=y
CONFIG_USB_CONFIGFS_MASS_STORAGE=y
CONFIG_USB_LIBCOMPOSITE=m/y
# SoC UDC驱动,如DWC2/DWC3/MUSB/CI_HDRC,按板选
CONFIG_USB_DWC2=y
DTS里OTG节点dr_mode按需求设"otg"或"peripheral",VBUS检测、角色切换要正常;有些板没有VBUS脚要在DTS强制vbus-valid,否则主机认不到设备。 启动后确认UDC存在:
mount -t configfs none /sys/kernel/config
ls /sys/class/udc/
modprobe libcomposite
udc目录为空说明UDC驱动没起来,后面写UDC会失败。
二、先做U盘后端镜像
U盘功能需要“后端文件”或块设备;用镜像最灵活,且可先在板端写数据再导出:
dd if=/dev/zero of=/data/export.img bs=1M count=64
mkfs.vfat -F 32 /data/export.img
mkdir -p /mnt/export
mount -o loop /data/export.img /mnt/export
cp /etc/app.conf /mnt/export/
sync; umount /mnt/export
重点:镜像交给gadget后,板端不要再mount同一文件;双端同时写会导致主机看到的文件系统错乱。只读导出日志可加ro,可写固件投放用可写镜像。
三、ConfigFS建复合Gadget
脚本化最稳,ACM+MassStorage挂同一配置c.1:
G=/sys/kernel/config/usb_gadget/g1
mkdir -p $G
echo 0x1d6b > $G/idVendor # Linux Foundation测试用,量产换自有VID
echo 0x0104 > $G/idProduct # 复合设备demo PID
echo 0x0200 > $G/bcdUSB
echo 0x0100 > $G/bcdDevice
mkdir -p $G/strings/0x409
echo "ARMFactory" > $G/strings/0x409/manufacturer
echo "ACM+UDisk" > $G/strings/0x409/product
echo "SN0001" > $G/strings/0x409/serialnumber
mkdir -p $G/configs/c.1/strings/0x409
echo "ACM_MS_Config" > $G/configs/c.1/strings/0x409/configuration
echo 250 > $G/configs/c.1/MaxPower
# 虚拟串口
mkdir -p $G/functions/acm.ser0
# U盘
mkdir -p $G/functions/mass_storage.disk0
echo /data/export.img > $G/functions/mass_storage.disk0/lun.0/file
echo 1 > $G/functions/mass_storage.disk0/lun.0/removable
ln -s $G/functions/acm.ser0 $G/configs/c.1/
ln -s $G/functions/mass_storage.disk0 $G/configs/c.1/
UDC=$(ls /sys/class/udc/ | head -n1)
echo $UDC > $G/UDC
绑定成功后板端出/dev/ttyGS0,主机识别ttyACM0和USB大容量设备;多LUN可继续建lun.1、lun.2。 要换配置先echo "" > $G/UDC解绑,再改函数、重绑,不必重启。
四、串口业务对接
ACM不需自己写驱动,应用直接读写字符设备:
int fd = open("/dev/ttyGS0", O_RDWR|O_NONBLOCK);
const char *msg = "boot ok\r\n";
write(fd, msg, strlen(msg));
// 主机串口工具打开ttyACM0即可双向收发
若做调试控制台,可让getty/login绑ttyGS0;若做机台协议,自己实现帧解析,别把printk和Gadget业务混在一起。Windows主机认CDC-ACM通常免驱,个别老系统要inf;Linux/macOS直出ttyACM。
五、U盘写回与安全管理
主机往U盘写固件后,板端处理流程:
# 主机安全弹出后,gadget可重新绑
echo "" > $G/UDC
mkdir -p /mnt/in
mount -o loop /data/export.img /mnt/in
cp /mnt/in/firmware.bin /opt/fw/
sync; umount /mnt/in
# 更新后再导出
echo $UDC > $G/UDC
敏感场景用ro=1防止主机改镜像;可写场景建议removable=1,主机弹出再落盘,避免热拔损坏FAT。 后端也可直接给/dev/mmcblkXpY,但块设备被gadget占用时板端不要同时挂载。
六、调试排错清单
主机无反应:ls /sys/class/udc看控制器名,dmesg查dwc2/dwc3/musb bound;确认OTG口是Device/OTG而不是Host。
只出U盘不出串口:检查acm函数目录、c.1软链、主机CDC驱动;PID/VID与旧驱动冲突可换测试VID。
串口能通U盘不识别:lun.0/file路径是否存在、镜像是否FAT/ext干净、是否已被本地mount。
枚举反复断开:MaxPower电流、USB线数据通路、VBUS供电、UDC中断优先级的排查。
量产固定:把上述脚本放进systemd/procd,UDC名从dts或udc目录动态取,VID/PID、镜像大小、ro/removable全参数化。
按ConfigFS把ACM与MassStorage合成单一Gadget,ARM设备插PC即同时获得调试串口和可拷文件U盘,比独立加载传统单功能模块更利于工业现场维护与批量烧录。





