CHAPTER 27

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 27-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 27-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 27-2 saiptest

saiptest Options	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. Type anything on you TTY keyboard, and the characters you type should show up on the TTY screen. NOTE: A TTY connection to the Serial Asynchronous Interface serial port requires corresponding character size set 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 anything within two minutes, this test will time-out.

Table 27-2 saiptest (Continued)

saiptest Options	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 27-3 saiptest

Argument	Explanation
dev=device_name	Specifies the asynchronous serial ports in PCI card slots being 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 to 1 or 2; the default is 1
Size=character_size	Sets 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 below identify probable causes for the card or test failure, and identify the Field Replaceable Unit (FRU), if possible. The three FRUs affected are: the Serial Asynchronous Interface card, the 78-pin shielded cable, and the Patch panel.

Table 27-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!

Table 27-4 saiptest(Continued)

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