RK182x USB ADB Gadget BusyBox 兼容性修复
本文记录 RK182x Buildroot 系统启动 USB ADB gadget 时,udc-select.sh 使用 Bash 数组语法导致 BusyBox ash 报错的问题及修复方法。
异常现象
板端已安装 /usr/bin/adbd,执行 USB gadget 启动命令后日志报错:
/usr/bin/usb-gadget: /etc/usb-gadget.d/udc-select.sh: line 149: syntax error: bad substitution
错误发生在检测 USB Device Controller(UDC)前,导致 ADB FunctionFS 和 USB gadget 均未完成创建。
原因
USB gadget 脚本使用 Bash 解释器:
#!/bin/bash
但当前 Buildroot rootfs 中 /bin/bash 实际指向 BusyBox:
/bin/bash -> busybox
udc-select.sh 原代码使用 Bash 专属的数组变量语法:
if [ "${BASH_SOURCE[0]}" != "$0" ]; then
USB_UDC=$UDC_SELECT
else
echo "UDC is $UDC_SELECT"
fi
BusyBox ash 不支持 ${BASH_SOURCE[0]},因此出现 bad substitution。
SDK 修复
修改文件:
device/rockchip/common/overlays/rootfs/usb-gadget/etc/usb-gadget.d/udc-select.sh
使用 USB gadget 主脚本已设置的 USB_GADGET_DIR 判断是否由主脚本加载,避免 Bash 数组语法:
# This file is sourced by usb-gadget. BusyBox ash does not support
# the BASH_SOURCE array used to distinguish sourced execution.
if [ -n "$USB_GADGET_DIR" ]; then
USB_UDC=$UDC_SELECT
else
echo "UDC is $UDC_SELECT"
fi
本地 Git 分支和提交:
repository: device/rockchip
branch: rk182x-adb-fix
commit: de6c4aea usb-gadget: support BusyBox ash UDC selection
已通过以下检查:
busybox ash -n common/overlays/rootfs/usb-gadget/etc/usb-gadget.d/udc-select.sh
git show --check --oneline HEAD
重新生成镜像
在 SDK 根目录执行:
cd /home/user/SDK/rk182x_linux
./build.sh rootfs
./build.sh firmware
该流程重新生成 rootfs 和更新包,不重新编译 kernel 或 U-Boot。完整包路径为:
output/firmware/update.img
板端临时修复
若需要先在已刷写板端验证,可备份并修改脚本第 141 行:
cp -p /etc/usb-gadget.d/udc-select.sh /userdata/udc-select.sh.bak
sed -i '141c\ if [ -n "$USB_GADGET_DIR" ]; then' /etc/usb-gadget.d/udc-select.sh
sh -n /etc/usb-gadget.d/udc-select.sh
随后重启 USB gadget:
/usr/bin/usb-gadget stop
sleep 1
/usr/bin/usb-gadget start
sleep 2
tail -n 30 /var/log/usb-gadget.log
该板端临时修改会在下次刷写 rootfs 后丢失,应以 SDK 修复后的 rootfs 为准。
预期结果与后续检查
修复后,日志不应再出现 bad substitution。执行以下命令检查 UDC 和 ADB FunctionFS:
ls /sys/class/udc
ls -l /dev/usb-ffs/adb
cat /var/log/usb-gadget.log
- 若日志显示
Selected UDC device: ...,表示 gadget 已找到并绑定 USB Device 控制器。 - 若日志显示
Failed to find a valid UDC device...,表示脚本兼容性问题已解决,后续应检查 USB OTG/DRD 硬件连接、Device Tree 和 DWC3 gadget 驱动。