1.\" $OpenBSD: sti.4,v 1.23 2011/12/30 20:06:11 miod 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: December 30 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.\" num mons 150.\" mon tbl 151.\" user data 152.\" sti mem req 153.\" user data size 154.\" maxtime 155.\" mon tbl desc struct 156.\" init_inptr 157.\" rename init_inptr_ext 158.\" init_inptr_ext 159.\" config mon type 160.\" cmt change 161.\" font unpmv 162.\" non text 163.It 164Implement 165.Dq block move . 166.\" non-text 167.It 168Implement 169.Dq set colour-map entry . 170.It 171Implement word mode. 172.It 173Support for multiple monitors. 174.It 175Support 176.Nm user_data 177.Nm 178space usage. 179.It 180Support for extra memory. 181.It 182Support for 183.Nm Windows NT (tm) . 184.It 185Monitor frequency reference. 186.It 187Early console. 188.It 189Support added for: PCXL, 190.Nm GSC 191bus, ROM-less operation. 192.El 193.It 8.05 194.Bl -bullet -compact 195.It 196Interrupt support. 197.It 198Report card's power usage. 199.It 200Birds of Prey. 201.It 202User interrupts. 203.El 204.It 8.06 205.Bl -bullet -compact 206.It 207Multiple fonts. 208.It 209Monitor table descriptor strings. 210.It 211PCXL2 and PCXU monitor descriptors. 212.El 213.It 8.08 214.Bl -bullet -compact 215.It 216HP-UX 10 support for Visualize FX 217.It 218.Nm dma_ctrl 219function added. 220.It 221.Nm flow_ctrl 222function added. 223.It 224.Nm user_timing 225function added. 226.El 227.It 8.09 228.Bl -bullet -compact 229.It 230Addition changes for 231.Nm Visualize FX 232due to rearchitecture for performance. 233.It 234.Nm process_mgr 235function added. 236.El 237.It 8.0a 238PCXL2 and PCXU dual 239.Nm PCI 240EPROM map mode, implemented on 241.Nm Visualize EG . 242.It 8.0b 243Support for HP-UX non-implicit locking DMA, implemented on 244.Nm Visualize FXE . 245.It 8.0c 246.Nm sti_util 247function added (flashing under HP-UX and other sideband traffic). 248.It 8.0d 249Colour frame buffer support. 250.El 251.Sh SEE ALSO 252.Xr dio 4 , 253.Xr intro 4 , 254.Xr pci 4 , 255.Xr phantomas 4 , 256.Xr sgc 4 , 257.Xr wsdisplay 4 258.Pp 259.Rs 260.%T Standard Text Interface For Graphics Devices 261.%N Revision 8.13 262.%D March 1, 2000 263.%I Hewlett-Packard 264.Re 265.Sh HISTORY 266The 267.Nm 268driver was written by 269.An Michael Shalayeff Aq mickey@openbsd.org 270for HPPA 271port for 272.Ox 2.7 . 273.\" .Pp 274.\" .Xr dio 4 , 275.\" .Xr pci 4 276.\" and 277.\" .Xr sgc 4 278.\" attachment code was written by 279.\" .An Miod Vallat . 280.Sh BUGS 281Currently, neither scroll back nor screen blanking functions 282are implemented. 283