SetupDesignGuide.pdf - Firmware Encoding Index

More documents

Recommendations

Info

Setup Design Guide DRAFT 9 HII Keyboard Support 9.1 Keyboard Mapping The keyboard mapping that is defined in EFI is loosely based on ISO 9995. The naming mechanism is illustrated in Figure 2. The keys that are highlighted in red are the keys that almost all keyboard layouts use for customizations. That does not necessarily mean that all the keys are different. In fact, most of the keys are likely to be the same, however when modifying the mapping one can normally reference the keys in red as the likely candidates to create modifications for. Instead of referencing keys in hardware specific ways such as scan codes or HID entries, EFI now defines an EFI_KEY enumeration that allows for a simple way to reference this hardware abstraction. It also provides a way to update the keyboard layout with a great deal of flexibility. Any of the keys can be mapped to any Unicode value or control code value. Esc F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 Print SLck Pause E0 E1 E2 E3 E4 E5 E6 E7 E8 E9 E10 E11 E12 Backspace Ins Home PgUp NLck / * - Tab D1 D2 D3 D4 D5 D6 D7 D8 D9 D10 D11 D12 D13* CapsLock C1 C2 C3 C4 C5 C6 C7 C8 C9 C10 C11 C12* Enter Del End PgDn 7 8 9 4 5 6 + LShift B0* B1 B2 B3 B4 B5 B6 B7 B8 B9 B10 RShift LCtrl A0 LAlt Space Bar A2 A3 A4 RCtrl 1 2 3 0 . Enter Figure 2 When defining the values for a particular key, there are five elements that are pertinent to the key. Key Name: Unicode Value: The EFI_KEY enumeration (see Figure 1) defines the names of the above keys. This defines the Unicode value (if any) of the named key. Shifted Unicode Value: This defines the Unicode value (if any) of the named key while the shift modifier key is being pressed Alt-GR Unicode Value: This defines the Unicode value (if any) of the named key while the modifier key (if any) is being pressed. Alt-GR Shifted Alt-GR Unicode Value: This defines the Unicode value (if any) of the named key while the Shift and Alt-GR modifier key (if any) is being pressed. 80
Setup Design Guide DRAFT Modifier Key Value: This defines the non-printable special function this key has assigned to it. Under normal circumstances, a key that has any Unicode definitions generally has a Control key value of SCAN_NULL. This means the key has no special function other than the printing of a character. If any of the Unicode values have a value of 0xFFFF this is the exception to the rule. Though rarely used, this is the one case which a key might have both a printable character and an active Control key value. An example of this would be the numeric keypad’s insert key. The definition for this key on a standard US keyboard is as follows: Key Name = ZERO_KEY Unicode Value = 0x0030 (basically a ‘0’) Shifted Unicode Value = 0xFFFF (the exception to the rule) Alt-GR Unicode Value = 0x0000 Shifted Alt-GR Unicode Value = 0x0000 Modifier Key Value = SCAN_INSERT This is one of the few keys that under normal circumstances prints something out, but also has a special function. These are generally limited to the numeric keypad, however this does not prevent someone from having the flexibility to define these types of variations. (Assuming for the implementation that the state of CapsLock and NumLock, etc will correctly handle the shift states since they do it already……just wanted to mention it and it was thought about) 9.2 Modifier Key Definitions Modifier keys are defined to allow for special functionality that is not necessarily accomplished by a printable character. Many of these modifier keys are flags to toggle certain state bits on and off inside of a keyboard driver. An example is CAPS_LOCK_MODIFIER. This state being active could alter what the typing of a particular key produces. Other control keys affect the position of the cursor like LEFT_ARROW_MODIFIER, END_MODIFIER, etc. One modifier key is likely unfamiliar to most people who exclusively use US keyboards, and that key is the ALT_GR_MODIFIER key. This key’s primary purpose is to activate a secondary type of shift modifier that exposes additional printable characters on certain keys. In some keyboard layouts this key does not exist and is normally the RIGHT_ALT_MODIFIER key. None of the other modifier key functions should be a mystery to someone familiar with the usage of a standard computer keyboard. An example of a few descriptor entries would be as follows: Layout = { EfiKeyLCtrl,0,0,0,0,LEFT_CONTROL_MODIFIER, //(Left control key) EfiKeyA0,0,0,0,0,NULL_MODIFIER, //(Not defined windows key) EfiKeySpaceBar,0x0020,0x0020,0x0020,0x0020,NULL_MODIFIER //(Space Bar) } // // Define the Control modifier value information 81
Page 1 and 2:
Tiano Setup Design Guide Draft for
Page 3 and 4:
Setup Design Guide DRAFT Revision H
Page 5 and 6:
DRAFT 4.3 5 User Interface Design..
Page 7 and 8:
DRAFT 1 Introduction 1.1 Scope This
Page 9 and 10:
DRAFT RTC: Real Time Clock. The pie
Page 11:
DRAFT Description: Status Codes Ret
Page 14 and 15:
Setup Design Guide DRAFT VFR source
Page 16 and 17:
Setup Design Guide DRAFT 2.1.5 HII
Page 18 and 19:
Setup Design Guide DRAFT Human Inte
Page 20 and 21:
Setup Design Guide DRAFT Human Inte
Page 22 and 23:
Setup Design Guide DRAFT The driver
Page 24 and 25:
Setup Design Guide DRAFT 3 Setup Bu
Page 26 and 27:
Setup Design Guide DRAFT #define IF
Page 28 and 29:
Setup Design Guide DRAFT ::= oneof
Page 30 and 31: Setup Design Guide DRAFT #strdef SP
Page 32 and 33: Setup Design Guide DRAFT should onl
Page 34 and 35: Setup Design Guide DRAFT 4.2.15 tim
Page 36 and 37: Setup Design Guide DRAFT 4.2.18 got
Page 38 and 39: Setup Design Guide DRAFT This keywo
Page 40 and 41: Setup Design Guide DRAFT 5 User Int
Page 42 and 43: Setup Design Guide DRAFT The area b
Page 44 and 45: Setup Design Guide DRAFT 6 Setup Dr
Page 46 and 47: Setup Design Guide DRAFT 7 HII Data
Page 48 and 49: Setup Design Guide DRAFT Related De
Page 50 and 51: Setup Design Guide DRAFT // // A fo
Page 52 and 53: Setup Design Guide DRAFT 7.1.1 EFI_
Page 62 and 63: Setup Design Guide DRAFT 7.1.10 EFI
Page 72 and 73: Setup Design Guide DRAFT 7.3 EFI Fo
Page 74 and 75: Setup Design Guide DRAFT EFI_SUCCES
Page 78 and 79: Setup Design Guide DRAFT 8 Simple I
Page 82 and 83: Setup Design Guide DRAFT // #define
Page 84 and 85: Setup Design Guide DRAFT accent key
Page 86: Setup Design Guide DRAFT proceeded
show all

SetupDesignGuide.pdf - Firmware Encoding Index

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?