通过U-boot挂载Coral Dev Kit eMMC为USB存储时主机无法识别

硬件连接类排查 #

• 确认接口插对：必须插设备上标注OTG功能的Type-C接口（即出厂固件烧录专用口），不要接外接外设用的USB Host口，插错Host口不会触发任何USB设备枚举流程。
• 更换合规线材：优先换带数据传输功能的全功能Type-C线，排除仅供电的充电线——这类线没有连接数据引脚，板端即使显示加载动画，主机也完全收不到设备信号。
• 保证供电充足：执行ums命令时必须给开发板接原装12V DC独立供电，不要仅靠OTG口从主机取电，供电不足时USB gadget枚举会直接中断，加载动画仅代表命令触发，不代表映射正常。

U-boot操作与配置类排查 #

• 确认命令执行时机正确：ums命令必须在系统引导前、停留在U-boot交互命令行阶段执行。如果你已经能SSH连接到eMMC上运行的操作系统，说明eMMC已经被Linux内核挂载占用，存储控制器权限被系统接管，此时再切回U-boot执行ums映射会直接失效。正确操作是上电时触发U-boot中断，阻止系统自动从eMMC引导，再执行映射命令。
• 核对mmc设备编号：执行ums命令前先在U-boot下跑mmc list确认板载eMMC的实际编号，部分版本的Coral Dev Kit U-boot中，SD卡对应mmc 0，板载eMMC对应mmc 1，编号输错会映射空的SD卡槽，主机自然扫不到存储设备。
• 检查U-boot驱动完整性：执行ums 0 mmc [对应eMMC编号]后，看串口输出是否包含UMS: disk start sector相关的枚举成功日志，如果只有加载动画没有后续日志，说明当前U-boot版本没有编译USB gadget大容量存储驱动，需要先升级到官方最新版U-boot固件。

主机端排查 #

• OTG线直接插主机原生USB口，不要经过USB Hub扩展，部分USB Hub不支持USB gadget类设备的枚举透传。
• Linux主机执行dmesg -w开实时内核日志监控，执行ums命令后观察日志输出：如果完全没有新USB设备插入的日志，问题出在板端或连接链路；如果有设备插入日志但识别失败，检查主机是否加载了usb-storage驱动模块。
• Windows主机打开设备管理器，查看是否有带黄色感叹号的未知USB大容量存储设备，如有手动加载系统自带的通用USB存储驱动即可，同时确认本地组策略没有禁用未知USB存储设备的挂载权限。

内容的提问来源于stack exchange，提问作者brad