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