STI(4)                  NetBSD Kernel Interfaces Manual                 STI(4)

NAME
     sti -- HP Standard Text Interface

SYNOPSIS
     sti* at mainbus0 irq ?
     sti* at phantomas0 irq ?
     wsdisplay*     at sti? console ?

DESCRIPTION
     The sti was created by HP to provide uniform frame-buffer access opera-
     tions for their 9000/300 and 9000/700 series of workstations.

     The following models are supported (though not all features or frame
     buffer depths may be available):

         Model               Bits   Mem   3D   Machines/Cards
         GRX                 8g     2          SGC
         CRX                 8      2          SGC
         Tomcat              8      2          SGC
         Stinger             8      2          HP9000/7[12]5/74[257]i
         Artist              8      2          HP9000/712/7[12]5/74[38]i
         CRX-24              24     16         SGC
         HCRX-8              8      2          GSC
         HCRX-24             24     16         GSC
         Visualize EG        16     2          HP B/C-class, GSC/PCI

     Implementation consists of a set of functions burnt in to the PROM on the
     card and providing the following set of functions (see below for PROM
     revision history on functions supported by particular PROM revision):

     o   Initialize graphics.
     o   State management.
     o   Print a character onto the screen using currently selected font.
     o   Copy a region of the frame-buffer to another location.
     o   Self testing.
     o   Exception handling.
     o   Frame-buffer configuration enquiry.
     o   Setting colour-map entry.
     o   DMA parameters.
     o   Flow control.
     o   User timing.
     o   Processing management.
     o   Miscellaneous utility functions.

     There are two modes for accessing the PROM: ``byte'' and ``word'' mode.
     In ``byte'' mode each 4-byte word contains only the low-ordered big-
     endian byte of data; i.e., to compose one word of data 4 words should be
     read and low-ordered bytes of those should be shifted correspondingly.
     In ``word'' mode each word contains all 4 bytes of valid data.

     PROM revision history:
     8.02
       Original release.
     8.03
       o   OSF-extended self test (a.k.a fast).
       o   Restore display.
     8.04
       o   Implement curr_mon function.
       o   Graphical boot screen.
       o   Implement ``block move''.
       o   Implement ``set colour-map entry''.  sti Implement word mode.
       o   Support for multiple monitors.
       o   Support user_data sti space usage.
       o   Support for extra memory.
       o   Support for Windows NT (tm).
       o   Monitor frequency reference.
       o   Early console.
       o   Support added for: PCXL, GSC bus, ROM-less operation.
     8.05
       o   Interrupt support.
       o   Report card's power usage.
       o   Birds of Prey.
       o   User interrupts.
     8.06
       o   Multiple fonts.
       o   Monitor table descriptor strings.
       o   PCXL2 and PCXU monitor descriptors.
     8.08
       o   HP-UX 10 support for Visualize FX
       o   dma_ctrl function added.
       o   flow_ctrl function added.
       o   user_timing function added.
     8.09
       o   Addition changes for Visualize FX due to rearchitecture for perfor-
           mance.
       o   process_mgr function added.
     8.0a
       PCXL2 and PCXU dual PCI EPROM map mode, implemented on Visualize EG.
     8.0b
       Support for HP-UX non-implicit locking DMA, implemented on Visualize
       FXE.
     8.0c
       sti_util function added (flashing under HP-UX and other sideband traf-
       fic).
     8.0d
       Colour frame buffer support.

SEE ALSO
     intro(4), phantomas(4), wsdisplay(4)

     Standard Text Interface For Graphics Devices, Hewlett-Packard, Revision
     8.13, March 1, 2000.

HISTORY
     The sti driver was written by Michael Shalayeff <mickey@openbsd.org> for
     HPPA port for OpenBSD 2.7.

BUGS
     Currently, neither scroll back nor screen blanking functions are imple-
     mented.

NetBSD 5.0_STABLE                May 11, 2001                NetBSD 5.0_STABLE
