test

SunVTS 3.0 Test Reference Manual

Chapter 29 Serial Asynchronous Interface (PCI) Test (saiptest)

saiptest checks the functionality of the Serial Asynchronous Interface card through its device driver.

saiptest Hardware Requirements

Before running the SunVTS diagnostics software, make sure you install the device driver and the cards to be tested. 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 -

You must run the saiptest in intervention mode.

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

The following hardware is also required to run other SunVTS Serial Asynchronous Interface tests:

saiptest Options

Figure 29-1 saiptest Options Menu

Graphic

The Configuration section of the option menu displays the asynchronous serial ports available for the Serial Asynchronous Interface board. Table 4-1 shows the available ports.

Table 29-1 saiptest Asynchronous Serial Ports

Board Number 

Board Device 

Serial Ports 

0 

saip0 

term/a000-a007 

1 

saip1 

term/b000-b007 

2 

saip2 

term/c000-c007 

3 

saip3 

term/d000-d007 

4 

saip4 

term/e000-e007 

5 

saip5 

term/f000-f007 

6 

saip6 

term/g000-g007 

7 

saip7 

term/h000-h007 

8 

saip8 

term/i000-i007 

9 

saip9 

term/j000-j007 

10 

saip10 

term/k000-k007 

11 

saip11 

term/l000-l007 

Table 29-2 saiptest Options

saiptest Option

Description 

Internal Test 

Performs internal loopback testing on the Serial Asynchronous Interface card(s) installed in PCI slots. You do not need to attach anything to the card(s) to perform this test. 

25-pin Loopback 

Provides full-duplex transmission and full-modem loopback testing of the serial port selected in the Serial Port section of the option menu. You must attach the 25-pin loopback plug to the serial port on the Serial Asynchronous Interface Patch Panel that is being tested. 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 selection of the option menu by echoing characters typed on a TTY terminal keyboard to the TTY terminal screen. The characters you type on your TTY keyboard display on the TTY screen. 

NOTE: A TTY connection to the Serial Asynchronous Interface serial port requires corresponding character size se up. For example, if a TTY attachment is running with 8-bit character size, then the Char Size saiptest option should be set to 8- bits. If you do not type any characters within two minutes, this test times-out.

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 the Internal Test is disabled and you are testing one port at a time. 

Char Size 

Specifies the 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; choose XOnOff, 

rtscts, or both. 

Data Type 

Specifies the selectable data type pattern; choose 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 saiptest options menu.

saiptest Test Modes

saiptest is only available in the Functional Test mode.

saiptest Command Line Syntax

/opt/SUNWvts/bin/saiptest standard_arguments -o dev=device_name, M=test_mode,B=baud_rate,Size=character_size,Stop=#of_stop_bits, Parity=parity,F=flow_control,Data=test_pattern,sp=serial_port

Table 29-3 saiptest Command Line Syntax

Argument 

Explanation 

dev=device_name

Specifies the asynchronous serial ports of the PCI card  

slots tested. Since there is no default, you must type a device name-either a board(saip0-12) or an individual port (term/x000-term/x007, where x is a-l): 

osaip0 = the 8 asynchronous serial ports in the first card 

osaip1 = the 8 asynchronous serial ports in the second card 

osaip2 = the 8 asynchronous serial ports in the third card 

osaip3 = the 8 asynchronous serial ports in the fourth card 

osaip4 = the 8 asynchronous serial ports in the fifth card 

osaip5 = the 8 asynchronous serial ports in the sixth card 

osaip6 = the 8 asynchronous serial ports in the seventh card 

osaip7 = the 8 asynchronous serial ports in the eighth card 

osaip8 = the 8 asynchronous serial ports in the ninth card 

osaip9 = the 8 asynchronous serial ports in the tenth card 

osaip10 = the 8 asynchronous serial ports in the eleventh card 

osaip11 = the 8 asynchronous serial ports in the twelfth card 

or 

/dev/term/x00m

Where x is a-l and m is 0 to 7 (any of the asynchronous serial

ports in PCI card slots). 

M=test_mode

Specifies Internal, 25_pin_loopback, or Echo_TTY test mode. 

B=baud_rate

Sets the baud rate to 110, 300, 600, 1200, 2400, 4800, 9600, 19200, 38400; the default is 9600. 

Stop=#of_stop_bits

Toggles the number of stop bits between 1 or 2; the default is 1. 

Size=character_size

Sets the character size as an integer between 5 and 8. 

Parity=parity

Specifies the parity as none, odd, or even; the default is none. 

F=flow_control 

Specifies flow control as xonoff, rtscts, or both. 

Data=test_pattern 

Specifies test pattern as 0x55555555, 0xAAAAAAAA, or random. 

sp=serial_port 

Specifies the terminal and asynchronous serial port number, such as term/a003. 

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

saiptest Error Messages

The saiptest error messages are generated when the SunVTS Serial Asynchronous Interface discovers errors. The error descriptions in the table below identify probable causes for the card or test failure, and identify the Field Replaceable Unit (FRU) and recommended action, if possible. The three FRUs under test are: the Serial Asynchronous Interface card, the 78-pin shielded cable, and the Patch panel

Table 29-4 saiptest 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

 

 

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 SAI/P 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 SAIP_ENLOOP error in device_name

 

 

8006

Ioctl SAIP_DISLOOP 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

 

 

8020

Timeout error on device_name

No loopback plug. 

Check the loopback plug. 

8021

Timeout error on device_name

TTY terminal not connected. 

Check the TTY terminal connected to the device. 

8022

Timeout error on device_name

 

 

.