home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / mskermit / msulk2.txt < prev    next >
Text File  |  2020-01-01  |  8KB  |  197 lines
  1. File LK250.HLP            LK250 KEYBOARD UTILITY                September 1993
  2.  
  3.  
  4. MSULK2.COM and MSULKV.COM are a "device drivers" for the DEC LK250 and LK450
  5. keyboards.  This is a keyboard made by Digital Equipment Corporation (DEC)
  6. that can be substituted for IBM's keyboard on IBM PC/ATs and above, including
  7. PS/2s, and is also the keyboard used on the DEC VAXmate.  MSULK2.COM is to be
  8. used on IBM equipment, MSULKV.COM is for the VAXmate.  The technical
  9. requirement is a machine with a bidirectional keyboard interface (separate
  10. keyboard controller) and a BIOS Int 15H hook for "System Request".  This
  11. program has no effect when run on original PCs and PC/XTs because those
  12. machines do not meet these requirements.  Here's what the LK250 driver does:
  13.  
  14. 1) It allows the keyboard to be switched from DEC to IBM mode and back under
  15. program control.  This replaces the "Press Alt-Special" mechanism provided by
  16. DEC.
  17.  
  18. 2) It allows programs which call it to manipulate the state of the keyboard.
  19. Currently, MS-DOS Kermit only does this to set/clear the Hold Screen LED, so
  20. that the user can tell if s/he's in Hold Screen mode.
  21.  
  22. 3) It intercepts certain key scancodes which normally can't be seen (like Num
  23. Lock) so that they can be used as DEC functions.
  24.  
  25. The LK250 driver controls the behavior of the top-row function keys and the
  26. two keypads on the right end of the keyboard.  When the driver is active, it
  27. puts your LK250 keyboard into "DEC" mode, meaning that the legends on the
  28. keytops apply, rather than the blue labels on the front of the keys.  The blue
  29. labels correspond to IBM keys and functions.
  30.  
  31. If the driver is loaded, MS-DOS Kermit 3.0 and later will make use of it if
  32. you tell Kermit to SET KEY LK and then SET KEY CLEAR:
  33.  
  34.   MS-Kermit>set key lk
  35.   MS-Kermit>set key clear
  36.  
  37. The SET KEY LK command has no effect if the driver is not loaded.  If the
  38. driver is loaded, this command sequence puts the keyboard into DEC mode during
  39. terminal emulation (CONNECT), and returns it to IBM mode whenever terminal
  40. emulation ends.
  41.  
  42. During terminal emulation, the scan codes of the DEC keys are mapped to the
  43. MS-DOS Kermit keyboard verbs of the same name as the DEC keys, so the keyboard
  44. appears to work like the regular LK201 DEC keyboard found on the VT200 and 300
  45. series terminals.  Here's the list of assignments when the LK250 driver is
  46. active and the keyboard is in DEC mode:
  47.  
  48. LK250 Key           Assignment (Character or Kermit Verb)
  49.  
  50. Space Bar           \313 (see below)
  51.  
  52. Compose             Escape (\27)                  Main Keyboard
  53. Backspace           DEL (\127)
  54. Shift-Backspace     Backspace (\8)
  55. Return              Carriage return (\13)
  56. Shift-Return        Linefeed (\10)
  57. Tab                 Horizontal Tab (\9)
  58.  
  59. F1  (Hold)          \Kholdscrn                    Top Row Function Keys
  60. F2  (Print Screen)  \Kprtscn
  61. F3  (Setup)         (none)
  62. F4                  (none)
  63. F5  (Break)         \Kbreak
  64. F6  (Interrupt)     \KdecF6
  65. F7  (Resume)        \KdecF7
  66. F8  (Cancel)        \KdecF8
  67. F9  (Main Screen)   \KdecF9
  68. F10 (Exit)          \KdecF10
  69. F11 (ESC)           \KdecF11
  70. F12 (BS)            \KdecF12
  71. F13 (LF)            \KdecF13
  72. F14 (Insert/Overst) \KdecF14
  73. F15 (Help)          \KdecHelp
  74. F16 (Do)            \KdecDo
  75. F17                 \KdecF17
  76. F18                 \KdecF18
  77. F19                 \KdecF19
  78. F20                 \KdecF20
  79.  
  80. Find                \KdecFind                     Cursor/select keypad (gray)
  81. Insert Here         \KdecInsert
  82. Remove              \KdecRemove
  83. Select              \KdecSelect
  84. Prev                \KdecPrev
  85. Next                \KdecNext
  86. Up Arrow            \Kuparr
  87. Left Arrow          \Klfarr
  88. Right Arrow         \Krtarr
  89. Down Arrow          \Kdnarr
  90.  
  91. PF1 (Gold)          \Kgold                         Numeric keypad
  92. PF2                 \Kpf2
  93. PF3                 \Kpf3
  94. PF4                 \Kpf4
  95. Keypad 7            \Kkp7
  96. Keypad 8            \Kkp8
  97. Keypad 9            \Kkp9
  98. Keypad - (Minus)    \Kkpminus
  99. Keypad 4            \Kkp4
  100. Keypad 5            \Kkp5
  101. Keypad 6            \Kkp6
  102. Keypad , (Comma)    \Kkpcoma
  103. Keypad 1            \Kkp1
  104. Keypad 2            \Kkp2
  105. Keypad 3            \Kkp3
  106. Keypad Enter        \Kkpenter
  107. Keypad 0            \Kkp0
  108. Keypad . (Period)   \Kkpdot
  109.  
  110. To install the driver, just type "msulk2" on IBM PCs and PS/2s, or "msulkv" on
  111. VAXmates (this assumes that MSULK2.COM or MSULKV.COM is in your current disk
  112. and directory or in your DOS path).  You can also run the driver from your
  113. AUTOEXEC.BAT file if you want it to be active all the time.
  114.  
  115. Version 3.13 of MS-DOS Kermit differs from earlier releases in differentiating
  116. the scan codes generated by the Space bar when pressed in conjunction with
  117. Shift, Ctrl, and/or Alt.  On a regular PC keyboard, unmodified Space bar
  118. generates a scan code of \32 (which is, indeed, the ASCII code for Space), but
  119. on an LK250, the code \313 is generated.  Thus, when using MS-DOS Kermit 3.13
  120. with an LK250 keyboard, you must make (at least) the following key mapping:
  121.  
  122.   SET KEY \313 \32          ; Make space bar send Space
  123.  
  124. You might also want to make separate mappings for Space bar combinations,
  125. for example:
  126.  
  127.   SET KEY \1337 \0         ; Ctrl-Spacebar sends NUL 
  128.   SET KEY \825 \32         ; Shift-Spacebar sends Space
  129.   etc.
  130.  
  131. For the VAXmate only, a set of key definitions is also required.  Add these
  132. to your MSCUSTOM.INI file:
  133.  
  134. SET KEY \326    \KPF3       ; PF3 Scrl Lock
  135. SET KEY \311    \KPF4       ; PF4 Prt Sc
  136.  
  137. SET KEY \339    \Kkpdot     ;    KP .    Delete
  138. SET KEY \338    \Kkp0       ;    KP 0    Install
  139. SET KEY \335    \Kkp1       ;    KP 1    End
  140. SET KEY \336    \Kkp2       ;    KP 2    Down Arrow
  141. SET KEY \337    \Kkp3       ;    KP 3    Page Down
  142. SET KEY \331    \Kkp4       ;    KP 4    Left Arrow
  143. SET KEY \332    \Kkp5       ;    KP 5    unused
  144. SET KEY \333    \Kkp6       ;    KP 6    Right Arrow
  145. SET KEY \327    \Kkp7       ;    KP 7    Home
  146. SET KEY \328    \Kkp8       ;    KP 8    Up Arrow
  147. SET KEY \329    \Kkp9       ;    KP 9    Page up
  148. SET KEY \330    \Kkpminus   ;    KP -    -
  149. SET KEY \334    \Kkpcoma    ;    KP ,    +
  150. SET KEY \2494   \Kkpenter   ;    Alt-Enter
  151.  
  152. SET KEY \389    \kdecfind   ;     Find or Home
  153. SET KEY \390    \kdecinsert ;     Insert Here
  154. SET KEY \391    \kdecremove ;     Remove
  155. SET KEY \392    \kdecselect ;     Select or End
  156. SET KEY \393    \kdecprev   ;     Previous Screen
  157. SET KEY \394    \kdecnext   ;     Next Screen
  158. SET KEY \395    \Kuparr     ;     Up Arrow
  159. SET KEY \396    \Klfarr     ;     Left Arrow
  160. SET KEY \397    \Krtarr     ;     Right Arrow
  161. SET KEY \398    \Kdnarr     ;     Down Arrow
  162.  
  163. SET KEY \315    \Kholdscrn  ;     F1  Toggle Hold Screen
  164. SET KEY \316    \Kprtscn    ;     F2  Print Screen;
  165. SET KEY \317    \Ktermtype  ;     F3  Toggle Toggle Terminal Type
  166. SET KEY \318    \Klogoff    ;     F4  Turn Session Logging Off
  167. SET KEY \319    \Kbreak     ;     F5  Break
  168.  
  169. SET KEY \x140 \kdecf6
  170. SET KEY \x141 \kdecf7
  171. SET KEY \x142 \kdecf8
  172. SET KEY \x143 \kdecf9
  173. SET KEY \x144 \kdecf10
  174. SET KEY \399 \kdecf11
  175. SET KEY \400 \kdecf12
  176. SET KEY \401 \kdecf13
  177. SET KEY \402 \kdecf14
  178. SET KEY \403 \kdechelp
  179. SET KEY \404 \kdecdo
  180. SET KEY \405 \kdecf17
  181. SET KEY \406 \kdecf18
  182. SET KEY \407 \kdecf19
  183. SET KEY \408 \kdecf20
  184.  
  185. ; shift-return
  186. SET KEY \796 \13
  187. ; shift-delete
  188. SET KEY \782 \127
  189.  
  190. The LK250 program was written in IBM PC assembly language and contributed to
  191. Kermit Distribution by Terry Kennedy, St. Peter's College, Jersey City, New
  192. Jersey, USA (TERRY@SPCVXA.SPC.EDU), December 1989.  It was adapted to the
  193. VAXmate by Trevor Warwick, Digital Equipment Co, Reading, England
  194. (warwick@marvin.enet.dec.com).
  195.  
  196. (End of File MSULK2.HLP)
  197.