CHAPTER 29

Soc+ Host Adapter Card Test(socaltest)

socaltest aids the validation and fault isolation of the SOC+ host adapter card. In the case of a faulty card, it tries to isolate the fault to the card, the GBIC module, or the DMA between the host adapter card and the host memory.

FIGURE 29-1 socaltest

socaltest Options

TABLE 29-1 socaltest

socaltest Options	Description
Internal Loopback Test	The internal loopback test checks the host adapter card and the DMA with the host system. This is accomplished as follows: · A frame is created in the host adapter local memory, sent out through the SOC+ transmitter and internally looped back to the SOC+ receiver. The received data is compared with the original data. · A frame is created in the host adapter local memory, sent out through the SOC+ transmitter and looped back through the SERDES (serialiser-deserialiser) chip on the host adapter card. The received data is compared with the original data. A frame is created in the host main memory, transferred through the DMA to the host adapter transmitter, looped back within the SOC+ chip, and transferred from the receiver to the host main memory through the DMA. The received frame is compared with the original transmitted frame, which tests the host memory to the host adapter DMA path.
External Loopback Test	The external loopback test is useful for verifying the proper functioning of the GBIC module. A frame is created in the host adapter local memory, sent out and looped back through the external loopback connector attached to the port. If the external loopback test is run together with the internal loopback test then the DMA path is also tested by creating a frame in host main memory, transferring it to the host adapter through the DMA, looping it back through the external loopback connector and transferring the received frame back to the host main memory by DMA.

---

Note - In addition to the internal and external loopback tests described above, socaltest also tests the basic functions of the SOC+ chip, the on board XRAM, and the host control buffer by invoking the appropriate tests implemented in firmware.

---

socaltest Test Modes

socaltest can only be run in the Functional test mode.

---

Note - You cannot run this test if the port is connected to a disk array.

---

socaltest Command Line Syntax

/opt/SUNWvts/bin/socaltest [standard arguments] -o dev=device name,[elb=enabled|disabled],[ilb=enabled|disabled]

TABLE 29-2 socaltest

Argument	Explanation
dev=device name	Specifies the name of the socal port to be tested
elb=enabled|disabled	Enables or disables the external loopback test
ilb=enabled|disabled	Enables or disables the internal loopback test

socaltest Error Messages

TABLE 29-3 socaltest

Error Message		Probable Cause(s)	Recommended Action
8000	Couldn't open <device_name>	SOC+ card not installed	Verify that the target SOC+ card is installed properly.
8002	{SOC+ host adapter}-- {host memory} loopback test failed!	Fault in DMA between host and SOC+ host adapter	Contact your authorized Sun service provider.

TABLE 29-3 socaltest(Continued)

Error Message		Probable Cause(s)	Recommended Action
8006	SOC+ host adapter	Loopback cable not connected	Connect loopback cable
	external loopback test failed!	OEC module faulty or not installed properly	Replace OEC module and retry
			Contact your authorized Sun service provider.
8009	SOC+ host adapter internal loopback test failed!	SOC+ host adapter is faulty or is not properly installed	Verify that the SOC+ host adapter is installed properly.
			Replace the host adapter and retry.
			Contact your authorized Sun service provider.
8010	Failed ioctl <ioctl_name>	System error	Contact your authorized Sun service provider.
8011	Host control buffer test failed	SOC+ host adapter is faulty	Replace the host adapter and retry.
			Contact your authorized Sun service provider.
8012	SOC+ selftest fails	SOC+ host adapter is faulty	Replace the host adapter and retry.
			Contact your authorized Sun service provider.
8013	XRAM test fails	SOC+ host adapter is faulty	Replace the host adapter and retry.
			Contact your authorized Sun service provider.