Serial Parallel Controller Test (spif)

The spif test accesses card components such as the cd-180 and ppc2 chips, and the serial and parallel ports via the Serial Parallel Controller device driver.

spif Hardware Requirements

Before running the SunVTS system exerciser, make sure you install the cards to be tested and the device driver. Also, you should reboot your system with the boot -r command to reconfigure the system and allow the SunVTS kernel to recognize the new driver.

---

Note - The spif test must be run in intervention mode.

---

The following minimum hardware configuration is required to successfully run the Internal Test:

• SBus-based SPARC desktop system with an SBus slot
• Serial Parallel Controller card, installed in one of the SBus slots

The following hardware is also required to run the other SunVTS Serial Parallel Controller tests:

• Serial Parallel Controller Patch panel (Part No. 540-2007)
• 96-pin loopback plugs (Part No. 370-1366)
• 25-pin serial loopback plugs (Part No. 540-1558)

• RS-232 serial cables (Part No. 530-1685)
• TTY terminal

spif Options

Figure 23-1 spif

The Configuration section of the option menu displays the serial ports available for the SPC/S board. The available ports are:

Board Number	Board Device	Serial Ports	Parallel Ports
0	stc0	term/0-7	printers/0
1	stc1	term/8-15	printers/1
2	stc2	term/16-23	printers/2
3	stc3	term/24-31	printers/3
4	stc4	term/32-39	printers/4
5	stc5	term/40-47	printers/5
6	stc6	term/48-55	printers/6
7	stc7	term/56-63	printers/7

The spif test options are described as follows:

• 96-pin Loopback (LB) test provides data transmission, full-modem loopback, and parallel port loopback testing. You must attach a 96-pin loopback plug to the card under test before running this test (See Appendix A, "Loopback Connectors").
• Internal Test performs a quick internal check of the Serial Parallel Controller card(s) installed in SBus slots. You do not need to attach anything to the card(s) to perform this test.
• 25-pin Loopback (LB) provides full-duplex transmission and full-modem loopback testing of the serial port selected in the Serial Port section of this menu. You must attach the 25-pin Loopback plug to the serial port on the Serial Parallel Controller Patch Panel that is being tested (See Appendix A, "Loopback Connectors"). This test cannot be run concurrently with the Echo-TTY option enabled.

---

Note - TTY connection to the spif serial port requires corresponding character size set up. For example, if a TTY attachment is running with 8-bit character size, then the spif test option 'Char Size' should also be set to 8 bits.

---

• Echo-TTY checks the proper operation of the serial port selected in the Serial Port section of this menu by echoing characters typed on a TTY terminal keyboard to the TTY terminal screen. Type anything on your TTY keyboard, and the characters you type should show up on the TTY screen.

---

Note - If you do not type anything within two minutes, this test will time-out. If you do not type anything at all, this test will still eventually time-out.

---

This test is terminated by pressing Control-C. After a short delay, the Status Window updates the Pass Count. This test cannot be run concurrently with the 25-pin Loopback subtest.

• Printer sends the entire ASCII character set to a parallel printer. You must attach a parallel printer to the parallel port on the Serial Parallel Controller patch panel. Observe the printer output to validate the test.
• Baud Rate specifies the baud rate; choose 110, 300, 600, 1200, 2400, 4800, 9600, 19200, or 38400 baud.

---

Note - The baud rate of 38400 can only be used if one port is tested at a time and the Internal Test is disabled.

---

• Char Size indicates character length; choose 5, 6, 7, or 8 characters.
• Stop Bit specifies the number of stop bits; choose 1 or 2 bits.
• Parity specifies the selectable parity; choose none, odd or even.
• Flow Control specifies the selectable flow control; choices are XOnOff, rtscts, or both.
• Data Type specifies the selectable data type pattern; it can be 0x55555555 (0x55), 0xaaaaaaaa (0xaa), or random.
• Serial Port specifies the serial port to be tested. The available ports are listed in the Configurations section at the top of the spif options menu.

You can also change the test options by modifying the /opt/SUNWvts/bin/.customtest file. See the section on Adding Your Own Tests in .customtest in the SunVTS 2.0 User's Guide.

spif Test Modes

Connectivity Mode Not available for spif.

Online Mode Not available for spif.

Offline Mode The spif test supports only the Offline mode.

spif Command Line Syntax

/opt/SUNWvts/bin/spif standard_arguments -o dev=device_name, M=test_mode,Ptr=enable/disable,B=baud_rate,Size=character_size,S=#of_stop_bits, Parity=parity,F=flow_control, Data=test_pattern, sp=serial_port

Argument	Explanation
dev=device_name	Specifies the serial ports in SBus card slots (0-63) being tested. Since there is no default, you must type a device name--either a board (stc0-7) or an individual port (term/0 - term/63):
	stc0 =....the 8 serial ports in the first card stc1 =....the 8 serial ports in the second card stc2 =....the 8 serial ports in the third card stc3 =....the 8 serial ports in the fourth card stc4 =....the 8 serial ports in the fifth card stc5 =....the 8 serial ports in the sixth card stc6 =....the 8 serial ports in the seventh card stc7 =....the 8 serial ports in the eighth card or /dev/term/mm Where mm is 0 to 63 (any of the serial ports in SBus card slots)

Argument	Explanation...(Continued)
M=test_mode	Specifies Internal, 96_pin_Loopback, 25_pin_loopback, or Echo_TTY test mode
Ptr=printer_test	Enables or disables the printer subtest
B=baud_rate	Sets the baud rate to 110, 300, 600, 1200, 2400, 4800, 9600, 19200, or 38400; the default is 9600. To use the 38400 rate, only one port at a time can be tested, and the Internal test must be disabled.
Stop=#of_stop_bits	Toggles the number of stop bits to 1 or 2; the default is 1.
Size=character_size	Sets character size as a number between 5 and 8.
P=parity	Specifies the parity as none, odd, or even; the default is none.
F=flow_control	Specifies flow control as xonxoff, rtscts, or both.
Data=test_pattern	Specifies test pattern as 0x55555555, 0xAAAAAAAA, or random.
sp=serial_port	Specifies the terminal and serial port number, such as term/3.

spif Error Messages

These error messages are generated when the SunVTS Serial Parallel Controller discovers errors. The error descriptions below identify probable causes for the card or test failure, and identify the Field Replaceable Unit (FRU), if possible. The three FRUs affected are: the Serial Parallel Controller card, the 96-pin shielded cable, and the Patch panel.

6000  <error_message>
6001  Expected = <value>, observed = <value>
6002  Expected (<value>):
6003  Observed (<value>):
6004  Modem Loopback test failed on <device_name>
6005  Off-line error on device <device_name>
6006  Paper out error on device <device_name>

6007  Busy error on device <device_name>

6008  Error on device <device_name>

6009  retry <number> exceeds limit <number> rc =s <value>

6010  Expected <number> bytes, observed <number> bytes

6011  Internal test failed on <device_name>

6012  Data Loopback test failed on <device_name>

6013  ioctl TIOCSSOFTCAR error on <device_name>

8000  Must provide device name!

8001  No SPC/S card found or device driver not installed

8002  ioctl TCSETS failed on <device_name>

8003  Open error on <device_name> - device driver may not
be installed properly

8004  Device <device_name> is already opened

8005  ioctl STC_SREGS(STC_IOREG-COR2) error in
<device_name>

8006  ioctl STC_GREGS(STC_IOREG-CCR) error in <device_name>

8007  ioctl STC_S1REGS(STC_IOREG-CCR) error in
<device_name>

8008  ioctl STC_SREGS(STC_PPCREG-PDATA) error in
<device_name>

8009  ioctl STC_GREGS(STC_PPCREG-PDATA) error in
<device_name>

8011  ioctl TIOCMGET failed on <device_name>

8012  <device_name>: Expected DSR set, observed clear
8013  <device_name>: Expected DSR clear, observed set
8014  ioctl TIOCMSET failed on <device_name>
8015  ioctl TIOCMBIC failed on <device_name>
8016  Read error on <device_name>
8017  Write error on <device_name>
8018  ioctl STC_GPPC error on device <device_name>
8019  Can't kill all processes
8020  Timeout error on <device_name>.

Probable_Cause(s):

a. No loopback plug

Recommended_Action(s):

a. Check Loopback plug!

8021  Timeout error on <device_name>.

Probable_Cause(s):

a. tty terminal not connected

Recommended_Action(s):

a. Check tty terminal connected to.

8022  Timeout error on <device_name>