Linux 下 PCI/PCIe 设备调试利器:lspci 与 setpci 使用指南
在 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演示模式验证,避免误操作导致硬件异常。
Linux工具及命令行





