blob: 069262fb619dfce82735bef6e639aa6abf6fc8f5 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001[This file is cloned from VesaFB/matroxfb]
2
3What is aty128fb?
4=================
5
6This is a driver for a graphic framebuffer for ATI Rage128 based devices
7on Intel and PPC boxes.
8
9Advantages:
10
11 * It provides a nice large console (128 cols + 48 lines with 1024x768)
12 without using tiny, unreadable fonts.
13 * You can run XF68_FBDev on top of /dev/fb0
14 * Most important: boot logo :-)
15
16Disadvantages:
17
18 * graphic mode is slower than text mode... but you should not notice
19 if you use same resolution as you used in textmode.
20 * still experimental.
21
22
23How to use it?
24==============
25
26Switching modes is done using the video=aty128fb:<resolution>... modedb
27boot parameter or using `fbset' program.
28
29See Documentation/fb/modedb.txt for more information on modedb
30resolutions.
31
32You should compile in both vgacon (to boot if you remove your Rage128 from
33box) and aty128fb (for graphics mode). You should not compile-in vesafb
34unless you have primary display on non-Rage128 VBE2.0 device (see
35Documentation/fb/vesafb.txt for details).
36
37
38X11
39===
40
41XF68_FBDev should generally work fine, but it is non-accelerated. As of
42this document, 8 and 32bpp works fine. There have been palette issues
43when switching from X to console and back to X. You will have to restart
44X to fix this.
45
46
47Configuration
48=============
49
50You can pass kernel command line options to vesafb with
51`video=aty128fb:option1,option2:value2,option3' (multiple options should
52be separated by comma, values are separated from options by `:').
53Accepted options:
54
55noaccel - do not use acceleration engine. It is default.
56accel - use acceleration engine. Not finished.
57vmode:x - chooses PowerMacintosh video mode <x>. Depreciated.
58cmode:x - chooses PowerMacintosh colour mode <x>. Depreciated.
59<XxX@X> - selects startup videomode. See modedb.txt for detailed
60 explanation. Default is 640x480x8bpp.
61
62
63Limitations
64===========
65
66There are known and unknown bugs, features and misfeatures.
67Currently there are following known bugs:
68 + This driver is still experimental and is not finished. Too many
69 bugs/errata to list here.
70
71--
72Brad Douglas <brad@neruo.com>