86Box-probing-tools/pcireg/README.md

pcireg

DOS, UEFI, Windows and Linux tool for reading, writing (where supported) and dumping PCI configuration space registers; scanning the PCI bus; and more.

Usage

PCIREG -s [-d]
∟ Display all devices on the PCI bus. Specify -d to dump registers as well.

PCIREG -t [-8]
∟ Display BIOS IRQ steering table. Specify -8 to display as 86Box code.
  (Not available in UEFI version)

PCIREG -i [bus] device [function]
∟ Show information about the specified device.

PCIREG -r [bus] device [function] register
∟ Read the specified register.

PCIREG -w [bus] device [function] register value
∟ Write byte, word or dword to the specified register.

PCIREG {-d|-dw|-dl} [bus] device [function [register]]
∟ Dump registers as bytes (-d), words (-dw) or dwords (-dl). Optionally
  specify the register to start from (requires bus to be specified as well).

All numeric parameters should be specified in hexadecimal (without 0x prefix).
{bus device function register} can be substituted for a single port CF8h dword.
Register dumps are saved to PCIbbddf.BIN where bb=bus, dd=device, f=function.

Building

DOS target

• Windows: Run wmake from an OpenWatcom "Build Environment" command prompt.
• Linux: Run wmake with OpenWatcom tools present in $PATH.

UEFI target

• Linux: Run make -f Makefile.uefi ARCH=x86_64 with a GCC toolchain installed.
  • Note that 32-bit UEFI targets are not supported yet.

Windows target

• Windows: Currently not supported due to issues building pciutils on MSYS2.
• Linux: Build pciutils then pcireg itself with a MinGW toolchain installed.
  • 32-bit:

  git clone https://github.com/pciutils/pciutils.git pciutils
  cd pciutils
  make CROSS_COMPILE=i686-w64-mingw32- HOST=i586-windows ZLIB=no DNS=no SHARED=no IDSDIR=""
  sudo make install-lib PREFIX=/usr/i686-w64-mingw32
  cd ..
  make -f Makefile.gcc CC=i686-w64-mingw32-gcc CFLAGS=-I/usr/local/include LDFLAGS=-static LDAPPEND=-lcfgmgr32 CP437_CONV=y DEST=pciregw
  

  • 64-bit:

  git clone https://github.com/pciutils/pciutils.git pciutils
  cd pciutils
  make CROSS_COMPILE=x86_64-w64-mingw32- HOST=x86_64-windows ZLIB=no DNS=no SHARED=no IDSDIR=""
  sudo make install-lib PREFIX=/usr/x86_64-w64-mingw32
  cd ..
  make -f Makefile.gcc CC=x86_64-w64-mingw32-gcc CFLAGS=-I/usr/local/include LDFLAGS=-static LDAPPEND=-lcfgmgr32 CP437_CONV=y DEST=pciregw64
  

Linux target

• Linux: Run make -f Makefile.gcc with a GCC toolchain and development files for libpci installed.

PCI ID database

• Run python3 pciids.py to update the PCI ID files, then lha a1o5 PCIIDS.LHA PCIIDS_*.BIN to compress them in the expected format.
  • The latest version of pci.ids is automatically downloaded and used to update the database.