CHAPTER 30

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:

• 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

saiptest Options

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 30-1 saiptest

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

Table 30-1 saiptest(Continued)

Board Number	Board Device	Serial Ports
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 30-2 saiptest

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.

Table 30-2 saiptest (Continued)

saiptest Option	Description
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 30-3 saiptest

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): ·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 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.

saiptest Error Messages

The saiptest error messages are generated when the SunVTS Serial Asynchronous Interface discovers errors. The error descriptions in Table 30-4 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 30-4 saiptest

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

Table 30-4 saiptest(Continued)

Error Message		Probable Cause(s)	Recommended Action
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