Orange Pi5 kernel

^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  1) =========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  2) Tridentfb
^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) Tridentfb is a framebuffer driver for some Trident chip based cards.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  6) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  7) The following list of chips is thought to be supported although not all are
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  8) tested:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  9) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) those from the TGUI series 9440/96XX and with Cyber in their names
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) those from the Image series and with Cyber in their names
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) those with Blade in their names (Blade3D,CyberBlade...)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) the newer CyberBladeXP family
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) All families are accelerated. Only PCI/AGP based cards are supported,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) none of the older Tridents.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) The driver supports 8, 16 and 32 bits per pixel depths.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) The TGUI family requires a line length to be power of 2 if acceleration
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) is enabled. This means that range of possible resolutions and bpp is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) limited comparing to the range if acceleration is disabled (see list
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) of parameters below).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) Known bugs:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) 1. The driver randomly locks up on 3DImage975 chip with acceleration
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26)    enabled. The same happens in X11 (Xorg).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) 2. The ramdac speeds require some more fine tuning. It is possible to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)    switch resolution which the chip does not support at some depths for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29)    older chips.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) How to use it?
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) ==============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) When booting you can pass the video parameter::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) 	video=tridentfb
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) The parameters for tridentfb are concatenated with a ':' as in this example::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) 	video=tridentfb:800x600-16@75,noaccel
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) The second level parameters that tridentfb understands are:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) ========  =====================================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) noaccel   turns off acceleration (when it doesn't work for your card)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) fp	  use flat panel related stuff
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) crt 	  assume monitor is present instead of fp
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) center 	  for flat panels and resolutions smaller than native size center the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) 	  image, otherwise use
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) stretch
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) memsize   integer value in KB, use if your card's memory size is misdetected.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) 	  look at the driver output to see what it says when initializing.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) memdiff   integer value in KB, should be nonzero if your card reports
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) 	  more memory than it actually has. For instance mine is 192K less than
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) 	  detection says in all three BIOS selectable situations 2M, 4M, 8M.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) 	  Only use if your video memory is taken from main memory hence of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) 	  configurable size. Otherwise use memsize.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) 	  If in some modes which barely fit the memory you see garbage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) 	  at the bottom this might help by not letting change to that mode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) 	  anymore.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) nativex   the width in pixels of the flat panel.If you know it (usually 1024
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) 	  800 or 1280) and it is not what the driver seems to detect use it.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) bpp	  bits per pixel (8,16 or 32)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) mode	  a mode name like 800x600-8@75 as described in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) 	  Documentation/fb/modedb.rst
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) ========  =====================================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) Using insane values for the above parameters will probably result in driver
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) misbehaviour so take care(for instance memsize=12345678 or memdiff=23784 or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) nativex=93)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) Contact: jani@astechnix.ro