NAME

gpx − gpx graphics display station

SYNOPSIS

Configuration file entry:
device gpx0 at vba0 csr 0x97300000
device gpx1 at vba0 csr 0x9eb00000
device gpx2 at vba0 csr 0x9f300000
device gpx3 at vba0 csr 0x9fb00000

DESCRIPTION

The GPX integrated graphics controller and devices provide a bitmapped color graphics display with associated keyboard.  The display and keyboard may combine to operate as a user terminal as described in console(7), display(7), and termio(7). 

Installation

A GPX display station consists of a display monitor connected to the Integrated SCSI/Ethernet/Graphics (ISEG) daughter-board and, optionally, a keyboard connected to either of the tty ports (UARTs) on the same processor board.  Up to four display stations may be configured on a Night Hawk system, one per processor board. 

A DIP switch on the ISEG daughter-board determines which of the two tty ports is associated with the display station.  The keyboard connected to that port should generate make-break codes compatible with the PC/AT-02. 

The system configuration file should have a device entry line for each GPX display station, as shown in the SYNOPSIS section above.  The minor number (the digit at the end of the device name) should be the number of the processor board to which the display station is connected. 

When configured as a user terminal, an instance of the getty(1M) program may be started by init(1M) via an /etc/inittab entry (see gettydefs(4) and inittab(4)).  Use the 9600L entry in the /etc/gettydefs file. 

Device Control

The /dev/gpxn devices accept the following ioctl(2) commands.  Argument structures are defined in the header file <sys/gpx.h>. 

GPX_RESET Reset device to power on state.  The graphics processor is reset to its initial operating state, the screen is cleared, and the terminal mode cursor is placed in the upper left character position.  For a hard reset, indicated by an argument value of GPX_HARD_RESET, the video parameters and color map are also reset to their initial values.  For a soft reset, indicated by an argument value of GPX_SOFT_RESET, the video parameters and color map are unchanged. 

GPX_MAP Map the graphics processor registers, video control registers, or frame buffer into the user’s virtual memory address space.  The argument value is a pointer to a GpxMapSegment structure containing two fields.  SegmentID should be set by the application to a value that identifies which area of the graphics processor’s memory and register space is to be mapped; valid segment identifiers are listed in <sys/gpx.h>.  Address should be initialized to 0 (unless the caller wishes to specify the virtual address at which the segment should be mapped); it is set by the operating system to the user’s memory address at which the area is mapped. 

GPX_UNMAP
Release the virtual memory address space used for the graphics processor registers, video control registers, and frame buffer. The argument value is a pointer to a GpxMapSegment structure that was returned by a prior use of GPX_MAP. 

GPX_GET_PARMS
Obtain the current device and video configuration. The argument value is a pointer to a GpxParms structure which is filled in by the system. 

GPX_SET_PARMS
Set the current device and video configuration. The argument value is a pointer to a GpxParms structure, usually one which was filled in by a prior use of GPX_GET_PARMS and then modified. 

GPX_GET_COLORMAP
Obtain the current color map table. The argument value is a pointer to a GpxColorMap structure which contains the number of entries in the color map followed by an array of entries.  The structure also contains the colors used for the foreground, background, and text cursor when the gpx device is operated as a user terminal.  There can be up to 256 entries in a color map. 

GPX_SET_COLORMAP
Set the color map. The argument value is a pointer to a GpxColorMap structure, usually one which was filled in by a prior use of GPX_GET_COLORMAP and then modified. 

GPX_GET_OVERLAY_COLORMAP
Obtain the current overlay color map table. The argument value is a pointer to a GpxColorMap structure which contains the number of entries in the overlay color map followed by an array of entries.  There can be up to 256 entries in a color map.  The foreground, background, and cursor color fields of the GpxColorMap structure are not used with the overlay color map. 

GPX_SET_OVERLAY_COLORMAP
Set the overlay color map. The argument value is a pointer to a GpxColorMap structure, usually one which was filled in by a prior use of GPX_GET_OVERLAY_COLORMAP and then modified. 

FILES

/dev/gpx[0-3] device files

<sys/gpx.h> header file describing gpx control structures

<sys/mb86990.h>
header file describing graphics processor registers

<sys/brooktree.h>
header file describing RAMDAC registers

SEE ALSO

gpxconfig(1) in the CX/UX User’s Reference Manual.

console(7), display(7), iseg(7), keyboard(7), termio(7). 

CX/UX Administrator’s Reference