PCIScope DOS agent (PCITool)

• Main features
• How to make a PCITool floppy
• Summary mode, Brief mode, Complete dump
• Text dump, Binary dump
• Configuration INI file, Format of a configuration file
• Command mode, Format of a command file
• Command line parameters
• PCITool components

Main features of PCITool are:

• Displaying summary, brief and complete information about installed PCI devices. Almost all PCI Vendor Id/Device Id are decoded as human-readable names.
• Reading a PCI configuration space, PCI Option ROMs and I/O memory mapped registers for known classes of PCI devices such as USB 1.1/2.0, 1394 (FireWire) and CardBus controllers. See /DA and /DB options.
• Producing a binary file in a format compatible with PCIScope (.BPD file), which includes full information about PCI and ISA PnP subsystems.
• Device detection process can be customized using special configuration INI file. PCITool is also able to check and automatically configure bridges to access memory and I/O registers of PCI devices behind them. See /CB option.
• Command mode to read/write and PCI configuration space registers.
• Ability to access all 4Gb address space with or without installed memory managers.

• You can make a snapshot of PCI and ISA PnP subsystems quickly and then open and explore it with PCIScope on another machine;
• You can get system information or even modify registers of PCI devices on a computer where Windows is not installed or doesn't start properly.

In order to make a PCITool floppy:

1. Make a DOS bootable floppy (DOS 6.22 or DOS 7.0 included into Windows 98 are recommended). PCITool was designed to work with and without memory managers.
2. Copy the following files from a PCIScope installation directory:
1. PCITOOL.EXE - PCITool utility
2. PCITOOL.INI - PCITool configuration file
3. PCITCMD.INI - PCITool command file; used with /CM parameter in Command Mode to read/write PCI registers.
4. PCIDEV.INI, PCIVEND.INI - Copy these files if you want to see human-readable PCI Vendor Id/Device Id.
   Warning: Processing the database of PCI vendors/devices from a floppy disk may work very slow.
3. You can run PCITool automatically from AUTOEXEC.BAT from a bootable floppy or manually from a command line.
   Parameters, which will be typically used:
1. /DB:filename - save full PCI/ISA PnP information into a PCIScope's binary file
2. /CM - switch on processing of PCITCMD.INI command file

• Ordinal number (PCITOOL specific index),
• Bus, device, function,
• Vendor ID, Device ID,
• BARs' value, size and address space,
• Filter setting for bridges.

PCITOOL uses PCIDEVS.INI and PCIVEND.INI to convert Vendor and Device IDs to human readable name. To get summary information you should launch PCITOOL without any parameters or using /A, /E, /XD, /CF to customize PCI device detection and output style. The following is a sample of program's screen:

• Ordinal number (PCITOOL specific index),
• Vendor ID, Device ID.

To get brief information you should launch PCITOOL with /B option.

To get text dump use /DA option.

To get text dump use /DB option.

Format of the settings is the following:

[BUS:DEV:FUN] - section name contains device location string

- Values for non-bridge device

IRQ            = <IRQ line register value>   ; By default has decimal
                                             ; format
BAR{n}         = <Value of n-th BAR>         ; BAR0 ... BAR6.
                                             ; Use BAR6 to access
                                             ; Option ROM register.

- Values for bridge device

PrimaryBus     = <Primary bus number>
SecondaryBus   = <Secondary bus number>
SubordinateBus = <Subordinate bus number>
VGAEnable      = <Value of VGA enable bit>   ; VGA enable bit in Bridge
                                             ; Control register
ISAEnable      = <Value of ISA enable bit>   ; ISA enable bit in Bridge
                                             ; Control register

- Values for PCI-2-PCI bridge

MemFilter      = <Base>:<Limit> |            ; Not prefetchable memory
                 <Base>,<Size>               ; filter
PreFilter      = <Base>:<Limit> |            ; Prefetchable memory
                 <Base>,<Size>               ; filter
IoFilter       = <Base>:<Limit> |            ; I/O filter
                 <Base>,<Size> ;

- Values for CardBus bridge

ExCABase       = <ExCA base address>         ; CardBus/ExCA registers
                                             ; base address
MemFilter{n}   = <Base>:<Limit>[,Prefetch] | ; MemFilter0, MemFilter1
                 <Base>,<Size>[,Prefetch]    ; Memory filter
IoFilter{n}    = <Base>:<Limit>            | ; IoFilter0, IoFilter1
                 <Base>,<Size>               ; I/O filter

All numbers should have hexadecimal format, except:
- IRQ line register value should have decimal format by default.
- <Size> value should have decimal format by default or have the following form: 1K, 2K, ... {n}K; 1M, 2M, ... {n}M (size in kilobytes or megabytes).

It needs to specify prefix '0x' or postfix 'h' to force the number to be recognized as hexadecimal. If the value string contains hexadecimal digits than the number is automatically recognized as hexadecimal.

;
;Some comments
;

W{b|w|d}:BUS:DEV:FUN:OFF=VAL ; Write data
...
R{b|w|d}:BUS:DEV:FUN:OFF     ; Read data
...

PCITOOL [/H|?] [/A] [/B] [/E] [/SF] [/DC:n] [/DA[:filename]] [/DB:filename] [/XD:BUS:DEV:FUN] [/XR] [/XP] [/HR] [/RS] [/CF:filename] [/CB] [/W{b|w|d}:BUS:DEV:FUN:OFF=VAL] [/R{b|w|d}:BUS:DEV:FUN:OFF] [/CM[:filename]]

where:

File:	Description:
PCITOOL.EXE	PCITool utility.
PCITOOL.INI	PCITool configuration file.
PCITCMD.INI	PCITool command file; used with /CM parameter in Command Mode to read/write PCI registers.
PCIDEV.INI, PCIVEND.INI	Database of known PCI vendors/devices. These files are used to decode PCI Vendor Id/Device Id as human-readable names. Warning: We don't recommend to use these files on a floppy. Processing the database of PCI vendors/devices from a floppy disk may work very slow.