Skip to main content

🖥️ PCI Devices

The PCI Devices page displays all PCI and PCIe devices detected on the MOS system. This includes internal controllers, bridges, graphics adapters, network interfaces, and other hardware components connected via the PCI bus. The information is useful for hardware identification, driver troubleshooting, and device passthrough configuration.

PCI Devices Overview

The PCI Devices page showing detected PCI hardware.


📦 Accessing PCI Devices

The PCI Devices page is available under the Hardware section in Settings.

  1. Navigate to Settings in the sidebar
  2. Go to HardwarePCI Devices
info

The PCI Devices page is read-only. It displays detected devices automatically — no configuration is required.


🗂️ Device Information

Each PCI device entry displays the following information:

FieldDescription
Device NameManufacturer and device description (e.g., Comet Lake SATA AHCI Controller)
SlotPCI bus address (e.g., 00:17.0 = bus 00, device 17, function 0)
ClassPCI device class code and description (e.g., SATA controller (0106))
Vendor IDPCI vendor identifier (e.g., 8086 = Intel Corporation)
Device IDPCI device identifier (e.g., 02d3)

📋 Common PCI Device Classes

Class CodeDescriptionExamples
0600Host bridgeCPU-to-memory controller
0300VGA compatible controllerIntegrated or discrete GPU
0106SATA controllerDisk storage interface
0c03USB controllerxHCI USB host controller
0280Network controllerWi-Fi, Ethernet adapters
0604PCI bridgePCIe root ports
0601ISA bridgeLPC/eSPI controller
0403Audio deviceIntel cAVS, HD Audio
0780Communication controllerManagement Engine Interface
0c80Serial bus controllerI2C, SPI controllers

⚡ Use Cases

  • Identify hardware — Check which controllers and interfaces are present on the system
  • Troubleshoot driver issues — Verify devices are detected before configuring drivers or plugins
  • GPU passthrough — Find the PCI slot and vendor/device ID for GPU passthrough to VMs
  • Network identification — Identify onboard network controllers and Wi-Fi adapters
  • Storage verification — Confirm SATA/NVMe controllers are properly detected
  • Diagnostics reference — Cross-reference with lspci output when troubleshooting

🔧 Technical Details

Slot Addressing

PCI slot addresses follow the format BB:DD.F:

ComponentDescriptionExample
Bus (BB)PCI bus number00
Device (DD)Device number on the bus17
Function (F)Function number (for multi-function devices)0
tip

When configuring PCI passthrough for VMs, you need the full slot address (e.g., 00:02.0 for the GPU). Use this page to find the correct address for each device.

Common Vendor IDs

Vendor IDManufacturer
8086Intel Corporation
10deNVIDIA Corporation
1002AMD / ATI
14e4Broadcom
10ecRealtek
1af4Red Hat (virtio)

📚 Best Practices

  • Check before driver installation — Verify the device appears here before installing drivers or plugins (e.g., NVIDIA GPU plugin)
  • Note slot addresses — PCI passthrough to VMs requires exact slot addresses
  • Identify onboard vs. discrete — Devices on bus 00 are typically onboard/integrated; higher bus numbers may indicate discrete PCIe cards
  • Cross-reference with lspci — For detailed troubleshooting, compare this list with lspci -nn output in the Web Terminal
warning

Do not attempt to remove or disable PCI devices from the system while it is running. Hardware changes should be made with the system powered off.


✅ Summary

The PCI Devices page provides a comprehensive overview of all PCI hardware on the system.

Key points:

  • Automatic detection — all PCI/PCIe devices are listed without configuration
  • Detailed identification — slot addresses, class codes, vendor and device IDs
  • Read-only — for inspection and troubleshooting only
  • Essential for passthrough — slot addresses needed for VM PCI passthrough configuration
  • Driver troubleshooting — verify hardware detection before installing drivers

Parts of this documentation were created with the assistance of AI tools. All AI-generated content has undergone review, but it may still contain inaccuracies, omissions, or outdated information.