3. 内核日志基础：dmesg命令详解、日志级别与USB过滤

在USB Gadget故障排查中，内核日志是第一道防线。无论是驱动加载失败、枚举错误还是端点配置异常，Linux内核都会通过printk输出诊断信息。掌握dmesg命令、理解日志级别、精准过滤USB相关日志，是每个嵌入式开发者必须练就的基本功。

3.1 dmesg命令详解

dmesg（diagnostic message）用于读取内核环形缓冲区（kernel ring buffer）中的日志。该缓冲区记录了从系统启动到当前时刻的所有内核消息，包括USB设备插拔、驱动绑定、错误警告等。

3.1.1 常用选项速查

3.1.2 典型用法示例

# 查看所有USB相关日志（不区分大小写）
dmesg | grep -i usb

# 实时跟踪USB Gadget相关日志
dmesg -Tw | grep -i gadget

# 仅显示错误和警告级别的USB日志
dmesg -l err,warn | grep -i usb

# 查看最近10条USB日志
dmesg | grep -i usb | tail -10

# 清除缓冲区后重新加载g_ether模块并观察
dmesg -c
modprobe g_ether
dmesg | tail -20

3.2 日志级别：从KERN_EMERG到KERN_DEBUG

Linux内核使用8个日志级别（log level）来标记消息的严重程度。级别越低（数字越小），优先级越高。USB Gadget驱动通常使用KERN_ERR、KERN_WARNING、KERN_INFO和KERN_DEBUG四个级别。

3.2.1 日志级别对照表

3.2.2 日志级别过滤实战

# 仅查看错误级别及以上的USB日志
dmesg -l emerg,alert,crit,err | grep -i usb

# 查看所有级别（包括调试）的USB Gadget日志
dmesg -l 0-7 | grep -i gadget

# 查看信息级别日志（通常包含枚举成功信息）
dmesg -l info | grep -i usb

3.3 如何过滤USB相关日志

USB子系统在内核中由多个模块组成，包括usbcore、usb-storage、usbhid、gadget等。过滤USB日志需要结合设施类型、关键词和日志级别三种手段。

3.3.1 按设施类型过滤

从Linux 3.x开始，dmesg -f支持按设施（facility）过滤。USB相关的设施包括：

3.3.2 按关键词过滤

关键词过滤是最灵活的方式，适用于所有内核版本。USB Gadget调试中常用的关键词包括：

• usb：所有USB相关日志
• gadget：Gadget框架日志（如g_ether、g_serial、g_mass_storage）
• dwc2 / dwc3 / musb：特定控制器驱动日志
• configfs：ConfigFS方式配置Gadget时的日志
• UDC：USB Device Controller相关日志
• ep0 / ep1：端点相关日志
• enum：枚举过程日志

# 多关键词组合过滤（显示USB Gadget且包含错误）
dmesg | grep -iE "usb|gadget" | grep -i "err\|fail\|warn"

# 查看特定控制器日志（以dwc2为例）
dmesg | grep -i dwc2

# 查看ConfigFS配置过程
dmesg | grep -i configfs

# 查看端点相关日志
dmesg | grep -i "ep[0-9]"

3.3.3 按时间范围过滤

使用-T选项配合grep的时间戳过滤，可以定位特定时间段内的USB事件：

# 查看最近5分钟的USB日志
dmesg -T | grep -i usb | awk '$0 > "2025-01-15 10:30:00"'

# 使用journalctl（systemd系统）按时间范围过滤
journalctl -k -t kernel --since "5 minutes ago" | grep -i usb

3.4 USB日志过滤流程

下图展示了从原始内核日志到定位USB Gadget问题的完整过滤流程：

3.5 实战案例：从日志中定位Gadget枚举失败

假设你加载了g_ether模块，但主机无法识别USB Gadget设备。以下是一组典型的排查步骤：

1. 清空缓冲区并加载模块：dmesg -c && modprobe g_ether
2. 查看最新日志：dmesg | tail -30
3. 过滤关键信息：dmesg | grep -iE "gadget|ether|udc|ep0"
4. 分析日志级别：关注KERN_ERR和KERN_WARNING级别的消息

[ 1234.567890] g_ether gadget: failed to bind to UDC
[ 1234.567895] dwc2 3f980000.usb: dwc2_hsotg_ep_enable: Invalid endpoint
[ 1234.567900] configfs-gadget gadget: super-speed config #1: error -22

3.6 日志过滤最佳实践