125 lines
2.7 KiB
Groff
125 lines
2.7 KiB
Groff
.\" $NetBSD: pckbd.4,v 1.3 1999/12/21 11:31:07 drochner Exp $
|
|
.Dd March 20, 1999
|
|
.Os
|
|
.Dt PCKBD 4
|
|
.Sh NAME
|
|
.Nm pckbd
|
|
.Nd PC keyboard driver for wscons
|
|
.Sh SYNOPSIS
|
|
.Cd pckbc* at isa?
|
|
.Cd pckbd* at pckbc?
|
|
.Cd wskbd* at pckbd? console ?
|
|
.Cd options PCKBD_LAYOUT=XXX
|
|
.Sh DESCRIPTION
|
|
This driver supports PC/AT keyboards within the
|
|
.Xr wscons 4
|
|
console framework. It doesn't provide direct device
|
|
driver entry points but makes its functions available via
|
|
the internal
|
|
.Xr wskbd 4
|
|
interface.
|
|
.Pp
|
|
The
|
|
.Nm
|
|
driver supports a number of different key mappings which
|
|
can be chosen from with the kernel option
|
|
.Dq PCKBD_LAYOUT
|
|
at compile time or with the utility
|
|
.Xr wsconsctl 8
|
|
(variable:
|
|
.Dq encoding
|
|
) at runtime.
|
|
Other mappings can be used if the whole keymap is replaced by means of
|
|
.Xr wsconsctl 8 .
|
|
The builtin mappings are at this time:
|
|
.Bl -hang
|
|
.It KB_US
|
|
(for wsconsctl:
|
|
.Dq us
|
|
) English / US keyboard mapping (default).
|
|
.It KB_DE
|
|
(
|
|
.Dq de
|
|
) German with
|
|
.Dq dead accents .
|
|
.It KB_FR
|
|
(
|
|
.Dq fr
|
|
) French.
|
|
.It KB_DK
|
|
(
|
|
.Dq dk
|
|
) Danish with
|
|
.Dq dead accents .
|
|
.It KB_IT
|
|
(
|
|
.Dq it
|
|
) Italian.
|
|
.It KB_UK
|
|
(
|
|
.Dq uk
|
|
) British.
|
|
.It KB_JP
|
|
(
|
|
.Dq jp
|
|
) Japanese.
|
|
.It KB_SV
|
|
(
|
|
.Dq sv
|
|
) Swedish with
|
|
.Dq dead accents .
|
|
.It KB_US | KB_DECLK
|
|
(
|
|
.Dq us.declk
|
|
) English / US mapping for
|
|
.Tn DEC
|
|
LK400-style keyboards with PC keyboard interface (eg LK461).
|
|
.It KB_US | KB_DVORAK
|
|
(
|
|
.Dq us.dvorak
|
|
) English / US keyboard with
|
|
.Dq Dvorak
|
|
layout.
|
|
.El
|
|
.Pp
|
|
The KB_DE, KB_DK and KB_SV mappings can be used in the KB_NODEAD (
|
|
.Dq .nodead
|
|
) variant. This switches off the
|
|
.Dq dead accents .
|
|
.Pp
|
|
The KB_US, KB_JP and KB_US | KB_DVORAK mappings can be modified
|
|
to swap the left CNTL and the CAPS LOCK keys by the
|
|
KB_SWAPCTRLCAPS variant bit or the
|
|
.Dq .swapctrlcaps
|
|
suffix.
|
|
.Pp
|
|
The KB_METAESC (
|
|
.Dq .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.)
|
|
.Pp
|
|
Because PC keyboard hardware doesn't contain a beeper, requests for
|
|
.Dq keyboard beeps
|
|
cannot be handled directly. On alpha and i386 a helper device attached
|
|
to the
|
|
.Xr pcppi 4
|
|
driver allows to use the standard ISA speaker for this purpose.
|
|
.Sh EXAMPLES
|
|
To set a german keyboard layout without
|
|
.Dq dead accents
|
|
and sending an ESC character before the key symbol if the ALT
|
|
key is pressed simultanously, use
|
|
.Ic wsconsctl -w encoding=de.nodead.metaesc .
|
|
To set it at kernel build time, add
|
|
.Cd options PCKBD_LAYOUT="(KB_DE | KB_NODEAD | KB_METAESC)"
|
|
to the kernel configuration file.
|
|
.Sh BUGS
|
|
The list of builtin mappings doesn't follow any logics.
|
|
It grew as people submitted what they needed.
|
|
.Sh SEE ALSO
|
|
.Xr isa 4 ,
|
|
.Xr wskbd 4 ,
|
|
.Xr wsconsctl 8 ,
|
|
.Xr pcppi 4 .
|