记一次RK3568搭建NAS BUG:开发板插上 USB 移动硬盘没反应

项目场景:

在使用嵌入式 Linux 开发板RK3568搭建NAS时,我们经常会外接各种 USB 存储设备。通常情况下,插上 U 盘或硬盘,敲一行 lsblk 就能直接挂载使用。但最近,我遇到了一个极其顽固的问题:系统明明通过 lsusb 认出了硬盘盒,但在 lsblk 里就是死活刷不出磁盘节点(如 /dev/sda)。


问题描述

硬件环境与初始症状

  • 操作系统:Ubuntu 20.04 (内核版本 5.10.160)
  • 外接设备:搭载 JMicron JMS583 主控的 M.2 NVMe 转 USB 硬盘盒(一块机械硬盘)

症状表现:

执行 lsblk:只能看到板载的 eMMC (mmcblk0, mmcblk1),完全没有 /dev/sda。

执行 lsusb:设备赫然在列,显示 Bus 001 Device 002: ID 152d:0583 JMicron Technology...,甚至在详细信息中显示已经成功以 USB 2.0 高速模式握手。

硬件层认出来了,块设备层却没认出来。


排查过程:

第一阶段:排查供电与协议冲突

由于我使用单独电源给这个SATA转USB磁盘供电,所以排除是电源问题;

然后,检查UAS 协议不匹配问题。JMicron JMS583 主控在 Linux 下的 UAS协议兼容性臭名昭著。在 USB 2.0 环境下,极易出现响应超时,导致内核不断重置设备。随后,尝试通过 sudo modprobe usb-storage quirks=152d:0583:u (这个152d:0583是lsusb获取)命令临时屏蔽 UAS 协议。

但是系统无情报错:FATAL: Module usb-storage not found...这意味着我的系统内核并没有将 USB 存储驱动编译成可动态加载的 .ko 模块。

第二阶段:绕过 Udev 机制:通过 new_id 强制重定向驱动

我开始怀疑是USB存储驱动有问题,然后通过ls /sys/bus/usb/drivers发现usb-storage 和 uas 都在列表里!这说明驱动并没有被阉割,而是被静态编译在了内核中。

真正原因是:系统底层虽然有 usb-storage 驱动,但它拒绝自动去接管这个新插入的 JMicron 硬盘盒。

所以我通过下面指令强行让usb-storage 驱动接管152d:0583存储设备

bash 复制代码
# 将设备 ID 强行写入 usb-storage 的接管列表中
echo "152d 0583" | sudo tee /sys/bus/usb/drivers/usb-storage/new_id

最终解决方案:

  1. 编辑 /etc/rc.local 文件:
bash 复制代码
sudo nano /etc/rc.local

在文件末尾的 exit 0 上一行,添加以下内容:

bash 复制代码
echo "152d 0583" > /sys/bus/usb/drivers/usb-storage/new_id

这个152d 0583换成自己的设备

相关推荐
灼行2 天前
Autosar SecOC 需求场景BUG(需求不一致性)【草稿】
bug
小豆庄4 天前
视频遮罩追踪退场后ID撞号的排查—多目标场景下的失效
opencv·算法·bug·视频·python3.11
sg_knight6 天前
Bug 定位实战:把报错丢给 Codex,它是怎么修的
chatgpt·llm·bug·openai·agent·ai编程·codex
8年车载测试7 天前
汽车五大域详解:动力、底盘、车身、座舱与智驾域
汽车·bug·jira·uds诊断·ecu刷写测试·canoe工具
ะัี潪ิื9 天前
Redisson Bug回顾
bug
猫咪很可爱10 天前
MySQL 5.7 备份恢复后函数与存储过程丢失:原因分析与正确备份姿势
数据库·mysql·bug·shell
李永奉11 天前
杰理可视化SDK开发-【BUG】AC7006F8芯片开启一拖二和双麦DNS通话算法后,大概率通话时蓝牙自动断连,RAM空间爆了问题处理
单片机·嵌入式硬件·mcu·物联网·电脑·bug
8年车载测试13 天前
车载测试中如何通过 Jira 平台提交 Bug:操作步骤与关键要点
bug·jira·uds诊断·hil测试·uds自动化测试·ecu刷写测试·canoe工具
硅基手札14 天前
SPI技术系列 13 · SPI 调试与排查
linux·运维·stm32·单片机·嵌入式硬件·bug
李永奉14 天前
杰理可视化SDK开发-【BUG】AC7006F8芯片开启一拖二和双麦通话语音算法后,设置触摸音在唤醒语音助手和通话时触摸音没作用问题
单片机·嵌入式硬件·mcu·物联网·电脑·bug