# Board locate: pciscan

#### Name

pciscan

#### Purpose

Determines the PCI bus and slot assignments for NMS PCI and CompactPCI boards installed in the system.

#### Usage

pciscan [ options ]

If you invoke pciscan without any command line options, it returns the locations of all NMS PCI and CompactPCI boards in the system.

If you invoke pciscan with command line arguments, the specified board flashes an LED.

The following table lists the valid command line options:

Option | Description
--- | ---
pci_bus pci_slot | Specifies the PCI bus and slot location of the board on which to flash an LED.
-h, -? | Displays the Help screen and terminates.
-a | Returns the locations for all PCI devices in the system, including NMS PCI boards.
-i | Displays additional information (CG boards only).
-l | Logs output to a file named pci_cfg.txt.
-r | Displays five PCI memory addresses.
-v | Displays register values for NMS boards.

#### Description

pciscan displays the PCI bus and PCI slot number for all NMS CompactPCI boards installed in the system.

To run this utility on a remote host, the utility must be physically resident on the remote host. Use a separate third-party utility such as telnet, rsh, or rexec to invoke the utility.

If you have a chassis with an unusual PCI bus topology (for example, bus number 171 directly follows bus number 0), pciscan functions more slowly. To speed up operation, create a text file specifying PCI bus numbers to search. Refer to Specifying PCI bus numbers for board search functions for more information.

On Windows systems, you can use pciscan to show the physical slot location of a specific board by flashing an LED on the board.

Note: On UNIX systems, use cg6ktool to flash a board LED on a specific CG board (as described in the CG board documentation), or blocate to flash a board LED on a specific AG board. Refer to AG board locate: blocate for more information.

#### Procedure

To run pciscan, enter:

pciscan

pciscan displays output similar to the following:

Bus Slot NMS ID
--- ---- ------
2 11 0x50d AG_4040C_E1
2 13 0x6000 CG_6000C_QUAD
--- ---- -- ----------------
There were 2 NMS PCI board(s) detected

If the -l option is specified, the board configuration is also logged to an ASCII text file with the current date and time. The log is created in a file named pci_cfg.txt, in the current working directory.

To flash an LED on a specific board under Windows, run pciscan with the PCI bus and PCI slot locations. For example:

pciscan 0 14

An LED on the board flashes.

If the -i option is specified, extra information is reported for CG boards only. This information includes:

- Number of DSPs on the board

- Number of HMIC switches on the board

- Number of lines (digital or analog) on the board

- Number of Ethernet chips on the board

- Whether or not the board has a daughterboard

- Number of CPUs on the board

This information is reported as follows:

Bus Slot NMS ID DSP Switch Line Eth xCard CPU
--- ---- ------ --- ------ ---- --- ----- ---
2 10 0x6000 32 1 4 2 No 1 CG_6000C_Quad
2 11 0x6000 32 1 4 2 No 1 CG_6000C_Quad
2 13 0x50d N/A N/A N/A N/A N/A N/A AG_4040C_T1
--- ---- -- ----------------
There were 3 NMS PCI board(s) detected

If the -i option is specified and a specific PCI bus and slot are specified, detailed information is reported for the board at the specified location, as follows:

pciscan 2 10 -i
NMS PCI Boards Scanner
*******************************
* Board CG_6000C_Quad (2:10)
*******************************
Board Standard
---------------
Family = 0x6000
TestLevel = 0x1712
TestLevelRev = 0x03
SoftwareComp = 0x00
OAMProductNo = 0x0601
MFGYear = 0x07D0
MFGWeek = 0x2C
ATETestBit = 0x00
SerialNum = 0x00056271
Reserved = 0x00000000
CG6000(C) Board Specific
---------------
AssemblyLevel = 0x1706
AssemblyRev = 0x0202
AssemblyYear = 0x07D0
AssemblyWeek = 0x24
Reserved = 0x00
FlashID = 0x01
FlashBlkSz = 0x10
NumDSPCores = 0x0020
DSPSpeed = 0x0064
DSPExtClk = 0x0014
DSPType = 0x01
CTBusType = 0x01
HostBusType = 0x03
NumSwitch = 0x01
SwitchType = 0x04
NumLine = 0x04
LineType = 0x03
NumEthernet = 0x02
EthernetType = 0x01
NumDaughterCard = 0x00
Reserved2 = 0x00
NumCPU = 0x01
CPUSpeed = 0x00E9
CPUExtClk = 0x0003
CPUType = 0x01
DRAMSz = 0x20
SRAMSz = 0x00
Reserved = 0x00
NICAddr[0] = 00.20.22.40.08.74.
NICAddr[1] = 00.20.22.40.08.75.