1.\" $OpenBSD: mgx.4,v 1.12 2008/04/15 20:23:53 miod Exp $ 2.\" 3.\" Copyright (c) 2003, 2005 Miodrag Vallat 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" notice, this list of conditions and the following disclaimer in the 12.\" documentation and/or other materials provided with the distribution. 13.\" 14.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 15.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 16.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 17.\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, 18.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 19.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 20.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 22.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN 23.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 24.\" POSSIBILITY OF SUCH DAMAGE. 25.\" 26.Dd $Mdocdate: April 15 2008 $ 27.Dt MGX 4 sparc64 28.Os 29.Sh NAME 30.Nm mgx 31.Nd SMS MGX and MGXPlus accelerated 8/24-bit color frame buffers 32.Sh SYNOPSIS 33.Cd "mgx* at sbus?" 34.Cd "wsdisplay* at mgx?" 35.Sh DESCRIPTION 36The 37.Tn Southland Media Systems 38.Pq now Tn "Quantum 3D" 39MGX and MGXPlus are SBus color frame buffers, with graphics acceleration 40capabilities. 41.Pp 42The 43.Nm 44driver interfaces the frame buffer with the 45.Xr wscons 4 46console framework. 47It does not provide direct device driver entry points 48but makes its functions available via the internal 49.Xr wsdisplay 4 50interface. 51.Sh DISPLAY RESOLUTION 52The MGX and MGXPlus frame buffers will adapt their resolution to the monitor 53they are connected to. 54However, when not connected to a Sun monitor, the device will default to the 55.Xr cgthree 4 -compatible 561152x900 resolution, with a refresh rate of 66Hz. 57A different resolution can be forced using the set of DIP switches 58.Pq sometimes covered by metal foil 59located near the SBus connector on the board itself. 60.Pp 61The DIP switch settings are as follows: 62.Bl -column " 1 2 3 4" "Resolution" "Refresh" 63.It Li Switches Ta Resolution Ta Refresh Ta Details 64.It Li " 1 2 3 4" Ta "" Ta "Rate" Ta "" 65.It " " 66.\" 0 67.It Li "OFF OFF OFF OFF" Ta 1024x768 Ta 77Hz 68.\" 2 69.It Li "OFF ON OFF OFF" Ta 1280x1024 Ta 76Hz 70.\" 3 (exactly the same as #7. Not a typo) 71.It Li "ON ON OFF OFF" Ta 1152x900 Ta 66Hz 72.\" 4 73.It Li "OFF OFF ON OFF" Ta 1152x900 Ta 76Hz 74.\" 6 75.It Li "OFF ON ON OFF" Ta 1152x900 Ta 77Hz 76.\" 7 77.It Li "ON ON ON OFF" Ta 1152x900 Ta 66Hz Ta cgthree compatible 78.\" 11 79.It Li "ON ON OFF ON " Ta 1152x900 Ta 66Hz Ta cgsix compatible 80.\" 12 81.It Li "OFF OFF ON ON " Ta 1280x1024 Ta 67Hz 82.\" 15 83.It Li "ON ON ON ON " Ta probed Ta probed Ta factory default 84.El 85.Pp 86All other combinations are unsupported and may damage the hardware. 87.Sh SEE ALSO 88.Xr intro 4 , 89.Xr sbus 4 , 90.Xr wscons 4 , 91.Xr wsdisplay 4 92.Sh CAVEATS 93This driver does not support mode switching at the moment, and 94drives the card in PROM-compatible, 8 bit, mode only. 95