Orange Pi5 kernel

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