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