1*4882a593Smuzhiyun================= 2*4882a593SmuzhiyunWhat is aty128fb? 3*4882a593Smuzhiyun================= 4*4882a593Smuzhiyun 5*4882a593Smuzhiyun.. [This file is cloned from VesaFB/matroxfb] 6*4882a593Smuzhiyun 7*4882a593SmuzhiyunThis is a driver for a graphic framebuffer for ATI Rage128 based devices 8*4882a593Smuzhiyunon Intel and PPC boxes. 9*4882a593Smuzhiyun 10*4882a593SmuzhiyunAdvantages: 11*4882a593Smuzhiyun 12*4882a593Smuzhiyun * It provides a nice large console (128 cols + 48 lines with 1024x768) 13*4882a593Smuzhiyun without using tiny, unreadable fonts. 14*4882a593Smuzhiyun * You can run XF68_FBDev on top of /dev/fb0 15*4882a593Smuzhiyun * Most important: boot logo :-) 16*4882a593Smuzhiyun 17*4882a593SmuzhiyunDisadvantages: 18*4882a593Smuzhiyun 19*4882a593Smuzhiyun * graphic mode is slower than text mode... but you should not notice 20*4882a593Smuzhiyun if you use same resolution as you used in textmode. 21*4882a593Smuzhiyun * still experimental. 22*4882a593Smuzhiyun 23*4882a593Smuzhiyun 24*4882a593SmuzhiyunHow to use it? 25*4882a593Smuzhiyun============== 26*4882a593Smuzhiyun 27*4882a593SmuzhiyunSwitching modes is done using the video=aty128fb:<resolution>... modedb 28*4882a593Smuzhiyunboot parameter or using `fbset` program. 29*4882a593Smuzhiyun 30*4882a593SmuzhiyunSee Documentation/fb/modedb.rst for more information on modedb 31*4882a593Smuzhiyunresolutions. 32*4882a593Smuzhiyun 33*4882a593SmuzhiyunYou should compile in both vgacon (to boot if you remove your Rage128 from 34*4882a593Smuzhiyunbox) and aty128fb (for graphics mode). You should not compile-in vesafb 35*4882a593Smuzhiyununless you have primary display on non-Rage128 VBE2.0 device (see 36*4882a593SmuzhiyunDocumentation/fb/vesafb.rst for details). 37*4882a593Smuzhiyun 38*4882a593Smuzhiyun 39*4882a593SmuzhiyunX11 40*4882a593Smuzhiyun=== 41*4882a593Smuzhiyun 42*4882a593SmuzhiyunXF68_FBDev should generally work fine, but it is non-accelerated. As of 43*4882a593Smuzhiyunthis document, 8 and 32bpp works fine. There have been palette issues 44*4882a593Smuzhiyunwhen switching from X to console and back to X. You will have to restart 45*4882a593SmuzhiyunX to fix this. 46*4882a593Smuzhiyun 47*4882a593Smuzhiyun 48*4882a593SmuzhiyunConfiguration 49*4882a593Smuzhiyun============= 50*4882a593Smuzhiyun 51*4882a593SmuzhiyunYou can pass kernel command line options to vesafb with 52*4882a593Smuzhiyun`video=aty128fb:option1,option2:value2,option3` (multiple options should 53*4882a593Smuzhiyunbe separated by comma, values are separated from options by `:`). 54*4882a593SmuzhiyunAccepted options: 55*4882a593Smuzhiyun 56*4882a593Smuzhiyun========= ======================================================= 57*4882a593Smuzhiyunnoaccel do not use acceleration engine. It is default. 58*4882a593Smuzhiyunaccel use acceleration engine. Not finished. 59*4882a593Smuzhiyunvmode:x chooses PowerMacintosh video mode <x>. Deprecated. 60*4882a593Smuzhiyuncmode:x chooses PowerMacintosh colour mode <x>. Deprecated. 61*4882a593Smuzhiyun<XxX@X> selects startup videomode. See modedb.txt for detailed 62*4882a593Smuzhiyun explanation. Default is 640x480x8bpp. 63*4882a593Smuzhiyun========= ======================================================= 64*4882a593Smuzhiyun 65*4882a593Smuzhiyun 66*4882a593SmuzhiyunLimitations 67*4882a593Smuzhiyun=========== 68*4882a593Smuzhiyun 69*4882a593SmuzhiyunThere are known and unknown bugs, features and misfeatures. 70*4882a593SmuzhiyunCurrently there are following known bugs: 71*4882a593Smuzhiyun 72*4882a593Smuzhiyun - This driver is still experimental and is not finished. Too many 73*4882a593Smuzhiyun bugs/errata to list here. 74*4882a593Smuzhiyun 75*4882a593SmuzhiyunBrad Douglas <brad@neruo.com> 76