1. 从一次真实的USB设备“失联”说起上周三凌晨一点实验室的工控机突然读不到那台用了三年的周立功USBCANFD接口卡了。dmesg里刷了一屏的device descriptor read/64, error -71插拔了七八次换了三个USB口甚至把机箱后面板所有接口都试了一遍设备依然像人间蒸发一样。当时第一反应是驱动崩了重装libusb、重编内核模块折腾了快两个小时最后用lsusb一敲发现设备压根没出现在总线上——问题根本不在驱动层而是USB物理链路或者供电出了岔子。这件事让我意识到一个很普遍的现象很多人遇到Linux下USB设备识别不了第一反应就是去查驱动、翻内核日志、重装系统却忽略了最基础也最有效的一步——先用lsusb把问题范围框定下来。lsusb这个命令看起来简单但它能帮你把“设备到底有没有被系统看到”这件事说清楚而这一步恰恰是排查所有USB问题的起点。这篇文章就是围绕lsusb这个核心工具把Linux下USB设备识别失败的排查流程完整拆一遍。不管你是插了USB转串口模块没反应还是STM32开发板连上电脑后/dev/ttyUSB0死活不出来又或者是USB Blaster、USBCANFD接口卡这类专业设备突然罢工这套流程都能帮你快速定位问题出在哪一层。内容会从USB协议的基础逻辑讲起再到lsusb的详细用法、输出解读、常见故障分类排查最后给出一套可以直接照着走的排查清单。适合有一定Linux基础、平时需要跟各种USB外设打交道的开发和运维人员参考。2. 为什么lsusb是USB排查的第一入口2.1 USB设备的枚举过程与lsusb的定位要理解lsusb为什么这么关键得先搞清楚Linux系统是怎么“看见”一个USB设备的。当你把设备插进USB口的那一刻系统内部发生了一系列标准化的枚举流程主机控制器检测到端口电平变化给设备供电然后发起复位操作接着通过控制端点0读取设备描述符分配地址再读取配置描述符、接口描述符、端点描述符最后根据设备类代码加载对应的驱动。整个过程走完设备才算真正“上线”。lsusb做的事情就是直接读取/sys/bus/usb/devices/和/dev/bus/usb/下的信息把当前总线上已经完成枚举的设备列出来。换句话说只要lsusb能看到设备就说明USB物理层、电气层、协议层的枚举至少走通了大部分如果lsusb看不到那问题一定出在枚举完成之前跟内核驱动、文件系统、应用程序都没关系。这个判断逻辑非常重要。很多人一上来就dmesg | grep usb看到一堆报错就慌了但其实dmesg里的信息量太大有控制器初始化的、有枚举失败的、有驱动绑定的混在一起很难快速定位。而lsusb给出的是一份“当前在线设备清单”干净利落一眼就能判断设备到底有没有被系统认到。2.2 lsusb与dmesg、/sys、/dev的分工在实际排查中lsusb不是孤立的它和另外几个信息源配合使用才能发挥最大价值。我习惯把它们的分工这样理解信息源回答的问题使用时机lsusb设备有没有被系统枚举到第一步判断问题层级dmesg枚举过程中发生了什么错误第二步看具体失败原因/sys/bus/usb/devices/设备的详细描述符和拓扑第三步深入分析设备能力/dev/设备节点有没有生成第四步确认用户空间可用性这个顺序很关键。先用lsusb确认设备是否在线如果在线但功能不正常再去dmesg看驱动绑定情况如果不在线直接跳到物理层和供电层排查。这样一层层往下走不会像无头苍蝇一样乱撞。2.3 一个容易被忽略的细节lsusb看到的不等于能用这里要特别提醒一点lsusb能看到设备只代表USB枚举完成了不代表驱动加载成功更不代表应用程序能正常使用。我见过太多案例lsusb里设备赫然在列但/dev/ttyUSB0就是不出来或者出来了但一读就报Input/output error。这种情况问题往往出在驱动层或者设备固件层需要结合dmesg和/sys继续深挖。反过来如果lsusb看不到设备那就不用浪费时间查驱动了直接去查线缆、供电、端口、BIOS设置这些底层问题。这个判断能帮你省下大量无效折腾的时间。3. lsusb命令的完整用法与输出解读3.1 基础用法与常用参数lsusb的基本用法非常简单直接敲命令就行lsusb输出大概长这样Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub Bus 001 Device 003: ID 0403:6001 Future Technology Devices International, Ltd FT232 Serial (UART) IC Bus 001 Device 002: ID 046d:c52b Logitech, Inc. Unifying Receiver Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub每一行的结构是Bus XXX Device YYY: ID VVVV:PPPP 厂商描述。其中VVVV是厂商IDVIDPPPP是产品IDPID这两个是识别设备身份的核心标识。常用的参数有这么几个lsusb -t以树形结构显示USB拓扑能清楚看到设备挂在哪个控制器、哪个Hub下面排查端口问题时特别有用。lsusb -v输出设备的完整描述符信息包括配置、接口、端点、设备类、供电参数等信息量极大通常配合-d指定具体设备使用。lsusb -d VVVV:PPPP只看指定VID:PID的设备比如lsusb -d 0403:6001只看FT232芯片的设备。lsusb -s Bus:Device只看指定总线号和设备号的设备比如lsusb -s 001:003。lsusb -D /dev/bus/usb/001/003直接读取指定设备节点的描述符适合设备节点存在但lsusb列表里看不到的诡异情况。我平时排查用得最多的是lsusb和lsusb -t这两个前者看设备清单后者看拓扑关系。-v参数输出太长一般只在需要确认设备类代码或者端点配置时才用。3.2 输出信息逐字段拆解拿上面那行FT232设备举例Bus 001 Device 003: ID 0403:6001 Future Technology Devices International, Ltd FT232 Serial (UART) ICBus 001设备挂在第1号USB总线上。Linux系统里每条USB总线对应一个主机控制器总线号在系统启动时分配。Device 003这是设备在总线上的地址每次插拔都会重新分配所以同一个设备在不同时间插可能显示不同的Device号。ID 0403:60010403是FTDI公司的VID6001是FT232R芯片的PID。这两个号码是USB-IF分配给厂商的全球唯一。Future Technology Devices International, Ltd厂商名称来自设备描述符里的字符串描述符。FT232 Serial (UART) IC产品名称同样来自设备描述符。这里有个经验点如果厂商名称和产品名称显示为空白或者乱码往往说明设备描述符读取不完整可能是固件有问题或者供电不稳导致枚举中断。这种情况即使lsusb能看到设备后续功能也大概率不正常。3.3 用lsusb -t看拓扑结构lsusb -t的输出是这样的/: Bus 02.Port 1: Dev 1, Classroot_hub, Driverxhci_hcd/4p, 5000M /: Bus 01.Port 1: Dev 1, Classroot_hub, Driverxhci_hcd/16p, 480M |__ Port 5: Dev 3, If 0, ClassVendor Specific Class, Driverftdi_sio, 12M |__ Port 7: Dev 2, If 0, ClassHuman Interface Device, Driverusbhid, 12M这个视图能直观看到几件事设备挂在哪个总线的哪个端口上、走的什么速度12M是全速480M是高速5000M是超高速、绑定了什么驱动。排查“设备插在Hub上不识别”这类问题时lsusb -t能帮你确认设备到底有没有出现在拓扑里以及它协商到的速度是否正常。我遇到过一种情况USB 3.0的移动硬盘插在USB 2.0的Hub上lsusb能看到设备但lsusb -t显示速度只有480M而且设备频繁掉线。后来换到直连主板的USB 3.0口就正常了。这就是拓扑和速度协商的问题光看lsusb列表是发现不了的。3.4 用lsusb -v深挖设备描述符当你需要确认设备的类代码、端点配置、供电需求时lsusb -v是唯一的选择。比如查一个USB转串口设备lsusb -v -d 0403:6001输出里重点看这几段bDeviceClass设备类代码。00表示由接口定义类02是通信类08是大容量存储类FF是厂商自定义。bNumConfigurations配置数量通常是1。bNumInterfaces接口数量。USB转串口设备通常有1个接口复合设备可能有多个。bNumEndpoints端点数量。串口设备一般有3个端点控制、批量输入、批量输出。bMaxPower设备从总线取的最大电流单位是2mA。比如bMaxPower 100mA表示取200mA。这里有个很实用的排查点如果bMaxPower显示的值超过了你所接端口的供电能力设备就可能因为供电不足而枚举失败。特别是USB 2.0端口标准供电是500mA如果设备要900mA插在USB 2.0口上就可能出问题必须换USB 3.0口或者带外部供电的Hub。4. USB设备识别失败的分类排查流程4.1 第一层lsusb完全看不到设备这是最常见也最让人头疼的情况。设备插上去lsusb列表里完全没有新增行dmesg里可能连枚举开始的日志都没有。问题一定出在枚举完成之前按以下顺序排查物理连接检查。先换一根USB线。别觉得这是废话我踩过至少三次坑都是线的问题有一次是线内部断了D或D-供电正常但数据不通还有一次是劣质线缆导致信号完整性太差低速设备能认高速设备就枚举失败。换线之后问题直接消失。另外检查接口有没有氧化、松动特别是工控环境里用了两三年的机器USB口积灰导致接触不良很常见。端口和Hub排查。把设备从Hub上拔下来直连主板后置USB口。很多前置面板的USB口是通过排线接到主板针脚上的排线质量差或者没插紧都会导致设备不识别。如果是笔记本换另一侧的USB口试试有些笔记本的USB口是挂在不同控制器下的供电能力也不一样。供电问题确认。大功率设备移动硬盘、USBCANFD接口卡、带外部供电的USB Hub对电流要求高。用lsusb -v看设备的bMaxPower如果超过500mA必须接外部供电或者换USB 3.0口。有个简单的判断方法插上设备后摸一下设备外壳或者接口附近如果明显发热但系统不认大概率是供电不足导致枚举反复重启。BIOS/UEFI设置检查。有些工控机或者服务器默认关闭了USB控制器或者把USB模式设成了“仅键盘鼠标”。进BIOS看USB Configuration里的USB Controller、XHCI Hand-off、Legacy USB Support这些选项确保USB控制器是启用的。虚拟机里跑Linux的话还要确认USB设备有没有从宿主机直通给虚拟机。内核模块检查。确认xhci_hcd、ehci_hcd、ohci_hcd、uhci_hcd这些主机控制器驱动有没有加载lsmod | grep -E xhci|ehci|ohci|uhci如果全都没有说明USB控制器驱动没加载lsusb自然什么都看不到。这种情况需要检查内核配置或者重新加载模块。4.2 第二层lsusb能看到但设备节点不生成lsusb里设备在列但/dev/ttyUSB0、/dev/ttyACM0这些设备节点死活不出来。问题出在驱动绑定阶段排查思路如下确认驱动是否匹配。用lsusb -t看设备的Driver字段。如果显示Driver(none)或者空白说明没有驱动绑定。这时候需要确认内核有没有编译对应的驱动模块。比如FT232R需要ftdi_sio模块CH340需要ch341模块CP210x需要cp210x模块。modprobe ftdi_sio modprobe ch341 modprobe cp210x加载后再看lsusb -t如果驱动绑上了设备节点通常就会自动生成。检查VID:PID是否在驱动支持列表里。有些国产USB转串口芯片用的是厂商自定义的VID:PID标准驱动不认。比如某些CH340的变种芯片PID不是7523而是其他值ch341驱动就不会自动绑定。解决方法是用new_id手动添加echo 1a86 5523 /sys/bus/usb-serial/drivers/ch341/new_id这个操作需要root权限而且重启后失效要持久化得写进/etc/udev/rules.d/下的规则文件。看dmesg里的驱动绑定日志。dmesg | tail -50重点找usb-serial、ttyUSB、ttyACM相关的行。如果看到usb 1-5: ch341-uart converter now attached to ttyUSB0说明驱动绑定成功设备节点应该已经生成了。如果看到probe failed或者device not accepting address那就是驱动探测失败需要进一步分析。权限问题排查。设备节点生成了但普通用户访问不了表现为Permission denied。用ls -l /dev/ttyUSB0看权限通常是crw-rw---- root dialout。把当前用户加入dialout组sudo usermod -aG dialout $USER然后重新登录生效。这个坑很常见特别是Ubuntu新版本默认把用户放在dialout组外面。4.3 第三层设备节点存在但功能异常设备节点有了但一读写就报错或者数据乱码、频繁掉线。这类问题往往跟供电、固件、协议配置有关供电稳定性排查。用dmesg -w实时监控插上设备后观察有没有device descriptor read/64, error -71、reset full-speed USB device、usb 1-5: USB disconnect这类反复出现的日志。如果有基本可以确定是供电或者信号完整性问题。换带外部供电的Hub或者换一根带磁环的屏蔽线往往能解决。波特率与流控配置。USB转串口设备在Linux下用stty配置波特率stty -F /dev/ttyUSB0 115200 cs8 -cstopb -parenb如果波特率不匹配读出来的就是乱码。另外注意硬件流控RTS/CTS有没有正确配置有些设备需要流控才能正常通信。固件版本确认。某些USB设备比如FTDI的FT232R有EEPROM固件如果固件损坏或者配置错误设备能枚举但功能不正常。用lsusb -v看iSerial、iProduct这些字符串描述符是否正常如果显示异常可能需要用厂商工具重新烧录固件。USB协议分析。如果以上都排查了还是有问题就需要上USB抓包工具了。Linux下可以用usbmon内核模块配合tcpdump或者Wireshark抓USB流量modprobe usbmon ls /sys/kernel/debug/usb/usbmon/然后tcpdump -i usbmon1 -w usb.pcap抓包用Wireshark分析。这个手段比较重一般只在驱动开发或者协议调试时用。4.4 第四层特定设备的特殊问题不同类型的USB设备有各自的“脾气”这里列几个常见的设备类型典型问题排查重点USB转串口FT232/CH340/CP210x驱动不绑定、设备节点不生成确认VID:PID、加载对应模块、检查new_idUSB BlasterFPGA下载器权限不足、udev规则缺失添加udev规则、确认usbblaster驱动USBCANFD接口卡供电不足、驱动版本不匹配外部供电、厂商驱动版本确认STM32开发板USB枚举失败、DFU模式识别检查BOOT引脚、确认DFU驱动USB摄像头带宽不足、格式不支持换USB控制器、确认UVC驱动USB存储设备分区表损坏、文件系统不识别lsblk、fdisk -l、fsck拿USB Blaster举例这是Altera FPGA下载器在Linux下需要usbblaster驱动和对应的udev规则。如果规则没配好普通用户没权限访问Quartus就认不到下载器。解决方法是创建/etc/udev/rules.d/51-usbblaster.rulesSUBSYSTEMusb, ATTR{idVendor}09fb, ATTR{idProduct}6001, MODE0666然后udevadm control --reload-rules重新加载。5. 一套可以直接抄的排查清单5.1 五分钟快速定位流程把上面的排查逻辑浓缩成一个可以照着走的流程第1分钟确认设备是否被枚举lsusb lsusb -t对比插拔前后的输出看设备有没有出现。如果出现了记下Bus号和Device号进入第3分钟。如果没出现进入第2分钟。第2分钟物理层和供电排查换USB线、换端口、直连主板检查dmesg | tail -30有没有枚举错误确认BIOS里USB控制器启用大功率设备接外部供电第3分钟驱动绑定确认lsusb -t | grep -A2 Bus dmesg | grep -E usb|tty看Driver字段有没有绑定看dmesg里有没有now attached to ttyUSBx。第4分钟设备节点和权限ls -l /dev/ttyUSB* /dev/ttyACM* groups确认节点存在、权限正确、用户在dialout组。第5分钟功能验证stty -F /dev/ttyUSB0 115200 cat /dev/ttyUSB0或者用minicom、screen、picocom做实际通信测试。5.2 常见错误信息速查表dmesg错误信息含义解决方向device descriptor read/64, error -71枚举时读取描述符失败供电、线缆、端口device not accepting address设备不接受分配的地址供电、固件、控制器兼容性unable to enumerate USB device枚举彻底失败物理层、供电、BIOS设置usb 1-5: reset full-speed USB device设备反复复位供电不稳、线缆质量差probe of 1-5:1.0 failed with error -5驱动探测失败驱动不匹配、固件问题ch341-uart converter now attached to ttyUSB0驱动绑定成功正常检查权限usbfs: interface 0 claimed by ftdi_sio接口被驱动占用正常说明驱动已绑定5.3 几个我踩过的坑和对应技巧坑一虚拟机USB直通后宿主机抢设备。在VMware或VirtualBox里把USB设备直通给Linux虚拟机结果宿主机又自动挂载了。解决方法是先在宿主机里把设备断开再在虚拟机设置里勾选“显示所有USB设备”然后手动连接。VirtualBox还需要装Extension Pack才能支持USB 2.0/3.0。坑二USB 3.0设备插在USB 2.0口上枚举失败。有些USB 3.0设备对供电要求高插在USB 2.0口上虽然lsusb能看到但速度协商失败设备反复掉线。lsusb -t里会显示480M而不是5000M。换USB 3.0口即可。坑三国产USB转串口芯片VID:PID不标准。某些CH340模块的PID是5523而不是标准的7523ch341驱动不自动绑定。用new_id手动添加后正常。这个技巧在工控现场特别实用因为很多国产模块为了规避驱动冲突会改PID。坑四udev规则写错导致设备节点权限不对。写udev规则时ATTR{idVendor}和ATTR{idProduct}的匹配要精确大小写敏感。规则文件放/etc/udev/rules.d/下文件名以数字开头比如99-mydevice.rules。改完记得udevadm control --reload-rules udevadm trigger。坑五lsusb看到设备但dmesg里没有任何驱动日志。这种情况往往是设备描述符读取不完整系统认到了设备但无法识别它的类代码。用lsusb -v -d VVVV:PPPP看bDeviceClass和bInterfaceClass如果是00或者FF说明设备需要厂商自定义驱动。这时候要么装厂商驱动要么用libusb写用户态程序直接操作。6. 从lsusb延伸出去的几个实用技巧6.1 用udev规则固化设备节点名USB转串口设备插拔后设备节点号会变今天ttyUSB0明天可能变ttyUSB1写脚本时很麻烦。用udev规则可以根据VID:PID和序列号固定节点名SUBSYSTEMtty, ATTRS{idVendor}0403, ATTRS{idProduct}6001, ATTRS{serial}A50285BI, SYMLINKttyFT232这样无论插拔多少次/dev/ttyFT232始终指向这个设备。序列号用lsusb -v -d 0403:6001 | grep iSerial查。6.2 用usbmon做协议级抓包前面提过usbmon这里补充一下具体用法。加载模块后/sys/kernel/debug/usb/usbmon/下会有0u、1u、2u等文件对应不同总线。用cat直接读或者用tcpdump抓cat /sys/kernel/debug/usb/usbmon/1u usb.log输出是文本格式的USB事务记录能看到控制传输、批量传输的原始数据。分析枚举失败时特别有用能看到具体是在哪个描述符读取阶段出的错。6.3 用lsusb配合脚本做设备监控写个简单的监控脚本设备插拔时自动记录#!/bin/bash while true; do lsusb /tmp/usb_now.txt if ! diff -q /tmp/usb_last.txt /tmp/usb_now.txt /dev/null 21; then echo USB设备变化$(date) diff /tmp/usb_last.txt /tmp/usb_now.txt cp /tmp/usb_now.txt /tmp/usb_last.txt fi sleep 2 done这个脚本在调试频繁插拔的设备时很好用能自动记录每次变化的时间点和设备差异。6.4 关于USB总线频率和设备兼容性USB 2.0的全速模式是12Mbps高速模式是480MbpsUSB 3.0是5GbpsUSB 3.1是10Gbps。有些老设备只支持低速1.5Mbps或全速插在USB 3.0口上可能因为控制器兼容性问题枚举失败。lsusb -t里能看到每个设备协商到的速度。如果发现设备协商速度异常低可以尝试在BIOS里关闭XHCI Hand-off或者把设备插到USB 2.0口上。另外USB Hub的级联层数也有限制规范最多7层。超过7层会导致枚举失败。工控现场如果用了多级Hub要确认拓扑深度没有超标。7. 写在最后的一些个人体会排查USB设备识别问题这件事说到底就是一层层剥洋葱先用lsusb确认设备有没有被系统看到再根据看到与否决定往哪个方向深挖。这个判断逻辑看起来简单但实际工作中能帮你省下大量无效折腾的时间。我见过太多人一上来就重装驱动、重编内核结果折腾半天发现是USB线坏了。lsusb这个命令本身没什么复杂的但它的价值在于给你一个清晰的起点。配合dmesg、lsusb -t、/sys这些信息源基本上90%以上的USB识别问题都能在五分钟内定位到大致方向。剩下的就是根据方向去具体排查该换线的换线该加驱动的加驱动该写udev规则的写udev规则。最后分享一个小习惯我在每台经常接USB外设的Linux机器上都会放一个usb-debug.sh脚本里面就是前面那套五分钟排查流程的自动化版本插上设备后一键跑一遍输出lsusb、lsusb -t、dmesg | tail -50、/dev/tty*列表和权限信息。这样即使半夜被叫起来处理问题也能快速进入状态不用从头回忆命令。这个脚本后来在团队里传开了大家都觉得比翻文档快得多。