C H A P T E R  54

Serial Parallel Controller Test (spiftest)


spiftest Description

The spiftest accesses card components such as the cd-180 and ppc2 chips, and the serial and parallel ports through the serial parallel controller device driver.


spiftest Requirements

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



Note - The spiftest must be run in Intervention mode.



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

The following hardware is also required to run the other SunVTS serial parallel controller tests:


spiftest Options

To reach the following dialog box, right-click on the test name in the System Map and select Test Parameter Options. If you do not see this test in the System Map, you might need to expand the collapsed groups, or your system might not include the device appropriate to this test. Refer to the SunVTS User's Guide for more details.


FIGURE 54-1 spiftest Test Parameter Options Dialog Box


The Configuration section of the Options dialog box displays the serial ports available for the SPC/S board. The available ports are listed in the table below.


TABLE 54-1 spiftest Serial Ports for the SPC/S Board

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 spiftest options are described in the table below.


TABLE 54-2 spiftest Options

spiftest Option

Description

96-pin Loopback (LB)

Provides data transmission, full-modem loopback, and parallel port loopback testing. You must attach a 96-pin loopback connector (part number 370-1366) to the card before running this test (see Appendix A, "96-Pin Female Loopback Connector" section).

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 selection 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). This test cannot be run concurrently with the Echo-TTY option enabled.

Echo-TTY

Checks the proper operation of the selected serial port by echoing characters typed on a TTY terminal keyboard to the TTY terminal screen. The characters you type should be displayed on the TTY screen.

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

If you do not type within two minutes, this test will timeout. Terminate testing 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.

Stop Bit

Specifies the number of stop bits. Choose 1 or 2 bits.

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.

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. Choices are 0x55555555 (0x55), 0xaaaaaaaa (0xaa), or random.

Serial Port term

Specifies the serial port to be tested. The available ports are listed in the Configurations section at the top of the spiftest Options dialog box.


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


spiftest Test Modes


TABLE 54-3 spiftest Supported Test Modes

Test Mode

Description

Functional

Runs the full set of tests.



spiftest Command-Line Syntax

/opt/SUNWvts/bin/spiftest 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


TABLE 54-4 spiftest Command-Line Syntax

Argument

Description

dev=device-name

Specifies the serial ports in SBus card slots (0-63) being tested. Since there is no default, you must type a board name:

  • 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

M=test-mode

Specifies Internal, 96-pin-Loopback, 25-pin-loopback, or Echo-TTY test mode.

Ptr=-enable/disable

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 between 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.




Note - 64-bit tests are located in the sparcv9 subdirectory: /opt/SUNWvts/bin/sparcv9/testname, or the relative path to which you installed SunVTS. If a test is not present in this directory, then it might be available as a 32-bit test only. For more information, see 32-Bit and 64-Bit Tests.