usr.sbin/pcvt/Misc/Doc/Keyboard.HP

   1 ================================================================================
   2 #                                                                              #
   3 #       Function key mapping for the "more HP" - like layout                   #
   4 #                                                                              #
   5 ================================================================================
   6
   7
   8 I.      Function Key Map
   9 ========================
  10
  11
  12 PC   | F1  | F2  | F3  | F4  | F5  | F6  | F7  | F8  | F9  | F10 | F11 | F12 |
  13 Key
  14      _________________________________________________________________________
  15 UNSHF| 132 | Soft|     |     |     | 7/8 | Dspl| Auto| SCRN| SCRN| SCRN| SCRN|
  16 SYS  | Cols|Reset|     |     | Beep| Bit | Func| Wrap|  0  |  1  |  2  |  3  |
  17 LABEL|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|
  18 UNSHF|     |     |     |     |     |     |     |     | SCRN| SCRN| SCRN| SCRN|
  19 USER | F6  | F7  | F8  | F9  | F10 | F11 | F12 | F13 |  0  |  1  |  2  |  3  |
  20 LABEL|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|
  21      |     |     |     |     |     |     |     |     | Fkey| U/S |VT/HP| Next|
  22 ALT  | F14 | HELP| DO  | F17 | F18 | F19 | F20 | F21 |Label|Label| Mode| SCRN|
  23      |_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|
  24      | User| User| User| User| User| User| User| User|     |     |     |     |
  25 SHIFT| F6  | F7  | F8  | F9  | F10 | F11 | F12 | F13 |     |     |     |     |
  26      |_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|
  27 ALT- | User| User| User| User| User| User| User| User|     |     |     |     |
  28 SHIFT| F14 | F15 | F16 | F17 | F18 | F19 | F20 | F21 |     |     |     |     |
  29      |_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|
  30 CTRL-| SCRN| SCRN| SCRN| SCRN| SCRN| SCRN| SCRN| SCRN| SCRN| SCRN| SCRN| SCRN|
  31 ALT  |  0  |  1  |  2  |  3  |  4  |  5  |  6  |  7  |  8  |  9  |  10 |  11 |
  32      |_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|
  33
  34 PC   | F1  | F2  | F3  | F4  | F5  | F6  | F7  | F8  | F9  | F10 | F11 | F12 |
  35 Key
  36
  37
  38
  39 II.     Special Keys Used To Change The General Runtime Functionality
  40 =====================================================================
  41
  42
  43         To be consistent with XFfree86 2.0 Virtual Screen switching, it is
  44         now also possible to switch screens by using:
  45
  46                 CTRL - ALT - Fx , where x can be 1 ... No of screens compiled,
  47                                   see the definition of PCVT_NSCREENS !
  48
  49
  50         Virtual Screen/Terminal switching
  51         ---------------------------------
  52
  53                 F9  or CTRL-ALT-F1      switches to screen 0
  54                 F10 or CTRL-ALT-F2      switches to screen 1
  55                 F11 or CTRL-ALT-F3      switches to screen 2
  56                 F12 or CTRL-ALT-F4      switches to screen 3
  57                 CTRL-ALT-F5             switches to screen 4
  58                 CTRL-ALT-F6             switches to screen 5
  59                 CTRL-ALT-F7             switches to screen 6
  60                 CTRL-ALT-F8             switches to screen 7
  61                 CTRL-ALT-F9             switches to screen 8
  62                 CTRL-ALT-F10            switches to screen 9
  63                 CTRL-ALT-F11            switches to screen 10
  64                 CTRL-ALT-F12            switches to screen 11
  65
  66                 (see also ALT-F12 below)
  67
  68
  69         ALT-F9  Function key labels ON / OFF
  70         ------------------------------------
  71
  72                 this key is only operational, when in HP/VT mode, see F11
  73
  74                 ALT-F9 toggles between function key labels displayed or not.
  75
  76                 ON:  screen has either 25-3 = 22, 28-3 = 25 or 50-3 = 47 lines
  77                         2 lines fkey labels displayed
  78                         row/col display enabled
  79                         1 line status/load avg line
  80
  81                 OFF: screen has either 25-3 = 22, 28-3 = 25 or 50-3 = 47 lines
  82                         no function key labels displayed
  83                         no row/col display
  84                         no status/load avg line
  85
  86                 applicable escape sequences:
  87
  88                         switch OFF:
  89                         ESC & j @       remove labels from screen
  90
  91                         switch ON:
  92                         ESC & j A       display system fkey labels
  93                         ESC & j B       display user fkey labels
  94                         ESC & j C       display current fkey labels
  95
  96
  97         ALT-F10 User / System Function key labels
  98         -----------------------------------------
  99
 100                 this key is only operational, when in HP/VT mode, see ALT-F11
 101
 102                 ALT-F10 toggles between the display of user or system
 103                 function key labels
 104
 105                 this key is only active if labels are toggled on via
 106                 the ALT-F9 function key
 107
 108                 screen has either 25-3 = 22, 28-3 = 25 or 50-3 = 47 lines
 109                         2 lines fkey labels displayed
 110                         row/col display enabled
 111                         1 line status/load avg line
 112
 113
 114                 applicable escape sequences: (see above)
 115
 116                         ESC & j A       display system fkey labels
 117                         ESC & j B       display user fkey labels
 118                         ESC & j C       display current fkey labels
 119
 120
 121         ALT-F11 Toggle between pure VT and HP-VT Emulation
 122         --------------------------------------------------
 123
 124                 This key switches between pure vt100/vt220 mode and
 125                 vt100/vt220 with hp-fkey-labels mode of operation.
 126                 this is not dependent of any screen resolution the
 127                 virtual consoles are in.
 128
 129                 initially, after power on, all virtual screens are in
 130                 the pure vt-mode:
 131
 132                 - the emulator does not execute any hp escape sequences
 133                 - the function key label lines are switched off
 134                 - no load average or status line is displayed
 135                 - no row / column counter is displayed
 136                 - no window number is displayed
 137                 - the full screen 25x80, 28x80 or 50x80 is usable
 138                 - ALT-F9 and ALT-F10 have no function
 139
 140                 when toggled to the vt/hp mix of operation, the following
 141                 changes take place:
 142
 143                 - the emulator executes the supported hp-esc sequences
 144                 - the function key labels are displayable depending
 145                   on the state of ALT-F9/F10
 146                 - the load average is displayed
 147                 - the row / column counters are displayed
 148                 - the window number is displayed in the lower right corner
 149                 - in any screen resolution, the last 3 lines are lost,
 150                   so one has a 22x80, 25x80 and 47x80 resolution
 151                 - F9 and F10 are operational.
 152
 153                 when switching modes by means of ALT-F11, the following
 154                 changes to the current environment, the emulator may
 155                 be in, apply:
 156
 157                 - the screen is cleared
 158                 - the cursor moves to the home position
 159                 - the scrolling region is reset to default
 160
 161                 (this functionality is available via an ioctl)
 162
 163         ALT-F12 Cycle current screen
 164         ----------------------------
 165
 166                 This key cycles through the display of the video
 167                 screens. on startup, screen 0 is displayed; with every
 168                 keypress of F12, the next screen is displayed, wrapping
 169                 from the maximum screen number back to screen 0.
 170
 171                 (this functionality is available via an ioctl)
 172
 173
 174 III.    Special Keys used to change the Runtime Functionality of a Page
 175 =======================================================================
 176
 177         when in mixed HP/VT mode, one has two types of function key labels
 178         on screen, user function keys and system function keys.
 179
 180         this functionality is NOT available in pure VT220 mode !
 181
 182         the user function keys emit the below mentioned VT220 function-
 183         key sequences. the labels can be reprogrammed by use of escape
 184         sequences.
 185
 186         in system function key mode, several pre-programmed functions inside
 187         the emulator can be toggled, currently implemented are:
 188
 189         - F1, if a chipset is detected for which 132 operation is supported,
 190                 F1 toggles between 80 columns and 132 columns.
 191         - F2, does a soft reset of the emulator code
 192         - F3, -/-
 193         - F4, -/-
 194         - F5, toggle the audible beep generation
 195         - F6, toggle 7/8 bit char width
 196         - F7, toggle display functions. this means that control codes
 197               in the range 0x00 to 0x1f are not EXECUTED by the emulator
 198               any longer, but displayed on the screen
 199         - F8, toggle automatic cursor wraparound at end of line
 200
 201         these functions operate just for the selected screen
 202
 203
 204 IV.     Keyboard VT220 compatibility
 205 ====================================
 206
 207         The following keys behave different as probably expected.
 208
 209         They were mapped to provide more VT220 compatibility.
 210
 211         To have F1-F8 emit something in HP-mode, you have to switch
 212         to user function key labels by using ALT-F10 (see ALT-F10 above) !
 213
 214         PC Keyboard     VT220 Keyboard
 215         -------------   --------------------------------------------------
 216         F1              F6      (ESC [ 17 ~)
 217         F2              F7      (ESC [ 18 ~)
 218         F3              F8      (ESC [ 19 ~)
 219         F4              F9      (ESC [ 20 ~)
 220         F5              F10     (ESC [ 21 ~)
 221         F6              F11     (ESC [ 23 ~)
 222         F7              F12     (ESC [ 24 ~)
 223         F8              F13     (ESC [ 25 ~)
 224         ALT-F1          F14     (ESC [ 26 ~)
 225         ALT-F2          HELP    (ESC [ 28 ~)
 226         ALT-F3          DO      (ESC [ 29 ~)
 227         ALT-F4          F17     (ESC [ 31 ~)
 228         ALT-F5          F18     (ESC [ 32 ~)
 229         ALT-F6          F19     (ESC [ 33 ~)
 230         ALT-F7          F20     (ESC [ 34 ~)
 231         ALT-F8          F21     (ESC [ 35 ~)    (i know !!!!)
 232
 233         SHIFT-F1 ... SHIFT-F8
 234                         User Defined Keys for F6 - F13
 235
 236         ALT-SHIFT-F1 ... ALT-SHIFT-F8
 237                         User Defined Keys for F14 - F20
 238
 239         Insert          Insert Here (ESC [ 2 ~)
 240
 241         Delete          Remove (ESC [ 3 ~)
 242
 243         Home            Find (ESC [ 1 ~)
 244
 245         End             Select (ESC [ 4 ~)
 246
 247         PgUp            Prev Screen (ESC [ 5 ~)
 248
 249         PgDn            Next Screen (ESC [ 6 ~)
 250
 251         PrtSc           (ignored)
 252
 253         Pause           (ignored)
 254
 255         Break           (ignored)
 256
 257         Cursor Keys     dependent upon state of cursor key mode either
 258                         ESC [ A ... ESC [ D or ESC O A ... ESC O D
 259
 260         NumLock         toggles Numeric Keypad for Keypad Numeric Mode
 261                         and Keypad Application Mode
 262
 263         ALT-Keypad-0    can be used to generate any keycode in the
 264         ALT-Keypad-1    rage 0-255.
 265         ALT-Keypad-2    this was modeled with the behaviour of a
 266         ALT-Keypad-3    popular boot loader in mind
 267         ALT-Keypad-4
 268         ALT-Keypad-5
 269         ALT-Keypad-6
 270         ALT-Keypad-7
 271         ALT-Keypad-8
 272         ALT-Keypad-9
 273
 274         Numeric Keypad  dependent upon state of keypad numeric/application
 275                         mode either 0 ... 9 or ESC O p ... ESC O y
 276
 277         ALT-NumLock     emits PF1 sequence (ESC O P)
 278
 279         ALT-Keypad-/    emits PF2 sequence (ESC O Q)
 280
 281         ALT-Keypad-*    emits PF3 sequence (ESC O R)
 282
 283         ALT-Keypad--    emits PF4 sequence (ESC O S)
 284
 285
 286 /* EOF */