home *** CD-ROM | disk | FTP | other *** search
/ Shareware Breakthrough: Utilities & Productivity / SharewearBreakthroughUtil_ProdCol.cdr / util / rs232mon / readme.txt < prev    next >
Encoding:
Text File  |  1992-10-24  |  3.3 KB  |  79 lines
  1. Program: RS232MON.EXE
  2. Requires: Windows 3.1
  3. Abstract:
  4. This Windows 3.1 Utility allows you to monitor the RS-232 port 
  5. activities  of your DOS programs as your DOS program runs. 
  6. This program is great for the development of embedded data 
  7. terminal applications as it allows you to
  8. transparently monitor any DOS access to your RS-232 ports.  It works 
  9. just like an HP RS-232 protocol analyzer except it cost $$$ less. 
  10.  
  11.  
  12. This program requires the use of the special windows device driver: 
  13. CBBGBUFF.386.  Before running this program you must copy this file
  14. into your windows directory (usually c:\windows).  You must then modify
  15. your SYSTEM.INI file to include a reference to this new device driver.
  16. To modify your SYSTEM.INI file:
  17.   1. Copy the file CBBGBUFF.386 to your \windows subdirectory.
  18.   2. In your SYSTEM.INI file, replace the command "device=*combuff" 
  19.      with the command "device=cbbgbuff.386".  You should find these
  20.      commands the the [386Enh] section of the file.
  21.  
  22. To run the program:
  23.    1.  Copy RS232mon.exe to your \windows subdirectory.
  24.    2.  Start windows
  25.    3.  Use the "Run" command from the program manager and type "RS232mon.exe"
  26.    4.  Open up an MS-DOS window and run the DOS program you wish to monitor.
  27.  
  28.  
  29.  
  30.  
  31. OPERATION
  32. =========
  33. The operation of RS232mon is pretty straight foward.  
  34. 1.  Select the port you wish to trace on using the trace menu command.  
  35. 2.  On the display, each horizontal line is broken up into two fields.
  36.     All transmit activity is reported on the top of the line while
  37.     all receive activity is reported on the bottom of the line.
  38. 3.  As each line is filled up, RS232mon will move to the next line below it.
  39.     When the last line is filled, RS232mon cycles back up to the first line.
  40.     You can always find the last trace events by looking for the "*" on the
  41.     right side of the display.
  42.  
  43. 4.  Be patient.  In order for RS232mon to be as non-intrusive as possible,
  44.     it will only update the display every few seconds or so.  It will not 
  45.     loose any characters since it internally buffers all RS-232 
  46.     activities.
  47.  
  48.  
  49. HINTS
  50. ======
  51. 1.  Make sure you set the "background" bit for your DOS program.  Otherwise,
  52.     windows will suspend your DOS program when you switch to another program
  53.     (like RS232mon).
  54. 2.  Make sure you add the command "device=CBBGBUFF.386" and remove the
  55.     command "device=*combuff" from your system.ini file.  See the 
  56.     instructions above.
  57. 3.  If you are using a serial mouse, you will not be able to monitor
  58.     the serial port that your mouse is using. 
  59.     That's because the mouse driver locks that serial port.
  60. 4.  If you are going to trace COM3 and COM4, make sure you set up
  61.     Windows to recognized this.  See you Windows manual about setting
  62.     up COM3 and COM4.  If possible, set up your DOS program to use
  63.     COM1 or COM2 instead.  (Tracing COM3 and COM4 is difficult, is
  64.     not recommend, and not guaranteed to work).
  65.  
  66. 5.  THIS IS A DEMO PROGRAM.  If you find this program useful, please
  67.     send me $30 and I will send you the full working version of this 
  68.     program.  The full version supports data loging to a file.  The demo
  69.     version does not.
  70.  
  71.  
  72. David Tamashiro
  73. CBBG Consulting
  74. 816 N. Abbott Ave
  75. Milpitas, CA 95035
  76.  
  77. Internet: davetam@netcom.com
  78.  
  79.