当前位置:首页 > 工业控制 > 工业控制
[导读]ARM板走OTG/Device口对接PC,最实用是ConfigFS搭复合Gadget:同一个USB枚举出CDC-ACM串口和Mass Storage U盘。相比老式g_serial/g_mass_storage独立加载,ConfigFS可在运行期自由组合功能、改VID/PID、加热插拔逻辑,工业调试“一根线同时看日志+拷配置”很省事。


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盘,比独立加载传统单功能模块更利于工业现场维护与批量烧录。



本站声明: 本文章由作者或相关机构授权发布,目的在于传递更多信息,并不代表本站赞同其观点,本站亦不保证或承诺内容真实性等。需要转载请联系该专栏作者,如若文章内容侵犯您的权益,请及时联系本站删除( 邮箱:macysun@21ic.com )。
关闭