1.\" 2.\" Copyright (c) 1999 3.\" Kazutaka YOKOTA <yokota@zodiac.mech.utsunomiya-u.ac.jp> 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer as 11.\" the first lines of this file unmodified. 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.Dd February 9, 1999 28.Dt ATKBDC 4 29.Os 30.Sh NAME 31.Nm atkbdc 32.Nd the AT keyboard controller interface 33.Sh SYNOPSIS 34.Cd "options KBD_RESETDELAY=N" 35.Cd "options KBD_MAXWAIT=N" 36.Cd "options KBDIO_DEBUG=N" 37.Cd "device atkbdc" 38.Pp 39In 40.Pa /boot/device.hints : 41.Cd hint.atkbdc.0.at="isa" 42.Cd hint.atkbdc.0.port="0x060" 43.Sh DESCRIPTION 44The keyboard controller 45.Nm 46provides I/O services for the AT keyboard and PS/2 mouse style 47pointing devices. 48This controller is required for the keyboard driver 49.Nm atkbd 50and the PS/2 pointing device driver 51.Nm psm . 52.Pp 53There can be only one 54.Nm 55device configured in the system. 56.Sh DRIVER CONFIGURATION 57.Ss Kernel Configuration Options 58The following kernel configuration options can be used to control the 59.Nm 60driver. 61They may be set in the kernel configuration file 62(see 63.Xr config 8 ) . 64.Bl -tag -width MOUSE 65.It Em KBD_RESETDELAY=X , KBD_MAXWAIT=Y 66The keyboard driver 67.Nm atkbd 68and the pointing device driver 69.Nm psm 70may ask the 71.Nm 72driver to reset these devices during the boot process. 73It sometimes takes a long time before these devices respond to 74the reset command. 75These options control how long the 76.Nm 77driver should 78wait before eventually giving up -- the driver will wait 79.Fa X 80* 81.Fa Y 82msecs at most. 83If the drivers seem unable to detect 84devices, you may want to increase these values. 85The default values are 86200 msec for 87.Fa X 88and 5 89for 90.Fa Y . 91.It Em KBDIO_DEBUG=N 92Sets the debug level to 93.Fa N . 94The default value is zero, which suppresses all debugging output. 95.El 96.\".Ss Driver Flags 97.\".Sh FILES 98.\".Sh EXAMPLE 99.\".Sh DIAGNOSTICS 100.\".Sh CAVEATS 101.\".Sh BUGS 102.Sh SEE ALSO 103.Xr atkbd 4 , 104.Xr psm 4 , 105.Xr config 8 106.Sh HISTORY 107The 108.Nm 109driver first appeared in 110.Fx 3.1 . 111It is based on the kbdio module in 112.Fx 2.2 . 113.Sh AUTHORS 114The kbdio module, the 115.Nm 116driver and this manual page were written by 117.An Kazutaka Yokota Aq Mt yokota@FreeBSD.org . 118