1.\" $NetBSD: hilkbd.4,v 1.1 2011/02/09 15:12:41 tsutsui Exp $ 2.\" $OpenBSD: hilkbd.4,v 1.13 2011/01/30 07:53:57 jmc Exp $ 3.\" 4.\" Copyright (c) 2003 Miodrag Vallat. 5.\" All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistribution of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in the 14.\" documentation and/or other materials provided with the distribution. 15.\" 16.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 17.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 18.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 19.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 20.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 21.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 22.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 23.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 24.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 25.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26.\" 27.\" 28.Dd February 9, 2011 29.Dt HILKBD 4 30.Os 31.Sh NAME 32.Nm hilkbd 33.Nd HIL keyboard device 34.Sh SYNOPSIS 35.Cd "hilkbd* at hil?" 36.Cd "wskbd* at hilkbd?" 37.Pp 38.Cd "option HILKBD_LAYOUT=XXX" 39.Sh DESCRIPTION 40This driver supports HIL keyboards within the 41.Xr wscons 4 42framework. 43It doesn't provide direct device driver entry points, but makes its 44functions available through the internal 45.Xr wskbd 4 46interface. 47.Pp 48The 49.Nm 50driver supports a number of different key mappings. 51By default, the layout corresponding to the keyboard model as probed 52by the 53.Nm 54driver will be used. 55A different layout can be chosen either with the kernel option 56.Dq HILKBD_LAYOUT 57at compile time, or with the 58.Xr wsconsctl 8 59utility (variable: 60.Dq keyboard.encoding ) 61at runtime. 62.Pp 63The supported key mappings are at this time: 64.Pp 65.Bl -tag -width Ds -offset indent -compact 66.It KB_DE 67.Pq de 68German with 69.Dq dead accents . 70.It KB_FR 71.Pq fr 72French with 73.Dq dead accents . 74.It KB_SV 75.Pq sv 76Swedish. 77.It KB_UK 78.Pq uk 79British. 80.It KB_US 81.Pq us 82English/US keyboard mapping. 83.El 84.Pp 85The KB_DE mapping can be used in the KB_NODEAD 86.Pq .nodead 87variant. 88This switches off the 89.Dq dead accents . 90.Sh EXAMPLES 91To set a Swedish keyboard mapping, use 92.Ic wsconsctl keyboard.encoding=sv . 93To set it at kernel build time, regardless of what keyboard is plugged, add 94the following to the kernel configuration file: 95.Bd -literal -offset indent 96option HILKBD_LAYOUT="KB_SV" 97.Ed 98.Sh SEE ALSO 99.Xr hil 4 , 100.Xr intro 4 , 101.Xr wskbd 4 , 102.Xr wsconsctl 8 103.Sh BUGS 104The list of built-in mappings is incomplete and has grown as people submitted 105information about their particular layout. 106.Pp 107The Swedish and British layout have been reconstructed from tables in the old 108HIL code present in the hp300 port, and have not been tested. 109