

    This readme file provides instructions for using the DigiBoard OS/2
    Serial Port Test Utility, DGOS2UD.EXE. This utility tests any OS/2
    Serial Device supported by a Physical Device Driver.



    Hardware and Software Requirements -

	Asynchronous Serial Port product.
	OS/2 Device Driver for the product (loaded).
	DGOS2UD.EXE Utility program.
	Single port loopback connector wired as such :

	   Signals		DB-25 pins

	   Rx  -> Tx		 2  -> 3
	   DTR -> DSR, DCD       20 -> 6,8
	   RTS -> CTS, RI        4  -> 5,22


    Test Preparation -

	To prepare for testing a serial port, ensure that the following
	criteria are met :

	- The hardware to be tested is properly installed.
	- The correct device driver has loaded successfully.
	- The loopback test connector is firmly installed on the port's
	  connector or cable.
	- The DGOS2UD.EXE utility is accessible from your hard disk of floppy
	  drive.


    DGOS2UD Execution -

	To start the utility, simply type DGOS2UD from any OS/2 Full Screen
	or Window. You will see a menu from which you can make the following
	choices :

		Select Port
		Short Test
		Continous Test
		Display Error Log
		Log File
		Exit

	Each of the choices are described below :

	Select Port -

	This selection permits you to specify the Serial Port to be tested
	by specifing the port's name. The default name is COM3 since you may
	very likely have the DigiBoard port's starting with this device name.
	If this is not the case, you may simply enter a different name.


	Short Test -

	Selecting this option starts testing the serial port by	running
	a series of tests that will terminate after one full pass. These
	tests check that all modem control outputs and inputs function
	properly. Data transmission and	reception is also test at different
	combinations of baud rates, data bits, stop bits, and parity bits.
	At each combination, 10 bytes are transmitted and checked for correct-
	ness after reception. Also, the port is tested at it's maximum baud
	rate with transmission of 10 kilobytes of data.


	The baud rates tested are as follows :

	110,150,300,600,1200,1800,2400,4800,9600,19200,38400,57600 and
	115200 with the following exceptions :

		Product				   Highest Baud Rate

	   Non-Intelligent Serial Ports  (e.g COM2)      19200
	   DigiBoard's PC/X Boards			 19200
	   DigiBoard's COM/Xi Boards                     19200
	   DigiBoard's C/X Concentrators                 57600

	The baud rates are limited due to product capabilities.


	Continuous Test -

	This test is just a continuous cycle of short test executions.
	When you select this option, you may choose wether the test will
	stop when an error is encountered or just continue testing until
	you manually stop it.


	Display Error Log -

	This selection allows you to view the record of errors for the
	test just executed. The error log records the following types of
	errors :

	    Receive Errors - These errors indicate that not all the data
		was received.

	    Transmit Errors - These errors indicate that not all the data
		was transmitted.

	    Data Integrity Errors - These errors indicate that the received
		data was incorrect.

	    Receive Overrun Errors - These errors indicate that the hardware
		lost receive data.

	    Receive Queue Overrun Errors - These errors indicate that the
		driver did not have enough buffer space to store the
		received data.

	    Parity Errors - These error indicate that the hardware detected
		a parity error on a received byte.

	    Framing Errors - These error indicate that the hardware detected
		a framing error on a received byte.

	    Modem Signal RTS/CTS Errors  &
	    Modem Signal DTS/DSR Errors - These errors indicate a failure
		occured with the indicated modem control line pair.

	Log File -

	 This option allows you to enable or disable the logging of data
	 transmission errors to a disk file in your current directory. This
	 error file has the name PORT#.ERR, where # is the com ports number
	 (e.g. 2 for COM2). The errors are appended to the log file with a
	 time/date stamp and a record of the erroneous data.


	 Exit -

	 Select this option to exit the utility.




    Error reporting -

	During the Short Test or the Continuous Test with Stop On Error
	selected, all errors will be presented to you in a red error message
	box with a description of the error and the test parameters. If you
	are running Continuous Test with no error stops, ann error indication
	will be posted at the bottom of the screen.


    Pass Indications -

	If your port has passed the diagnostic tests, there will be no
	errors reported in the Error Log and you may assume that the
	hardware and driver are functioning properly.

