1.\" $NetBSD: ffb.4,v 1.2 2011/04/09 21:53:58 wiz Exp $ 2.\" 3.\" Copyright (c) 2011 The NetBSD Foundation, Inc. 4.\" All rights reserved. 5.\" 6.\" This code is derived from software contributed to The NetBSD Foundation 7.\" by Julian Coleman 8.\" 9.\" Redistribution and use in source and binary forms, with or without 10.\" modification, are permitted provided that the following conditions 11.\" are met: 12.\" 1. Redistributions of source code must retain the above copyright 13.\" notice, this list of conditions and the following disclaimer. 14.\" 2. Redistributions in binary form must reproduce the above copyright 15.\" notice, this list of conditions and the following disclaimer in the 16.\" documentation and/or other materials provided with the distribution. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28.\" POSSIBILITY OF SUCH DAMAGE. 29.\" 30.Dd April 1, 2011 31.Dt FFB 4 sparc64 32.Os 33.Sh NAME 34.Nm ffb 35.Nd Sun accelerated 24-bit color frame buffer 36.Sh SYNOPSIS 37.Cd "ffb* at mainbus0 addr 0xff8de000: Creator3D, model SUNW,501-4790, dac 10" 38.Pq UltraSPARC II horizontal 39.Cd "ffb* at mainbus0 addr 0xfeb80000: Creator3D, model SUNW,501-4788, dac 10" 40.Pq UltraSPARC II vertical 41.Cd "ffb* at mainbus0: Elite3D, model SUNW,540-3623, dac 10" 42.Pq UltraSPARC II vertical 43.Cd "ffb* at upa0: Creator3D, model SUNW,501-4788, dac 10" 44.Pq UltraSPARC III vertical 45.Cd "ffb* at upa0: Elite3D, model SUNW,540-3623, dac 10" 46.Pq UltraSPARC III vertical 47.Sh DESCRIPTION 48The 49.Nm 50is a UPA based color frame buffer, found in some Sun SBus and PCI systems. 51The 52.Nm 53driver supports both the Creator/Creator3D, and the Elite3D frame buffers. 54.Pp 55There are several versions of the 56.Nm 57board. 58The Sun part numbers and board types are: 59.Pp 60.Bl -tag -offset indent -compact 61.It 501-2634 62Creator Series 1 (FFB) 63.It " " 64Ultra1, Ultra2 65.It 501-4127 66Creator Series 1 (FFB) 67.It " " 68Ultra1, Ultra2, Enterprisexx00 69.It 501-2633 70Creator 3D Series 1 (FFB) 71.It " " 72Ultra1, Ultra2 73.It 501-3129 74Creator 3D Series 1 (FFB) 75.It " " 76Ultra1, Ultra2, Enterprisexx00 77.It 501-4126 78Creator 3D Series 1 (FFB) 79.It " " 80Ultra1, Ultra2 81.It 501-4174 82Creator Series 2 (FFB2) 83.It " " 84Ultra 30, Ultra 60 85.It 501-4173 86Creator3D Series 2 (FFB2) 87.It " " 88Ultra1, Ultra2, Enterprisexx00 89.It 501-4172 90Creator3D Series 2 (FFB2) 91.It " " 92Ultra30, Ultra60 93.It 501-4789 94Creator Series 3 (FFB2+) 95.It " " 96Ultra10, Ultra30, Ultra60 97.It 501-4790 98Creator 3D Series 3 (FFB2+) 99.It " " 100Ultra2, Enterprisexx00 101.It 501-4788, 501-5690 102Creator 3D Series 3 (FFB2+) 103.It " " 104Ultra10, Ultra30, Ultra60, Blade1000, Blade2000 105.It 501-4860, 501-5268, 501-5201, 501-5484 106Elite3D-m3 Series 1 (AFB) 107.It " " 108Ultra10, Ultra30, Ultra60, Ultra80 109.It 540-3623, 540-3902 110Elite3D-m6 Series 1 (AFB) 111.It " " 112Ultra10, Ultra30, Ultra60, Ultra80 113.It 501-5574, 501-5575 114Elite3D-m3 Series 2 (AFB) 115.It " " 116Ultra10, Ultra30, Ultra60, Ultra80, Blade1000, Blade2000 117.It 540-4313 118Elite3D-m6 Series 2 (AFB) 119.It " " 120Ultra10, Ultra30, Ultra60, Ultra80, Blade1000, Blade2000 121.It 540-3058, 540-3979, 540-4335 122Elite3D-m6 (AFB) 123.It " " 124Ultra2, Ultra450, Enterprisexx00 125.El 126.Pp 127The 128.Sq Creator 129cards have 5MB of on-board memory, support a maximum graphics resolution 130of 1280x1024, and are single-buffered. 131.Pp 132The 133.Sq Creator3D 134cards have 15MB of on-board memory support a maximum resolution of 1351280x1024 double-buffered, and 1920x1360 single-buffered. 136.Pp 137The 138.Sq Elite3D 139cards have 15MB of on-board memory, support a maximum resolution of 1401280x1024, and are always double-buffered. 141The 142.Sq Elite3D-m3 143cards have one hardware geometry engine, whereas the 144.Sq Elite3D-m6 145cards have two. 146.Pp 147The 148.Sq Series 3 149cards are considerably faster than the 150.Sq Series 1 151and 152.Sq Series 2 153cards. 154.Pp 155The 156.Nm 157driver supports reading 158.Dv EDID 159data from connected monitors, and will automatically set a resolution that is 160supported by both the card and the monitor if the 161.Dv EDID 162data can be read. 163This can be overridden for the console frame buffer, by setting the 164.Dv output-device 165openprom variable. 166For example, the following openprom command will set the console resolution 167to 1280x1024 @ 60Hz, which will not be altered by the 168.Nm 169driver. 170.Bd -literal -offset indent 171setenv output-device screen:r1280x1024x60 172.Ed 173.Sh SEE ALSO 174.Xr eeprom 8 175.Sh BUGS 176It is necessary to blank the video output when reading 177.Dv EDID 178data. 179.Pp 180The 181.Nm 182driver does not support 3D acceleration. 183.Pp 184Not all 185.Dv 13W3 186to 187.Dv VGA 188converters connect 189.Dv 13W3 190pin 2 to 191.Dv VGA 192pin 9. 193This pin supplies +5V DC to power the monitor 194.Dv EEPROM , 195even when the monitor 196is powered off, and is necessary in order to obtain 197.Dv EDID 198data on some monitors. 199.Pp 200Adapters that are known to connect these pins are: 201.Pp 202.Bl -tag -offset indent -compact 203.It 530-2917 204.Dv 13W3 205cable 206.It 130-3034 207.Dv VGA 208cable 209.El 210.Pp 211Adapters that are known not to connect these pins are: 212.Pp 213.Bl -tag -offset indent -compact 214.It 530-2357 215.Dv 13W3 216cable 217.El 218