1.\" $NetBSD: sti.4,v 1.2 2010/11/09 12:24:47 skrll Exp $ 2.\" $OpenBSD: sti.4,v 1.19 2007/05/31 19:19:52 jmc 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 November 9, 2010 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" 36.Cd "sti* at phantomas?" 37.Cd "sti* at pci?" 38.Cd "wsdisplay* at sti?" 39.Sh DESCRIPTION 40The 41.Nm 42was created by HP to provide uniform frame-buffer access operations 43for their 9000/300 and 9000/700 series of workstations. 44.Pp 45The 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 "EVRX" Ta "8" Ta "2" Ta "" Ta "HP9000/425e" 50.\" .It "Timber" Ta "8" Ta "2" Ta "" Ta "HP9000/705/710" 51.It "GRX" Ta "8g" Ta "2" Ta "" Ta "SGC" 52.It "CRX" Ta "8" Ta "2" Ta "" Ta "SGC" 53.It "Tomcat" Ta "8" Ta "2" Ta "" Ta "SGC" 54.It "Stinger" Ta "8" Ta "2" Ta "" Ta "HP9000/7[12]5/74[257]i" 55.It "Artist" Ta "8" Ta "2" Ta "" Ta "HP9000/712/7[12]5/74[38]i" 56.It "CRX-24" Ta "24" Ta "16" Ta "" Ta "SGC" 57.\" .It "CRX-24Z" Ta "24" Ta "16" Ta "y" Ta "SGC" 58.\" .It "CRX-48Z" Ta "24" Ta "16" Ta "y" Ta "SGC/GSC" 59.It "HCRX-8" Ta "8" Ta "2" Ta "" Ta "GSC" 60.\" .It "HCRX-8Z" Ta "8" Ta "2" Ta "y" Ta "GSC" 61.It "HCRX-24" Ta "24" Ta "16" Ta "" Ta "GSC" 62.\" .It "HCRX-24Z" Ta "24" Ta "16" Ta "y" Ta "GSC" 63.\" .It "Visualize 8" Ta "8" Ta "2" Ta "y" Ta "GSC" 64.It "Visualize EG" Ta "16" Ta "2" Ta "" Ta "HP B/C-class, GSC/PCI" 65.\" .It "Visualize 24" Ta "24" Ta "16" Ta "y" Ta "GSC" 66.\" .It "Visualize 48" Ta "24" Ta "16" Ta "y" Ta "GSC" 67.\" .It "Visualize 48XP" Ta "24" Ta "16" Ta "y" Ta "GSC" 68.It "Visualize FXE" Ta "24" Ta "24" Ta "y" Ta "PCI 32/66" 69.It "Visualize FX2" Ta "24" Ta "24" Ta "y" Ta "PCI 64/66" 70.It "Visualize FX4/FX6" Ta "24" Ta "32" Ta "y" Ta "PCI 64/66" 71.\" .It "Visualize FX5pro" Ta "24" Ta "64" Ta "y" Ta "PCI 64/66" 72.\" .It "Visualize FX10pro" Ta "24" Ta "128" Ta "y" Ta "PCI 64/66" 73.El 74.Pp 75Implementation consists of a set of functions burnt in to the PROM 76on the card and providing the following set of functions (see below 77for PROM revision history on functions supported by particular PROM 78revision): 79.Pp 80.Bl -bullet -compact 81.It 82Initialize graphics. 83.It 84State management. 85.It 86Print a character onto the screen using currently selected font. 87.It 88Copy a region of the frame-buffer to another location. 89.It 90Self testing. 91.It 92Exception handling. 93.It 94Frame-buffer configuration enquiry. 95.It 96Setting colour-map entry. 97.It 98DMA parameters. 99.It 100Flow control. 101.It 102User timing. 103.It 104Processing management. 105.It 106Miscellaneous utility functions. 107.El 108.Pp 109There are two modes for accessing the PROM: 110.Dq byte 111and 112.Dq word 113mode. 114In 115.Dq byte 116mode each 4-byte word contains only the low-ordered big-endian 117byte of data; i.e., to compose one word of data 4 words should be read 118and low-ordered bytes of those should be shifted correspondingly. 119In 120.Dq word 121mode each word contains all 4 bytes of valid data. 122.Pp 123PROM revision history: 124.Bl -tag -width "00.00" -compact 125.It 8.02 126Original release. 127.It 8.03 128.Bl -bullet -compact 129.It 130OSF-extended self test (a.k.a fast). 131.It 132Restore display. 133.El 134.It 8.04 135.Bl -bullet -compact 136.\" global cfg 137.\" rename global cfg ext 138.\" global cfg ext 139.It 140Implement 141.Nm curr_mon 142function. 143.It 144Graphical boot screen. 145.\" sti_mem_addr 146.\" dd 147.\" word mode 148.\" num mons 149.\" mon tbl 150.\" user data 151.\" sti mem req 152.\" user data size 153.\" maxtime 154.\" mon tbl desc struct 155.\" init_inptr 156.\" rename init_inptr_ext 157.\" init_inptr_ext 158.\" config mon type 159.\" cmt change 160.\" font unpmv 161.\" non text 162.It 163Implement 164.Dq block move . 165.\" non-text 166.It 167Implement 168.Dq set colour-map entry . 169.Nm 170Implement word mode. 171.It 172Support for multiple monitors. 173.It 174Support 175.Nm user_data 176.Nm 177space usage. 178.It 179Support for extra memory. 180.It 181Support for 182.Nm Windows NT (tm) . 183.It 184Monitor frequency reference. 185.It 186Early console. 187.It 188Support added for: PCXL, 189.Nm GSC 190bus, ROM-less operation. 191.El 192.It 8.05 193.Bl -bullet -compact 194.It 195Interrupt support. 196.It 197Report card's power usage. 198.It 199Birds of Prey. 200.It 201User interrupts. 202.El 203.It 8.06 204.Bl -bullet -compact 205.It 206Multiple fonts. 207.It 208Monitor table descriptor strings. 209.It 210PCXL2 and PCXU monitor descriptors. 211.El 212.It 8.08 213.Bl -bullet -compact 214.It 215HP-UX 10 support for Visualize FX 216.It 217.Nm dma_ctrl 218function added. 219.It 220.Nm flow_ctrl 221function added. 222.It 223.Nm user_timing 224function added. 225.El 226.It 8.09 227.Bl -bullet -compact 228.It 229Addition changes for 230.Nm Visualize FX 231due to rearchitecture for performance. 232.It 233.Nm process_mgr 234function added. 235.El 236.It 8.0a 237PCXL2 and PCXU dual 238.Nm PCI 239EPROM map mode, implemented on 240.Nm Visualize EG . 241.It 8.0b 242Support for HP-UX non-implicit locking DMA, implemented on 243.Nm Visualize FXE . 244.It 8.0c 245.Nm sti_util 246function added (flashing under HP-UX and other sideband traffic). 247.It 8.0d 248Colour frame buffer support. 249.El 250.Sh SEE ALSO 251.Xr intro 4 , 252.Xr phantomas 4 , 253.Xr wsdisplay 4 254.Pp 255.Rs 256.%T Standard Text Interface For Graphics Devices 257.%N Revision 8.13 258.%D March 1, 2000 259.%I Hewlett-Packard 260.Re 261.Sh HISTORY 262The 263.Nm 264driver was written by 265.An Michael Shalayeff Aq mickey@openbsd.org 266for HPPA 267port for 268.Ox 2.7 . 269.Sh BUGS 270Currently, neither scroll back nor screen blanking functions 271are implemented. 272