kbd.4 revision 1.2.2.1 $NetBSD: kbd.4,v 1.2.2.1 1997/11/26 04:17:03 mellon Exp $ Copyright (c) 1996 The NetBSD Foundation, Inc. All rights reserved. This code is derived from software contributed to The NetBSD Foundation by Paul Kranenburg. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. All advertising materials mentioning features or use of this software must display the following acknowledgement: This product includes software developed by the NetBSD Foundation, Inc. and its contributors. 4. Neither the name of The NetBSD Foundation nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE..Dd June 22, 1996
.Dt KBD 4 sparc
.Os
.Sh NAME
.Nm kbd
.Nd workstation keyboard
.Sh SYNOPSIS
.Cd "pseudo-device kbd"
.Sh DESCRIPTION
The
.Nm
driver provides an interface to the workstation console keyboard.
.Dq type 2 ,
.Dq type 3 ,
and
.Dq type 4
keyboards are supported. All types generate keycodes encoding the
key identity and motion (up or down) as the keys are pressed and released.
The
.Nm
driver either passes the keycodes to an application as they come in, or
translates them into ASCII characters first according to a set of built-in
tables.
If the keyboard is configured as the device
to be used for system console input
q see Xr openprom 4 ,
it will be internally connected to the
a /dev/console
device special file, which can be used as a
.Xr tty 4
device.
The device special file
a /dev/kbd
is used to get direct access to the keyboard input stream. The following
ioctl's are supported (mostly just enough to keep the X11 server going):
l -tag -width KIOCSDIRECT t KIOCTRANS Set translation mode. The argument is of type
.Fa "int *" ,
the only value supported is
.Dv TR_UNTRANS_EVENT .
t KIOCGTRANS Get translation mode. The argument is of type
.Fa "int *" .
.Dv TR_UNTRANS_EVENT
is always returned.
t KIOCGETKEY Fill in old-style key station translation. The argument is of type
.Fa "struct okiockey *" .
t KIOCCMD Send a command to the keyboard. The argument is of type
.Fa "int *" ,
and can have one of the following values:
l -tag -width KBD_CMD_NOCLICK t KBD_CMD_BELL Start the keyboard beeper.
t KBD_CMD_NOBELL Stop the keyboard beeper.
t KBD_CMD_CLICK Instruct the keyboard to make extra noise when touching keys.
t KBD_CMD_NOCLICK Instruct the keyboard to.. oh well..
.El
t KIOCTYPE Get keyboard type. The argument is of type
.Fa "int *" ,
in which one of the values
.Dv KB_SUN2 ,
.Dv KB_SUN3
or
.Dv KB_SUN4
will be returned.
t KIOCSDIRECT Route the keyboard input stream through the (SunOS) compatible event module.
The argument is of type
.Fa "int *" ,
a non-zero value will put the driver into
.Dq event
mode, while a value of zero will make it return to
.Dq ASCII translation
mode.
t KIOCSKEY Set key station translation. The argument is of type
.Fa "struct kiockey *"
q see Pa /usr/include/machine/kbio.h No for more details .
t KIOCGKEY Get key station translation. The argument is of type
.Fa "struct kiockey *" .
t KIOCLAYOUT Get keyboard layout
q Do type 4 Dc only .
The argument is of type
.Fa "int *" ,
in which the uninterpreted result of the
.Dv KBD_CMD_GLAYOUT
keyboard command is returned
o on Dv KBDUN4
type keyboards this will be the setting of a DIP switch bank
c .
t KIOCSLED Set LED state
q Do type 4 Dc only .
The argument is of type
.Fa "char *" ,
and is the inclusive OR of the following flags:
p
l -tag -width LED_SCROLL_LOCK -compact t LED_NUM_LOCK t LED_COMPOSE t LED_SCROLL_LOCK t LED_CAPS_LOCK .El
p
Each of these flags turn on the LED in the obvious key.
t KIOCGLED Get LED state
q Do type 4 Dc only .
The argument is of type
.Fa "char *" ,
in which the current LED state is returned.
.El
.Sh SEE ALSO
.Xr ms 4
.Sh BUGS
.Nm
is hardwired to the built-in
.Em zs1
serial port.