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