USB keyboard support
ukbd* at uhidev?
wskbd* at ukbd?
driver provides support for USB
keyboards i.e. HID devices in the “keyboard” class. Access to
the keyboard is through the
driver supports a number of
different key mappings which can be chosen from with the kernel option
“UKBD_LAYOUT” at compile time or with the utility
“keyboard.encoding”) at runtime. Other mappings can be used if
the whole keymap is replaced by means of
. The built-in
mappings are at this time:
- (be) Belgium French.
- (br) Brazilian.
- (cf) Canadian French.
- (de) German with “dead accents”.
- (dk) Danish with “dead accents”.
- (es) Spanish.
- (fr) French.
- KB_FR | KB_APPLE
- (fr.apple) French for Apple black USB keyboards.
- KB_FR | KB_DVORAK
- (fr.dvorak) French keyboard with “Dvorak-Bepo” layout.
- (hu) Hungarian.
- (is) Icelandic with “dead accents”.
- (it) Italian.
- (jp) Japanese.
- (la) Latinamerican.
- (lt) Lithuanian in “ISO 8859-13”.
- (lv) Latvian
- (nl) Dutch with “dead accents”.
- (no) Norwegian with “dead accents”.
- (pl) Polish in “ISO 8859-2”.
- (pt) Portuguese.
- KB_PT | KB_APPLE
- (pt.apple) Portuguese for Apple black USB keyboards.
- (ru) Russian in “KOI8”.
- (sf) Swiss French with “dead accents”.
- (sg) Swiss German with “dead accents”.
- (si) Slovenian.
- (sv) Swedish with “dead accents”.
- (tr) Turkish in “ISO 8859-9” with “dead
- (ua) Ukrainian in “KOI8”.
- (uk) British.
- (us) English/US keyboard mapping (default).
- KB_US | KB_DVORAK
- (us.dvorak) English/US keyboard with “Dvorak” layout.
The KB_DE, KB_DK, KB_IS, KB_NO, KB_SF, KB_SG, KB_SV and KB_TR mappings can be
used in the KB_NODEAD (.nodead) variant. This switches off the “dead
The KB_BE, KB_FR, KB_FR | KB_APPLE, KB_FR | KB_DVORAK, KB_JP, KB_UK, KB_US and
KB_US | KB_DVORAK mappings can be modified to swap the left Control and the
Caps Lock keys by the KB_SWAPCTRLCAPS variant bit or the
The KB_METAESC (.metaesc) option can be applied to any layout. If set, keys
pressed together with the ALT modifier are prefixed by an ESC character.
(Standard behaviour is to add 128 to the ASCII value.)
To set a German keyboard layout without “dead accents” and sending
an ESC character before the key symbol if the ALT key is pressed
. To set it at kernel build time,
add the following to the kernel configuration file:
driver appeared in
was added in OpenBSD 2.8
driver is brought into action rather
late in the boot process, so if it is used as the console driver then
is not usable until late in
The list of built-in mappings doesn't follow any logic. It grew as people
submitted what they needed.