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