home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 4 Drivers / 04-Drivers.zip / 594p.zip / DGUDREAD.ME < prev    next >
Text File  |  1994-03-03  |  5KB  |  157 lines
  1.  
  2.  
  3.     This readme file provides instructions for using the DigiBoard OS/2
  4.     Serial Port Test Utility, DGOS2UD.EXE. This utility tests any OS/2
  5.     Serial Device supported by a Physical Device Driver.
  6.  
  7.  
  8.  
  9.     Hardware and Software Requirements -
  10.  
  11.     Asynchronous Serial Port product.
  12.     OS/2 Device Driver for the product (loaded).
  13.     DGOS2UD.EXE Utility program.
  14.     Single port loopback connector wired as such :
  15.  
  16.        Signals        DB-25 pins
  17.  
  18.        Rx  -> Tx         2  -> 3
  19.        DTR -> DSR, DCD       20 -> 6,8
  20.        RTS -> CTS, RI        4  -> 5,22
  21.  
  22.  
  23.     Test Preparation -
  24.  
  25.     To prepare for testing a serial port, ensure that the following
  26.     criteria are met :
  27.  
  28.     - The hardware to be tested is properly installed.
  29.     - The correct device driver has loaded successfully.
  30.     - The loopback test connector is firmly installed on the port's
  31.       connector or cable.
  32.     - The DGOS2UD.EXE utility is accessible from your hard disk of floppy
  33.       drive.
  34.  
  35.  
  36.     DGOS2UD Execution -
  37.  
  38.     To start the utility, simply type DGOS2UD from any OS/2 Full Screen
  39.     or Window. You will see a menu from which you can make the following
  40.     choices :
  41.  
  42.         Select Port
  43.         Short Test
  44.         Continous Test
  45.         Display Error Log
  46.         Log File
  47.         Exit
  48.  
  49.     Each of the choices are described below :
  50.  
  51.     Select Port -
  52.  
  53.     This selection permits you to specify the Serial Port to be tested
  54.     by specifing the port's name. The default name is COM3 since you may
  55.     very likely have the DigiBoard port's starting with this device name.
  56.     If this is not the case, you may simply enter a different name.
  57.  
  58.  
  59.     Short Test -
  60.  
  61.     Selecting this option starts testing the serial port by    running
  62.     a series of tests that will terminate after one full pass. These
  63.     tests check that all modem control outputs and inputs function
  64.     properly. Data transmission and    reception is also test at different
  65.     combinations of baud rates, data bits, stop bits, and parity bits.
  66.     At each combination, 10 bytes are transmitted and checked for correct-
  67.     ness after reception. Also, the port is tested at it's maximum baud
  68.     rate with transmission of 10 kilobytes of data.
  69.  
  70.  
  71.     The baud rates tested are as follows :
  72.  
  73.     110,150,300,600,1200,1800,2400,4800,9600,19200,38400,57600 and
  74.     115200 with the following exceptions :
  75.  
  76.         Product                   Highest Baud Rate
  77.  
  78.        Non-Intelligent Serial Ports  (e.g COM2)      19200
  79.        DigiBoard's PC/X Boards             19200
  80.        DigiBoard's COM/Xi Boards                     19200
  81.        DigiBoard's C/X Concentrators                 57600
  82.  
  83.     The baud rates are limited due to product capabilities.
  84.  
  85.  
  86.     Continuous Test -
  87.  
  88.     This test is just a continuous cycle of short test executions.
  89.     When you select this option, you may choose wether the test will
  90.     stop when an error is encountered or just continue testing until
  91.     you manually stop it.
  92.  
  93.  
  94.     Display Error Log -
  95.  
  96.     This selection allows you to view the record of errors for the
  97.     test just executed. The error log records the following types of
  98.     errors :
  99.  
  100.         Receive Errors - These errors indicate that not all the data
  101.         was received.
  102.  
  103.         Transmit Errors - These errors indicate that not all the data
  104.         was transmitted.
  105.  
  106.         Data Integrity Errors - These errors indicate that the received
  107.         data was incorrect.
  108.  
  109.         Receive Overrun Errors - These errors indicate that the hardware
  110.         lost receive data.
  111.  
  112.         Receive Queue Overrun Errors - These errors indicate that the
  113.         driver did not have enough buffer space to store the
  114.         received data.
  115.  
  116.         Parity Errors - These error indicate that the hardware detected
  117.         a parity error on a received byte.
  118.  
  119.         Framing Errors - These error indicate that the hardware detected
  120.         a framing error on a received byte.
  121.  
  122.         Modem Signal RTS/CTS Errors  &
  123.         Modem Signal DTS/DSR Errors - These errors indicate a failure
  124.         occured with the indicated modem control line pair.
  125.  
  126.     Log File -
  127.  
  128.      This option allows you to enable or disable the logging of data
  129.      transmission errors to a disk file in your current directory. This
  130.      error file has the name PORT#.ERR, where # is the com ports number
  131.      (e.g. 2 for COM2). The errors are appended to the log file with a
  132.      time/date stamp and a record of the erroneous data.
  133.  
  134.  
  135.      Exit -
  136.  
  137.      Select this option to exit the utility.
  138.  
  139.  
  140.  
  141.  
  142.     Error reporting -
  143.  
  144.     During the Short Test or the Continuous Test with Stop On Error
  145.     selected, all errors will be presented to you in a red error message
  146.     box with a description of the error and the test parameters. If you
  147.     are running Continuous Test with no error stops, ann error indication
  148.     will be posted at the bottom of the screen.
  149.  
  150.  
  151.     Pass Indications -
  152.  
  153.     If your port has passed the diagnostic tests, there will be no
  154.     errors reported in the Error Log and you may assume that the
  155.     hardware and driver are functioning properly.
  156.  
  157.