46 - C H A P T E R -

C H A P T E R 46

Serial Asynchronous Interface (PCI) Test (saiptest)

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

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:

PCI-based SPARC system with a PCI slot
Serial asynchronous interface card, installed in one of the PCI slots

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

Serial asynchronous interface patch panel (part no. 370-2810)
25-pin serial loopback plugs (part no. 540-1558)
RS-232 serial cables (part no. 530-1685)
TTY terminal

saiptest Options

To reach the dialog box below, 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 may not include the device appropriate to this test. Refer to the SunVTS User's Guide for more details.

FIGURE 46-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 46-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 46-2 `saiptest` Options
`saiptest` Option	Description
Internal Test	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.
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. 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.
Timeout	Specifies the number of seconds until the test times out. The default is 120 seconds.

saiptest Test Modes

TABLE 46-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=#of_stop_bits, Parity=parity,F=flow_control,Data=test_pattern,sp=serial_port,tout=time_out

TABLE 46-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): saip0 = the 8 asynchronous serial ports in the first card saip1 = the 8 asynchronous serial ports in the second card saip2 = the 8 asynchronous serial ports in the third card saip3 = the 8 asynchronous serial ports in the fourth card saip4 = the 8 asynchronous serial ports in the fifth card saip5 = the 8 asynchronous serial ports in the sixth card saip6 = the 8 asynchronous serial ports in the seventh card saip7 = the 8 asynchronous serial ports in the eighth card saip8 = the 8 asynchronous serial ports in the ninth card saip9 = the 8 asynchronous serial ports in the tenth card saip10 = the 8 asynchronous serial ports in the eleventh card saip11 = the 8 asynchronous serial ports in the twelfth card saip12 = the 8 asynchronous serial ports in the thirteenth card saip13 = the 8 asynchronous serial ports in the fourteenth card saip14 = the 8 asynchronous serial ports in the fifteenth card saip15 = the 8 asynchronous serial ports in the sixteenth card or `/dev/term/x00`m 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 - 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.

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.