share/man/man4/sti.4

   1 .\"     $NetBSD$
   2 .\"     $OpenBSD: sti.4,v 1.14 2004/06/08 02:54:53 mickey Exp $
   3 .\"
   4 .\" Copyright (c) 2001 Michael Shalayeff
   5 .\" All rights reserved.
   6 .\"
   7 .\" Redistribution and use in source and binary forms, with or without
   8 .\" modification, are permitted provided that the following conditions
   9 .\" are met:
  10 .\" 1. Redistributions of source code must retain the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer.
  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 OR HIS RELATIVES BE LIABLE FOR ANY DIRECT,
  20 .\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  21 .\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  22 .\" SERVICES; LOSS OF MIND, USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  24 .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
  25 .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
  26 .\" THE POSSIBILITY OF SUCH DAMAGE.
  27 .\"
  28 .Dd May 11, 2001
  29 .Dt STI 4
  30 .Os
  31 .Sh NAME
  32 .Nm sti
  33 .Nd HP Standard Text Interface
  34 .Sh SYNOPSIS
  35 .Cd "sti*       at mainbus0 irq ?"
  36 .Cd "sti*       at phantomas0 irq ?"
  37 .\" .Cd "sti*   at pci? device ? function ?"
  38 .Cd "wsdisplay* at sti? console ?"
  39 .Sh DESCRIPTION
  40 The
  41 .Nm
  42 was created by HP to provide uniform frame-buffer access operations
  43 for their 9000/300 and 9000/700 series of workstations.
  44 .Pp
  45 The following models are supported
  46 (though not all features or frame buffer depths may be available):
  47 .Bl -column "Visualize FX10pro" "Bits" "Mem" "3D" "machines" -offset left
  48 .It "Model" Ta "Bits" Ta "Mem" Ta "3D" Ta "Machines/Cards"
  49 .\" .It "Timber" Ta "8" Ta "2" Ta "" Ta "HP9000/705/710"
  50 .It "GRX" Ta "8g" Ta "2" Ta "" Ta "SGC"
  51 .It "CRX" Ta "8" Ta "2" Ta "" Ta "SGC"
  52 .It "Tomcat" Ta "8" Ta "2" Ta "" Ta "SGC"
  53 .It "Stinger" Ta "8" Ta "2" Ta "" Ta "HP9000/7[12]5/74[257]i"
  54 .It "Artist" Ta "8" Ta "2" Ta "" Ta "HP9000/712/7[12]5/74[38]i"
  55 .It "CRX-24" Ta "24" Ta "16" Ta "" Ta "SGC"
  56 .\" .It "CRX-24Z" Ta "24" Ta "16" Ta "y" Ta "SGC"
  57 .\" .It "CRX-48Z" Ta "24" Ta "16" Ta "y" Ta "SGC/GSC"
  58 .It "HCRX-8" Ta "8" Ta "2" Ta "" Ta "GSC"
  59 .\" .It "HCRX-8Z" Ta "8" Ta "2" Ta "y" Ta "GSC"
  60 .It "HCRX-24" Ta "24" Ta "16" Ta "" Ta "GSC"
  61 .\" .It "HCRX-24Z" Ta "24" Ta "16" Ta "y" Ta "GSC"
  62 .\" .It "Visualize 8" Ta "8" Ta "2" Ta "y" Ta "GSC"
  63 .It "Visualize EG" Ta "16" Ta "2" Ta "" Ta "HP B/C-class, GSC/PCI"
  64 .\" .It "Visualize 24" Ta "24" Ta "16" Ta "y" Ta "GSC"
  65 .\" .It "Visualize 48" Ta "24" Ta "16" Ta "y" Ta "GSC"
  66 .\" .It "Visualize 48XP" Ta "24" Ta "16" Ta "y" Ta "GSC"
  67 .\" .It "Visualize FXE" Ta "24" Ta "24" Ta "y" Ta "PCI 32/66"
  68 .\" .It "Visualize FX2" Ta "24" Ta "24" Ta "y" Ta "PCI 64/66"
  69 .\" .It "Visualize FX4/FX6" Ta "24" Ta "32" Ta "y" Ta "PCI 64/66"
  70 .\" .It "Visualize FX5pro" Ta "24" Ta "64" Ta "y" Ta "PCI 64/66"
  71 .\" .It "Visualize FX10pro" Ta "24" Ta "128" Ta "y" Ta "PCI 64/66"
  72 .El
  73 .Pp
  74 Implementation consists of a set of functions burnt in to the PROM
  75 on the card and providing the following set of functions (see below
  76 for PROM revision history on functions supported by particular PROM
  77 revision):
  78 .Pp
  79 .Bl -bullet -compact
  80 .It
  81 Initialize graphics.
  82 .It
  83 State management.
  84 .It
  85 Print a character onto the screen using currently selected font.
  86 .It
  87 Copy a region of the frame-buffer to another location.
  88 .It
  89 Self testing.
  90 .It
  91 Exception handling.
  92 .It
  93 Frame-buffer configuration enquiry.
  94 .It
  95 Setting colour-map entry.
  96 .It
  97 DMA parameters.
  98 .It
  99 Flow control.
 100 .It
 101 User timing.
 102 .It
 103 Processing management.
 104 .It
 105 Miscellaneous utility functions.
 106 .El
 107 .Pp
 108 There are two modes for accessing the PROM:
 109 .Dq byte
 110 and
 111 .Dq word
 112 mode.
 113 In
 114 .Dq byte
 115 mode each 4-byte word contains only the low-ordered big-endian
 116 byte of data; i.e., to compose one word of data 4 words should be read
 117 and low-ordered bytes of those should be shifted correspondingly.
 118 In
 119 .Dq word
 120 mode each word contains all 4 bytes of valid data.
 121 .Pp
 122 PROM revision history:
 123 .Bl -tag -width "00.00" -compact
 124 .It 8.02
 125 Original release.
 126 .It 8.03
 127 .Bl -bullet -compact
 128 .It
 129 OSF-extended self test (a.k.a fast).
 130 .It
 131 Restore display.
 132 .El
 133 .It 8.04
 134 .Bl -bullet -compact
 135 .\" global cfg
 136 .\" rename global cfg ext
 137 .\" global cfg ext
 138 .It
 139 Implement
 140 .Nm curr_mon
 141 function.
 142 .It
 143 Graphical boot screen.
 144 .\" sti_mem_addr
 145 .\" dd
 146 .\" word mode
 147 .\" num mons
 148 .\" mon tbl
 149 .\" user data
 150 .\" sti mem req
 151 .\" user data size
 152 .\" maxtime
 153 .\" mon tbl desc struct
 154 .\" init_inptr
 155 .\" rename init_inptr_ext
 156 .\" init_inptr_ext
 157 .\" config mon type
 158 .\" cmt change
 159 .\" font unpmv
 160 .\" non text
 161 .It
 162 Implement
 163 .Dq block move .
 164 .\" non-text
 165 .It
 166 Implement
 167 .Dq set colour-map entry .
 168 .Nm
 169 Implement word mode.
 170 .It
 171 Support for multiple monitors.
 172 .It
 173 Support
 174 .Nm user_data
 175 .Nm
 176 space usage.
 177 .It
 178 Support for extra memory.
 179 .It
 180 Support for
 181 .Nm Windows NT (tm) .
 182 .It
 183 Monitor frequency reference.
 184 .It
 185 Early console.
 186 .It
 187 Support added for: PCXL,
 188 .Nm GSC
 189 bus, ROM-less operation.
 190 .El
 191 .It 8.05
 192 .Bl -bullet -compact
 193 .It
 194 Interrupt support.
 195 .It
 196 Report card's power usage.
 197 .It
 198 Birds of Prey.
 199 .It
 200 User interrupts.
 201 .El
 202 .It 8.06
 203 .Bl -bullet -compact
 204 .It
 205 Multiple fonts.
 206 .It
 207 Monitor table descriptor strings.
 208 .It
 209 PCXL2 and PCXU monitor descriptors.
 210 .El
 211 .It 8.08
 212 .Bl -bullet -compact
 213 .It
 214 HP-UX 10 support for Visualize FX
 215 .It
 216 .Nm dma_ctrl
 217 function added.
 218 .It
 219 .Nm flow_ctrl
 220 function added.
 221 .It
 222 .Nm user_timing
 223 function added.
 224 .El
 225 .It 8.09
 226 .Bl -bullet -compact
 227 .It
 228 Addition changes for
 229 .Nm Visualize FX
 230 due to rearchitecture for performance.
 231 .It
 232 .Nm process_mgr
 233 function added.
 234 .El
 235 .It 8.0a
 236 PCXL2 and PCXU dual
 237 .Nm PCI
 238 EPROM map mode, implemented on
 239 .Nm Visualize EG .
 240 .It 8.0b
 241 Support for HP-UX non-implicit locking DMA, implemented on
 242 .Nm Visualize FXE .
 243 .It 8.0c
 244 .Nm sti_util
 245 function added (flashing under HP-UX and other sideband traffic).
 246 .It 8.0d
 247 Colour frame buffer support.
 248 .El
 249 .Sh SEE ALSO
 250 .Xr intro 4 ,
 251 .Xr phantomas 4 ,
 252 .Xr wsdisplay 4
 253 .Pp
 254 .Rs
 255 .%T Standard Text Interface For Graphics Devices
 256 .%N Revision 8.13
 257 .%D March 1, 2000
 258 .%I Hewlett-Packard
 259 .Re
 260 .Sh HISTORY
 261 The
 262 .Nm
 263 driver was written by
 264 .An Michael Shalayeff Aq mickey@openbsd.org
 265 for HPPA
 266 port for
 267 .Ox 2.7 .
 268 .Sh BUGS
 269 Currently, neither scroll back nor screen blanking functions
 270 are implemented.