Index: linux-2.6.8.1-ck7/arch/i386/boot/video.S =================================================================== --- linux-2.6.8.1-ck7.orig/arch/i386/boot/video.S 2004-03-11 21:28:53.000000000 +1100 +++ linux-2.6.8.1-ck7/arch/i386/boot/video.S 2004-09-09 11:33:55.143959561 +1000 @@ -164,10 +164,12 @@ basret: ret # parameters in the default 80x25 mode -- these are set directly, # because some very obscure BIOSes supply insane values. mode_params: +#ifdef CONFIG_FB_VESA_STD #ifdef CONFIG_VIDEO_SELECT cmpb $0, graphic_mode jnz mopar_gr #endif +#endif movb $0x03, %ah # Read cursor position xorb %bh, %bh int $0x10 @@ -200,6 +202,7 @@ mopar2: movb %al, %fs:(PARAM_VIDEO_LINES ret #ifdef CONFIG_VIDEO_SELECT +#ifdef CONFIG_FB_VESA_STD # Fetching of VESA frame buffer parameters mopar_gr: leaw modelist+1024, %di @@ -243,6 +246,7 @@ mopar_gr: movw %es, %fs:(PARAM_VESAPM_SEG) movw %di, %fs:(PARAM_VESAPM_OFF) no_pm: ret +#endif # The video mode menu mode_menu: @@ -457,10 +461,10 @@ mode_set: cmpb $VIDEO_FIRST_V7>>8, %ah jz setv7 - + cmpb $VIDEO_FIRST_VESA>>8, %ah jnc check_vesa - + orb %ah, %ah jz setmenu @@ -547,6 +551,7 @@ check_vesa: cmpb $0x09, %al jz setvesa # This is a text mode +#ifdef CONFIG_FB_VESA_STD movb (%di), %al # Check capabilities. andb $0x99, %al cmpb $0x99, %al @@ -563,6 +568,7 @@ check_vesa: movb $0, do_restore # no screen restore stc ret +#endif _setbad: jmp setbad # Ugly... Index: linux-2.6.8.1-ck7/Documentation/fb/vesafb.txt =================================================================== --- linux-2.6.8.1-ck7.orig/Documentation/fb/vesafb.txt 2004-06-16 17:35:30.000000000 +1000 +++ linux-2.6.8.1-ck7/Documentation/fb/vesafb.txt 2004-09-09 11:33:55.144959406 +1000 @@ -2,16 +2,18 @@ What is vesafb? =============== -This is a generic driver for a graphic framebuffer on intel boxes. +Vesafb is a generic framebuffer driver for x86 and x86_64 boxes. -The idea is simple: Turn on graphics mode at boot time with the help -of the BIOS, and use this as framebuffer device /dev/fb0, like the m68k -(and other) ports do. - -This means we decide at boot time whenever we want to run in text or -graphics mode. Switching mode later on (in protected mode) is -impossible; BIOS calls work in real mode only. VESA BIOS Extensions -Version 2.0 are required, because we need a linear frame buffer. +VESA BIOS Extensions Version 2.0 are required, because we need a linear +frame buffer. VBE 3.0 is required if you want to use modes with a higher +(than the standard 60Hz) refresh rate. + +The VESA framebuffer driver comes in two flavors - the standard vesafb +and vesafb-tng. Vesafb-tng is available only on 32-bit x86 due to the +technology it uses (vm86). Vesafb-tng has more features than vesafb +(adjusting the refresh rate on VBE3.0-compliant boards, switching the +video mode without rebooting, selecting a mode by providing its +modedb name, and more) but might be unstable on some systems. Advantages: @@ -29,16 +31,27 @@ Disadvantages: How to use it? ============== -Switching modes is done using the vga=... boot parameter. Read -Documentation/svga.txt for details. - -You should compile in both vgacon (for text mode) and vesafb (for -graphics mode). Which of them takes over the console depends on -whenever the specified mode is text or graphics. - -The graphic modes are NOT in the list which you get if you boot with -vga=ask and hit return. The mode you wish to use is derived from the -VESA mode number. Here are those VESA mode numbers: +If you are running your system on hardware platform where vm86 is supported +(this is 32-bit x86 only as of the time of writing this document) and you +decide to use vesafb-tng, you can either the driver into the kernel or use it +as a module. The graphic mode you want to use is in both cases specified using +the standard modedb format. + +If your system doesn't support vm86 calls yet (all 64-bit platforms), things +get a little more tricky. Since on such systems you can't do BIOS calls from +protected mode in which kernel runs, you have to decide at boot time whenever +you want to run in text or in graphics mode. Switching mode later on is +impossible. Switching modes is done using the vga=... boot parameter. Read +Documentation/svga.txt for details. Below is a more detailed description of +what to do on systems using the standard vesafb driver. + +You should compile in both vgacon (for text mode) and vesafb (for graphics mode). +Which of them takes over the console depends on whenever the specified mode is +text or graphics. + +The graphic modes are NOT in the list which you get if you boot with vga=ask +and hit return. The mode you wish to use is derived from the VESA mode number. +Here are those VESA mode numbers: | 640x480 800x600 1024x768 1280x1024 ----+------------------------------------- @@ -47,8 +60,7 @@ VESA mode number. Here are those VESA mo 64k | 0x111 0x114 0x117 0x11A 16M | 0x112 0x115 0x118 0x11B -The video mode number of the Linux kernel is the VESA mode number plus -0x200. +The video mode number of the Linux kernel is the VESA mode number plus 0x200. Linux_kernel_mode_number = VESA_mode_number + 0x200 @@ -61,10 +73,10 @@ So the table for the Kernel mode numbers 64k | 0x311 0x314 0x317 0x31A 16M | 0x312 0x315 0x318 0x31B -To enable one of those modes you have to specify "vga=ask" in the -lilo.conf file and rerun LILO. Then you can type in the desired -mode at the "vga=ask" prompt. For example if you like to use -1024x768x256 colors you have to say "305" at this prompt. +To enable one of those modes you have to specify "vga=ask" in the lilo.conf +file and rerun LILO. Then you can type in the desired mode at the "vga=ask" +prompt. For example if you like to use 1024x768x256 colors you have to say +"305" at this prompt. If this does not work, this might be because your BIOS does not support linear framebuffers or because it does not support this mode at all. @@ -77,6 +89,7 @@ Extensions v2.0 are required, 1.2 is NOT 2. Note: Some newer versions of LILO appear to work with those hex values, if you set the 0x in front of the numbers. + X11 === @@ -86,77 +99,177 @@ It depends on X-Server and graphics boar The X-Server must restore the video mode correctly, else you end up with a broken console (and vesafb cannot do anything about this). +With vesafb-tng chances are that the console will be restored properly +even if the X server messed up the video mode. Refresh rates ============= -There is no way to change the vesafb video mode and/or timings after -booting linux. If you are not happy with the 60 Hz refresh rate, you -have these options: +With VBE3.0 compatible BIOSes and vesafb-tng it is possible to change +the refresh rate either at boot time (by specifying the @ part of +the mode name) or later, using the fbset utility. + +With VBE2.0 there is no way to change the mode timings after booting +Linux. If you are not happy with the 60 Hz refresh rate, you have +these options: - * configure and load the DOS-Tools for your the graphics board (if - available) and boot linux with loadlin. + * configure and load the DOS tools for your the graphics board (if + available) and boot Linux with loadlin. * use a native driver (matroxfb/atyfb) instead if vesafb. If none is available, write a new one! - * VBE 3.0 might work too. I have neither a gfx board with VBE 3.0 - support nor the specs, so I have not checked this yet. + * use a BIOS editor to change the default refresh rate (such an + editor does exist at least for ATI Radeon BIOSes). + * if you're running a non-vm86 and VBE3.0-compatible system, you can + use a kernel patch to hard-code some mode timings in the kernel and + use these while setting the graphic mode at boot time. Configuration ============= -The VESA BIOS provides protected mode interface for changing -some parameters. vesafb can use it for palette changes and -to pan the display. It is turned off by default because it -seems not to work with some BIOS versions, but there are options -to turn it on. - -You can pass options to vesafb using "video=vesafb:option" on -the kernel command line. Multiple options should be separated -by comma, like this: "video=vesafb:ypan,invers" - -Accepted options: - -invers no comment... - -ypan enable display panning using the VESA protected mode - interface. The visible screen is just a window of the +The VESA BIOS provides protected mode interface for changing some parameters. +vesafb can use it for palette changes and to pan the display. It is turned +off by default because it seems not to work with some BIOS versions, but there +are options to turn it on. + +You can pass options to vesafb using "video=vesafb:option" on the kernel +command line. Multiple options should be separated by comma, like this: +"video=vesafb:ypan,1024x768-32@85" + +Accepted options (both vesafb and vesafb-tng): + +ypan Enable display panning using the VESA protected mode + interface or vm86 calls. The visible screen is just a window of the video memory, console scrolling is done by changing the start of the window. pro: * scrolling (fullscreen) is fast, because there is no need to copy around data. - * You'll get scrollback (the Shift-PgUp thing), + * you'll get scrollback (the Shift-PgUp thing), the video memory can be used as scrollback buffer - kontra: * scrolling only parts of the screen causes some + con: * scrolling only parts of the screen causes some ugly flicker effects (boot logo flickers for example). -ywrap Same as ypan, but assumes your gfx board can wrap-around - the video memory (i.e. starts reading from top if it - reaches the end of video memory). Faster than ypan. - -redraw scroll by redrawing the affected part of the screen, this - is the safe (and slow) default. +ywrap Same as ypan, but assumes your gfx board can wrap-around the video + memory (i.e. starts reading from top if it reaches the end of video + memory). Faster than ypan. +redraw Scroll by redrawing the affected part of the screen, this is the + safe (and slow) default. -vgapal Use the standard vga registers for palette changes. +vgapal Use the standard VGA registers for palette changes. This is the default. + pmipal Use the protected mode interface for palette changes. -mtrr setup memory type range registers for the vesafb framebuffer. +mtrr Setup memory type range registers for the vesafb framebuffer. + +nomtrr Do not use memory type range registers for vesafb. vram:n remap 'n' MiB of video RAM. If 0 or not specified, remap memory according to video mode. (2.5.66 patch/idea by Antonino Daplas reversed to give override possibility (allocate more fb memory than the kernel would) to 2.4 by tmb@iki.fi) -Have fun! +Options accepted only by vesafb-tng: + + The mode you want to set, in the standard modedb format. Refer to + modedb.txt for detailed description. If you specify a mode that is + not supported by your board's BIOS, vesafb will attempt to set a + similar mode. The list of supported modes can be found in + /proc/fbx/modes, where x is the framebuffer number (usually 0). + When vesafb is compiled as a module, the mode string should be + provided as a value of the parameter 'mode'. + +vbemode:x + Force the use of VBE mode x. The mode will only be set if it's + found in VBE-provided list of supported modes. + NOTE: The mode number 'x' should be specified in VESA mode number + notation, not the Linux kernel one (ie. 257 instead of 769). + HINT: If you use this option because normal parameter does + not work for you and you use a X server, you'll probably want to + set the 'nocrtc' option to ensure that the video mode is properly + restored after console <-> X switches. + +nocrtc Do not use CRTC timings while setting the graphic mode. This option + makes sence only with VBE3.0 compliant systems. Use it if you have + problems with the modes set in the standard way. Note that specifying + this option means the refresh rate will be ignored and will stay at + your BIOS' default (60 Hz). + +noedid Do not try to fetch and use EDID-provided modes. + +gtf Force the use of VESA's GTF (Generalized Timing Formula). Specifying + this will cause vesafb to skip it's internal modedb and EDID-modedb + and jump straight to the GTF part of the code (normally used only is + everything else failed). This can be useful if you want to get as much + as possible from you graphics board but your BIOS doesn't support + modes with refresh rates you require. Note that you may need to + specify the maxhf, maxvf and maxclk parameters if they are not + provided by EDID. + +Additionally, the following parameters may be provided. They all override the +EDID-provided values and BIOS defaults. Refer to you monitor's specs to get +the correct values for maxhf, maxvf and maxclk for your hardware. + +maxhf:n Maximum horizontal frequency (in kHz). +maxvf:n Maximum vertical frequency (in Hz). +maxclk:n Maximum pixel clock (in MHz). + + +Vesafb-tng Technical details +============================ + +1. The driver architecture. + +The driver's code is stored in 3 files: + /drivers/video/vesafb-tng.c + /drivers/video/vesafb-thread.c + /include/video/vesa.h + +vesafb-tng.c contains the main code. vesafb-thread.c contains code for the +vesafb service thread. A separate thread is necessary because we need to remap +memory in order to be able to use the vm86 calls. The service thread is started +regardless of whether vesafb is compiled into the kernel or compiled as a +module. This is necessary because of the active_mm stuff, better described in +the header of vesafb-thread.c. + +2. The driver initialization + + o vesafb_vbe_init + - get basic info about the graphics BIOS + - fetch data about all modes supported by VBE + - get info about the protected mode interface + - get EDID data and attempt to create an EDID modedb + + o vesafb_probe + - get service thread's PID (started earlier from fbmem.c) + - call vesafb_vbe_init + - try to find the specified mode in vesa_modes modedb + - if the previous step failed or was skipped: + - try to find a matching mode in the VBE modedb - identify VBE mode ID + - try to find a matching mode in the EDID modedb + - if the previous step failed or was skipped: + - try to calculate mode timings with GTF + - low level setup - request_mem_region, ioremap, etc. + - setup /proc/fb/modes and /proc/fb/vbe_info - Gerd +3. Used hacks + + o info->var.reserved[0] holds the VBE mode ID + o info->var.reserved[1] holds a pointer to the VBE mode data in vesafb's + mode database. + +Have fun! -- +Original document for the vesafb driver by Gerd Knorr -Minor (mostly typo) changes -by Nico Schmoigl +Minor (mostly typo) changes by +Nico Schmoigl + +Extended documentation for vm86, VBE3.0 and vesafb-tng by +Micha³ Januszewski + Index: linux-2.6.8.1-ck7/drivers/video/fbmem.c =================================================================== --- linux-2.6.8.1-ck7.orig/drivers/video/fbmem.c 2004-08-15 14:08:09.000000000 +1000 +++ linux-2.6.8.1-ck7/drivers/video/fbmem.c 2004-09-09 11:33:55.145959250 +1000 @@ -97,6 +97,7 @@ extern int virgefb_setup(char*); extern int resolver_video_setup(char*); extern int s3triofb_init(void); extern int vesafb_init(void); +extern int vesafb_init_thread(void); extern int vesafb_setup(char*); extern int vga16fb_init(void); extern int vga16fb_setup(char*); @@ -306,7 +307,6 @@ static struct { #ifdef CONFIG_FB_VESA { "vesafb", vesafb_init, vesafb_setup }, #endif - /* * Chipset specific drivers that don't use resource management (yet) */ @@ -1519,6 +1519,9 @@ fbmem_init(void) } #endif +#if defined(CONFIG_FB_VESA_TNG) || defined(CONFIG_FB_VESA_TNG_MODULE) + vesafb_init_thread(); +#endif /* * Probe for all builtin frame buffer devices */ Index: linux-2.6.8.1-ck7/drivers/video/Kconfig =================================================================== --- linux-2.6.8.1-ck7.orig/drivers/video/Kconfig 2004-09-09 11:31:16.902607592 +1000 +++ linux-2.6.8.1-ck7/drivers/video/Kconfig 2004-09-09 11:39:38.680386962 +1000 @@ -287,7 +287,7 @@ config FB_TGA cards. Say Y if you have one of those. config FB_VESA - bool "VESA VGA graphics support" + tristate "VESA VGA graphics support" depends on FB && (X86 || X86_64) help This is the frame buffer device driver for generic VESA 2.0 @@ -295,6 +295,47 @@ config FB_VESA You will get a boot time penguin logo at no additional cost. Please read . If unsure, say Y. +choice + prompt "VESA driver type" + depends on FB_VESA + default FB_VESA_STD if X86_64 + default FB_VESA_TNG if X86 + +config FB_VESA_STD + bool "vesafb" + help + This is the frame buffer device driver for generic VESA 2.0 + compliant graphic cards. The older VESA 1.2 cards are not supported. + You will get a boot time penguin logo at no additional cost. Please + read . Choose this driver if you + are experiencing problems with vesafb-tng or if you own a 64-bit system. + + Note that this driver cannot be compiled as a module. + +config FB_VESA_TNG + bool "vesafb-tng" + depends on !X86_64 + help + This is the frame buffer device driver for generic VESA 2.0 + compliant graphic cards. It is capable of taking advantage of + VBE 3.0 features. With this driver you will be able to adjust + the refresh rate (VBE 3.0 compliant boards only) and change + the graphic mode on-the-fly. + + You will also get a boot time penguin logo at no additional cost. Please + read . + +endchoice + +config FB_VESA_DEFAULT_MODE + string "VESA default mode" + depends on FB_VESA_TNG + default "640x480@60" + help + This option is used to determine the default mode vesafb is + supposed to switch to in case no mode is provided as a kernel + command line parameter. + config VIDEO_SELECT bool depends on FB_VESA Index: linux-2.6.8.1-ck7/drivers/video/Makefile =================================================================== --- linux-2.6.8.1-ck7.orig/drivers/video/Makefile 2004-09-09 11:31:16.903607437 +1000 +++ linux-2.6.8.1-ck7/drivers/video/Makefile 2004-09-09 11:33:55.147958938 +1000 @@ -44,7 +44,25 @@ obj-$(CONFIG_FB_CIRRUS) += cirrusfb.o obj-$(CONFIG_FB_TRIDENT) += tridentfb.o cfbfillrect.o cfbimgblt.o cfbcopyarea.o obj-$(CONFIG_FB_S3TRIO) += S3triofb.o obj-$(CONFIG_FB_TGA) += tgafb.o cfbfillrect.o cfbcopyarea.o cfbimgblt.o -obj-$(CONFIG_FB_VESA) += vesafb.o cfbfillrect.o cfbcopyarea.o cfbimgblt.o + +ifeq ($(CONFIG_FB_VESA),m) + ifeq ($(CONFIG_FB_VESA_STD),y) + obj-y += vesafb.o cfbfillrect.o cfbcopyarea.o cfbimgblt.o + else + obj-m += vesafb-tng.o cfbfillrect.o cfbcopyarea.o cfbimgblt.o + obj-y += vesafb-thread.o + endif +else + ifeq ($(CONFIG_FB_VESA),y) + ifeq ($(CONFIG_FB_VESA_STD),y) + obj-y += vesafb.o cfbfillrect.o cfbcopyarea.o cfbimgblt.o + else + obj-y += vesafb-tng.o vesafb-thread.o cfbfillrect.o \ + cfbcopyarea.o cfbimgblt.o + endif + endif +endif + obj-$(CONFIG_FB_VGA16) += vga16fb.o cfbfillrect.o cfbcopyarea.o \ cfbimgblt.o vgastate.o obj-$(CONFIG_FB_VIRGE) += virgefb.o Index: linux-2.6.8.1-ck7/drivers/video/vesafb-thread.c =================================================================== --- linux-2.6.8.1-ck7.orig/drivers/video/vesafb-thread.c 2003-03-27 19:01:40.000000000 +1100 +++ linux-2.6.8.1-ck7/drivers/video/vesafb-thread.c 2004-09-09 11:33:55.148958782 +1000 @@ -0,0 +1,578 @@ +/* + * Framebuffer driver for VBE 2.0+ compliant graphic boards - kernel thread + * and vm86 routines. + * + * This code has to be compiled into the kernel even if vesafb is configured + * as a module. If vesafb_thread were to be started while the module is being + * initialized, it would share its active_mm with modprobe. This mm would be + * lost after modprobe finished its work, and we can't allow it, because we + * need it for as long as the vesafb thread is active. + * + * (c) 2004 Micha³ Januszewski + * + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include