share/man/man4/man4.hp300/ite.4

   1 .\"     $NetBSD: ite.4,v 1.7 2002/01/15 01:36:15 wiz Exp $
   2 .\"
   3 .\" Copyright (c) 1990, 1991, 1993
   4 .\"     The Regents of the University of California.  All rights reserved.
   5 .\"
   6 .\" This code is derived from software contributed to Berkeley by
   7 .\" the Systems Programming Group of the University of Utah Computer
   8 .\" Science Department.
   9 .\"
  10 .\" Redistribution and use in source and binary forms, with or without
  11 .\" modification, are permitted provided that the following conditions
  12 .\" are met:
  13 .\" 1. Redistributions of source code must retain the above copyright
  14 .\"    notice, this list of conditions and the following disclaimer.
  15 .\" 2. Redistributions in binary form must reproduce the above copyright
  16 .\"    notice, this list of conditions and the following disclaimer in the
  17 .\"    documentation and/or other materials provided with the distribution.
  18 .\" 3. Neither the name of the University nor the names of its contributors
  19 .\"    may be used to endorse or promote products derived from this software
  20 .\"    without specific prior written permission.
  21 .\"
  22 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  23 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  24 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  25 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  26 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  27 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  28 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  29 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  30 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  31 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  32 .\" SUCH DAMAGE.
  33 .\"
  34 .\"     from: @(#)ite.4 8.1 (Berkeley) 6/9/93
  35 .\"
  36 .Dd September 10, 2001
  37 .Dt ITE 4 hp300
  38 .Os
  39 .Sh NAME
  40 .Nm ite
  41 .Nd
  42 .Tn HP
  43 Internal Terminal Emulator graphics driver
  44 .Sh SYNOPSIS
  45 .Cd "ite* at grf?"
  46 .Sh DESCRIPTION
  47 .Tn TTY
  48 special files of the form ``ttye?''
  49 are interfaces to the
  50 .Tn HP ITE
  51 for bit-mapped displays as implemented under
  52 .Bx .
  53 An
  54 .Tn ITE
  55 is the main system console on most
  56 .Tn HP300
  57 workstations and
  58 is the mechanism through which a user communicates with the machine.
  59 If more than one display exists on a system,
  60 any or all can be used as
  61 .Tn ITE Ns s
  62 with the limitation that only the first
  63 one opened will have a keyboard (since only one keyboard is supported).
  64 .Pp
  65 .Tn ITE
  66 devices use the
  67 .Tn HP-UX
  68 .Sq Li 300h
  69 .Xr termcap 5
  70 or
  71 .Xr terminfo 5
  72 entries.
  73 However, as currently implemented,
  74 the
  75 .Tn ITE
  76 does not support the full range of
  77 .Tn HP-UX
  78 capabilities for this device.
  79 Missing are multiple colors, underlining, blinking, softkeys,
  80 programmable tabs, scrolling memory and keyboard arrow keys.
  81 The keyboard does not have any of the international character
  82 support of
  83 .Tn HP Ns 's
  84 .Tn NLS
  85 system.
  86 It does use the left and right
  87 .Em extend char
  88 keys as meta keys, in that it will set the eighth bit of the character code.
  89 .Pp
  90 Upon booting, the kernel will first look for an
  91 .Tn ITE
  92 device
  93 to use as the system console
  94 .Pq Pa /dev/console .
  95 If a display exists at any hardware address, it will be the console.
  96 The kernel looks for, in order:
  97 a 98544, 98545, or 98547 Topcat display,
  98 a 98700 Gatorbox at a supported address (see
  99 .Xr gbox 4 ) ,
 100 or a 98720 Renaissance at a supported address (see
 101 .Xr rbox 4 ) .
 102 Currently there is no
 103 .Tn ITE
 104 support for the
 105 98548, 98549, 98550 and 98556 boards.
 106 .Pp
 107 When activated as an
 108 .Tn ITE
 109 (special file opened),
 110 all displays go through a standard initialization sequence.
 111 The frame buffer is cleared,
 112 the
 113 .Tn ROM
 114 fonts are unpacked and loaded into off-screen storage and
 115 a cursor appears.
 116 The
 117 .Tn ITE
 118 initialization routine also sets the colormap entry used to white.
 119 Variable colors are not used, mainly for reasons of simplicity.
 120 The font pixels are all set to 0xff and the colormap entry corresponding
 121 to all planes is set to R=255, G=255 and B=255.
 122 The actual number of planes used to display the characters depends
 123 on the hardware installed.
 124 Finally, if the keyboard
 125 .Tn HIL
 126 device is not already assigned to another
 127 .Tn ITE
 128 device, it is placed in ``cooked'' mode and assigned to this
 129 .Tn ITE .
 130 .Pp
 131 On most systems,
 132 a display is used both as an
 133 .Tn ITE
 134 .Pf ( Pa /dev/ttye?
 135 aka
 136 .Pa /dev/console )
 137 and as a graphics device
 138 .Pq /dev/grf? .
 139 In this environment,
 140 there is some interaction between the two uses that should be noted.
 141 For example, opening
 142 .Pa /dev/grf0
 143 will deactivate the
 144 .Tn ITE ,
 145 that is, write over whatever may be on the
 146 .Tn ITE
 147 display.
 148 When the graphics application is finished and
 149 .Pa /dev/grf0
 150 closed,
 151 the
 152 .Tn ITE
 153 will be reinitialized with the frame buffer cleared
 154 and the
 155 .Tn ITE
 156 colormap installed.
 157 .Sh DIAGNOSTICS
 158 None under
 159 .Bx .
 160 .Sh SEE ALSO
 161 .Xr grf 4 ,
 162 .Xr hil 4 ,
 163 .Xr tty 4