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