share/man/man4/akbd.4

   1 .\"     $NetBSD$
   2 .\"
   3 .\" Copyright (c) 2003 Alex Zepeda <zipzippy@sonic.net>
   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.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\" 3. All advertising materials mentioning features or use of this software
  15 .\"    must display the following acknowledgement:
  16 .\"      This product includes software developed by Alex Zepeda.
  17 .\" 4. The name of the author may not be used to endorse or promote products
  18 .\"    derived from this software without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  21 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  22 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  23 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  24 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  25 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  26 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  27 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  28 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  29 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  30 .\"
  31 .Dd September 21, 2003
  32 .Dt AKBD 4
  33 .Os
  34 .Sh NAME
  35 .Nm akbd
  36 .Nd Apple Desktop Bus keyboard driver for wscons
  37 .Sh SYNOPSIS
  38 .Cd "akbd* at obio?"
  39 .Cd "wskbd* at akbd? console ?"
  40 .Pp
  41 .Cd "options ALTXBUTTONS"
  42 .Cd "options CAPS_IS_CONTROL"
  43 .Cd "options FORCE_FUNCTION_KEYS"
  44 .Sh DESCRIPTION
  45 This driver provides the
  46 .Xr wscons 4
  47 driver with support for Apple Desktop Bus keyboards.
  48 .Pp
  49 To work around the limited number of buttons found on most ADB mice,
  50 one can map key sequences to trigger mouse button events.
  51 To map Option+1, Option+2, Option+3 to mouse buttons 1, 2, and 3
  52 respectively, add the following line to your kernel configuration
  53 file:
  54 .Pp
  55 .Cd "options ALTXBUTTONS"
  56 .Pp
  57 On macppc systems it is possible to tweak the keyboard driver
  58 to treat the caps lock key on an ADB keyboard as a control key.
  59 This requires special remapping because of ADB's strange emulation of
  60 a mechanically-locked key.  To enable this code add the following
  61 line to your kernel configuration file:
  62 .Pp
  63 .Cd options CAPS_IS_CONTROL
  64 .Pp
  65 On macppc PowerBooks, several function keys double as "hot keys"
  66 (brightness, volume, eject) when the Fn modifier is held down.
  67 Mac OS X likes to reprogram the keyboard controller to send hot key
  68 events when Fn is not held down and send function key events when it
  69 is.
  70 To transform the non-keyboard "button" events back into function key
  71 events, place the following line in your kernel configuration file:
  72 .Pp
  73 .Cd options FORCE_FUNCTION_KEYS
  74 .Sh SUPPORTED HARDWARE
  75 .Nx
  76 is known to support the following
  77 .Tn ADB
  78 keyboards:
  79 .Bl -bullet -offset indent
  80 .It
  81 On-board keyboards on PowerBook models
  82 .It
  83 Apple Standard Keyboard
  84 .It
  85 Apple Keyboard II
  86 .It
  87 Apple Extended Keyboard
  88 .It
  89 Apple Extended Keyboard II
  90 .It
  91 Apple Adjustable Keyboard
  92 .It
  93 Most third-party ADB keyboards are supported
  94 .El
  95 .Sh SEE ALSO
  96 .Xr adb 4 ,
  97 .Xr wscons 4 ,
  98 .Xr wskbd 4 ,
  99 .Xr wsconsctl 8
 100 .Sh BUGS
 101 The number pad on extended keyboards does not send out the proper
 102 key codes for many applications.
 103 .Pp
 104 The LEDs on extended keyboards are not functional under
 105 .Nx .