CHAPTER 17

Intelligent Fibre Channel Processor Test (ifptest)

ifptest tests the functionality of the PCI FC_AL card when there are no devices attached to the loop. The driver checks for devices on the fibre loop. If devices are detected it blocks any diagnostic commands.

---

Note - When devices are attached to the loop, do not run ifptest. Instead, run tests against the individual devices. This will test the whole subsystem including the FC_AL controller.

---

---

Note - The driver checks for devices on the fibre loop, and will block any diagnostic command if it finds attached devices.

---

ifptest uses the "mailbox" interface to the card. This interface allows certain firmware operations to be performed that normally would not be available to the application layer.

There are four subtests that are run in online and functional modes:

• Mailbox loopback Test

  Loads a series of registers into the input mailboxes on the card and then reads the output mailboxes and compares results. This verifies that the system side of the card is operating correctly, and that the internal data paths are ok.

• Firmware revision check

  Reads the firmware revision from the firmware and compares it against a revision loaded by the driver.

• Checksum firmware test

  Runs an internal checksum test on the installed firmware. This verifies that the risc ram on the card is fully functional and that the installed firmware is still intact. This test also serves as a quick ram check of the risc ram.

• Dump revision levels

  Extracts the hardware and firmware revision levels of different sub modules on the card.

ifptest Options

ifptest Option Menu

Table 0-1 ifptest

ifptest Options	Description
Mailbox Loopback Test	Enable|Disable the mailbox loopback command. This test writes data patterns into the mailboxes and then reads them back from the output mailboxes and verifies the data is correct.
Firmware Revision Check	Enable|Disable the firmware revision check command. This test extracts the firmware revision from the RISC firmware code and verifies against expected values.
Firmware Checksum Test	Enable|Disable the firmware checksum command. This command instructs the interface's risc processor to calculate the checksum on the current microcode and then compare it against the checksum that was loaded in with the microcode.
Check Module Revisions	Enable|Disable the firmware checksum command. This command returns the revision level of several sub-modules on the interface card. Although this test is executed when enabled, the module revision levels are only printed out in VERBOSE mode.

ifptest Command Line Syntax

/opt/SUNWvts/bin/ifptest standard_arguments [-p n] [-i n] [-w n]
-o [dev=device name] [mbox=Enable|Disable] [fwrevcheck=Enable|Disable]
[checksum=Enable|Disable] [modrevcheck=Enable|Disable]

TABLE 17-1 ifptest

Argument	Explanation
dev	The name of the device to test.
mbox	Enable|Disable the mailbox loopback command. This test writes data patterns into the mailboxes and then reads them back from the output mailboxes and verifies the data is correct.
fwrevcheck	Enable|Disable the firmware revision check command. This test extracts the firmware revision from the RISC firmware code and verifies against expected values.
checksum	Enable|Disable the firmware checksum command. This command instructs the interface's risc processor to calculate the checksum on the current microcode and then compare it against the checksum that was loaded in with the microcode.
modrevcheck	Enable|Disable the firmware checksum command. This command returns the revision level of several sub-modules on the interface card. Although this test is executed when enabled, the module revision levels are only printed out in VERBOSE mode.

ifptest Test Modes

ifptest runs in three modes.

TABLE 17-2 ifptest

Test Mode	Description
Functional mode	ifptest runs the full set of mailbox tests
Online mode	ifptest runs the full set of mailbox tests
Connectivity	ifptest only performs an open/close

---

Note - Connectivity mode will only open the controller to verify that the path is still viable.

---

ifptest Error Messages

TABLE 17-3 ifptest

	Error Message	Probable Cause(s)	Recommended Action
6000	Mailbox loopback failed	FC_AL board, System software.	Replace FC_AL board. If the problem persists, contact your authorized Sun service provider.
6001	Error: No device specified to test.
6002	Can not associate device with string.	New hardware added since VTS probe or system software.	Stop all testing and re-probe. If the problem persists, contact your authorized Sun service provider.
6003	FW Stop command returned data, expected 0.	IFP Firmware or a system software.	Reload IFP firmware. If the problem persists, contact your authorized Sun service provider.
6004	Command #data (cmd=value) did not successfully complete, status: Obs 0xvalue, Exp 0xvalue	IFP Firmware or a system software.	Reload IFP firmware. If the problem persists, contact your authorized Sun service provider.

TABLE 17-3 ifptest(Continued)

	Error Message	Probable Cause(s)	Recommended Action
6005	Chained command number data failed to complete.	IFP Firmware or a system software.	Reload IFP firmware. If the problem persists, contact your authorized Sun service provider.
6006	data errors were observed during this cycle.
6007	Command chain aborted: data commands queued, data commands run
6008	Command Issued: mbox[0]=0xvalue, mbox[1]=0xvalue, mbox[2]=0xvalue, mbox[3]=0xvalue, mbox[4]=0xvalue, mbox[5]=0xvalue, mbox[6]=0xvalue, mbox[7]=0xvalue
6009	Result Mboxes: mbox[0]=0xvalue, mbox[1]=0xvalue, mbox[2]=0xvalue, mbox[3]=0xvalue, mbox[4]=0xvalue, mbox[5]=0xvalue, mbox[6]=0xvalue, mbox[7]=0xvalue
6010	HCCR=0xvalue, BUS_SEMA=0xvalue, ISR=0xvalue, ICR=0xvalue, CDMA_COUNT=0xvalue, CDMA_ADDR=0xvalue
6011	CDMA_STATUS=0xvalue, CDMA_CONTROL=0xvalue, RDMA_COUNT=0xvalue, RDMA_ADDR=0xvalue, RDMA_STATUS=0xvalue, RDMA_CONTROL=0xvalue
6012	TDMA_COUNT=0xvalue, TDMA_ADDR=0xvalue, TDMA_STATUS=0xvalue, TDMA_CONTROL=0xvalue, RISC_PSR=0xvalue, RISC_IVR=0xvalue

TABLE 17-3 ifptest(Continued)

	Error Message	Probable Cause(s)	Recommended Action
6013	RISC_REGS: RR0=0xvalue, RR1=0xvalue, RR2=0xvalue, RR3=0xvalue, RR4=0xvalue, RR5=0xvalue, RR6=0xvalue, RR7=0xvalue
6014	RISC_REGS: RR8=0xvalue, RR9=0xvalue, RR10=0xvalue, RR11=0xvalue, RR12=0xvalue, RR13=0xvalue, RR14=0xvalue, RR15=0xvalue
6015	RISC_PCR=0xvalue, RISC_RAR0=0xvalue, RISC_RAR1=0xvalue, RISC_LCR=0xvalue, RISC_PC=0xvalue, RISC_SP=0xvalue
6016	REQUEST_IN=0xvalue, REQUEST_OUT=0xvalue, RESPONSE_IN=0xvalue, RESPONSE_OUT=0xvalue
6017	CURRENT_REQ_PTR=0xvalue, BASE_REQ_PTR=0xvalue, CURRENT_RESP_PTR=0xvalue, BASE_RESP_PTR=0xvalue
8000	string: invalid file descriptor data passed in.	Programming error or system software.	If the problem persists, contact your authorized Sun service provider.
8001	string: IOCTL call failed: string.	wrong/missing IFP driver.	Contact your system administrator to load correct driver. If the problem persists, contact your authorized Sun service provider.
8002	string: Firmware checksum failed, Rec: value, Exp: 0x0	Unsupported or bad firmware loaded or bad ifp controller.	Load the correct ifp driver. If the problem persists, contact your authorized Sun service provider.
8003	string: Get Revision command failed, return code 0xvalue.	Incorrect ifp firmware loaded or a system software problem.	Load the correct ifp driver. If the problem persists, contact your authorized Sun service provider.
8004	string: Phase 1 Revision check failed, Act: 0xvalue, Exp: 0xvalue	System software problem.	Contact your system administrator. If the problem persists, contact your authorized Sun service provider.

TABLE 17-3 ifptest(Continued)

	Error Message	Probable Cause(s)	Recommended Action
8005	string: Firmware restart failed, Counter: 0xvalue, Status: 0xvalue	System software problem. Possible defective IFP card.	Contact your system administrator. If the problem persists, contact your authorized Sun service provider.
8006	Unknown option passed in: string	Program error or system software problem.	Contact your system administrator. If the problem persists, contact your authorized Sun service provider.
8007	Bad option string passed to test: string	Program error or system software problem.	Contact your system administrator. If the problem persists, contact your authorized Sun service provider.
8008	Open of IFP device failed; string	System software problem.	Contact your system administrator. If the problem persists, contact your authorized Sun service provider.