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