0001 =================
0002 What is aty128fb?
0003 =================
0004
0005 .. [This file is cloned from VesaFB/matroxfb]
0006
0007 This is a driver for a graphic framebuffer for ATI Rage128 based devices
0008 on Intel and PPC boxes.
0009
0010 Advantages:
0011
0012 * It provides a nice large console (128 cols + 48 lines with 1024x768)
0013 without using tiny, unreadable fonts.
0014 * You can run XF68_FBDev on top of /dev/fb0
0015 * Most important: boot logo :-)
0016
0017 Disadvantages:
0018
0019 * graphic mode is slower than text mode... but you should not notice
0020 if you use same resolution as you used in textmode.
0021 * still experimental.
0022
0023
0024 How to use it?
0025 ==============
0026
0027 Switching modes is done using the video=aty128fb:<resolution>... modedb
0028 boot parameter or using `fbset` program.
0029
0030 See Documentation/fb/modedb.rst for more information on modedb
0031 resolutions.
0032
0033 You should compile in both vgacon (to boot if you remove your Rage128 from
0034 box) and aty128fb (for graphics mode). You should not compile-in vesafb
0035 unless you have primary display on non-Rage128 VBE2.0 device (see
0036 Documentation/fb/vesafb.rst for details).
0037
0038
0039 X11
0040 ===
0041
0042 XF68_FBDev should generally work fine, but it is non-accelerated. As of
0043 this document, 8 and 32bpp works fine. There have been palette issues
0044 when switching from X to console and back to X. You will have to restart
0045 X to fix this.
0046
0047
0048 Configuration
0049 =============
0050
0051 You can pass kernel command line options to vesafb with
0052 `video=aty128fb:option1,option2:value2,option3` (multiple options should
0053 be separated by comma, values are separated from options by `:`).
0054 Accepted options:
0055
0056 ========= =======================================================
0057 noaccel do not use acceleration engine. It is default.
0058 accel use acceleration engine. Not finished.
0059 vmode:x chooses PowerMacintosh video mode <x>. Deprecated.
0060 cmode:x chooses PowerMacintosh colour mode <x>. Deprecated.
0061 <XxX@X> selects startup videomode. See modedb.txt for detailed
0062 explanation. Default is 640x480x8bpp.
0063 ========= =======================================================
0064
0065
0066 Limitations
0067 ===========
0068
0069 There are known and unknown bugs, features and misfeatures.
0070 Currently there are following known bugs:
0071
0072 - This driver is still experimental and is not finished. Too many
0073 bugs/errata to list here.
0074
0075 Brad Douglas <brad@neruo.com>
