1.\" $NetBSD: sti.4,v 1.1 2004/09/22 16:38:26 jkunz Exp $ 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 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 "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 74Implementation consists of a set of functions burnt in to the PROM 75on the card and providing the following set of functions (see below 76for PROM revision history on functions supported by particular PROM 77revision): 78.Pp 79.Bl -bullet -compact 80.It 81Initialize graphics. 82.It 83State management. 84.It 85Print a character onto the screen using currently selected font. 86.It 87Copy a region of the frame-buffer to another location. 88.It 89Self testing. 90.It 91Exception handling. 92.It 93Frame-buffer configuration enquiry. 94.It 95Setting colour-map entry. 96.It 97DMA parameters. 98.It 99Flow control. 100.It 101User timing. 102.It 103Processing management. 104.It 105Miscellaneous utility functions. 106.El 107.Pp 108There are two modes for accessing the PROM: 109.Dq byte 110and 111.Dq word 112mode. 113In 114.Dq byte 115mode each 4-byte word contains only the low-ordered big-endian 116byte of data; i.e., to compose one word of data 4 words should be read 117and low-ordered bytes of those should be shifted correspondingly. 118In 119.Dq word 120mode each word contains all 4 bytes of valid data. 121.Pp 122PROM revision history: 123.Bl -tag -width "00.00" -compact 124.It 8.02 125Original release. 126.It 8.03 127.Bl -bullet -compact 128.It 129OSF-extended self test (a.k.a fast). 130.It 131Restore 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 139Implement 140.Nm curr_mon 141function. 142.It 143Graphical 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 162Implement 163.Dq block move . 164.\" non-text 165.It 166Implement 167.Dq set colour-map entry . 168.Nm 169Implement word mode. 170.It 171Support for multiple monitors. 172.It 173Support 174.Nm user_data 175.Nm 176space usage. 177.It 178Support for extra memory. 179.It 180Support for 181.Nm Windows NT (tm) . 182.It 183Monitor frequency reference. 184.It 185Early console. 186.It 187Support added for: PCXL, 188.Nm GSC 189bus, ROM-less operation. 190.El 191.It 8.05 192.Bl -bullet -compact 193.It 194Interrupt support. 195.It 196Report card's power usage. 197.It 198Birds of Prey. 199.It 200User interrupts. 201.El 202.It 8.06 203.Bl -bullet -compact 204.It 205Multiple fonts. 206.It 207Monitor table descriptor strings. 208.It 209PCXL2 and PCXU monitor descriptors. 210.El 211.It 8.08 212.Bl -bullet -compact 213.It 214HP-UX 10 support for Visualize FX 215.It 216.Nm dma_ctrl 217function added. 218.It 219.Nm flow_ctrl 220function added. 221.It 222.Nm user_timing 223function added. 224.El 225.It 8.09 226.Bl -bullet -compact 227.It 228Addition changes for 229.Nm Visualize FX 230due to rearchitecture for performance. 231.It 232.Nm process_mgr 233function added. 234.El 235.It 8.0a 236PCXL2 and PCXU dual 237.Nm PCI 238EPROM map mode, implemented on 239.Nm Visualize EG . 240.It 8.0b 241Support for HP-UX non-implicit locking DMA, implemented on 242.Nm Visualize FXE . 243.It 8.0c 244.Nm sti_util 245function added (flashing under HP-UX and other sideband traffic). 246.It 8.0d 247Colour 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 261The 262.Nm 263driver was written by 264.An Michael Shalayeff Aq mickey@openbsd.org 265for HPPA 266port for 267.Ox 2.7 . 268.Sh BUGS 269Currently, neither scroll back nor screen blanking functions 270are implemented. 271