调试 / TSENGCHEN BLOG

2026-08-27_RK182x_USB_ADB_gadget_BusyBox兼容性修复

02_Debug · 第 9 / 16 篇

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 驱动。
02_Debug · 文档目录
上一篇2026-08-27_RK182x_OpenSBI启动Illegal_instruction修复下一篇2026-09-07_RK3576_TEST1_DSMC_FPGA验证与板端SDK配置对比