test

SunVTS 3.0 Test Reference Manual

Chapter 33 Serial Parallel Controller Test (spiftest)

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 Hardware Requirements

Before running the SunVTS system exerciser, make sure you install the cards to be tested and the device driver. You should also reboot your system with the boot -r command to reconfigure the system and allow 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

Figure 33-1 spiftest Option Menu

Graphic

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

Table 33-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 33-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 Lookback 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 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. 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 time-out. 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. 

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 spiftest Options menu.

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 3.0 User's Guide.

spiftest Test Modes

The spiftest supports only the Functional test mode.

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 33-3 spiftest Command Line Syntax

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 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=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 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. If a test is not present in this directory, then it may only be available as a 32-bit test. For more information refer to "32-Bit and 64-Bit Tests".

spiftest Error Messages

These error messages are generated when the SunVTS serial parallel controller discovers any 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.

Table 33-4 spiftest Error Messages

 

Error Message 

Probable Cause(s) 

Recommended Action 

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.

There is no loopback plug 

Check the loopback plug. 

8021

Timeout error on device_name

TTY terminal not connected 

Check the TTY terminal connection. 

8022

Timeout error on device_name