1.\" $OpenBSD: sti.4,v 1.3 2001/08/03 15:21:16 mpech 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.\" 3. All advertising materials mentioning features or use of this software 15.\" must display the following acknowledgement: 16.\" This product includes software developed by Michael Shalayeff. 17.\" 4. The name of the author may not be used to endorse or promote products 18.\" derived from this software without specific prior written permission. 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 21.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 22.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 23.\" IN NO EVENT SHALL THE AUTHOR OR HIS RELATIVES BE LIABLE FOR ANY DIRECT, 24.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 25.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 26.\" SERVICES; LOSS OF MIND, USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 28.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 29.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 30.\" THE POSSIBILITY OF SUCH DAMAGE. 31.\" 32.Dd May 11, 2001 33.Dt STI 4 34.Os 35.Sh NAME 36.Nm sti 37.Nd HP Standard Text Interface 38.Sh SYNOPSIS 39.Cd "sti* at mainbus0 irq ?" 40.\" .Cd "sti* at pci? device ? function ?" 41.Cd "wsdisplay* at sti? console ?" 42.Sh DESCRIPTION 43The 44.Nm 45was created by HP to provide uniform frame-buffer access operations 46for their 9000/300 and 9000/700 series of workstations. 47Implementation consists of a set of functions burnt in to the PROM 48on the card and providing the following set of functions (see below 49for PROM revision history on functions supported by particular PROM 50revision): 51.Pp 52.Bl -bullet -compact 53.It 54Initialize graphics. 55.It 56State management. 57.It 58Print a character onto the screen using currently selected font. 59.It 60Copy a region of the frame-buffer to another location. 61.It 62Self testing. 63.It 64Exception handling. 65.It 66Frame-buffer configuration enquiry. 67.It 68Setting colour-map entry. 69.It 70DMA parameters. 71.It 72Flow control. 73.It 74User timing. 75.It 76Processing management. 77.It 78Miscellaneous utility functions. 79.El 80.Pp 81There are two modes for accessing the PROM: 82.Dr byte 83and 84.Dq word 85mode. 86In 87.Dq byte 88mode each 4-byte word contains only the low-ordered big-endian 89byte of data; i.e., to compose one word of data 4 words should be read 90and low-ordered bytes of those should be shifted correspondingly. 91In 92.Dq word 93mode each word contains all 4 bytes of valid data. 94.Pp 95PROM revision history: 96.Bl -tag -width "00.00" -compact 97.It 8.02 98Original release. 99.It 8.03 100.Bl -bullet -compact 101.It 102OSF-extended self test (a.k.a fast). 103.It 104Restore display. 105.El 106.It 8.04 107.Bl -bullet -compact 108.\" global cfg 109.\" rename global cfg ext 110.\" global cfg ext 111.It 112Implement 113.Nm curr_mon 114function. 115.\" friendly boot 116.\" sti_mem_addr 117.\" dd 118.\" word mode 119.\" num mons 120.\" mon tbl 121.\" user data 122.\" sti mem req 123.\" user data size 124.\" maxtime 125.\" mon tbl desc struct 126.\" init_inptr 127.\" rename init_inptr_ext 128.\" init_inptr_ext 129.\" config mon type 130.\" cmt change 131.\" font unpmv 132.\" non text 133.It 134Implement 135.Dq block move . 136.\" non-text 137.It 138Implement 139.Dq set colour-map entry . 140.Nm 141Implement word mode. 142.It 143Support for multiple monitors. 144.It 145Support 146.Nm user_data 147.Nm 148space usage. 149.It 150Support for extra memory. 151.It 152Support for 153.Nm Windows NT (tm) . 154.It 155Monitor frequency reference. 156.It 157Early console. 158.It 159Support added for: PCXL, 160.Nm GSC 161bus, ROM-less operation. 162.El 163.It 8.05 164.Bl -bullet -compact 165.It 166Interrupt support. 167.It 168Report card's power usage. 169.It 170Birds of Prey. 171.It 172User interrupts. 173.El 174.It 8.06 175.Bl -bullet -compact 176.It 177Multiple fonts. 178.It 179Monitor table descriptor strings. 180.It 181PCXL2 and PCXU monitor descriptors. 182.El 183.It 8.08 184.Bl -bullet -compact 185.It 186HP/UX 10 support for Visualize FX 187.It 188.Nm dma_ctrl 189function added. 190.It 191.Nm flow_ctrl 192function added. 193.It 194.Nm user_timing 195function added. 196.El 197.It 8.09 198.Bl -bullet -compact 199.It 200Addition changes for 201.Nm Visualize FX 202due to rearchitecture for performance. 203.It 204.Nm process_mgr 205function added. 206.El 207.It 8.0a 208PCXL2 and PCXU dual 209.Nm PCI 210EPROM map mode, implemented on 211.Nm Visualize EG . 212.It 8.0b 213Support for HP-UX non-implicit locking DMA, implemented on 214.Nm Visualize FXE . 215.It 8.0c 216.Nm sti_util 217function added (flashing under HP-UX and other sideband traffic). 218.It 8.0d 219Colour frame buffer support. 220.El 221.Sh SEE ALSO 222.Xr intro 4 , 223.Xr wsdisplay 4 . 224.Pp 225"Standard Text Interface For Graphics Devices", 226Revision 8.13, March 1, 2000, Hewlett Packard 227.Sh BUGS 228Currently none of the font loading, scroll back or screen blanking 229is implemented. 230.Sh HISTORY 231The 232.Nm 233driver was written by 234.An Michael Shalayeff Aq mickey@openbsd.org 235for 236.Xr hppa 4 237port for 238.Ox 2.7 . 239