1. 从一次真实的USB掉线说起上周三凌晨两点实验室的工控机突然报错接在USB口上的FT232R串口模块从系统里消失了。我第一反应是线松了换了根线还是没反应第二反应是模块烧了换了个新的照样识别不到。折腾了半小时才想起来敲lsusb结果发现设备其实挂在总线上只是驱动没绑上。这件事让我意识到很多人遇到USB识别问题第一反应是硬件坏了实际上软件层面的问题占了七成以上。这篇内容就是围绕lsusb这个命令展开的。它属于usbutils工具包是Linux系统里查看USB设备信息最直接的工具。不管你是刚接触Linux的新手还是天天跟嵌入式板子打交道的老手只要碰到USB设备识别不了、USB转串口没反应、USB转CANFD接口卡不工作这类问题lsusb都是排查链条上的第一站。我会把整个排查流程拆开讲清楚包括命令的每个参数怎么用、输出信息怎么读、不同现象对应什么问题、以及从lsusb出发往下一步步定位的方法。看完你至少能做到5分钟内判断出问题出在硬件层、驱动层还是权限层。需要说明的是文中涉及的具体操作步骤和参数解读一部分来自我自己的实操记录一部分是基于Linux USB子系统的通用机制做的合理补充。不同发行版和内核版本可能有细微差异但核心逻辑是一致的。2. lsusb命令到底在看什么2.1 USB子系统的三层结构要理解lsusb的输出得先知道Linux是怎么组织USB设备的。整个USB子系统大致分三层最底下是USB主机控制器Host Controller比如xHCI、EHCI、OHCI这些它们对应的是主板上的物理USB接口中间是USB总线Bus每条总线下面可以挂多个设备最上面是USB设备Device包括Hub和具体的外设。lsusb做的事情就是遍历/dev/bus/usb/下面的设备节点把内核已经枚举到的USB设备列出来。注意关键词是“已经枚举到”——如果设备连枚举都没完成lsusb是看不到它的。这一点很关键后面排查流程里会反复用到。你可以把USB枚举想象成新员工入职设备插上去相当于人到了公司门口主机控制器分配地址相当于发了工牌驱动绑定相当于安排了工位。lsusb能看到的是已经拿到工牌的人如果连工牌都没发那就得往更底层查。2.2 lsusb输出的每一列是什么意思直接跑一条最简单的命令lsusb典型输出长这样Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub Bus 001 Device 004: ID 0403:6001 Future Technology Devices International, Ltd FT232 Serial (UART) IC Bus 001 Device 003: ID 046d:c52b Logitech, Inc. Unifying Receiver Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub逐列拆解Bus 002设备挂在第2条USB总线上。总线编号由主机控制器决定一般主板后置接口和前置接口会分属不同总线。Device 001这条总线上的设备编号。注意这个编号是动态分配的设备重新插拔后会变所以不能拿它当设备的唯一标识。ID 1d6b:0003这是最关键的信息。冒号前面是厂商IDVendor ID简称VID后面是产品IDProduct ID简称PID。VID由USB-IF统一分配PID由厂商自己定义。比如0403是FTDI公司的VID6001是FT232R芯片的PID。Linux Foundation 3.0 root hub设备描述字符串由设备固件提供。root hub是主机控制器自带的根集线器不是外接设备。提示如果你只记得一个信息来搜驱动那就记VID:PID。Linux内核的驱动匹配就是靠这两个ID来的。2.3 常用参数组合与实际用途lsusb本身参数不多但组合起来很实用参数作用典型场景-v输出详细信息包括描述符、配置、接口、端点排查驱动绑定失败、供电不足-t以树形结构显示USB设备拓扑理清Hub层级关系定位哪个口有问题-d 0403:6001只显示指定VID:PID的设备确认特定设备是否被枚举-s 001:004只显示指定总线号:设备号的设备配合-v深入看某个设备-D /dev/bus/usb/001/004直接读取设备节点的描述符设备不在标准列表里时的备用手段我平时最常用的组合是lsusb -t先看拓扑确认设备挂在哪条总线、经过几级Hub然后再用lsusb -v -d VID:PID看具体描述符。这两个命令下去大部分“识别不了”的问题都能缩小范围。lsusb -t的输出大概是这样/: Bus 02.Port 1: Dev 1, Classroot_hub, Driverxhci_hcd/6p, 5000M /: Bus 01.Port 1: Dev 1, Classroot_hub, Driverxhci_hcd/12p, 480M |__ Port 3: Dev 4, If 0, ClassVendor Specific Class, Driverftdi_sio, 12M |__ Port 5: Dev 3, If 0, ClassHuman Interface Device, Driverusbhid, 12M这里能看到每个设备挂在哪条总线的哪个端口上以及绑定了什么驱动。如果某个设备的Driver后面是空的或者显示(none)那基本可以确定是驱动没绑上。3. 五步排查流程从lsusb到问题定位3.1 第一步确认设备是否被内核枚举插上设备立刻跑lsusb同时开另一个终端监控内核日志sudo dmesg -w然后重新插拔一次设备观察dmesg有没有新输出。正常枚举会看到类似这样的日志[ 1234.567890] usb 1-3: new full-speed USB device number 5 using xhci_hcd [ 1234.678901] usb 1-3: New USB device found, idVendor0403, idProduct6001 [ 1234.678902] usb 1-3: New USB device strings: Mfr1, Product2, SerialNumber3 [ 1234.789012] ftdi_sio 1-3:1.0: FTDI USB Serial Device converter detected如果dmesg完全没反应说明设备连枚举都没开始问题在更底层——可能是接口供电不足、线缆损坏、或者设备本身故障。如果dmesg有枚举日志但lsusb看不到那可能是权限问题或者usbutils版本太老。这一步的核心判断逻辑是dmesg有日志 lsusb能看到 枚举成功dmesg有日志 lsusb看不到 权限或工具问题dmesg无日志 硬件层问题。3.2 第二步看驱动有没有绑上枚举成功不代表能用。设备被内核认出来了但如果没有合适的驱动去绑定它的接口应用层照样访问不了。用lsusb -t看lsusb -t找到你的设备对应的那行看Driver后面是什么。以FT232R为例正常应该显示Driverftdi_sio。如果显示Driver(none)或者根本没有Driver字段说明驱动没绑上。这时候可以进一步看lsmod | grep ftdi如果模块没加载手动加载sudo modprobe ftdi_sio再重新插拔设备看驱动是否自动绑定。如果加载了模块还是不绑定可能是VID:PID不在驱动支持列表里需要手动添加echo 0403 6001 | sudo tee /sys/bus/usb-serial/drivers/ftdi_sio/new_id注意new_id这种方式是临时的重启后失效。永久生效需要写udev规则或者修改驱动源码重新编译。3.3 第三步检查设备节点有没有生成驱动绑上之后内核会在/dev/下面创建设备节点。对于USB转串口设备通常是/dev/ttyUSB0或者/dev/ttyACM0。检查ls -l /dev/ttyUSB*如果什么都没有但驱动确实绑上了可能是以下原因设备被其他驱动抢占了比如usbserial通用驱动先绑了内核模块参数限制了设备数量设备节点被删除了但驱动还认为存在可以看dmesg里有没有类似ftdi_sio: failed to create device的报错。另外检查/sys/class/tty/下面有没有对应的条目ls /sys/class/tty/ | grep -E USB|ACM3.4 第四步权限和用户组问题设备节点存在但应用打不开十有八九是权限问题。默认情况下/dev/ttyUSB0的属主是root:dialout权限是crw-rw----。普通用户不在dialout组里就没法访问。检查当前用户所属组groups如果没有dialout加进去sudo usermod -aG dialout $USER然后必须重新登录才生效。这一点很多人会忽略改完组之后直接在当前终端试发现还是不行以为方法错了。实际上组信息是在登录时加载的新开的终端如果没重新登录用的还是旧的组信息。临时方案是直接用sudo跑应用但不推荐长期这么干。更规范的做法是写udev规则给特定VID:PID的设备固定权限# /etc/udev/rules.d/99-ftdi.rules SUBSYSTEMtty, ATTRS{idVendor}0403, ATTRS{idProduct}6001, MODE0666, GROUPdialout写完规则后重新加载sudo udevadm control --reload-rules sudo udevadm trigger3.5 第五步排除供电和Hub干扰如果前面四步都过了设备节点也有权限也对但通信还是不稳定或者时好时坏那就要怀疑供电和Hub了。USB 2.0标准单个端口最大输出500mAUSB 3.0是900mA。有些设备峰值电流能到800mA以上插在Hub上就容易掉电重启。用lsusb -v看设备的MaxPower字段sudo lsusb -v -d 0403:6001 | grep -i MaxPower输出类似MaxPower 90mA说明设备声明自己最多用90mA。但注意这是设备声明的值实际峰值可能更高。如果设备工作不稳定试试直接插主板后置接口绕过前置面板和Hub。另外dmesg里如果出现device descriptor read/64, error -71或者cannot enable. Maybe the USB cable is bad?这类日志基本可以确定是物理层问题——换线、换口、换设备逐个排除。4. 典型场景与对应排查路径4.1 USB转串口设备识别不了这是最常见的一类问题。FT232R、CH340、CP2102、PL2303这些芯片方案在Linux下的表现各不相同。FT232R用的是ftdi_sio驱动内核自带一般插上就能用。但有些山寨模块用的FT232R是翻新芯片PID可能被改过导致驱动匹配不上。这时候用lsusb看到VID:PID是0403:6001但驱动不绑可以手动new_id。CH340的VID:PID是1a86:7523内核3.14以后自带ch341驱动。老内核需要自己编译驱动。如果lsusb能看到但/dev/ttyUSB0不出现检查ch341模块是否加载。CP2102的VID:PID是10c4:ea60驱动是cp210x。这个芯片比较稳定一般不会有问题。PL2303要注意老版本芯片和新版本HXA芯片的驱动不一样老驱动不支持新芯片会出现乱码或者无法通信。排查路径总结lsusb确认VID:PIDlsusb -t看驱动绑定情况dmesg看枚举和驱动加载日志ls /dev/ttyUSB*确认设备节点检查权限和用户组4.2 USB转CANFD接口卡不工作周立功这类USB转CANFD接口卡通常用的是FTDI的FT232H或者类似的USB桥接芯片加上一颗CAN控制器。Linux下需要专门的SocketCAN驱动比如gs_usb或者厂商提供的内核模块。lsusb能看到设备但ip link里没有can0接口说明驱动没加载或者没绑定。先确认内核模块lsmod | grep -E gs_usb|can_dev|can_raw如果没有加载sudo modprobe gs_usb sudo modprobe can_raw然后看dmesg有没有gs_usb相关的绑定日志。如果驱动加载了但接口还是不出现可能是设备的VID:PID不在gs_usb支持列表里需要手动添加或者用厂商提供的驱动。4.3 STM32开发板USB识别不了STM32的USB外设可以配置成多种模式CDC虚拟串口、HID、MSC、DFU等。如果板子插上后lsusb能看到设备但电脑端软件连不上先确认固件里USB描述符配置是否正确。常见问题是STM32的USB时钟配置错误导致枚举失败。dmesg里会看到device descriptor read/64, error -71或者unable to enumerate USB device。这种情况lsusb是看不到设备的因为枚举根本没完成。排查思路确认USB时钟源和分频配置正确48MHz确认DP/DM线没有接反确认VBUS检测电路正常用USB抓包工具看枚举过程卡在哪一步4.4 虚拟机里USB设备透传失败在虚拟机里用USB设备需要把物理机上的USB设备透传给虚拟机。常见问题是透传后虚拟机里lsusb看不到设备或者看到了但驱动不绑。先确认物理机上设备正常然后检查虚拟机的USB控制器配置。VMware和VirtualBox的USB透传机制不一样VMware需要安装VMware ToolsVirtualBox需要安装Extension Pack。透传成功后虚拟机里应该能看到和物理机一样的VID:PID。如果看不到检查虚拟机的USB控制器版本是否匹配设备速度USB 3.0设备需要xHCI控制器。5. 常见问题速查与避坑经验5.1 问题速查表现象可能原因排查命令解决方向lsusb完全看不到设备硬件故障、供电不足、线缆损坏dmesg -w换线、换口、换设备lsusb能看到但驱动不绑VID:PID不在驱动列表lsusb -t、lsmod手动new_id或写udev规则驱动绑了但无设备节点驱动冲突、模块参数限制dmesg、ls /sys/class/tty/卸载冲突驱动、调整模块参数设备节点存在但打不开权限不足、用户组不对ls -l /dev/ttyUSB*、groups加入dialout组或写udev规则通信不稳定、时断时续供电不足、Hub干扰lsusb -v看MaxPower直插后置接口、用带供电Hub虚拟机里看不到设备透传配置错误检查虚拟机USB控制器安装Tools/Extension Pack5.2 几个容易踩的坑坑一只看lsusb不看dmesg。lsusb只告诉你“现在有什么”dmesg告诉你“发生了什么”。排查问题时两个一起看才能形成完整的时间线。坑二改了用户组不重新登录。usermod -aG改完组之后当前会话的组信息不会更新。必须退出重新登录或者用newgrp dialout临时切换。我见过有人改完组之后重启了三次都没生效最后发现是没重新登录。坑三udev规则写错属性。写udev规则时ATTRS和ATTR要分清。ATTRS匹配的是父设备的属性ATTR匹配的是当前设备的属性。对于USB转串口设备VID:PID在父设备上所以要用ATTRS。写错了规则不生效而且不会有明显报错。坑四忽略USB Hub的层级。有些设备对Hub层级敏感超过一定级数就不工作。lsusb -t能看清拓扑结构如果设备挂在很深的层级上试试直插根Hub。坑五用Device号当唯一标识。Device号是动态分配的每次插拔都会变。写脚本或者规则时要用VID:PID或者序列号不能用Bus号和Device号。5.3 一个实用的调试脚本我平时会用一个简单的脚本快速收集USB设备信息省得每次手敲一堆命令#!/bin/bash # usb-debug.sh - 快速收集USB设备信息 echo lsusb lsusb echo echo lsusb -t lsusb -t echo echo USB串口设备 ls -l /dev/ttyUSB* /dev/ttyACM* 2/dev/null echo echo 最近USB相关内核日志 dmesg | grep -i usb | tail -30 echo echo 已加载USB相关模块 lsmod | grep -E usb|ftdi|ch34|cp210|pl230|gs_usb这个脚本在排查现场很管用一条命令把所有关键信息都抓出来方便对比分析。6. 从lsusb出发的进阶排查手段6.1 用usbmon抓包看枚举过程lsusb和dmesg能看到结果但看不到过程。如果枚举在某个环节失败了dmesg可能只给一个模糊的错误码。这时候需要上usbmon抓包。加载usbmon模块sudo modprobe usbmon然后看/sys/kernel/debug/usb/usbmon/下面有哪些总线ls /sys/kernel/debug/usb/usbmon/用cat读取对应总线的数据流sudo cat /sys/kernel/debug/usb/usbmon/1u输出是实时的USB数据包包括控制传输、中断传输、批量传输。枚举过程主要看控制传输特别是GET_DESCRIPTOR请求。如果设备在某个描述符请求后没有响应就能精确定位到哪一步失败了。这个手段比较底层适合驱动开发和固件调试场景。日常排查用dmesg加lsusb基本够了。6.2 用udevadm看设备属性udevadm是排查设备节点和权限问题的利器。插上设备后udevadm info -a -n /dev/ttyUSB0输出会列出设备的所有属性包括从父设备继承的VID:PID、序列号、物理路径等。写udev规则时就是从这里挑属性来匹配。还可以监控udev事件udevadm monitor --udev --property然后插拔设备看udev收到了什么事件、匹配了什么规则、最终创建了什么设备节点。如果规则没生效这里能看到原因。6.3 用lsusb -v看描述符细节lsusb -v的输出很长但有几个字段值得重点关注bMaxPower设备声明的最大电流判断供电是否足够bNumInterfaces接口数量复合设备会有多个接口bInterfaceClass接口类比如Vendor Specific Class表示厂商自定义bEndpointAddress端点地址看数据传输方向wMaxPacketSize端点最大包大小影响传输效率如果设备声明了多个接口但只有一个被驱动绑定其他接口显示Driver(none)那可能是驱动只支持部分功能。这种情况需要确认设备是否真的需要所有接口或者找支持完整功能的驱动。6.4 内核模块参数调整有些USB驱动有模块参数可以调整行为。比如usbserial驱动有vendor和product参数可以强制绑定特定设备sudo modprobe usbserial vendor0x0403 product0x6001ftdi_sio驱动有latency_timer参数调整读写延迟sudo modprobe ftdi_sio latency_timer1这些参数在调试通信超时问题时很有用。具体支持哪些参数可以看modinfo ftdi_sio7. 一些个人体会排查USB识别问题最忌讳的就是一上来就重装系统或者换硬件。我自己的经验是九成以上的问题都能在lsusb加dmesg的组合下定位到。关键是要有耐心按层次一步步来先确认枚举再确认驱动再确认设备节点最后确认权限和供电。每一步都有对应的命令和判断标准不要跳步。另外记录现场信息很重要。我习惯在排查前先跑一遍那个调试脚本把当前状态存下来。有时候改了一个配置问题变了但忘了之前是什么状态对比起来就很麻烦。有记录的话前后一对比变化点一目了然。最后说一个容易被忽略的点USB线缆的质量。劣质线缆的阻抗不匹配会导致信号完整性下降表现为枚举失败或者通信误码。我遇到过一根线插U盘正常插串口模块就不行换线就好了。所以排查到最后如果所有软件层面都正常别忘了换根好线试试。
驱动)
