- pull MI HIL device man pages from OpenBSD
- remove obsolete hp300 ite, grf, and hil devices
This commit is contained in:
tsutsui
parent
bde889cccb
commit
d57520da96
@ -1,4 +1,4 @@
|
||||
# $NetBSD: mi,v 1.1285 2011/02/08 03:20:14 haad Exp $
|
||||
# $NetBSD: mi,v 1.1286 2011/02/09 15:12:40 tsutsui Exp $
|
||||
#
|
||||
# Note: don't delete entries from here - mark them as "obsolete" instead.
|
||||
#
|
||||
@ -1004,6 +1004,10 @@
|
||||
./usr/share/man/cat4/hdaudio.0 man-sys-catman .cat
|
||||
./usr/share/man/cat4/hdaudiobus.0 man-sys-catman .cat
|
||||
./usr/share/man/cat4/hifn.0 man-sys-catman .cat
|
||||
./usr/share/man/cat4/hil.0 man-sys-catman .cat
|
||||
./usr/share/man/cat4/hilkbd.0 man-sys-catman .cat
|
||||
./usr/share/man/cat4/hilid.0 man-sys-catman .cat
|
||||
./usr/share/man/cat4/hilms.0 man-sys-catman .cat
|
||||
./usr/share/man/cat4/hme.0 man-sys-catman .cat
|
||||
./usr/share/man/cat4/hp300/apci.0 man-obsolete obsolete
|
||||
./usr/share/man/cat4/hp300/autoconf.0 man-sys-catman .cat
|
||||
@ -1020,14 +1024,14 @@
|
||||
./usr/share/man/cat4/hp300/frodo.0 man-sys-catman .cat
|
||||
./usr/share/man/cat4/hp300/gb.0 man-obsolete obsolete
|
||||
./usr/share/man/cat4/hp300/gbox.0 man-sys-catman .cat
|
||||
./usr/share/man/cat4/hp300/grf.0 man-sys-catman .cat
|
||||
./usr/share/man/cat4/hp300/hil.0 man-sys-catman .cat
|
||||
./usr/share/man/cat4/hp300/grf.0 man-obsolete obsolete
|
||||
./usr/share/man/cat4/hp300/hil.0 man-obsolete obsolete
|
||||
./usr/share/man/cat4/hp300/hpib.0 man-sys-catman .cat
|
||||
./usr/share/man/cat4/hp300/hpibbus.0 man-sys-catman .cat
|
||||
./usr/share/man/cat4/hp300/hyper.0 man-sys-catman .cat
|
||||
./usr/share/man/cat4/hp300/intio.0 man-sys-catman .cat
|
||||
./usr/share/man/cat4/hp300/intro.0 man-sys-catman .cat
|
||||
./usr/share/man/cat4/hp300/ite.0 man-sys-catman .cat
|
||||
./usr/share/man/cat4/hp300/ite.0 man-obsolete obsolete
|
||||
./usr/share/man/cat4/hp300/kmem.0 man-sys-catman .cat
|
||||
./usr/share/man/cat4/hp300/le.0 man-obsolete obsolete
|
||||
./usr/share/man/cat4/hp300/mem.0 man-sys-catman .cat
|
||||
@ -3759,6 +3763,10 @@
|
||||
./usr/share/man/html4/hdaudiobus.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hdaudio.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hifn.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hil.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hilkbd.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hilid.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hilms.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hme.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hp300/autoconf.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hp300/cons.html man-sys-htmlman html
|
||||
@ -3770,14 +3778,14 @@
|
||||
./usr/share/man/html4/hp300/fhpib.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hp300/frodo.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hp300/gbox.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hp300/grf.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hp300/hil.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hp300/grf.html man-obsolete obsolete
|
||||
./usr/share/man/html4/hp300/hil.html man-obsolete obsolete
|
||||
./usr/share/man/html4/hp300/hpib.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hp300/hpibbus.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hp300/hyper.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hp300/intio.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hp300/intro.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hp300/ite.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hp300/ite.html man-obsolete obsolete
|
||||
./usr/share/man/html4/hp300/kmem.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hp300/mem.html man-sys-htmlman html
|
||||
./usr/share/man/html4/hp300/nhpib.html man-sys-htmlman html
|
||||
@ -6291,6 +6299,10 @@
|
||||
./usr/share/man/man4/hdaudio.4 man-sys-man .man
|
||||
./usr/share/man/man4/hdaudiobus.4 man-sys-man .man
|
||||
./usr/share/man/man4/hifn.4 man-sys-man .man
|
||||
./usr/share/man/man4/hil.4 man-sys-man .man
|
||||
./usr/share/man/man4/hilkbd.4 man-sys-man .man
|
||||
./usr/share/man/man4/hilid.4 man-sys-man .man
|
||||
./usr/share/man/man4/hilms.4 man-sys-man .man
|
||||
./usr/share/man/man4/hme.4 man-sys-man .man
|
||||
./usr/share/man/man4/hp300/apci.4 man-obsolete obsolete
|
||||
./usr/share/man/man4/hp300/autoconf.4 man-sys-man .man
|
||||
@ -6307,14 +6319,14 @@
|
||||
./usr/share/man/man4/hp300/frodo.4 man-sys-man .man
|
||||
./usr/share/man/man4/hp300/gb.4 man-obsolete obsolete
|
||||
./usr/share/man/man4/hp300/gbox.4 man-sys-man .man
|
||||
./usr/share/man/man4/hp300/grf.4 man-sys-man .man
|
||||
./usr/share/man/man4/hp300/hil.4 man-sys-man .man
|
||||
./usr/share/man/man4/hp300/grf.4 man-obsolete obsolete
|
||||
./usr/share/man/man4/hp300/hil.4 man-obsolete obsolete
|
||||
./usr/share/man/man4/hp300/hpib.4 man-sys-man .man
|
||||
./usr/share/man/man4/hp300/hpibbus.4 man-sys-man .man
|
||||
./usr/share/man/man4/hp300/hyper.4 man-sys-man .man
|
||||
./usr/share/man/man4/hp300/intio.4 man-sys-man .man
|
||||
./usr/share/man/man4/hp300/intro.4 man-sys-man .man
|
||||
./usr/share/man/man4/hp300/ite.4 man-sys-man .man
|
||||
./usr/share/man/man4/hp300/ite.4 man-obsolete obsolete
|
||||
./usr/share/man/man4/hp300/kmem.4 man-sys-man .man
|
||||
./usr/share/man/man4/hp300/le.4 man-obsolete obsolete
|
||||
./usr/share/man/man4/hp300/mem.4 man-sys-man .man
|
||||
|
||||
84
share/man/man4/hil.4
Normal file
84
share/man/man4/hil.4
Normal file
@ -0,0 +1,84 @@
|
||||
.\" $NetBSD: hil.4,v 1.1 2011/02/09 15:12:41 tsutsui Exp $
|
||||
.\" $OpenBSD: hil.4,v 1.10 2007/05/31 19:19:50 jmc Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 2003 Miodrag Vallat.
|
||||
.\" All rights reserved.
|
||||
.\"
|
||||
.\" Redistribution and use in source and binary forms, with or without
|
||||
.\" modification, are permitted provided that the following conditions
|
||||
.\" are met:
|
||||
.\" 1. Redistribution 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.
|
||||
.\"
|
||||
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR 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 February 9, 2011
|
||||
.Dt HIL 4
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm hil
|
||||
.Nd introduction to HP-HIL support
|
||||
.Sh SYNOPSIS
|
||||
.Ss hp300
|
||||
.Cd "hil* at intio?"
|
||||
.\".Ss hp700
|
||||
.\".Cd "hil* at gsc? irq 1"
|
||||
.Pp
|
||||
.Cd "hilkbd* at hil?"
|
||||
.Cd "hilms* at hil?"
|
||||
.Cd "hilid* at hil?"
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Nm
|
||||
interface provides access to the
|
||||
.Dq Human Interface Loop
|
||||
controller found on many
|
||||
.Tn HP
|
||||
workstations.
|
||||
.Pp
|
||||
It provides generic HIL management and interfaces for child devices,
|
||||
such as keyboards, button boxes, mice, graphics tablet, and ID modules.
|
||||
.\".Pp
|
||||
.\"hil devices:
|
||||
.\"HP 45911A HP-HIL Graphics Tablet
|
||||
.\"HP 46020A HP-HIL Keyboard
|
||||
.\"HP 46021A HP-HIL Keyboard
|
||||
.\"HP 46060A HP-HIL Mouse
|
||||
.\"HP 46060B HP-HIL 3-Button Mouse
|
||||
.\"HP 46083A HP-HIL Knob
|
||||
.\"HP 46085A HP-HIL Control Dial Module
|
||||
.\"HP 46086A HP-HIL 32-Button Box
|
||||
.\"HP 46087A HP-HIL A-Size Digitizer
|
||||
.\"HP 46088A HP-HIL B-Size Digitizer
|
||||
.\"HP 46089A HP-HIL 4-Button Cursor for the HP 46087/88A Tablets
|
||||
.\"HP 46094A HP-HIL Quadrature Box
|
||||
.\"HP 46095A HP-HIL Quadrature 3-Button Mouse
|
||||
.\"HP 80409A HP-HIL 3-Button Track Ball
|
||||
.Pp
|
||||
.Nx
|
||||
provides support for the following devices:
|
||||
.Pp
|
||||
.Bl -tag -width "hilkbd(4)XX" -offset 3n -compact
|
||||
.It Xr hilid 4
|
||||
HIL ID module device
|
||||
.It Xr hilkbd 4
|
||||
HIL keyboard device
|
||||
.It Xr hilms 4
|
||||
HIL mouse and graphics tablet device
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.\".Xr gsc 4 ,
|
||||
.Xr intro 4
|
||||
47
share/man/man4/hilid.4
Normal file
47
share/man/man4/hilid.4
Normal file
@ -0,0 +1,47 @@
|
||||
.\" $NetBSD: hilid.4,v 1.1 2011/02/09 15:12:41 tsutsui Exp $
|
||||
.\" $OpenBSD: hilid.4,v 1.5 2007/05/31 19:19:50 jmc Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 2003 Miodrag Vallat.
|
||||
.\" All rights reserved.
|
||||
.\"
|
||||
.\" Redistribution and use in source and binary forms, with or without
|
||||
.\" modification, are permitted provided that the following conditions
|
||||
.\" are met:
|
||||
.\" 1. Redistribution 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.
|
||||
.\"
|
||||
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR 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 February 9, 2011
|
||||
.Dt HILID 4
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm hilid
|
||||
.Nd HIL ID module device
|
||||
.Sh SYNOPSIS
|
||||
.Cd "hilid* at hil?"
|
||||
.Sh DESCRIPTION
|
||||
This driver recognizes the HIL
|
||||
.Dq ID module
|
||||
device.
|
||||
The only purpose of this device is to provide a small, unique,
|
||||
bitstring.
|
||||
.Sh SEE ALSO
|
||||
.Xr hil 4 ,
|
||||
.Xr intro 4
|
||||
.Sh BUGS
|
||||
There is currently no way to communicate the ID module bitstring to
|
||||
userland applications.
|
||||
108
share/man/man4/hilkbd.4
Normal file
108
share/man/man4/hilkbd.4
Normal file
@ -0,0 +1,108 @@
|
||||
.\" $NetBSD: hilkbd.4,v 1.1 2011/02/09 15:12:41 tsutsui Exp $
|
||||
.\" $OpenBSD: hilkbd.4,v 1.13 2011/01/30 07:53:57 jmc Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 2003 Miodrag Vallat.
|
||||
.\" All rights reserved.
|
||||
.\"
|
||||
.\" Redistribution and use in source and binary forms, with or without
|
||||
.\" modification, are permitted provided that the following conditions
|
||||
.\" are met:
|
||||
.\" 1. Redistribution 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.
|
||||
.\"
|
||||
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR 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 February 9, 2011
|
||||
.Dt HILKBD 4
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm hilkbd
|
||||
.Nd HIL keyboard device
|
||||
.Sh SYNOPSIS
|
||||
.Cd "hilkbd* at hil?"
|
||||
.Cd "wskbd* at hilkbd?"
|
||||
.Pp
|
||||
.Cd "option HILKBD_LAYOUT=XXX"
|
||||
.Sh DESCRIPTION
|
||||
This driver supports HIL keyboards within the
|
||||
.Xr wscons 4
|
||||
framework.
|
||||
It doesn't provide direct device driver entry points, but makes its
|
||||
functions available through the internal
|
||||
.Xr wskbd 4
|
||||
interface.
|
||||
.Pp
|
||||
The
|
||||
.Nm
|
||||
driver supports a number of different key mappings.
|
||||
By default, the layout corresponding to the keyboard model as probed
|
||||
by the
|
||||
.Nm
|
||||
driver will be used.
|
||||
A different layout can be chosen either with the kernel option
|
||||
.Dq HILKBD_LAYOUT
|
||||
at compile time, or with the
|
||||
.Xr wsconsctl 8
|
||||
utility (variable:
|
||||
.Dq keyboard.encoding )
|
||||
at runtime.
|
||||
.Pp
|
||||
The supported key mappings are at this time:
|
||||
.Pp
|
||||
.Bl -tag -width Ds -offset indent -compact
|
||||
.It KB_DE
|
||||
.Pq de
|
||||
German with
|
||||
.Dq dead accents .
|
||||
.It KB_FR
|
||||
.Pq fr
|
||||
French with
|
||||
.Dq dead accents .
|
||||
.It KB_SV
|
||||
.Pq sv
|
||||
Swedish.
|
||||
.It KB_UK
|
||||
.Pq uk
|
||||
British.
|
||||
.It KB_US
|
||||
.Pq us
|
||||
English/US keyboard mapping.
|
||||
.El
|
||||
.Pp
|
||||
The KB_DE mapping can be used in the KB_NODEAD
|
||||
.Pq .nodead
|
||||
variant.
|
||||
This switches off the
|
||||
.Dq dead accents .
|
||||
.Sh EXAMPLES
|
||||
To set a Swedish keyboard mapping, use
|
||||
.Ic wsconsctl keyboard.encoding=sv .
|
||||
To set it at kernel build time, regardless of what keyboard is plugged, add
|
||||
the following to the kernel configuration file:
|
||||
.Bd -literal -offset indent
|
||||
option HILKBD_LAYOUT="KB_SV"
|
||||
.Ed
|
||||
.Sh SEE ALSO
|
||||
.Xr hil 4 ,
|
||||
.Xr intro 4 ,
|
||||
.Xr wskbd 4 ,
|
||||
.Xr wsconsctl 8
|
||||
.Sh BUGS
|
||||
The list of built-in mappings is incomplete and has grown as people submitted
|
||||
information about their particular layout.
|
||||
.Pp
|
||||
The Swedish and British layout have been reconstructed from tables in the old
|
||||
HIL code present in the hp300 port, and have not been tested.
|
||||
48
share/man/man4/hilms.4
Normal file
48
share/man/man4/hilms.4
Normal file
@ -0,0 +1,48 @@
|
||||
.\" $NetBSD: hilms.4,v 1.1 2011/02/09 15:12:41 tsutsui Exp $
|
||||
.\" $OpenBSD: hilms.4,v 1.7 2007/05/31 19:19:50 jmc Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 2003 Miodrag Vallat.
|
||||
.\" All rights reserved.
|
||||
.\"
|
||||
.\" Redistribution and use in source and binary forms, with or without
|
||||
.\" modification, are permitted provided that the following conditions
|
||||
.\" are met:
|
||||
.\" 1. Redistribution 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.
|
||||
.\"
|
||||
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR 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 February 9, 2011
|
||||
.Dt HILMS 4
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm hilms
|
||||
.Nd HIL mouse and graphics tablet device
|
||||
.Sh SYNOPSIS
|
||||
.Cd "hilms* at hil?"
|
||||
.Cd "wsmouse* at hilms? mux 0"
|
||||
.Sh DESCRIPTION
|
||||
This driver supports HIL mice and graphics tablet within the
|
||||
.Xr wscons 4
|
||||
framework.
|
||||
It doesn't provide direct device driver entry points, but makes its
|
||||
functions available through the internal
|
||||
.Xr wsmouse 4
|
||||
interface.
|
||||
.Sh SEE ALSO
|
||||
.Xr hil 4 ,
|
||||
.Xr intro 4 ,
|
||||
.Xr wsmouse 4
|
||||
@ -1,9 +1,9 @@
|
||||
# $NetBSD: Makefile,v 1.14 2003/11/24 22:47:37 wiz Exp $
|
||||
# $NetBSD: Makefile,v 1.15 2011/02/09 15:12:41 tsutsui Exp $
|
||||
# from: @(#)Makefile 8.1 (Berkeley) 6/18/93
|
||||
|
||||
MAN= autoconf.4 cons.4 ct.4 dio.4 dcm.4 dnkbd.4 \
|
||||
dvbox.4 frodo.4 \
|
||||
gbox.4 grf.4 hpib.4 hil.4 hyper.4 intro.4 intio.4 ite.4 mem.4 \
|
||||
gbox.4 hpib.4 hyper.4 intro.4 intio.4 mem.4 \
|
||||
ppi.4 rbox.4 rd.4 rmp.4 rtc.4 topcat.4
|
||||
|
||||
#MAN+= dcl.4
|
||||
|
||||
@ -1,214 +0,0 @@
|
||||
.\" $NetBSD: grf.4,v 1.9 2003/08/07 10:31:06 agc Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1990, 1991, 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
.\"
|
||||
.\" This code is derived from software contributed to Berkeley by
|
||||
.\" the Systems Programming Group of the University of Utah Computer
|
||||
.\" Science Department.
|
||||
.\"
|
||||
.\" 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. Neither the name of the University 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 REGENTS 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 REGENTS 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.
|
||||
.\"
|
||||
.\" from: @(#)grf.4 8.1 (Berkeley) 6/9/93
|
||||
.\"
|
||||
.Dd September 10, 2001
|
||||
.Dt GRF 4 hp300
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm grf
|
||||
.Nd
|
||||
.Tn HP
|
||||
graphics frame buffer device interface
|
||||
.Sh SYNOPSIS
|
||||
.Cd "grf* at dvbox?"
|
||||
.Cd "grf* at gbox?"
|
||||
.Cd "grf* at hyper?"
|
||||
.Cd "grf* at rbox?"
|
||||
.Cd "grf* at topcat?"
|
||||
.Sh DESCRIPTION
|
||||
This is a generic description of the frame buffer device interface.
|
||||
The devices to which this applies are the 98544, 98545 and 98547
|
||||
Topcat display cards (also known as
|
||||
.Tn HP300H
|
||||
devices),
|
||||
the 98548, 98549 and 98550
|
||||
Catseye display cards,
|
||||
the 98700
|
||||
Gatorbox graphics box,
|
||||
the 98720
|
||||
Renaissance graphics box,
|
||||
and the 98730
|
||||
DaVinci graphics box.
|
||||
.Pp
|
||||
Use of the devices can be effectively approached from two directions.
|
||||
The first is through
|
||||
.Tn HP-UX
|
||||
.Em Starbase
|
||||
routines, the second is by direct control in the
|
||||
.Bx
|
||||
environment.
|
||||
In order to use the Starbase libraries,
|
||||
code must be compiled in an
|
||||
.Tn HP-UX
|
||||
environment, either by doing so on an
|
||||
.Tn HP-UX
|
||||
machine and transferring the binaries to the
|
||||
.Bx
|
||||
machine, or by compilation
|
||||
with the use of the
|
||||
.Ic hpux
|
||||
command.
|
||||
Applications using Starbase libraries have been run successfully
|
||||
on
|
||||
.Bx
|
||||
machines using both of these compilation techniques.
|
||||
.Pp
|
||||
Direct compilation,
|
||||
such as that used for the X Window System servers, has also been successful.
|
||||
Examples of some frame buffer operations can be found in
|
||||
the device dependent X Window system sources, for example the
|
||||
.Pa /usr/src/new/X/libhp.fb
|
||||
directory. These files contain examples of device dependent color map
|
||||
initialization, frame buffer operations, bit moving routines etc.
|
||||
.Pp
|
||||
The basic programming of the
|
||||
.Nm grf Ns ?
|
||||
devices involves opening the device
|
||||
file, mapping the control registers and frame buffer addresses into user
|
||||
space, and then manipulating the device as the application requires.
|
||||
The address mapping is controlled by an
|
||||
.Xr ioctl 2
|
||||
call to map the device into user space, and an unmap call when finished.
|
||||
The ioctls supported by
|
||||
.Bx
|
||||
are:
|
||||
.Bl -tag -width indent
|
||||
.It Dv GRFIOCGINFO
|
||||
Get Graphics Info
|
||||
.Pp
|
||||
Get info about device, setting the entries in the
|
||||
.Em grfinfo
|
||||
structure, as defined in \*[Lt]hpdev/grfioctl.h\*[Gt]:
|
||||
.Bd -literal
|
||||
struct grfinfo {
|
||||
int gd_id; /* HPUX identifier */
|
||||
caddr_t gd_regaddr; /* control registers physaddr */
|
||||
int gd_regsize; /* control registers size */
|
||||
caddr_t gd_fbaddr; /* frame buffer physaddr */
|
||||
int gd_fbsize; /* frame buffer size */
|
||||
short gd_colors; /* number of colors */
|
||||
short gd_planes; /* number of planes */
|
||||
/* new stuff */
|
||||
int gd_fbwidth; /* frame buffer width */
|
||||
int gd_fbheight; /* frame buffer height */
|
||||
int gd_dwidth; /* displayed part width */
|
||||
int gd_dheight; /* displayed part height */
|
||||
int gd_pad[6]; /* for future expansion */
|
||||
};
|
||||
.Ed
|
||||
.It Dv GRFIOCON
|
||||
Graphics On
|
||||
.Pp
|
||||
Turn graphics on by enabling
|
||||
.Tn CRT
|
||||
output. The screen will come on, displaying
|
||||
whatever is in the frame buffer, using whatever colormap is in place.
|
||||
.It Dv GRFIOCOFF
|
||||
Graphics Off
|
||||
.Pp
|
||||
Turn graphics off by disabling output to the
|
||||
.Tn CRT .
|
||||
The frame buffer contents
|
||||
are not affected.
|
||||
.It Dv GRFIOCMAP
|
||||
Map Device to user space
|
||||
.Pp
|
||||
Map in control registers and framebuffer space. Once the device file is
|
||||
mapped, the frame buffer structure is accessible.
|
||||
.It Dv GRFIOCUNMAP
|
||||
Unmap Device
|
||||
.Pp
|
||||
Unmap control registers and framebuffer space.
|
||||
.El
|
||||
.Pp
|
||||
For further information about the use of ioctl see the man page.
|
||||
.Sh FILES
|
||||
.Bl -tag -width /dev/*crt*? -compact
|
||||
.It Pa /dev/grf?
|
||||
.Bx
|
||||
interface special files
|
||||
.It Pa /dev/*crt*
|
||||
.Tn HP-UX
|
||||
.Em starbase
|
||||
interface special files
|
||||
.El
|
||||
.Sh EXAMPLES
|
||||
This short code fragment is an example of opening some graphics device and
|
||||
mapping in the control and frame buffer space:
|
||||
.Bd -literal
|
||||
#define GRF_DEV \*[Lt]some_graphics_device\*[Gt] /* /dev/grfN */
|
||||
{
|
||||
struct fbstruct *regs; /* fbstruct = gboxfb, rboxfb, etc. */
|
||||
u_char *Addr, frame_buffer;
|
||||
struct grfinfo gi;
|
||||
int disp_fd;
|
||||
|
||||
disp_fd = open(GRF_DEV,1);
|
||||
if (ioctl (disp_fd, GRFIOCGINFO, \*[Am]gi) \*[Lt] 0) return -1;
|
||||
(void) ioctl (disp_fd, GRFIOCON, 0);
|
||||
|
||||
Addr = (u_char *) 0;
|
||||
if (ioctl (disp_fd, GRFIOCMAP, \*[Am]Addr) \*[Lt] 0) {
|
||||
(void) ioctl (disp_fd, GRFIOCOFF, 0);
|
||||
return -1;
|
||||
}
|
||||
regs = (fbstruct *) Addr; /* Control Registers */
|
||||
frame_buffer = (u_char *) Addr + gi.gd_regsize; /* Frame buffer mem */
|
||||
}
|
||||
.Ed
|
||||
.Sh DIAGNOSTICS
|
||||
None under
|
||||
.Bx .
|
||||
.Tn HP-UX
|
||||
The
|
||||
.Tn CE.utilities/Crtadjust
|
||||
programs must be used for each specific device.
|
||||
.Sh ERRORS
|
||||
.Bl -tag -width [EINVAL]
|
||||
.It Bq Er ENODEV
|
||||
no such device.
|
||||
.It Bq Er EBUSY
|
||||
Another process has the device open.
|
||||
.It Bq Er EINVAL
|
||||
Invalid ioctl specification.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr ioctl 2 ,
|
||||
.Xr dvbox 4 ,
|
||||
.Xr gbox 4 ,
|
||||
.Xr hil 4 ,
|
||||
.Xr hyper 4 ,
|
||||
.Xr rbox 4 ,
|
||||
.Xr topcat 4
|
||||
@ -1,550 +0,0 @@
|
||||
.\" $NetBSD: hil.4,v 1.11 2003/08/07 10:31:06 agc Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1990, 1991, 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
.\"
|
||||
.\" This code is derived from software contributed to Berkeley by
|
||||
.\" the Systems Programming Group of the University of Utah Computer
|
||||
.\" Science Department.
|
||||
.\"
|
||||
.\" 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. Neither the name of the University 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 REGENTS 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 REGENTS 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.
|
||||
.\"
|
||||
.\" from: @(#)hil.4 8.2 (Berkeley) 11/30/93
|
||||
.\"
|
||||
.Dd November 30, 1993
|
||||
.Dt HIL 4 hp300
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm hil
|
||||
.Nd Human Interface Link device driver
|
||||
.Sh SYNOPSIS
|
||||
.Cd "hil* at intio?"
|
||||
.Sh DESCRIPTION
|
||||
The Human Interface Link
|
||||
.Pq Tn HIL
|
||||
is the interface used by the Series
|
||||
300 computers to connect devices such as keyboards, mice, control knobs,
|
||||
and
|
||||
.Tn ID
|
||||
modules to the machine.
|
||||
.Pp
|
||||
Special files
|
||||
.Pa /dev/hil[1-7]
|
||||
refer to physical
|
||||
.Tn HIL
|
||||
devices 1 through 7.
|
||||
.Pa /dev/hil0
|
||||
is an artifact of a never-completed interface and is not currently
|
||||
useful for anything. In the current implementation, only one keyboard
|
||||
can be used for text-mode interaction via the
|
||||
.Xr ite 4
|
||||
interface; other keyboards, if any, are accessible only via their
|
||||
.Pa /dev/hil Ns Em N
|
||||
interfaces, as described here.
|
||||
.Pp
|
||||
The device file that corresponds to a particular
|
||||
.Tn HIL
|
||||
device is determined
|
||||
by the order of the devices on the loop. For instance, if an
|
||||
.Tn ID
|
||||
module
|
||||
is the second physical device on the loop, then
|
||||
.Pa /dev/hil2
|
||||
is the special
|
||||
file that should be used for communication with that module.
|
||||
.Pp
|
||||
Communication with an
|
||||
.Tn HIL
|
||||
device is begun with an
|
||||
.Em open
|
||||
system call. A process may open a device already opened by another
|
||||
process unless the existing process is operating in
|
||||
.Tn HP-UX
|
||||
compatibility mode,
|
||||
in which case it requires exclusive use of the device, or
|
||||
another process has the device open and is using
|
||||
.Tn HP-UX
|
||||
style
|
||||
device access (see
|
||||
.Dv HILIOCHPUX
|
||||
below).
|
||||
.Pp
|
||||
In the current implementation,
|
||||
.Tn HP-UX
|
||||
style access is the only supported access method. This interface uses
|
||||
.Xr read 2
|
||||
calls to receive packets of data representing events. (An interface
|
||||
using a memory area shared between the kernel and the user process was
|
||||
partially implemented, and remnants of it can be found in the include
|
||||
files and the driver, but it does not work and probably will be
|
||||
completely dropped in favor of a console interface providing better
|
||||
cross-port consistency.)
|
||||
.Pp
|
||||
To receive events from a device, a user process uses
|
||||
.Xr open 2
|
||||
to open the device, then uses the
|
||||
.Dv HILIOCHPUX
|
||||
ioctl (see below) to request
|
||||
.Tn HP-UX
|
||||
style access. Then data obtained with
|
||||
.Xr read 2
|
||||
consists of a stream of packets, each of which has a five-byte header
|
||||
consisting of a one-byte length (including the header) and a four-byte
|
||||
timestamp, which is measured in hundredths of a second since some fixed
|
||||
reference point. The timestamp is stored in host-native byte order;
|
||||
copying it into a
|
||||
.Sq long int
|
||||
variable with
|
||||
.Xr memcpy 3
|
||||
or equivalent will give a useful result. Following this header is zero
|
||||
or more bytes, as received from the device. This manual page documents
|
||||
this data only minimally; see PACKET FORMAT below.
|
||||
.\" Need someone who knows to write authoritative doc for device data!
|
||||
.Pp
|
||||
.Xr select 2
|
||||
may be used in the usual way to detect input data.
|
||||
.Pp
|
||||
.Xr ioctl 2
|
||||
is used to control the
|
||||
.Tn HIL
|
||||
device.
|
||||
The ioctl commands (which unfortunately are defined in an include file,
|
||||
.Pa /usr/src/sys/arch/hp300/dev/hilioctl.h ,
|
||||
not normally installed under
|
||||
.Pa /usr/include ) ,
|
||||
are as follows. Many of these are functionally identical to ioctls
|
||||
.Tn HP-UX
|
||||
provides.
|
||||
.Bl -tag -width HILIOCARO
|
||||
.It Dv HILIOCID
|
||||
Identify and Describe
|
||||
.Pp
|
||||
The device will return up to 11 bytes of information describing the
|
||||
type and characteristics of the device.
|
||||
At the very least, 2 bytes of information,
|
||||
the device
|
||||
.Tn ID ,
|
||||
and the Describe Record Header will be returned.
|
||||
Identical to the
|
||||
.Tn HP-UX
|
||||
.Dv HILID
|
||||
ioctl.
|
||||
.It Dv HILIOCSC
|
||||
Report Security Code
|
||||
.Pp
|
||||
Request the security code record from a device. The security code can
|
||||
vary from 1 byte to 15, and is only supported by some
|
||||
.Tn HIL
|
||||
devices.
|
||||
Identical to the
|
||||
.Tn HP-UX
|
||||
.Dv HILSC
|
||||
ioctl.
|
||||
.It Dv HILIOCRN
|
||||
Report Name
|
||||
.Pp
|
||||
An ascii string of up to 15 bytes in length that describes the device
|
||||
is returned.
|
||||
Identical to the
|
||||
.Tn HP-UX
|
||||
.Dv HILRN
|
||||
ioctl.
|
||||
.It Dv HILIOCRS
|
||||
Report Status
|
||||
.Pp
|
||||
An ascii string of up to 15 bytes in length that describes the current
|
||||
status of the device is returned.
|
||||
Identical to the
|
||||
.Tn HP-UX
|
||||
.Dv HILRS
|
||||
ioctl.
|
||||
.It Dv HILIOCED
|
||||
Extended Describe
|
||||
.Pp
|
||||
Additional information of up to 15 bytes is returned describing the device.
|
||||
This ioctl is similar to
|
||||
.Tn HILIOCID ,
|
||||
which must be used first
|
||||
to determine if the device supports extended describe.
|
||||
Identical to the
|
||||
.Tn HP-UX
|
||||
.Dv HILED
|
||||
ioctl.
|
||||
.It Dv HILIOCAROFF
|
||||
Disable Auto Repeat
|
||||
.Pp
|
||||
Turn off auto repeat on the keyboard while it is in cooked mode.
|
||||
Identical to the
|
||||
.Tn HP-UX
|
||||
.Dv HILDKR
|
||||
ioctl.
|
||||
.It Dv HILIOCAR1
|
||||
Enable Auto Repeat
|
||||
.Pp
|
||||
Turn on auto repeat on the keyboard while it is in raw mode.
|
||||
The repeat rate is set to 1/30th of a second.
|
||||
Identical to the
|
||||
.Tn HP-UX
|
||||
.Dv HILER1
|
||||
ioctl.
|
||||
.It Dv HILIOCAR2
|
||||
Enable Auto Repeat
|
||||
.Pp
|
||||
Turn on auto repeat on the keyboard while it is in raw mode.
|
||||
The repeat rate is set to 1/60th of a second.
|
||||
Identical to the
|
||||
.Tn HP-UX
|
||||
.Dv HILER2
|
||||
ioctl.
|
||||
.Pp
|
||||
The following ioctls are specific to this implementation:
|
||||
.It Dv HILIOCBEEP
|
||||
Beep
|
||||
.Pp
|
||||
Generate a keyboard beep as defined by
|
||||
.Ar arg .
|
||||
.Ar arg
|
||||
is a pointer to two bytes of information;
|
||||
the first is the duration of the beep (microseconds),
|
||||
the second is the frequency of the beep (Hertz).
|
||||
.It Dv HILIOCHPUX
|
||||
Use HP-UX Read Interface
|
||||
.Pp
|
||||
Use
|
||||
.Tn HP-UX
|
||||
semantics for gathering data from this device. This call must be used
|
||||
before anything can be read from the descriptor.
|
||||
.El
|
||||
.Sh PACKET FORMAT
|
||||
When reading data from a device, events are received as data packets,
|
||||
with a header as described above. Here we provide (very rudimentary)
|
||||
documentation for the format of the device-dependent data, for at least
|
||||
one type of mouse and keyboard (specifically, the 46060A two-button
|
||||
mechanical mouse and 46021A keyboard); other mice and keyboards may or
|
||||
may not be similar.
|
||||
.Pp
|
||||
The first byte of data is a bitmask. Only two bits have known meaning:
|
||||
.Bl -tag -width 0x123
|
||||
.It Li 0x02
|
||||
The data portion contains mouse motion deltas, two signed 8-bit
|
||||
quantities, X delta first.
|
||||
.It Li 0x40
|
||||
The data portion contains a key or mouse button up/down event, one
|
||||
byte. The low bit is 0 if the event is a
|
||||
.Sq down
|
||||
event, 1 if an
|
||||
.Sq up
|
||||
event. The other seven bits identify the key or button, according to
|
||||
the table below.
|
||||
.El
|
||||
.Pp
|
||||
If both bits are set, the mouse deltas appear before the button byte.
|
||||
.Pp
|
||||
The known identifying values for key/button events are (only the 0xfe
|
||||
bits are listed):
|
||||
.Pp
|
||||
.\" Growl. The .Sm manipulations simply don't work, and I don't know
|
||||
.\" how to get a double-quote or backslash to work. So I name all the
|
||||
.\" special characters...what I want to write is something like,
|
||||
.\" The
|
||||
.\" .Sm off
|
||||
.\" .Li =
|
||||
.\" /
|
||||
.\" .Li +
|
||||
.\" key
|
||||
.\" to get "The =/+ key" with the = and + set .Li style.
|
||||
.Bl -tag -width 0x123 -compact
|
||||
.It 0x04
|
||||
.Sq Extend char
|
||||
(right-hand).
|
||||
.It 0x06
|
||||
.Sq Extend char
|
||||
(left-hand).
|
||||
.It 0x08
|
||||
.Sq Shift
|
||||
(right-hand).
|
||||
.It 0x0a
|
||||
.Sq Shift
|
||||
(left-hand).
|
||||
.It 0x0c
|
||||
.Sq CTRL
|
||||
.It 0x0e
|
||||
.Sq Break
|
||||
/
|
||||
.Sq Reset
|
||||
.It 0x10
|
||||
4, on the numeric keypad.
|
||||
.It 0x12
|
||||
8, on the numeric keypad.
|
||||
.It 0x14
|
||||
5, on the numeric keypad.
|
||||
.It 0x16
|
||||
9, on the numeric keypad.
|
||||
.It 0x18
|
||||
6, on the numeric keypad.
|
||||
.It 0x1a
|
||||
7, on the numeric keypad.
|
||||
.It 0x1c
|
||||
The comma key on the numeric keypad.
|
||||
.It 0x1e
|
||||
.Sq Enter ,
|
||||
on the numeric keypad.
|
||||
.It 0x20
|
||||
1, on the numeric keypad
|
||||
.It 0x22
|
||||
The slash key on the numeric keypad.
|
||||
.It 0x24
|
||||
2, on the numeric keypad.
|
||||
.It 0x26
|
||||
The plus key on the numeric keypad.
|
||||
.It 0x28
|
||||
3, on the numeric keypad.
|
||||
.It 0x2a
|
||||
The asterisk key on the numeric keypad.
|
||||
.It 0x2c
|
||||
0, on the numeric keypad.
|
||||
.It 0x2e
|
||||
The minus key on the numeric keypad.
|
||||
.It 0x30
|
||||
B
|
||||
.It 0x32
|
||||
V
|
||||
.It 0x34
|
||||
C
|
||||
.It 0x36
|
||||
X
|
||||
.It 0x38
|
||||
Z
|
||||
.It 0x3e
|
||||
.Sq ESC
|
||||
/
|
||||
.Sq DEL
|
||||
.It 0x42
|
||||
The second (counting from the left) of the four unmarked keys at the
|
||||
top right.
|
||||
.It 0x46
|
||||
The third (counting from the left) of the four unmarked keys at the top
|
||||
right.
|
||||
.It 0x48
|
||||
The period key on the numeric keypad.
|
||||
.It 0x4a
|
||||
The leftmost of the four unmarked keys at the top right.
|
||||
.It 0x4c
|
||||
The
|
||||
.Sq Tab
|
||||
key on the numeric keypad.
|
||||
.It 0x4e
|
||||
The rightmost of the four unmarked keys at the top right.
|
||||
.It 0x50
|
||||
H
|
||||
.It 0x52
|
||||
G
|
||||
.It 0x54
|
||||
F
|
||||
.It 0x56
|
||||
D
|
||||
.It 0x58
|
||||
S
|
||||
.It 0x5a
|
||||
A
|
||||
.It 0x5e
|
||||
.Sq Caps
|
||||
.It 0x60
|
||||
U
|
||||
.It 0x62
|
||||
Y
|
||||
.It 0x64
|
||||
T
|
||||
.It 0x66
|
||||
R
|
||||
.It 0x68
|
||||
E
|
||||
.It 0x6a
|
||||
W
|
||||
.It 0x6c
|
||||
Q
|
||||
.It 0x6e
|
||||
.Sq Tab
|
||||
.It 0x70
|
||||
The digit-7 / ampersand key.
|
||||
.It 0x72
|
||||
The digit-6 / circumflex key.
|
||||
.It 0x74
|
||||
The digit-5 / percent-sign key.
|
||||
.It 0x76
|
||||
The digit-4 / dollar-sign key.
|
||||
.It 0x78
|
||||
The digit-3 / hash-mark key.
|
||||
.It 0x7a
|
||||
The digit-2 / at-sign key.
|
||||
.It 0x7c
|
||||
The digit-1 / exclamation-point key.
|
||||
.It 0x7e
|
||||
The backquote / tilde key.
|
||||
.It 0x80
|
||||
Left mouse button.
|
||||
.It 0x82
|
||||
Right mouse button.
|
||||
.It 0x90
|
||||
.Sq Menu
|
||||
.It 0x92
|
||||
.Sq F4
|
||||
.It 0x94
|
||||
.Sq F3
|
||||
.It 0x96
|
||||
.Sq F2
|
||||
.It 0x98
|
||||
.Sq F1
|
||||
.It 0x9c
|
||||
.Sq Stop
|
||||
.It 0x9e
|
||||
.Sq Enter
|
||||
/
|
||||
.Sq Print
|
||||
.It 0xa0
|
||||
.Sq System
|
||||
/
|
||||
.Sq User
|
||||
.It 0xa2
|
||||
.Sq F5
|
||||
.It 0xa4
|
||||
.Sq F6
|
||||
.It 0xa6
|
||||
.Sq F7
|
||||
.It 0xa8
|
||||
.Sq F8
|
||||
.It 0xac
|
||||
.Sq Clear line
|
||||
.It 0xae
|
||||
.Sq Clear display
|
||||
.It 0xb0
|
||||
The digit-8 / asterisk key.
|
||||
.It 0xb2
|
||||
The digit-9 / left-parenthesis key.
|
||||
.It 0xb4
|
||||
The digit-0 / right-parenthesis key.
|
||||
.It 0xb6
|
||||
The minus-sign / underscore key.
|
||||
.It 0xb8
|
||||
The equal-sign / plus-sign key.
|
||||
.It 0xba
|
||||
.Sq Back space
|
||||
.It 0xbc
|
||||
.Sq Insert line
|
||||
.It 0xbe
|
||||
.Sq Delete line
|
||||
.It 0xc0
|
||||
I
|
||||
.It 0xc2
|
||||
O
|
||||
.It 0xc4
|
||||
P
|
||||
.It 0xc6
|
||||
The left-bracket / left-brace key.
|
||||
.It 0xc8
|
||||
The right-bracket / right-brace key.
|
||||
.It 0xca
|
||||
The backslash / vertical-bar key.
|
||||
.It 0xcc
|
||||
.Sq Insert char
|
||||
.It 0xce
|
||||
.Sq Delete char
|
||||
.It 0xd0
|
||||
J
|
||||
.It 0xd2
|
||||
K
|
||||
.It 0xd4
|
||||
L
|
||||
.It 0xd6
|
||||
The semicolon / colon key.
|
||||
.It 0xd8
|
||||
The single-quote / double-quote key.
|
||||
.It 0xda
|
||||
.Sq Return
|
||||
.It 0xdc
|
||||
The arrow key pointing up and left.
|
||||
.It 0xde
|
||||
.Sq Prev
|
||||
.It 0xe0
|
||||
M
|
||||
.It 0xe2
|
||||
The period / less-than key.
|
||||
.It 0xe4
|
||||
The comma / greater-than key.
|
||||
.It 0xe6
|
||||
The slash / question-mark key.
|
||||
.It 0xea
|
||||
.Sq Select
|
||||
.It 0xee
|
||||
.Sq Next
|
||||
.It 0xf0
|
||||
N
|
||||
.It 0xf2
|
||||
The spacebar.
|
||||
.It 0xf8
|
||||
The left-pointing arrow key.
|
||||
.It 0xfa
|
||||
The down-pointing arrow key.
|
||||
.It 0xfc
|
||||
The up-pointing arrow key.
|
||||
.It 0xfe
|
||||
The right-pointing arrow key.
|
||||
.El
|
||||
.Sh FILES
|
||||
.Bl -tag -width /dev/hil[1-7] -compact
|
||||
.It Pa /dev/hil[1-7]
|
||||
Individual
|
||||
.Tn HIL
|
||||
loop devices.
|
||||
.El
|
||||
.Sh ERRORS
|
||||
.Bl -tag -width [EINVAL]
|
||||
.It Bq Er ENODEV
|
||||
No such HIL loop device.
|
||||
.It Bq Er ENXIO
|
||||
HIL loop is inoperative.
|
||||
.It Bq Er EBUSY
|
||||
Another HP-UX process has the device open, or another
|
||||
.Bx
|
||||
process has the
|
||||
device open, and is using it in
|
||||
.Tn HP-UX
|
||||
mode.
|
||||
.It Bq Er EINVAL
|
||||
Invalid
|
||||
.Xr ioctl 2
|
||||
specification.
|
||||
.El
|
||||
.Sh BUGS
|
||||
Requiring
|
||||
.Dv HILIOCHPUX
|
||||
to be able to read anything is gross. It is probably not worth fixing,
|
||||
though, because the whole hil/ite mechanism will probably be replaced
|
||||
with a more-or-less port-independent scheme in the foreseeable future.
|
||||
.\" .Sh HISTORY
|
||||
.\" The
|
||||
.\" .Nm
|
||||
.\" interface is
|
||||
.\" .Ud
|
||||
@ -1,163 +0,0 @@
|
||||
.\" $NetBSD: ite.4,v 1.8 2003/08/07 10:31:06 agc Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1990, 1991, 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
.\"
|
||||
.\" This code is derived from software contributed to Berkeley by
|
||||
.\" the Systems Programming Group of the University of Utah Computer
|
||||
.\" Science Department.
|
||||
.\"
|
||||
.\" 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. Neither the name of the University 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 REGENTS 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 REGENTS 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.
|
||||
.\"
|
||||
.\" from: @(#)ite.4 8.1 (Berkeley) 6/9/93
|
||||
.\"
|
||||
.Dd September 10, 2001
|
||||
.Dt ITE 4 hp300
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm ite
|
||||
.Nd
|
||||
.Tn HP
|
||||
Internal Terminal Emulator graphics driver
|
||||
.Sh SYNOPSIS
|
||||
.Cd "ite* at grf?"
|
||||
.Sh DESCRIPTION
|
||||
.Tn TTY
|
||||
special files of the form ``ttye?''
|
||||
are interfaces to the
|
||||
.Tn HP ITE
|
||||
for bit-mapped displays as implemented under
|
||||
.Bx .
|
||||
An
|
||||
.Tn ITE
|
||||
is the main system console on most
|
||||
.Tn HP300
|
||||
workstations and
|
||||
is the mechanism through which a user communicates with the machine.
|
||||
If more than one display exists on a system,
|
||||
any or all can be used as
|
||||
.Tn ITE Ns s
|
||||
with the limitation that only the first
|
||||
one opened will have a keyboard (since only one keyboard is supported).
|
||||
.Pp
|
||||
.Tn ITE
|
||||
devices use the
|
||||
.Tn HP-UX
|
||||
.Sq Li 300h
|
||||
.Xr termcap 5
|
||||
or
|
||||
.Xr terminfo 5
|
||||
entries.
|
||||
However, as currently implemented,
|
||||
the
|
||||
.Tn ITE
|
||||
does not support the full range of
|
||||
.Tn HP-UX
|
||||
capabilities for this device.
|
||||
Missing are multiple colors, underlining, blinking, softkeys,
|
||||
programmable tabs, scrolling memory and keyboard arrow keys.
|
||||
The keyboard does not have any of the international character
|
||||
support of
|
||||
.Tn HP Ns 's
|
||||
.Tn NLS
|
||||
system.
|
||||
It does use the left and right
|
||||
.Em extend char
|
||||
keys as meta keys, in that it will set the eighth bit of the character code.
|
||||
.Pp
|
||||
Upon booting, the kernel will first look for an
|
||||
.Tn ITE
|
||||
device
|
||||
to use as the system console
|
||||
.Pq Pa /dev/console .
|
||||
If a display exists at any hardware address, it will be the console.
|
||||
The kernel looks for, in order:
|
||||
a 98544, 98545, or 98547 Topcat display,
|
||||
a 98700 Gatorbox at a supported address (see
|
||||
.Xr gbox 4 ) ,
|
||||
or a 98720 Renaissance at a supported address (see
|
||||
.Xr rbox 4 ) .
|
||||
Currently there is no
|
||||
.Tn ITE
|
||||
support for the
|
||||
98548, 98549, 98550 and 98556 boards.
|
||||
.Pp
|
||||
When activated as an
|
||||
.Tn ITE
|
||||
(special file opened),
|
||||
all displays go through a standard initialization sequence.
|
||||
The frame buffer is cleared,
|
||||
the
|
||||
.Tn ROM
|
||||
fonts are unpacked and loaded into off-screen storage and
|
||||
a cursor appears.
|
||||
The
|
||||
.Tn ITE
|
||||
initialization routine also sets the colormap entry used to white.
|
||||
Variable colors are not used, mainly for reasons of simplicity.
|
||||
The font pixels are all set to 0xff and the colormap entry corresponding
|
||||
to all planes is set to R=255, G=255 and B=255.
|
||||
The actual number of planes used to display the characters depends
|
||||
on the hardware installed.
|
||||
Finally, if the keyboard
|
||||
.Tn HIL
|
||||
device is not already assigned to another
|
||||
.Tn ITE
|
||||
device, it is placed in ``cooked'' mode and assigned to this
|
||||
.Tn ITE .
|
||||
.Pp
|
||||
On most systems,
|
||||
a display is used both as an
|
||||
.Tn ITE
|
||||
.Pf ( Pa /dev/ttye?
|
||||
aka
|
||||
.Pa /dev/console )
|
||||
and as a graphics device
|
||||
.Pq /dev/grf? .
|
||||
In this environment,
|
||||
there is some interaction between the two uses that should be noted.
|
||||
For example, opening
|
||||
.Pa /dev/grf0
|
||||
will deactivate the
|
||||
.Tn ITE ,
|
||||
that is, write over whatever may be on the
|
||||
.Tn ITE
|
||||
display.
|
||||
When the graphics application is finished and
|
||||
.Pa /dev/grf0
|
||||
closed,
|
||||
the
|
||||
.Tn ITE
|
||||
will be reinitialized with the frame buffer cleared
|
||||
and the
|
||||
.Tn ITE
|
||||
colormap installed.
|
||||
.Sh DIAGNOSTICS
|
||||
None under
|
||||
.Bx .
|
||||
.Sh SEE ALSO
|
||||
.Xr grf 4 ,
|
||||
.Xr hil 4 ,
|
||||
.Xr tty 4
|
||||
Loading…
x
Reference in New Issue
Block a user