home *** CD-ROM | disk | FTP | other *** search
/ Hot Shareware 32 / hot34.iso / ficheros / DTOOL / INTER57E.ZIP / PCICFG11.ZIP / PCICFG.TXT < prev   
Text File  |  1998-01-04  |  11KB  |  235 lines
  1.        PCICFG - Show configuration space for PCI devices
  2.        =================================================
  3.  
  4.               Version 1.02
  5.             Copyright 1997,1998 Ralf Brown
  6.  
  7. PCICFG is a small utility to tell you more than you ever wanted to
  8. know about the PCI devices in your computer.  To install it, you can
  9. simply extract all of the files in the distribution archive into a
  10. directory on your hard disk.  A minimal installation consists of
  11. PCICFG.EXE and PCICFG.DAT; to enable the Verbose option, you will also
  12. need the *.PCI files.
  13.  
  14. There are two ways to run PCICFG in normal use:
  15.     PCICFG [flag(s)] bus device function
  16.     PCICFG [flag(s)] *               (to scan all devices)
  17.  
  18. PCI devices have an address which is broken down into a PCI-bus number
  19. (usually 0), a device number within that bus (0-31), and a function
  20. number within the device (0-7).  The majority of devices have only a
  21. single function (0); multi-function devices are those which incorporate
  22. very different functionalities within a single chip, i.e.  a chip which
  23. is both a SCSI and an EIDE controller might present separate function
  24. numbers for each.  If you use the first form of the commandline, PCICFG
  25. will display information on only the specified device (or function for
  26. a multi-function device).
  27.  
  28. Since you will probably not know the addresses of the devices in your
  29. computer, the second form of the commandline tells PCICFG to scan all
  30. possible PCI addresses for active devices.  You will generally want to
  31. run this with the -t flag (see below) the very first time you use
  32. PCICFG in order to find out which devices are installed.
  33.  
  34. The two optional flags which PCICFG supports are:
  35.         -t      terse -- output only device type and ID
  36.         -v      verbose output for known devices
  37.  
  38. Use -v for more verbose output on devices specifically recognized by
  39. PCICFG (these are described by the *.PCI files, where the first four
  40. characters of the filename are the vendor ID and the next four the
  41. device ID).  Output is generally quite lengthy even without -v, so you
  42. should redirect output into a file or pipe it to MORE or LIST.
  43.  
  44. For system maintenance, a third method of running PCICFG is available:
  45.     PCICFG -m filename [filename ...]
  46. which will merge the vendor/device IDs contained in the specified files
  47. into PCICFG.DAT if they are not already present.
  48.  
  49.  
  50.                 Examples
  51.                 ========
  52.  
  53. Example 1: PCICFG -t *
  54.  
  55. PCICFG v1.02 (c) Copyright 1997,1998 Ralf Brown
  56. PCI bus 00 device 00 function 00:  Header Type 'non-bridge' (single-func)
  57. Intel Corporation               ║ Class 06: bridge        I/F: 00
  58. 82434LX/NX  (Mercury/Neptune)           ║ SubCl 00: CPU/PCI        Rev: 10
  59. -----------------------------------------------------------
  60. PCI bus 00 device 01 function 00:  Header Type 'non-bridge' (single-func)
  61. PC Technology                   ║ Class 01: disk         I/F: 00
  62. RZ1000                       ║ SubCl 01: IDE            Rev: 01
  63. -----------------------------------------------------------
  64. PCI bus 00 device 02 function 00:  Header Type 'non-bridge' (single-func)
  65. Intel Corporation               ║ Class 00: reserved        I/F: 00
  66. 82378/82379 SIO  ISA Bridge           ║ SubCl 00: ???            Rev: 03
  67. -----------------------------------------------------------
  68. PCI bus 00 device 06 function 00:  Header Type 'non-bridge' (single-func)
  69. S3                       ║ Class 03: display        I/F: 00
  70. Trio64/64V+                   ║ SubCl 00: VGA            Rev: 53
  71. -----------------------------------------------------------
  72. PCI bus 00 device 0C function 00:  Header Type 'non-bridge' (single-func)
  73. DEC                       ║ Class 02: network        I/F: 00
  74. DC21041 Tulip Plus               ║ SubCl 00: Ethernet        Rev: 21
  75. -----------------------------------------------------------
  76. PCI bus 00 device 0E function 00:  Header Type 'non-bridge' (single-func)
  77. S3                       ║ Class 03: display        I/F: 00
  78. Trio64/64V+                   ║ SubCl 00: VGA            Rev: 43
  79.  
  80.  
  81. Example 2: PCICFG 0 14 0
  82.  
  83. PCICFG v1.02 (c) Copyright 1997,1998 Ralf Brown
  84. PCI bus 00 device 0E function 00:  Header Type 'non-bridge' (single-func)
  85. Vendor:    5333    S3                                                
  86. Device:    8811    S3 Trio64/64V+                                    
  87. Class:      03    display                 Revision:    43
  88. SubClass: 00    VGA                     ProgramI/F:    00
  89. CommandReg:     0023 = I/O-on mem-on VGAsnoop
  90. Status Reg:     0200 = (med)
  91. CacheLine:       00    Latency:    00    BIST:         00
  92. SubsysVendor:    0000    SubsysDevice: 0000
  93. Base Addresses:
  94.     (0) A0000000 = mem base=A0000000 len=64M
  95. CardBus:     00000000    ExpansionROM: FE000000 (64K,disabled)
  96. INTline:       09    INTpin:       01
  97. MinGrant:       00    MaxLatency:   00
  98. Device-Specific Data:
  99.  40: 00000000  00000000  00000000  00000000  00000000  00000000 
  100.  58: 00000000  00000000  00000000  00000000  00000000  00000000 
  101.  70: 00000000  00000000  00000000  00000000  00000000  00000000 
  102.  88: 00000000  00000000  00000000  00000000  00000000  00000000 
  103.  A0: 00000000  00000000  00000000  00000000  00000000  00000000 
  104.  B8: 00000000  00000000  00000000  00000000  00000000  00000000 
  105.  D0: 00000000  00000000  00000000  00000000  00000000  00000000 
  106.  E8: 00000000  00000000  00000000  00000000  00000000  00000000 
  107.  
  108.  
  109. Example 3: PCICFG -v 0 0 0
  110.  
  111. PCICFG v1.02 (c) Copyright 1997,1998 Ralf Brown
  112. PCI bus 00 device 00 function 00:  Header Type 'non-bridge' (single-func)
  113. Vendor:    8086    Intel Corporation                                 
  114. Device:    04A3    82434LX/NX  (Mercury/Neptune)                     
  115. Class:      06    bridge                  Revision:    10
  116. SubClass: 00    CPU/PCI                 ProgramI/F:    00
  117. CommandReg:     0146 = mem-on busmstr parity-err sys-err
  118. Status Reg:     A500 = parity-err mst-abort det-parity (slow)
  119. CacheLine:       00    Latency:    40    BIST:         00
  120. SubsysVendor:    0000    SubsysDevice: 0000
  121. No base addresses
  122. CardBus:     00000000    ExpansionROM: 00000000 (no ROM)
  123. INTline:       00    INTpin:       00
  124. MinGrant:       00    MaxLatency:   00
  125. Device-Specific Data:
  126.  40: 00000000  00000000  00000000  00000000  0B9B40A6  E5000006 
  127.  58: 50555700  00555555  20181008  20202020  00000000  00000000 
  128.  70: 00003003  00000000  00000000  A000220F  00000000  00000000 
  129.  88: 00000000  00000000  00000000  00000000  00000000  00000000 
  130.  A0: 00000000  00000000  00000000  00000000  00000000  00000000 
  131.  B8: 00000000  00000000  00000000  00000000  00000000  00000000 
  132.  D0: 00000000  00000000  00000000  00000000  00000000  00000000 
  133.  E8: 00000000  00000000  00000000  00000000  00000000  00000000 
  134. 82434NX (Neptune) registers in detail:
  135.  Host CPU:         type: 101  bus speed: 60 MHz  L1 cache enabled
  136.  L2 cache:         256K  async SRAM (enabled)  cache all reads
  137.            cache byte select  LX-compatible connectivity
  138.            LX only: write-back
  139.  Deturbo control:  40
  140.  CPU Buf Control:  read-around-write enabled
  141.                    CPU-PCI posted writes enabled, CPU-mem posted writes enabled
  142.  PCI Control:      LBXs connected to TRDY#
  143.                    PCI-memory posted writes disabled, PCI burst enabled
  144.  DRAM Control:     parity errors masked  SMRAM not enabled
  145.                    DRAM bursts: X-3-3-3
  146.            0-Active RAS# Mode: N  Burst-of-Four Refresh: Y
  147.            Refresh Type: RAS#-only (enabled)
  148.  DRAM Timing:      RAS# Wait State: N   CAS# Wait State: N
  149.  DRAM Boundaries:   8M  16M  24M  32M  32M  32M  32M  32M
  150.  Memory Size:       32M
  151.  Programmable Attribute Map
  152.     C000-C3FF: C-R    D000-D3FF: C-R    E000-E3FF: C-R    F000-FFFF: C-R
  153.     C400-C7FF: C-R    D400-D7FF: C-R    E400-E7FF: C-R
  154.     C800-CBFF: ---    D800-DBFF: C-R    E800-EBFF: ---
  155.     CC00-CFFF: C-R    DC00-DFFF: C-R    EC00-EFFF: ---    8000-9FFF: CWR
  156.  Error Control:    03 = SERR# on: --------- ---------------- ---------------
  157.            SERR# on ------------------ --------------
  158.            PERR# on -----------   assert PEN# on reads
  159.            L2 cache parity disabled
  160.  Error Status:     30 = ---------------- PCI-read parity PCI-address parity
  161.             ----------- --------------- --------
  162.  SMRAM control:    SMM Space at segment 8000 is ---- ------ ------
  163.  ISA memory hole:  at 0M, size 1M (disabled)
  164.  Frame Buffer:       16M at 2560M (A0000000)    byte merging enabled
  165.            lock requests disabled  transparent buffer writes disabled
  166.                    applied to VGA-range
  167.  
  168.  
  169.  
  170.                Writing your own .PCI file
  171.                ==========================
  172.  
  173. All of the information used by PCICFG.EXE is in plain-text format,
  174. which means you can update it for your system if you have devices
  175. which are not yet recognized (and if you send me your updates, I'll
  176. put them in the next release along with your name).
  177.  
  178.  
  179. PCICFG.DAT
  180. ----------
  181.  
  182. This file lists the vendor and device IDs by which a device is
  183. identified.  Its format is very simple: for each vendor ID, there is a
  184. line giving the vendor ID number and the associated vendor name,
  185. optionally followed by one or more lines listing the device IDs used by
  186. that vendor.  Both vendor and device IDs consist of four hexadecimal
  187. digits; a sample fragment of the PCICFG.DAT file is
  188.  
  189.     Vendor 1003 ULSI
  190.       0201 US201 Graphics Controller
  191.     Vendor 1004 VLSI Technologies
  192.       0005 VL82C591 CPU Bridge
  193.  
  194. Which indicates that vendor 0x1003 is ULSI, and that it uses device ID
  195. 0x0201 for its model US201 graphics controller.  Both vendor and device
  196. names are limited to 50 characters (anything beyond that is simply
  197. ignored).  The only limits on the size of the PCICFG.DAT file are that
  198. all of the information must fit into available memory, and no single
  199. vendor's information may occupy more than 16K (250 or more devices,
  200. depending on the lengths of the device names).
  201.  
  202. If you have another listing of vendor and device IDs, you can have
  203. PCICFG merge them into PCICFG.DAT rather than manually updating the
  204. file, using
  205.     PCICFG -m filename
  206. The list in 'filename' must be in either the PCICFG format or the format
  207. used by Merlin's PCI program (essentially the PCICFG format without the
  208. initial signature and the 'Vendor' markers; device IDs *must* be indented,
  209. unlike PCICFG.DAT where the indent is optional).
  210.  
  211.  
  212. *.PCI
  213. -----
  214.  
  215. These files give a more detailed breakdown of a device's configuration
  216. data.  The filename indicates the device for which it is a description.
  217.  
  218. The main content of a .PCI file is a set of lines with embedded
  219. printf-style conversion specifiers, which list addresses in the
  220. device's PCI configuration space and how to turn the values stored
  221. there into numbers or text.  The included BLANK.PCI can be used as a
  222. template for your own .PCI files, and contains more details on the
  223. conversion specifiers.
  224.  
  225.  
  226.                  Update History
  227.                  ==============
  228.  
  229. 21dec97    v1.00    initial non-beta release
  230. 03jan98    v1.01    bugfix
  231. 04jan98    v1.10    implemented data merging (-m), removed 64K limit on PCICFG.DAT
  232.         tightened output in terse mode
  233.  
  234.                   End of File
  235.