1.\" $NetBSD: ffb.4,v 1.3 2018/03/26 10:54:31 jdc 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 on 160.Sq Series 2 161and 162.Sq Series 3 163cards, and will automatically set a resolution that is supported by both the 164card and the monitor if the 165.Dv EDID 166data can be read. 167This can be overridden for the console frame buffer, by setting the 168.Dv output-device 169openprom variable. 170For example, the following openprom command will set the console resolution 171to 1280x1024 @ 60Hz, which will not be altered by the 172.Nm 173driver. 174.Bd -literal -offset indent 175setenv output-device screen:r1280x1024x60 176.Ed 177.Sh SEE ALSO 178.Xr eeprom 8 179.Sh BUGS 180It is necessary to blank the video output when reading 181.Dv EDID 182data. 183.Pp 184The 185.Nm 186driver does not support 3D acceleration. 187.Pp 188Not all 189.Dv 13W3 190to 191.Dv VGA 192converters connect 193.Dv 13W3 194pin 2 to 195.Dv VGA 196pin 9. 197This pin supplies +5V DC to power the monitor 198.Dv EEPROM , 199even when the monitor 200is powered off, and is necessary in order to obtain 201.Dv EDID 202data on some monitors. 203.Pp 204Adapters that are known to connect these pins are: 205.Pp 206.Bl -tag -offset indent -compact 207.It 530-2917 208.Dv 13W3 209cable 210.It 130-3034 211.Dv VGA 212cable 213.El 214.Pp 215Adapters that are known not to connect these pins are: 216.Pp 217.Bl -tag -offset indent -compact 218.It 530-2357 219.Dv 13W3 220cable 221.El 222