saiptest checks the functionality of the Serial Asynchronous Interface card through its device driver.
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.
You must run the saiptest in intervention mode.
The following minimum hardware configuration is required to successfully run the Internal test:
PCI-based SPARC desktop 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. 7600-0027)
25-pin serial loopback plugs (Part No. 540-1558)
RS-232 serial cables (Part No. 530-1685)
TTY terminal
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 is only available in the Functional Test mode.
/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. |
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".
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 |
|
|
.