Linux setpci命令介绍
setpci 是一个强大的Linux命令，用于查询和配置PCI设备的硬件参数。通过直接访问PCI配置寄存器，管理员可以读取或者修改任何PCI设备的配置空间。这个功能在调整系统性能、启用或禁用硬件特性、进行硬件故障排查时非常有用。
Linux setpci命令适用的Linux版本
setpci 命令几乎在所有主流Linux发行版中都可用。但是，它不是所有Linux发行版默认安装的一部分。对于没有预装setpci的发行版，您可以按照下面的方法进行安装：
# 基于apt的发行版（如Debian、Ubuntu、Raspbian、Kali Linux等）：
sudo apt-get update
sudo apt-get install pciutils
# 基于yum的发行版（如RedHat，CentOS 7等）：
sudo yum update
sudo yum install pciutils
# 基于dnf的发行版（如Fedora，CentOS 8等）：
sudo dnf update
sudo dnf install pciutils
# 基于apk的发行版（如Alpine Linux）：
sudo apk add pciutils
# 基于pacman的发行版（如Arch Linux）：
sudo pacman -Syu
sudo pacman -S pciutils
# 基于zypper的发行版（如openSUSE）：
sudo zypper ref
sudo zypper in pciutils
# 基于pkg的FreeBSD发行版
sudo pkg update
sudo pkg install pciutils
# 基于Homebrew的OS X/macOS发行版：
brew update
brew install pciutils
Linux setpci命令的基本语法
语法格式：
setpci [options] [<device> [<value>]]
Linux setpci命令的常用选项或参数说明
使用Markdown表格形式列出常用选项：
| 选项 | 描述 |
|---|---|
| -s | 指定设备的总线、设备和功能号 |
| -d | 过滤查找特定的设备ID |
| -v | 显示详细输出 |
| -x | 以十六进制格式显示配置空间的内容 |
| -D | 访问PCI域 |
（由于选项较少，这里列出了全部常用选项。）
Linux setpci命令实例详解
实例1：列出所有PCI设备的详细信息
此实例展示如何使用setpci列出所有PCI设备的详细信息。
[linux@bashcommandnotfound.cn ~]$ lspci -vvv
实例2：读取特定PCI设备的配置
以下命令读取总线1，设备0，功能0的设备的配置空间的第一个字节。
[linux@bashcommandnotfound.cn ~]$ setpci -s 01:00.0 0x0.L
实例3：修改PCI设备的配置
此命令将总线1，设备0，功能0的设备的配置空间的第一个字节设置为0x07。
[linux@bashcommandnotfound.cn ~]$ setpci -s 01:00.0 0x0.L=0x07
实例4：读取具体的配置寄存器值
读取指定PCI设备的vendor ID值。
[linux@bashcommandnotfound.cn ~]$ setpci -s 01:00.0 vendor
实例5：查找具有特定vendor ID和device ID的PCI设备
如果你想找到具有特定vendor ID和device ID的PCI设备，可以使用以下命令：
[linux@bashcommandnotfound.cn ~]$ lspci -d 8086:1503
示例6：在PCI设备的配置寄存器中设置特定位
假设您想在PCI设备上启用总线主控。这通常是通过将命令寄存器（偏移量0x04）的第2位设置为1来完成的。为此，您需要读取当前值，设置特定位，然后写回去。
# 读取命令寄存器的当前值
current_value=$(setpci -s 01:00.0 COMMAND)
# 设置命令寄存器的第2位
new_value=$((current_value | 0x4))
# 写回新值
setpci -s 01:00.0 COMMAND=$new_value
示例7：禁用PCI设备的内存空间访问
如果您想禁止PCI设备的内存空间访问(MSA)，您可以清除命令寄存器的第1位。
# 读取命令寄存器的当前值
current_value=$(setpci -s 01:00.0 COMMAND)
# 清除命令寄存器的第1位以禁用MSA
new_value=$((current_value & ~0x2))
# 写回新值
setpci -s 01:00.0 COMMAND=$new_value
示例8：更改PCI设备的延迟计时器
延迟计时器位于配置空间的偏移量0x0D。要将其更改为特定值，比如0x20，您可以使用：
setpci -s 01:00.0 LATENCY_TIMER=20
示例9：调整缓存行大小
要调整PCI设备的缓存行大小，可以对偏移量0x0C的缓存行大小寄存器进行写操作。
# 将缓存行大小设置为64字节
setpci -s 01:00.0 CACHE_LINE_SIZE=40
示例10：启用内存写入和无效操作
要启用内存写入和无效操作，请将命令寄存器的第4位设置为1。
# 启用内存写入和无效操作
current_value=$(setpci -s 01:00.0 COMMAND)
new_value=$((current_value | 0x10))
setpci -s 01:00.0 COMMAND=$new_value
示例11：读取PCI设备的类代码和子类
类代码和子类提供了有关设备执行的功能类型的信息。您可以按以下方式从配置空间中读取这些信息：
setpci -s 01:00.0 CLASS
示例12：查找具有特定类代码的设备
要查找特定类代码（例如，网络控制器）的所有设备，您可以使用lspci配合grep过滤器：
lspci -nn | grep '0200'
示例13：调整最大有效载荷大小
最大有效载荷大小可以在PCI Express功能结构中的设备控制寄存器中设置。此寄存器的位置因设备而异，因此您应首先使用lspci找到功能指针，然后使用setpci设置最大有效载荷大小。
# 假设设备控制寄存器在偏移量0x78
setpci -s 01:00.0 0x78.B=10
示例14：读取PCI设备的状态
状态寄存器提供了有关PCI设备状态的标志。您可以按以下方式进行读取：
setpci -s 01:00.0 STATUS
示例15：重置PCI设备
一些设备可以通过其控制寄存器进行重置。这是高度特定于设备的操作，应谨慎进行。
# 假设设备可以通过写入偏移量0x3C进行重置
setpci -s 01:00.0 0x3C.B=1
注意：在尝试修改其配置寄存器之前，始终咨询设备的手册或文档，因为不正确的设置可能导致系统不稳定或硬件损坏。
Linux setpci 注意事项
在使用setpci和lspci等工具操作PCI设备时，应注意以下几点：
- 备份当前设置：在更改PCI配置之前，务必记录下当前的配置值，以便在出现问题时能够恢复原状。
- 理解硬件规格：在使用这些命令之前，应当充分理解您的硬件规格和PCI协议标准，以避免不当操作导致的问题。
- 权限：修改硬件配置通常需要超级用户权限，因此运行这些命令时可能需要使用
sudo。 - 谨慎操作：错误的配置可能导致系统不稳定或者硬件故障，特别是在写入操作时。
- 文档参考：在进行任何修改之前，查看设备的技术手册或者数据表，了解每个寄存器的确切功能和合法值范围。
- 测试环境：如果可能，先在非生产环境下测试您的更改，确保它们不会影响系统的稳定性。
- 恢复计划：在进行变更前，确保有一个恢复计划，包括物理访问设备以恢复设置的能力。
评论区