1.\" $NetBSD: pckbd.4,v 1.6 2001/06/12 11:26:21 wiz Exp $ 2.Dd March 20, 1999 3.Os 4.Dt PCKBD 4 5.Sh NAME 6.Nm pckbd 7.Nd PC keyboard driver for wscons 8.Sh SYNOPSIS 9.Cd pckbc* at isa? 10.Cd pckbd* at pckbc? 11.Cd wskbd* at pckbd? console ? 12.Cd options PCKBD_LAYOUT=XXX 13.Sh DESCRIPTION 14This driver supports PC/AT keyboards within the 15.Xr wscons 4 16console framework. It doesn't provide direct device 17driver entry points but makes its functions available via 18the internal 19.Xr wskbd 4 20interface. 21.Pp 22The 23.Nm 24driver supports a number of different key mappings which 25can be chosen from with the kernel option 26.Dq PCKBD_LAYOUT 27at compile time or with the utility 28.Xr wsconsctl 8 29(variable: 30.Dq encoding 31) at runtime. 32Other mappings can be used if the whole keymap is replaced by means of 33.Xr wsconsctl 8 . 34The builtin mappings are at this time: 35.Bl -hang 36.It KB_US 37(for wsconsctl: 38.Dq us 39) English / US keyboard mapping (default). 40.It KB_DE 41( 42.Dq de 43) German with 44.Dq dead accents . 45.It KB_FR 46( 47.Dq fr 48) French. 49.It KB_DK 50( 51.Dq dk 52) Danish with 53.Dq dead accents . 54.It KB_IT 55( 56.Dq it 57) Italian. 58.It KB_UK 59( 60.Dq uk 61) British. 62.It KB_JP 63( 64.Dq jp 65) Japanese. 66.It KB_SV 67( 68.Dq sv 69) Swedish with 70.Dq dead accents . 71.It KB_US | KB_DECLK 72( 73.Dq us.declk 74) English / US mapping for 75.Tn DEC 76LK400-style keyboards with PC keyboard interface (eg LK461). 77.It KB_US | KB_DVORAK 78( 79.Dq us.dvorak 80) English / US keyboard with 81.Dq Dvorak 82layout. 83.El 84.Pp 85The KB_DE, KB_DK and KB_SV mappings can be used in the KB_NODEAD ( 86.Dq .nodead 87) variant. This switches off the 88.Dq dead accents . 89.Pp 90The KB_US, KB_JP and KB_US | KB_DVORAK mappings can be modified 91to swap the left CTRL and the CAPS LOCK keys by the 92KB_SWAPCTRLCAPS variant bit or the 93.Dq .swapctrlcaps 94suffix. 95.Pp 96The KB_METAESC ( 97.Dq .metaesc 98) option can be applied to any layout. If set, keys pressed together 99with the ALT modifier are prefixed by an ESC character. (Standard 100behaviour is to add 128 to the ASCII value.) 101.Pp 102Because PC keyboard hardware doesn't contain a beeper, requests for 103.Dq keyboard beeps 104cannot be handled directly. On alpha and i386 a helper device attached 105to the 106.Xr pcppi 4 107driver allows to use the standard ISA speaker for this purpose. 108.Sh EXAMPLES 109To set a german keyboard layout without 110.Dq dead accents 111and sending an ESC character before the key symbol if the ALT 112key is pressed simultaneously, use 113.Ic wsconsctl -w encoding=de.nodead.metaesc . 114To set it at kernel build time, add 115.Cd options PCKBD_LAYOUT="(KB_DE | KB_NODEAD | KB_METAESC)" 116to the kernel configuration file. 117.Sh BUGS 118The list of builtin mappings doesn't follow any logics. 119It grew as people submitted what they needed. 120.Sh SEE ALSO 121.Xr isa 4 , 122.Xr wskbd 4 , 123.Xr wsconsctl 8 , 124.Xr pcppi 4 125