C H A P T E R  49

Serial Asynchronous Interface (PCI) Test (saiptest)


saiptest Description

The saiptest checks the functionality of the serial asynchronous interface (SAI) card through its device driver.



Note - You must have Patch ID 109338 installed on the system where you plan to run the saiptest.




saiptest Requirements

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



Note - You must run the saiptest in Intervention mode.





Note - You must have Patch ID 109338 installed on the system where you plan to run the sapitest.



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

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 49-1 saiptest Test Parameter Options Dialog Box

Screenshot of the saiptest Test Parameter Options dialog box


The Configuration section of the Options dialog box displays the asynchronous serial ports available for the SAI board. The following table shows the available ports.


TABLE 49-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

12

saip12

term/m000-m007

13

saip 13

term/n000-n007

14

saip 14

term/o000-o007

15

saip 15

term/p00-p007


 


TABLE 49-2 saiptest Options

saiptest Option

Description

Test Mode: Internal

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

Test Mode: 25-pin loopback

Provides full-duplex transmission and full-modem loopback testing of the serial port selected in the Serial Port section of the dialog box. 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.

Test Mode: Echo-TTY

Checks the proper operation of the serial port selected in the Serial Port section of the option 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 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 dialog box.

Timeout

Specifies the number of seconds until the test times out. The default is 120 seconds.



saiptest Test Modes


TABLE 49-3 saiptest Supported Test Modes

Test Mode

Description

Functional

(Offline)

Runs the full set of tests.



saiptest Command-Line Syntax

/opt/SUNWvts/bin/saiptest standard-arguments -o dev=device-name, M=test-mode,B=baud-rate,Size=character-size,Stop=n-of-stop-bits,
Parity=
parity,F=flow-control,Data=test-pattern,sp=serial-port,tout=time-out

 


TABLE 49-4 saiptest Command-Line Syntax

Argument

Description

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-16) or an individual port (term/x000-term/x007, where x is a-p):

bulletsaip0 = the 8 asynchronous serial ports in the first card

bulletsaip1 = the 8 asynchronous serial ports in the second card

bulletsaip2 = the 8 asynchronous serial ports in the third card

bulletsaip3 = the 8 asynchronous serial ports in the fourth card

bulletsaip4 = the 8 asynchronous serial ports in the fifth card

bulletsaip5 = the 8 asynchronous serial ports in the sixth card

bulletsaip6 = the 8 asynchronous serial ports in the seventh card

bulletsaip7 = the 8 asynchronous serial ports in the eighth card

bulletsaip8 = the 8 asynchronous serial ports in the ninth card

bulletsaip9 = the 8 asynchronous serial ports in the tenth card

bulletsaip10 = the 8 asynchronous serial ports in the eleventh card

bulletsaip11 = the 8 asynchronous serial ports in the twelfth card

bulletsaip12 = the 8 asynchronous serial ports in the thirteenth card

bulletsaip13 = the 8 asynchronous serial ports in the fourteenth card

bulletsaip14 = the 8 asynchronous serial ports in the fifteenth card

bulletsaip15 = the 8 asynchronous serial ports in the sixteenth card

or

/dev/term/x00m

Where x is a-p 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/a00n (sp=n).

tout=time-out

Specifies the number of seconds until the test times out. The default is 120 seconds.




Note - The saiptest error messages are generated when the SunVTS Serial Asynchronous Interface discovers errors. The error descriptions that appear in the VTS interface identify probable causes for the card or test failure, and identify the field replaceable unit (FRU) and recommended action, if possible. The two FRUs under test are: the Serial Asynchronous Interface card, and the patch panel with the cable attached.