Documentation/fb/uvesafb.rst

2 uvesafb - A Generic Driver for VBE2+ compliant video cards
6 ---------------
8 uvesafb should work with any video card that has a Video BIOS compliant
12 v86d.  v86d is used to run the x86 Video BIOS code in a simulated and
30 --------------------------
32 uvesafb is a _generic_ driver which supports a wide variety of video
33 cards, but which is ultimately limited by the Video BIOS interface.
36 - Lack of any type of acceleration.
37 - A strict and limited set of supported video modes.  Often the native
39   with uvesafb, simply because the Video BIOS doesn't support the
40   video mode you want to use.  This can be especially painful with
41   widescreen panels, where native video modes don't have the 4:3 aspect
42   ratio, which is what most BIOS-es are limited to.
43 - Adjusting the refresh rate is only possible with a VBE 3.0 compliant
44   Video BIOS.  Note that many nVidia Video BIOS-es claim to be VBE 3.0
48 ----------------
54  video=uvesafb:1024x768-32,mtrr:3,ywrap (compiled into the kernel)
56  # modprobe uvesafb mode_option=1024x768-32 mtrr=3 scroll=ywrap  (module)
61 ypan    Enable display panning using the VESA protected mode
63 	video memory, console scrolling is done by changing the
67 ywrap   Same as ypan, but assumes your gfx board can wrap-around
68 	the video memory (i.e. starts reading from top if it
69 	reaches the end of video memory).  Faster than ypan.
73 	is the default on non-x86.
82 pmipal      Use the protected mode interface for palette changes.
83             This is the default if the protected mode interface is
89                 - 0 - disabled (equivalent to nomtrr)
90                 - 3 - write-combining (default)
98             Remap 'n' MiB of video RAM.  If 0 or not specified, remap memory
99             according to video mode.
101 vtotal:n    If the video BIOS of your card incorrectly determines the total
102             amount of video RAM, use this option to override the BIOS (in MiB).
104 <mode>      The mode you want to set, in the standard modedb format.  Refer to
106             a module, the mode string should be provided as a value of the
109 vbemode:x   Force the use of VBE mode x.  The mode will only be set if it's
110             found in the VBE-provided list of supported modes.
111             NOTE: The mode number 'x' should be specified in VESA mode number
113             HINT: If you use this option because normal <mode> parameter does
115             set the 'nocrtc' option to ensure that the video mode is properly
116             restored after console <-> X switches.
118 nocrtc      Do not use CRTC timings while setting the video mode.  This option
119             has any effect only if the Video BIOS is VBE 3.0 compliant.  Use it
125 noedid      Do not try to fetch and use EDID-provided modes.
130             a module parameter, and not as a part of the video= string.  If you
136 EDID-provided values and BIOS defaults.  Refer to your monitor's specs to get
146 ----------------------
170     A list of video modes supported by the Video BIOS along with their
171     VBE mode numbers in hex.
177 ----------------
179 Uvesafb will set a video mode with the default refresh rate and timings
180 from the Video BIOS if you set pixclock to 0 in fb_var_screeninfo.
186  Last updated: 2017-10-10