home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / pcmag / gwlites.arc / GWLITES.DOC < prev   
Encoding:
Text File  |  1989-10-08  |  9.5 KB  |  187 lines
  1.  
  2.  
  3.  
  4.  
  5.                    GWLITES -- Software Breakout Box
  6.                                  from
  7.                    PC Magazine ..... March 14, 1989
  8.                    --------------------------------
  9.  
  10. Purpose:  Replaces an RS-232 breakout box by displaying the status of the
  11.           DTR, DSR, RTS, CTS, DCD, and RI pins; also indicates the data
  12.           rate, parity, number of data bits, and number of stop bits of
  13.           the serial port being monitored.
  14.  
  15. Format:   GWLITES [comport] [U]
  16.  
  17. Remarks:  GWLITES is a memory-resident utility that may be loaded either
  18.           at the DOS prompt or as part of an AUTOEXEC.BAT file.  If no
  19.           commmunications port is specified, GWLITES defaults to COM1:.
  20.           The default hotkey is Alt-L, which alternately pops up and
  21.           cancels the on-screen display.  Default display position is
  22.           the upper-right-hand corner of the screen.  GWLITES can be
  23.           deinstalled by entering the optional u (or U) parameter.
  24.           DO NOT precede the u (or U) with a slash.
  25.  
  26.           GWLITES.BAS will create GWLITES.COM on the B: drive when run
  27.           once from basic.  GWLITES so created will reflect all default
  28.           values.
  29.  
  30.           The various default options of GWLITES can be changed with
  31.           DEBUG.COM, as explained below.  The available patch points, the
  32.           number of bytes allocated, and the default values are listed
  33.           below, as well.
  34.  
  35. -------------------------------------------------------------------------------
  36. GWLITES.COM                                                              page 2
  37. -------------------------------------------------------------------------------
  38.  
  39.                            Patch Points
  40.                            ------------
  41.  
  42.                Function             Address      Bytes     Default
  43.                --------             -------      -----     -------
  44.  
  45.         Hotkey ID String              0155h          8        Alt-L
  46.         Hotkey Scan Code              0160h          1         26h
  47.         GWLITES Video Attribute       0161h          1         70h
  48.         GWLITES Display Row Number    0162h          1          0
  49.         GWLITES Display Column Offset 0163h          1          0
  50.         Refresh Frequency Counter     0164h          1          2
  51.         Default COM Port Designator   0165h          1          0 
  52.         Hotkey Shift Mask             01A0h          1          8 
  53.  
  54.  
  55.  
  56.               Keyboard Scan Codes for Alternative Hotkeys
  57.               -------------------------------------------
  58.  
  59.  +---+  +---+---+---+---+  +---+---+---+---+  +---+---+---+---+  +---+---+---+
  60.  |Esc|  |F1 |F2 |F3 |F4 |  |F5 |F6 |F7 |F8 |  |F9 |F10|F11|F12|  |PSc|ScL|SyR|
  61.  | 01|  | 3B| 3C| 3D| 3E|  | 3F| 40| 41| 42|  | 43| 44| 57| 58|  | 37| 46| 54|
  62.  +---+  +---+---+---+---+  +---+---+---+---+  +---+---+---+---+  +---+---+---+
  63.  +---+---+---+---+---+---+---+---+---+---+---+---+---+-------+ +---+---+---+---+
  64.  |~` |!1 |@2 |#3 |$4 |%5 |^6 |&7 |*8 |(9 |)10|_- |+= |BkS    | |NLk|/  |*  |-  |
  65.  | 29| 02| 03| 04| 05| 06| 07| 08| 09| 0A| 0B| 0C| 0D|     2B| | 45| 35| 37| 4A|
  66.  +---+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-----+ +---+---+---+---+
  67.  |Tab  |Q  |W  |E  |R  |T  |Y  |U  |I  |O  |P  |{[ |}] ||\   | |Hm7|8  |PU9|+  |
  68.  |   0F| 10| 11| 12| 13| 14| 15| 16| 17| 18| 19| 1A| 1B|   2B| | 47| 48| 49|   |
  69.  +-----++--++--++--++--++--++--++--++--++--++--++--++--+-----+ +---+---+---+   |
  70.  |CpL   |A  |S  |D  |F  |G  |H  |J  |K  |L  |:; |"' |Ent     | |4  |5  |6  |   |
  71.  |    3A| 1E| 1F| 20| 21| 22| 23| 24| 25| 26| 27| 28|      1C| | 4B| 4C| 4E| 4E|
  72.  +------++--++--++--++--++--++--++--++--++--++--++--+--------+ +---+---+---+---+
  73.  |Shf    |Z  |X  |C  |V  |B  |N  |M  |<, |>. |?/ |Shf        | |E1 |2  |PD3|Ent|
  74.  |     2A| 2C| 2D| 2E| 2F| 30| 31| 32| 33| 34| 35|         36| | 4F| 50| 51|   |
  75.  +-----+-++--+--++---+---+---+---+---+---+--++---+-+--+------+ +---+---+---+   |
  76.  |Ctl  |  |Alt  |Spc                         |Alt  |  |Ctl   | |In0    |Del|   |
  77.  |   1D|  |   38|                          39|   38|  |    1D| |     52| 53| 1C|
  78.  +-----+  +-----+----------------------------+-----+  +------+ +-------+---+---+
  79.  
  80.  
  81.                             Shift_Mask Value Table
  82.                             ----------------------
  83.                       0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F
  84.               Alt.............................o..o..o..o..o..o..o..o
  85.               Ctrl................o..o..o..o..............o..o..o..o
  86.               LShft.........o..o........o..o........o..o........o..o
  87.               RShft......o.....o.....o.....o.....o.....o.....o.....o
  88.                       0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F
  89.                                             o = key pressed
  90.  
  91.      (Use the scan codes and shift masks shown here to modify GWLITES.COM
  92.                    as described on the following pages.)
  93.  
  94.  
  95. -------------------------------------------------------------------------------
  96. GWLITES.COM                                                              page 3
  97. -------------------------------------------------------------------------------
  98.  
  99.           Using DEBUG.COM to change the Hotkey Scan Code and Shift Mask
  100.           -------------------------------------------------------------
  101.  
  102. The default hotkey, Alt-L, may conflict with other applications.  To change
  103. the hotkey FROM "Alt-L" to, say, "Cntl-F1", follow this DEBUG script:
  104.  
  105.              DEBUG GWLITES.COM        (invokes debug and loads GWLITES.COM)
  106.              E 0160 3B                (sets hotkey as F1)
  107.              E 01A0 4                 (sets shift mask as "control")
  108.              E 0155 "Cntl-F1"         (changes installation display)
  109.              W                        (writes file back to disk)
  110.              Q                        (quits DEBUG)
  111.  
  112.  
  113.                               IBM PC Color Codes
  114.                               ------------------
  115.              Code        Color                Code        Color
  116.              ----        -----                ----        -----
  117.               0          Black                 8          Gray
  118.               1          Blue                  9          Light Blue
  119.               2          Green                 A          Light Green
  120.               3          Cyan                  B          Light Cyan
  121.               4          Red                   C          Light Red
  122.               5          Magenta               D          Light Magenta
  123.               6          Brown                 E          Yellow
  124.               7          White                 F          Bright White
  125.  
  126. Use DEBUG to change the byte at address 0161h; for example, changing that
  127. byte to 4F produces bright white characters on a red background.  Background
  128. colors can have any value from 0 to 7, and foreground colors, any value from
  129. 0 to F.
  130.  
  131. To change the row in which the GWLITES display appears, change the byte at
  132. address 0162h.  The value may be from 0 to 24, representing rows counted
  133. from top to bottom.  The column offset at address 0163h moves the display
  134. the designated number of columns away from the right edge of the screen.
  135. To be ridiculous, the following DEBUG script puts the display in the center
  136. of the screen:
  137.  
  138.                         DEBUG GWLITES.COM
  139.                         E 0162 12
  140.                         E 0163 40
  141.                         W
  142.                         Q
  143.  
  144. The default refresh frequency counter updates the GWLITES display every other
  145. timer tick, or about 9 times per second.  The freqency can be dropped to 1,
  146. producing a refresh about 18 times per second, but the overhead is high.  A
  147. value in the range of 2 to 9 is about right.  Use this DEBUG script to change
  148. the refresh frequency to (approximately) 4 times per second:
  149.  
  150.                         DEBUG GWLITES.COM
  151.                         E 0164 5
  152.                         W
  153.                         Q
  154.  
  155. -------------------------------------------------------------------------------
  156. GWLITES.COM                                                              page 4
  157. -------------------------------------------------------------------------------
  158.  
  159. If no [comport] parameter is entered on the command line, GWLITES defaults to
  160. the value stored at 0165h.  Unlike the command line, on which COM1 would be
  161. designated by ASCII 1, the BIOS thinks of COM1 as port number 0, COM2 as port
  162. number 1, and so forth.  To change the default communications port to COM2,
  163. use this DEBUG script:
  164.                         DEBUG GWLITES.COM
  165.                         E 0165 1
  166.                         W
  167.                         Q
  168.  
  169.  
  170. Putting it all together, then, the following DEBUG script modifies GWLITES.COM
  171. in the manner shown:
  172.  
  173.              DEBUG GWLITES.COM        (invokes debug and loads GWLITES.COM)
  174.              E 0155 "Cntl-F1"         (changes installation display)
  175.              E 0160 3B                (sets hotkey as F1)
  176.              E 0161 4F                (Bright white on red display)
  177.              E 0162 0                 (Display in Row 0 - top of screen)
  178.              E 0163 0                 (Display at 0th column from right edge)
  179.              E 0164 9                 (Display refresh every 9/18 second)
  180.              E 0165 1                 (Defaults to COM2:)
  181.              E 01A0 4                 (sets shift mask as "control")
  182.              W                        (writes file back to disk)
  183.              Q                        (quits DEBUG)
  184.  
  185. -------------------------- Information from PC Magazine -----------------------
  186. -------------------------- March 14, 1989      pp 315ff -----------------------
  187.