home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / MOUSE / COMCHK12.ZIP / COMMCHK.DOC next >
Encoding:
Text File  |  1990-11-17  |  3.2 KB  |  113 lines

  1. Commchk.doc    Version 1.2
  2.  
  3.     Documentation for the Serial protocol analizer
  4.  
  5.     Commchk is used to analyze information on a serial line by
  6.     intercepting the information and allowing you to view the
  7.     captured information in either a HEX format or in an ASCII format.
  8.     The information captured may also be saved in files stored on disk.
  9.  
  10.     Commchk performs this function by routing any information read from
  11.     com1 to com2 and any information read from com2 to com1, while 
  12.     capturing the information for display and or saving to a file.
  13.  
  14.     Commchk will split the screen into 2 windows, an upper window
  15.     and a lower window. the upper window will display the information
  16.     captured from com1 and sent to com2. The lower window will
  17.     display the information captured from com2 and sent to com1.
  18.  
  19.     This program was developed to allow analyzing information being
  20.     send from a host computer to a slave computer to determine the
  21.     source of errors that were getting into the system.
  22.  
  23.     Alternatively, Commchk can be used to allow a computer that does
  24.     not have a modem to access the modem of a second computer.
  25.  
  26.     Commchk command line options are summarized as follows.
  27.  
  28.         -I 0/1/2    all commands up to the next "I" command
  29.                 are for the identified port.
  30.                     0 = both ports
  31.                     1 = com1
  32.                     2 = com2
  33.  
  34.         -B baud        baud rates from 300 baud to 57600
  35.                 baud are supported.
  36.  
  37.         -P parity    Allowable paritys are
  38.                 EVEN, ODD, NONE
  39.  
  40.         -W word length    7 or 8 bits
  41.  
  42.         -S stop bits    1 or 2 stop bits
  43.  
  44.         -f file name    the file name must not have a length of
  45.                 greater than 7 characters, not including
  46.                 the path name. It is used to create create
  47.                 2 files, one for information read from com1,
  48.                 and one for information read from com2 by
  49.                 appending the communications port number
  50.                 and .fil to the end of the file name.
  51.                 IE: -f test
  52.                     generates test1.fil - com1 info
  53.                           test2.fil - com2 info
  54.  
  55.                      -f c:\commchk\test
  56.                     generates c:\commchk\test1.fil
  57.                           c:\commchk\test2.fil
  58.  
  59.     Example startup command:
  60.  
  61.         COMMCHK -I 1 -B 1200 -P E -W 7 -S 2 -I 2 -B 4800 -P N -W 8
  62.  
  63.         THIS SETS COM1 TO 1200 BAUD, 7 BIT, EVEN PARITY, 2 STOP BITS
  64.         AND COM2 TO 4800 BAUD, NO PARITY, 8 BIT.
  65.  
  66.  
  67.     Commchk keyboard commands are summarized as follows.
  68.  
  69.         F1 key - Help
  70.  
  71.         O  key - Open the currently active capture files
  72.  
  73.         C  key - Close the currently active capture files
  74.  
  75.         D  key - Toggle video display on and off
  76.  
  77.         F  key - Flush out all current serial port buffers
  78.                  of all characters.
  79.  
  80.         A  key - place the display in ASCII mode
  81.  
  82.         H  key - place the display in HEX mode
  83.  
  84.         Q  key - Quit
  85.  
  86.     Commchk Startup defaults are as follows
  87.         2400 Baud, 8 Data bits, 1 Stop bit, No parity
  88.         No capture file
  89.  
  90.  
  91. Revision History:
  92.  
  93.     11/5/90  - Fixed serial protocol data errors.
  94.  
  95.     11/13/90 - Modified help routine to not interrupt serial data flow.
  96.  
  97.                Added Flush buffer command.
  98.  
  99.                Modified asynchronous character send routine
  100.                errors that caused loss of characters.
  101.  
  102.                Added code to allow setting of the serial
  103.                ports to different parameters.
  104.  
  105.                Removed SHAREWARE message.
  106.  
  107.  
  108.     Written using Turbo C++ by:
  109.  
  110.         Timothy L. Garrison
  111.         3003 W. Marquette Woods Rd.
  112.         Stevensville Mi. 49127
  113.