summaryrefslogtreecommitdiff
path: root/share/man/man4/man4.mac68k/adb.4
diff options
context:
space:
mode:
Diffstat (limited to 'share/man/man4/man4.mac68k/adb.4')
-rw-r--r--share/man/man4/man4.mac68k/adb.4216
1 files changed, 7 insertions, 209 deletions
diff --git a/share/man/man4/man4.mac68k/adb.4 b/share/man/man4/man4.mac68k/adb.4
index 184daf6b4d5..1347f97dd31 100644
--- a/share/man/man4/man4.mac68k/adb.4
+++ b/share/man/man4/man4.mac68k/adb.4
@@ -28,19 +28,19 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.\" $OpenBSD: adb.4,v 1.9 2004/03/20 22:13:48 miod Exp $
+.\" $OpenBSD: adb.4,v 1.10 2006/01/10 07:37:31 miod Exp $
.\" $NetBSD: adb.4,v 1.1 1997/07/18 02:13:42 ender Exp $
.\"
-.Dd July 17, 1997
+.Dd January 10, 2006
.Dt ADB 4 mac68k
.Os
.Sh NAME
.Nm adb
-.Nd Apple Desktop Bus event interface
+.Nd Apple Desktop Bus driver
.Sh SYNOPSIS
.Cd "adb0 at obio?"
-.Cd "#option MRG_ADB" Pq "use ROM-based ADB driver"
-.Fd #include <machine/adbsys.h>
+.Cd "akbd* at adb?"
+.Cd "ams* at adb?"
.Sh DESCRIPTION
The Apple Desktop Bus
.Pq Tn ADB
@@ -48,202 +48,9 @@ is the single-master, multiple-slave, low-speed serial bus
interface used by Macintosh computers to connect input devices
such as keyboards, mice, trackballs, and graphics tablets
to the machine.
-.Pp
-The
-.Nm
-device is the sole interface to user input.
-It combines both keyboard and mouse drivers into one event driver.
-All user input is obtained by doing a
-.Xr read 2
-on the
-.Nm
-device.
-Since most Macintosh mice have only one button, the
-.Nm
-driver will emulate a second and third mouse button with
-the keyboard.
-The
-.Nm
-device only supports being opened by one process at a time.
-.Pp
-There are two interfaces to the
-.Tn ADB
-hardware supported by the
-.Nm
-driver.
-The older of the two relies on information in the Macintosh
-.Tn ROM
-to interface with the hardware.
-This method is only available if the
-.Dv MRG_ADB
-option is defined in the kernel configuration file.
-The newer method interfaces directly with the
-.Tn VIA
-hardware and with the Power Manager hardware if it is
-present
-.Pq e.g. on the PowerBooks .
-The default configuration currently uses the
-Macintosh
-.Tn ROM
-Glue
-.Pq Tn MRG
-method.
-.Pp
-The
-.Xr ioctl 2
-call is used to control the
-.Tn ADB
-event device.
-The following is a list of available
-.Xr ioctl 2
-commands:
-.Bl -tag -width ADBIOC_GETREPEAT
-.It Dv ADBIOC_DEVSINFO
-Get
-.Tn ADB
-Device Info
-.Pp
-The
-.Nm
-event device will return an array of information containing an entry
-for each device connected to the bus.
-Each entry contains the current address, default address, and handler ID for
-the corresponding
-.Tn ADB
-device.
-.It Dv ADBIOC_GETREPEAT
-Get Keyboard Repeat Info
-.Pp
-Returns a structure containing the current keyboard repeat delay
-and keyboard repeat interval.
-.It Dv ADBIOC_SETREPEAT
-Set Keyboard Repeat Rate
-.Pp
-Sets the keyboard repeat delay and interval to the values specified
-by
-.Ar argp .
-.It Dv ADBIOC_RESET
-.Tn ADB
-Reset
-.Pp
-Perform a reset of the
-.Tn ADB
-which will reinitialize all of the devices attached to the bus.
-.It Dv ADBIOC_LISTENCMD
-ADB Listen Command
-.Pp
-Send data to the register of the
-.Tn ADB
-device specified by
-.Ar argp .
-This command is not fully implemented at this time.
-.El
-.Sh HARDWARE
-The
-.Nm
-device supports the ADB hardware of most m68k-based
-Macintosh models,
-including the II-series, Centris- and Quadra-series, PowerBook-
-and Duo-series, LC-series, and Performa-series models.
-.Pp
-Most standard
-.Tn ADB
-devices are supported by the
-.Nm
-driver, including mice which follow Apple's
-Extended Mouse Protocol.
-Many multi-button mice which follow a proprietary protocol are
-not currently supported in multi-button mode.
-The following is a partial list of supported
-.Tn ADB
-devices:
-.Bd -filled -offset indent
-.Bl -item -compact
-.It
-Apple Standard Keyboard
-.It
-Apple Extended Keyboard
-.It
-Apple Adjustable Keyboard
-.It
-Apple Desktop Bus Mouse
-.It
-Logitech TrackMan
-.It
-Logitech MouseMan
-.It
-Microspeed Mouse Deluxe
-.It
-Mouse Systems A3 Mouse
-.El
-.Ed
-.Sh FILES
-.Bl -tag -width /dev/adb -compact
-.It Pa /dev/adb
-The
-.Tn ADB
-event device.
-.El
-.Sh DIAGNOSTICS
-.Bl -diag -compact
-.It adb0 at obio0 (ADB event device).
-This is a normal autoconfiguration message noting the presence of the
-.Nm
-event device.
-.It adb: bus subsystem.
-A standard autoconfiguration message indicating the initialization
-of the
-.Tn ADB
-subsystem.
-.It adb: no devices found.
-No
-.Tn ADB
-devices were found to be connected to the bus during autoconfiguration.
-.It adb: using %s series hardware support.
-Indicates the class of
-.Tn ADB
-hardware support the machine uses.
-.It adb: hardware type unknown for this machine.
-The
-.Tn ADB
-hardware in this machine is currently unsupported.
-.It "adb: no ROM ADB driver in this kernel for this machine."
-The kernel lacks the necessary Macintosh ROM Glue
-.Pq Tn MRG
-support for accessing the
-.Tn ADB
-hardware on this machine.
-.It adb: using serial console.
-A serial console will be used for user input rather than the
-.Tn ADB
-event device.
-.It adb: %s at %d.
-An
-.Tn ADB
-device of the type specified by
-.Em %s
-has been found at location
-.Em %d .
-.El
-.Sh ERRORS
-.Bl -tag -width Er
-.It Bq Er ENXIO
-No such
-.Tn ADB
-event device.
-.It Bq Er EBUSY
-Another process has the device open.
-.It Bq Er EINVAL
-Invalid
-.Xr ioctl 2
-specification.
-.It Bq Er EMSGSIZE
-The size of the
-.Tn ADB
-event being read is too large to fit into the buffer
-allocated to it.
-.El
.Sh SEE ALSO
+.Xr akbd 4 ,
+.Xr ams 4 ,
.Xr intro 4
.Sh HISTORY
The
@@ -269,13 +76,4 @@ hardware is supported yet.
The talk command is currently unimplemented.
.It
The listen command is not implemented yet.
-.It
-Not all multi-button mice are currently supported.
-.It
-Only mapped and relative-position
-.Tn ADB
-devices
-.Pq i.e. keyboards and mice
-are supported.
-Thus absolute-position and other exotic devices will not work.
.El