Linux工具及命令行
+ -

Linux 下 PCI/PCIe 设备调试利器:lspci 与 setpci 使用指南

2026-11-06 16 0

在 Linux 系统中,排查 PCI/PCIe 设备(如网卡、显卡、USB 控制器等)的硬件状态、驱动绑定情况或底层寄存器配置时,lspci 和 setpci 是最核心的两个命令行工具。它们同属于 pciutils 软件包,但定位截然不同:

  • lspci:只读的“查看器”,用于列出设备、查看配置空间和能力信息。
  • setpci:可读写的“调试器”,用于直接读取或修改配置空间的任意寄存器,风险极高,需谨慎使用。

一、lspci:PCI 设备信息查看器

lspci 的核心用途是枚举总线上的设备,并通过不同参数展示不同深度的信息。

1. 基本设备列表

lspci

输出所有设备的简要信息,格式为 [BDF地址] [设备类型]: [厂商名称] [设备名称]。例如:
03:00.0 USB controller: VMware USB3 xHCI 1.0 Controller

2. 显示数字 ID(精确匹配用)

lspci -nn

在名称后附加 [厂商ID:设备ID](十六进制),便于精确筛选或编写脚本。例如:
03:00.0 USB controller [0c03]: VMware USB3 xHCI 1.0 Controller [15ad:0779]

3. 查看设备使用的内核驱动

lspci -k

显示每个设备当前绑定的内核驱动模块和内核模块路径。排查“设备识别了但没工作”的问题时非常关键。例如:

Kernel driver in use: xhci_hcd
Kernel modules: xhci_pci

4. 查看详细能力与链路状态(最常用)

lspci -vv -s 03:00.0

-vv 会解析并输出设备的全部能力(Capabilities),包括电源管理(PM)、PCIe 链路状态(LnkSta)、MSI/MSI-X 中断配置等。-vvv 会输出更底层的细节。这是排查 PCIe 链路速率、ASPM、中断问题的首选命令。

5. 十六进制转储配置空间

sudo lspci -xxx -s 03:00.0

以十六进制形式直接显示设备的 256 字节标准配置空间。加 -xxxx 可读取 PCIe 扩展配置空间(4KB)。需要 root 权限。

6. 按地址或 ID 筛选

lspci -s 03:00.0          # 按 BDF 地址筛选
lspci -d 15ad:0779        # 按厂商:设备 ID 筛选
lspci -s 03:00.0 -vv      # 组合使用,查看特定设备的详细信息

7. 查看 PCIe 拓扑树

lspci -t

以树形结构展示 PCIe 桥和设备之间的层级关系,便于理解总线拓扑。


二、setpci:配置空间读写调试器

setpci 直接操作配置空间寄存器。所有数值默认均为十六进制,读写时必须指定宽度后缀:.B(1 字节)、.W(2 字节)、.L(4 字节)。

1. 设备选择

-s 03:00.0          # 按 BDF 地址选择
-d 15ad:0779        # 按 厂商ID:设备ID 选择

2. 读取寄存器

可以直接使用寄存器名称(如 COMMAND、VENDOR_ID),也可以使用偏移地址加宽度:

# 读取 COMMAND 寄存器(通常为 2 字节)
sudo setpci -s 03:00.0 COMMAND

# 读取偏移 0x04 处的 2 个字节(字)
sudo setpci -s 03:00.0 04.w

# 读取偏移 0x00 处的 4 个字节(双字)
sudo setpci -s 03:00.0 00.l

3. 写入寄存器

格式为 寄存器=值,必须带宽度后缀:

# 向 COMMAND 寄存器写入 0x0007(开启 I/O、Memory、Bus Master)
sudo setpci -s 03:00.0 COMMAND=0007

# 使用偏移地址写入 2 字节
setpci -vD -s 03:00.0 COMMAND=0007
0000:03:00.0 @04 0007

注意:写入 0x00(Vendor ID)这类只读寄存器通常无效,而随意修改 BAR、COMMAND 等关键寄存器可能导致系统崩溃或设备异常。

4. 安全建议:使用 Demo 模式

在执行复杂的写入序列前,先用 -D 参数模拟操作,确认命令无误:

setpci -vD -s 03:00.0 COMMAND=0007

-v 会输出详细的操作过程,-D 表示不实际写入。

5. 查看所有已知寄存器名称

列出 setpci 能识别的所有标准寄存器名称及其偏移地址,方便查阅。

setpci --dumpregs
cap pos w name
     00 W VENDOR_ID
     02 W DEVICE_ID
     04 W COMMAND
     06 W STATUS
     08 B REVISION
     09 B CLASS_PROG
     0a W CLASS_DEVICE
     0c B CACHE_LINE_SIZE
     0d B LATENCY_TIMER
     0e B HEADER_TYPE
     0f B BIST
     10 L BASE_ADDRESS_0
     14 L BASE_ADDRESS_1
     18 L BASE_ADDRESS_2
     1c L BASE_ADDRESS_3
     20 L BASE_ADDRESS_4
     24 L BASE_ADDRESS_5
     28 L CARDBUS_CIS
     2c W SUBSYSTEM_VENDOR_ID
     2e W SUBSYSTEM_ID
     30 L ROM_ADDRESS
     3c B INTERRUPT_LINE
     3d B INTERRUPT_PIN
     3e B MIN_GNT
     3f B MAX_LAT
     18 B PRIMARY_BUS
     19 B SECONDARY_BUS
     1a B SUBORDINATE_BUS
     1b B SEC_LATENCY_TIMER
     1c B IO_BASE
     1d B IO_LIMIT
     1e W SEC_STATUS
     20 W MEMORY_BASE
     22 W MEMORY_LIMIT
     24 W PREF_MEMORY_BASE
     26 W PREF_MEMORY_LIMIT
     28 L PREF_BASE_UPPER32
     2c L PREF_LIMIT_UPPER32
     30 W IO_BASE_UPPER16
     32 W IO_LIMIT_UPPER16
     38 L BRIDGE_ROM_ADDRESS
     3e W BRIDGE_CONTROL
     10 L CB_CARDBUS_BASE
     14 W CB_CAPABILITIES
     16 W CB_SEC_STATUS
     18 B CB_BUS_NUMBER
     19 B CB_CARDBUS_NUMBER
     1a B CB_SUBORDINATE_BUS
     1b B CB_CARDBUS_LATENCY
     1c L CB_MEMORY_BASE_0
     20 L CB_MEMORY_LIMIT_0
     24 L CB_MEMORY_BASE_1
     28 L CB_MEMORY_LIMIT_1
     2c W CB_IO_BASE_0
     2e W CB_IO_BASE_0_HI
     30 W CB_IO_LIMIT_0
     32 W CB_IO_LIMIT_0_HI
     34 W CB_IO_BASE_1
     36 W CB_IO_BASE_1_HI
     38 W CB_IO_LIMIT_1
     3a W CB_IO_LIMIT_1_HI
     40 W CB_SUBSYSTEM_VENDOR_ID
     42 W CB_SUBSYSTEM_ID
     44 L CB_LEGACY_MODE_BASE
  01 00 - CAP_PM
  02 00 - CAP_AGP
  03 00 - CAP_VPD
  04 00 - CAP_SLOTID
  05 00 - CAP_MSI
  06 00 - CAP_CHSWP
  07 00 - CAP_PCIX
  08 00 - CAP_HT
  09 00 - CAP_VNDR
  0a 00 - CAP_DBG
  0b 00 - CAP_CCRC
  0c 00 - CAP_HOTPLUG
  0d 00 - CAP_SSVID
  0e 00 - CAP_AGP3
  0f 00 - CAP_SECURE
  10 00 - CAP_EXP
  11 00 - CAP_MSIX
  12 00 - CAP_SATA
  13 00 - CAP_AF
  14 00 - CAP_EA
0001 00 - ECAP_AER
0002 00 - ECAP_VC
0003 00 - ECAP_DSN
0004 00 - ECAP_PB
0005 00 - ECAP_RCLINK
0006 00 - ECAP_RCILINK
0007 00 - ECAP_RCECOLL
0008 00 - ECAP_MFVC
0009 00 - ECAP_VC2
000a 00 - ECAP_RBCB
000b 00 - ECAP_VNDR
000d 00 - ECAP_ACS
000e 00 - ECAP_ARI
000f 00 - ECAP_ATS
0010 00 - ECAP_SRIOV
0011 00 - ECAP_MRIOV
0012 00 - ECAP_MCAST
0013 00 - ECAP_PRI
0015 00 - ECAP_REBAR
0016 00 - ECAP_DPA
0017 00 - ECAP_TPH
0018 00 - ECAP_LTR
0019 00 - ECAP_SECPCI
001a 00 - ECAP_PMUX
001b 00 - ECAP_PASID
001c 00 - ECAP_LNR
001d 00 - ECAP_DPC
001e 00 - ECAP_L1PM
001f 00 - ECAP_PTM
0020 00 - ECAP_M_PCIE
0021 00 - ECAP_FRS
0022 00 - ECAP_RTR
0023 00 - ECAP_DVSEC
0024 00 - ECAP_VF_REBAR
0025 00 - ECAP_DLNK
0026 00 - ECAP_16GT
0027 00 - ECAP_LMR
0028 00 - ECAP_HIER_ID
0029 00 - ECAP_NPEM

三、常用场景速查表

需求 命令
查看所有设备简要信息 lspci
查看设备 ID 和厂商 ID lspci -nn
查看设备绑定的驱动 lspci -k
查看设备详细能力(链路、中断等) lspci -vv -s 03:00.0
十六进制转储配置空间 sudo lspci -xxx -s 03:00.0
读取特定寄存器 sudo setpci -s 03:00.0 COMMAND
写入特定寄存器 sudo setpci -s 03:00.0 COMMAND=0007
模拟写入(不实际执行) setpci -vD -s 03:00.0 COMMAND=0007
查看 PCIe 拓扑树 lspci -t

四、总结

  • 看设备、看状态、看驱动:用 lspci。日常排查 90% 的问题(驱动未加载、链路降速、中断异常)都能通过 lspci -vv 定位。
  • 改寄存器、做底层调试:用 setpci。操作前务必确认寄存器含义和写入值,优先使用 -D 演示模式验证,避免误操作导致硬件异常。

0 篇笔记 写笔记

关注公众号
取消
感谢您的支持,我会继续努力的!
扫码支持
扫码打赏,你说多少就多少

打开支付宝扫一扫,即可进行扫码打赏哦

您的支持,是我们前进的动力!