Make a branch to make krunner Good Enough For Aaron™.
[kdebase/uwolfer.git] / apps / konsole / developer-doc / old-documents / More / vt100_numeric_keypad.txt
blobfbd953d45b853e6683a10574cb313873a03fd385
1 Subject: Re: ENTER keys
3 In message <538902171@KSINET.COM>, John.ksi@KSINET.COM says:
5 >  We're using MicroSoft's telnet software to connect to Stratus (VOS).
6 >  Using a VT100 emulator (yes, on both ends - I'm not THAT novice) we
7 >  find that the ENTER key (the key marked "Enter" on the PC's keypad)
8 >  does the same thing as the RETURN key (the key marked "Enter" on the
9 >  main part of the PC's keyboard) when it comes to working with CRT 
10 >  forms.
11 >  ...
12 >  (A) why do the RETURN and ENTER keys behave the same?
13 >  (B) how does one submit a completed CRT form with ONE keystroke?
15 To which <Paul_Green@vos.stratus.com> replied in message
16 <199502171715.MAA11104@transfer.stratus.com>:
18 |  You don't say which ttp you are using on VOS, but I will assume
19 |  it is the vt100.ttp file.
20 |  
21 |  The "keyboard" section of the vt100.ttp file defines the names
22 |  and key sequences used by the VT100 keys.  In it we find:
24 |       enter-key      Enter          esc O M
27 I have not used the Microsoft "telnet" application, but one standard
28 setup option in a DEC VT100 (or VT220, VT340, VT420, VT510, etc.) is
29 the "keypad mode"--what the behavior of the numeric keypad should be.
31 The two modes are "application" and "numeric".
33 In numeric mode, the various keypad keys send either the ASCII code
34 for decimal digits, or the ASCII code for the comma, period, or
35 hyphen, or (in the case of the keypad "Enter" key") the ASCII carriage
36 return control character (or CR/LF if so configured).
38 The "Enter" key behavior you describe is characteristic of numeric-
39 keypad mode.
41 The application mode is used by programs that don't need decimal
42 digits so much but need lots of user-activated software functions.
43 The DEC text-editing programs (EDT, EVE, etc.) are a classic example.
44 In application mode, the keypad keys send special Escape sequences
45 that chiefly begin with the so-called SS3 (single-shift G3) prefix,
46 which in 7-bit ASCII representation is the "Esc O".  (In 8-bit, SS3
47 is the single code hexadecimal 8F.)
49 The following chart summarizes the possible codes (7-bit) generated by
50 the DEC terminals' keypad:
52  Keypad Key    Numeric Mode   Application Mode
53  ----------    ------------   ----------------
54     0                0            Esc O p
55     1                1            Esc O q
56     2                2            Esc O r
57     3                3            Esc O s
58     4                4            Esc O t
59     5                5            Esc O u
60     6                6            Esc O v
61     7                7            Esc O w
62     8                8            Esc O x
63     9                9            Esc O y
64     -                -            Esc O m
65     ,                ,            Esc O l
66     .                .            Esc O n
67     Enter      carriage return    Esc O M
68     PF1           Esc O P         Esc O P
69     PF2           Esc O Q         Esc O Q
70     PF3           Esc O R         Esc O R
71     PF4           Esc O S         Esc O S
74  was intended for use by programs that
79 This is a matter that my site has encountered in a slightly different form.
81 Article 2620 of comp.protocols.kermit.misc:
82 Path: cs.utk.edu!cssun.mathcs.emory.edu!hobbes.cc.uga.edu!news-feed-1.peachnet.edu!gatech!swrinde!cs.utexas.edu!news.cs.utah.edu!cc.usu.edu!jrd
83 From: jrd@cc.usu.edu (Joe Doupnik)
84 Newsgroups: comp.protocols.kermit.misc
85 Subject: Re: Defining functional keys
86 Message-ID: <1995Apr22.122257.48276@cc.usu.edu>
87 Date: 22 Apr 95 12:22:57 MDT
88 References: <3n5307$jdd@kaie.va.ttu.ee>
89 Organization: Utah State University
90 Lines: 109
92 In article <3n5307$jdd@kaie.va.ttu.ee>, uuno@sofia.va.ttu.ee (Uuno Vallner) writes:
93 > We try to use KERMIT DOS as terminal. We have Novel and  Unix 
94 > mixed network. We try access to OSF/1 via IPX using Softnet in OSF/1.
95
96 > We defined Kermit port bios3. It works perfectly. We need to use estonian 
97 > characters. We are resolved this problem too. But ...
98
99 > We use application in OSF/1 (text retrieval system trip), which needs 
100 > for operating Application keypad (7,8. 9 ..1,0 ...)and some functional keys.
101 > But Kermit are using 7 as "home"
103 > Kermit interpreted non correct functional keys. After pressing f1, system 
104 > sends only ESC , after next f1 follows code and new ESC. Same effect is with
105 > array keys. 
106 --------------
108         I think there is some confusion about DEC versus IBM PC keys.
109 The relationship is detailed in distribution file MSVIBM.VT and also
110 in the user's manual book "Using MS-DOS Kermit." The IBM PC numeric
111 keypad keys are not necessarily related to the DEC KeyPad keys. Here
112 is a cutout from my copy of msvibm.vt:
115 1. VT320/VT102/VT52/Heath-19 EMULATOR IN MS-DOS KERMIT IBM-PC, CODE SUMMARY
117            VT320/VT102 keypads          Heath-19 and VT52 Keypads     
118               IBM keys                      IBM Keys                   
119    +------+------+------+------+  +------+------+-------+----------+
120    |  PF1 |  PF2 |  PF3 |  PF4 |  | Blue |  Red |  Grey | up arrow | - Vendor
121    |  F1  |  F2  |  F3  |  F4  |  |  F1  |  F2  |  F3   | up arrow | - Kermit
122    +------+------+------+------+  +------+------+-------+----------+
123    |  7   |  8   |  9   |  -   |  |  7   |  8   |  9    |down arrow|
124    |  F5  |  F6  |  F7  |  F8  |  |  F5  |  F6  |  F7   |down arrow|
125    +------+------+------+------+  +------+------+-------+----------+
126    |  4   |  5   |  6   |  ,   |  |  4   |  5   |  6    | rgt arrow|
127    |  F9  |  F10 |  SF1 |  SF2 |  |  F9  |  F10 |  SF1  | rgt arrow|
128    +------+------+------+------+  +------+------+-------+----------+
129    |  1   |  2   |  3   |  E   |  |  1   |  2   |  3    |left arrow|
130    |  SF3 |  SF4 |  SF5 |  n  S|  |  SF3 |  SF4 |  SF5  |left arrow|
131    +------+------+------+  t  F|  +------+------+-------+----------+
132    |  0------0   |  .   |  e  6|  |  0------0   |  .    |  Enter   |
133    |   SF7       |  SF8 |  r   |  |  SF7        |  SF8  |  SF6     |
134    +-------------+------+------+  +-------------+-------+----------+
136 SF1 means push Shift and F1 keys simultaneously
137 ---------------------------------------------------------------------------
138 Below, the acronyms CSI and SS3 stand for 8-bit control codes in an 8-bit
139 environment or for their 7-bit equivalents "ESC [" and "ESC O", respectively.
140 Command SET TERMINAL CONTROL {8-BIT | 7-BIT}, and an equivalent command from
141 the host, determines the usage for output text; use of parity forces 7-bit
142 mode.  CSI is decimal 155, SS3 is decimal 143.  Similarly, DCS is decimal 144
143 or ESC P and ST is decimal 156 or ESC \.  APC is decimal 159 or ESC _.
144 ---------------------------------------------------------------------------
145 Codes sent by DEC and Heath arrow keys
146 Key             Verb    IBM     VT320/VT102 mode        VT52/H19 mode
147                         key     Cursor  Application     Cursor or Application
149 up              uparr   up      CSI A   SS3 A           ESC A
150 down            dnarr   down    CSI B   SS3 B           ESC B
151 right           rtarr   right   CSI C   SS3 C           ESC C
152 left            lfarr   left    CSI D   SS3 D           ESC D
154 Codes sent by DEC editing keys, not preassigned to keys.
155 Key             Verb            VT320 mode              VT102/VT52/H19 mode
157 Find            decFind         CSI 1 ~                 these keys
158 Insert Here     decInsert       CSI 2 ~                  send nothing
159 Remove          decRemove       CSI 3 ~
160 Select          decSelect       CSI 4 ~
161 Prev Screen     decPrev         CSI 5 ~
162 Next Screen     decNext         CSI 6 ~                 ~ is ASCII chart 7/14
164 Codes sent by DEC Numeric Keypad
165 Key             Verb    IBM     ANSI VT320/VT102 mode   VT52/H19 mode
166                         key     Numeric Application     Numeric Application
168 PF1/HF7/Blue   Gold,pf1 F1      SS3 P   SS3 P           ESC P   ESC P
169 PF2/HF8/Red     pf2     F2      SS3 Q   SS3 Q           ESC Q   ESC Q
170 PF3/HF9/Grey    pf3     F3      SS3 R   SS3 R           ESC R   ESC R
171 PF4/HF1         pf4     F4      SS3 S   SS3 S           ESC S   ESC S
172 0               kp0     SF7     0       SS3 p           0       ESC ? p
173 1               kp1     SF3     1       SS3 q           1       ESC ? q
174 2               kp2     SF4     2       SS3 r           2       ESC ? r
175 3               kp3     SF5     3       SS3 s           3       ESC ? s
176 4               kp4     F9      4       SS3 t           4       ESC ? t
177 5               kp5     F10     5       SS3 u           5       ESC ? u
178 6               kp6     SF1     6       SS3 v           6       ESC ? v
179 7               kp7     F5      7       SS3 w           7       ESC ? w
180 8               kp8     F6      8       SS3 x           8       ESC ? x
181 9               kp9     F7      9       SS3 y           9       ESC ? y
182 comma (,)       kpcoma  SF2     ,       SS3 l           ,       ESC ? l
183 minus (-)       kpminus F8      -       SS3 m           -       ESC ? m
184 period (.)      kpdot   SF8     .       SS3 n           .       ESC ? n
185 Enter           kpenter SF6     CR or   SS3 M           CR or   ESC ? M
186                                 CR LF   (newline on)    CR LF
187  (SFn means hold down Shift key while pressing Function key n.)
188 ---------------
190         Please note that \Kkp0...\Kkp0 are placed on IBM PC function
191 keys by default. You can redefine such things using Kermit command
192 SET KEY, as discussed in depth in "Using MS-DOS Kermit."
193         I don't quite understand why you are using SET PORT BIOS3. Do
194 you have some Int 14h interceptor present to route traffic to the net?
195 For real serial ports BIOS3 is terrible. If you are using Novell's ODI
196 material then Kermit can operate as a native ODI client (using it's
197 internal TCP/IP stack). This is discussed in the release notes.
198         Joe D.