1.\" $OpenBSD: sti.4,v 1.25 2014/03/19 12:57:51 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: March 19 2014 $ 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 pci?" 36.Cd "sti* at phantomas0" 37.Cd "wsdisplay* at sti?" 38.Sh DESCRIPTION 39The 40.Nm 41was created by HP to provide uniform frame-buffer access operations 42for their 9000/300 and 9000/700 series of workstations. 43.Pp 44The following models are supported 45(though not all features or frame buffer depths may be available): 46.Bl -column "Visualize FX4/FX6" "Bits" "Mem" "3D" "Machines/Cards" -offset left 47.It Sy "Model" Ta Sy "Bits" Ta Sy "Mem" Ta Sy "3D" Ta Sy "Machines/Cards" 48.It "VRX" Ta 8 Ta "2" Ta "" Ta "HP9000/362/382" 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.\" 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.It 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 pci 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 Mt mickey@openbsd.org 266for HPPA 267port for 268.Ox 2.7 . 269.\" .Pp 270.\" .Xr pci 4 271.\" attachment code was written by 272.\" .An Miod Vallat . 273.Sh BUGS 274Currently, neither scroll back nor screen blanking functions 275are implemented. 276