Skip to content

L
linux
Commit ab42b818 authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab Committed by Jonathan Corbet
Browse files
Options

docs: fb: convert docs to ReST and rename to *.rst 

The conversion is actually:
  - add blank lines and identation in order to identify paragraphs;
  - fix tables markups;
  - add some lists markups;
  - mark literal blocks;
  - adjust title markups.

At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.

Also, removed the Maintained by, as requested by Geert.
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+samsung@kernel.org>
Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent 10ffebbe
Expand all Show whitespace changes
Inline Side-by-side
Showing with 1952 additions and 1056 deletions
Documentation/admin-guide/kernel-parameters.txt
View file @ ab42b818
...@@ -5024,7 +5024,7 @@ ...@@ -5024,7 +5024,7 @@
vector=percpu: enable percpu vector domain vector=percpu: enable percpu vector domain
video= [FB] Frame buffer configuration video= [FB] Frame buffer configuration
See Documentation/fb/modedb.txt. See Documentation/fb/modedb.rst.
video.brightness_switch_enabled= [0,1] video.brightness_switch_enabled= [0,1]
If set to 1, on receiving an ACPI notify event If set to 1, on receiving an ACPI notify event
......
Documentation/fb/api.txt → Documentation/fb/api.rst
View file @ ab42b818
The Frame Buffer Device API ===========================
--------------------------- The Frame Buffer Device API
===========================
Last revised: June 21, 2011 Last revised: June 21, 2011
...@@ -21,13 +22,13 @@ deal with different behaviours. ...@@ -21,13 +22,13 @@ deal with different behaviours.
--------------- ---------------
Device and driver capabilities are reported in the fixed screen information Device and driver capabilities are reported in the fixed screen information
capabilities field. capabilities field::
struct fb_fix_screeninfo { struct fb_fix_screeninfo {
... ...
__u16 capabilities; /* see FB_CAP_* */ __u16 capabilities; /* see FB_CAP_* */
... ...
}; };
Application should use those capabilities to find out what features they can Application should use those capabilities to find out what features they can
expect from the device and driver. expect from the device and driver.
...@@ -151,9 +152,9 @@ fb_fix_screeninfo and fb_var_screeninfo structure respectively. ...@@ -151,9 +152,9 @@ fb_fix_screeninfo and fb_var_screeninfo structure respectively.
struct fb_fix_screeninfo stores device independent unchangeable information struct fb_fix_screeninfo stores device independent unchangeable information
about the frame buffer device and the current format. Those information can't about the frame buffer device and the current format. Those information can't
be directly modified by applications, but can be changed by the driver when an be directly modified by applications, but can be changed by the driver when an
application modifies the format. application modifies the format::
struct fb_fix_screeninfo { struct fb_fix_screeninfo {
char id[16]; /* identification string eg "TT Builtin" */ char id[16]; /* identification string eg "TT Builtin" */
unsigned long smem_start; /* Start of frame buffer mem */ unsigned long smem_start; /* Start of frame buffer mem */
/* (physical address) */ /* (physical address) */
...@@ -172,13 +173,13 @@ struct fb_fix_screeninfo { ...@@ -172,13 +173,13 @@ struct fb_fix_screeninfo {
/* specific chip/card we have */ /* specific chip/card we have */
__u16 capabilities; /* see FB_CAP_* */ __u16 capabilities; /* see FB_CAP_* */
__u16 reserved[2]; /* Reserved for future compatibility */ __u16 reserved[2]; /* Reserved for future compatibility */
}; };
struct fb_var_screeninfo stores device independent changeable information struct fb_var_screeninfo stores device independent changeable information
about a frame buffer device, its current format and video mode, as well as about a frame buffer device, its current format and video mode, as well as
other miscellaneous parameters. other miscellaneous parameters::
struct fb_var_screeninfo { struct fb_var_screeninfo {
__u32 xres; /* visible resolution */ __u32 xres; /* visible resolution */
__u32 yres; __u32 yres;
__u32 xres_virtual; /* virtual resolution */ __u32 xres_virtual; /* virtual resolution */
...@@ -216,7 +217,7 @@ struct fb_var_screeninfo { ...@@ -216,7 +217,7 @@ struct fb_var_screeninfo {
__u32 rotate; /* angle we rotate counter clockwise */ __u32 rotate; /* angle we rotate counter clockwise */
__u32 colorspace; /* colorspace for FOURCC-based modes */ __u32 colorspace; /* colorspace for FOURCC-based modes */
__u32 reserved[4]; /* Reserved for future compatibility */ __u32 reserved[4]; /* Reserved for future compatibility */
}; };
To modify variable information, applications call the FBIOPUT_VSCREENINFO To modify variable information, applications call the FBIOPUT_VSCREENINFO
ioctl with a pointer to a fb_var_screeninfo structure. If the call is ioctl with a pointer to a fb_var_screeninfo structure. If the call is
...@@ -255,14 +256,14 @@ monochrome, grayscale or pseudocolor visuals, although this is not required. ...@@ -255,14 +256,14 @@ monochrome, grayscale or pseudocolor visuals, although this is not required.
- For truecolor and directcolor formats, applications set the grayscale field - For truecolor and directcolor formats, applications set the grayscale field
to zero, and the red, blue, green and transp fields to describe the layout of to zero, and the red, blue, green and transp fields to describe the layout of
color components in memory. color components in memory::
struct fb_bitfield { struct fb_bitfield {
__u32 offset; /* beginning of bitfield */ __u32 offset; /* beginning of bitfield */
__u32 length; /* length of bitfield */ __u32 length; /* length of bitfield */
__u32 msb_right; /* != 0 : Most significant bit is */ __u32 msb_right; /* != 0 : Most significant bit is */
/* right */ /* right */
}; };
Pixel values are bits_per_pixel wide and are split in non-overlapping red, Pixel values are bits_per_pixel wide and are split in non-overlapping red,
green, blue and alpha (transparency) components. Location and size of each green, blue and alpha (transparency) components. Location and size of each
......
Documentation/fb/arkfb.txt → Documentation/fb/arkfb.rst
View file @ ab42b818
========================================
arkfb - fbdev driver for ARK Logic chips arkfb - fbdev driver for ARK Logic chips
======================================== ========================================
Supported Hardware Supported Hardware
......
Documentation/fb/aty128fb.txt → Documentation/fb/aty128fb.rst
View file @ ab42b818
[This file is cloned from VesaFB/matroxfb] =================
What is aty128fb? What is aty128fb?
================= =================
.. [This file is cloned from VesaFB/matroxfb]
This is a driver for a graphic framebuffer for ATI Rage128 based devices This is a driver for a graphic framebuffer for ATI Rage128 based devices
on Intel and PPC boxes. on Intel and PPC boxes.
...@@ -24,15 +25,15 @@ How to use it? ...@@ -24,15 +25,15 @@ How to use it?
============== ==============
Switching modes is done using the video=aty128fb:<resolution>... modedb Switching modes is done using the video=aty128fb:<resolution>... modedb
boot parameter or using `fbset' program. boot parameter or using `fbset` program.
See Documentation/fb/modedb.txt for more information on modedb See Documentation/fb/modedb.rst for more information on modedb
resolutions. resolutions.
You should compile in both vgacon (to boot if you remove your Rage128 from You should compile in both vgacon (to boot if you remove your Rage128 from
box) and aty128fb (for graphics mode). You should not compile-in vesafb box) and aty128fb (for graphics mode). You should not compile-in vesafb
unless you have primary display on non-Rage128 VBE2.0 device (see unless you have primary display on non-Rage128 VBE2.0 device (see
Documentation/fb/vesafb.txt for details). Documentation/fb/vesafb.rst for details).
X11 X11
...@@ -48,16 +49,18 @@ Configuration ...@@ -48,16 +49,18 @@ Configuration
============= =============
You can pass kernel command line options to vesafb with You can pass kernel command line options to vesafb with
`video=aty128fb:option1,option2:value2,option3' (multiple options should `video=aty128fb:option1,option2:value2,option3` (multiple options should
be separated by comma, values are separated from options by `:'). be separated by comma, values are separated from options by `:`).
Accepted options: Accepted options:
noaccel - do not use acceleration engine. It is default. ========= =======================================================
accel - use acceleration engine. Not finished. noaccel do not use acceleration engine. It is default.
vmode:x - chooses PowerMacintosh video mode <x>. Deprecated. accel use acceleration engine. Not finished.
cmode:x - chooses PowerMacintosh colour mode <x>. Deprecated. vmode:x chooses PowerMacintosh video mode <x>. Deprecated.
<XxX@X> - selects startup videomode. See modedb.txt for detailed cmode:x chooses PowerMacintosh colour mode <x>. Deprecated.
<XxX@X> selects startup videomode. See modedb.txt for detailed
explanation. Default is 640x480x8bpp. explanation. Default is 640x480x8bpp.
========= =======================================================
Limitations Limitations
...@@ -65,8 +68,8 @@ Limitations ...@@ -65,8 +68,8 @@ Limitations
There are known and unknown bugs, features and misfeatures. There are known and unknown bugs, features and misfeatures.
Currently there are following known bugs: Currently there are following known bugs:
+ This driver is still experimental and is not finished. Too many
- This driver is still experimental and is not finished. Too many
bugs/errata to list here. bugs/errata to list here.
--
Brad Douglas <brad@neruo.com> Brad Douglas <brad@neruo.com>
Documentation/fb/cirrusfb.txt → Documentation/fb/cirrusfb.rst
View file @ ab42b818
============================================
Framebuffer driver for Cirrus Logic chipsets
============================================
Framebuffer driver for Cirrus Logic chipsets Copyright 1999 Jeff Garzik <jgarzik@pobox.com>
Copyright 1999 Jeff Garzik <jgarzik@pobox.com>
.. just a little something to get people going; contributors welcome!
{ just a little something to get people going; contributors welcome! }
Chip families supported: Chip families supported:
SD64 - SD64
Piccolo - Piccolo
Picasso - Picasso
Spectrum - Spectrum
Alpine (GD-543x/4x) - Alpine (GD-543x/4x)
Picasso4 (GD-5446) - Picasso4 (GD-5446)
GD-5480 - GD-5480
Laguna (GD-546x) - Laguna (GD-546x)
Bus's supported: Bus's supported:
PCI - PCI
Zorro - Zorro
Architectures supported: Architectures supported:
i386 - i386
Alpha - Alpha
PPC (Motorola Powerstack) - PPC (Motorola Powerstack)
m68k (Amiga) - m68k (Amiga)
...@@ -34,10 +34,9 @@ Default video modes ...@@ -34,10 +34,9 @@ Default video modes
------------------- -------------------
At the moment, there are two kernel command line arguments supported: At the moment, there are two kernel command line arguments supported:
mode:640x480 - mode:640x480
mode:800x600 - mode:800x600
or - mode:1024x768
mode:1024x768
Full support for startup video modes (modedb) will be integrated soon. Full support for startup video modes (modedb) will be integrated soon.
...@@ -93,5 +92,3 @@ Version 1.9.4 ...@@ -93,5 +92,3 @@ Version 1.9.4
Version 1.9.3 Version 1.9.3
------------- -------------
* Bundled with kernel 2.3.14-pre1 or later. * Bundled with kernel 2.3.14-pre1 or later.
Documentation/fb/cmap_xfbdev.txt → Documentation/fb/cmap_xfbdev.rst
View file @ ab42b818
==========================
Understanding fbdev's cmap Understanding fbdev's cmap
-------------------------- ==========================
These notes explain how X's dix layer uses fbdev's cmap structures. These notes explain how X's dix layer uses fbdev's cmap structures.
*. example of relevant structures in fbdev as used for a 3-bit grayscale cmap - example of relevant structures in fbdev as used for a 3-bit grayscale cmap::
struct fb_var_screeninfo {
struct fb_var_screeninfo {
.bits_per_pixel = 8, .bits_per_pixel = 8,
.grayscale = 1, .grayscale = 1,
.red = { 4, 3, 0 }, .red = { 4, 3, 0 },
.green = { 0, 0, 0 }, .green = { 0, 0, 0 },
.blue = { 0, 0, 0 }, .blue = { 0, 0, 0 },
} }
struct fb_fix_screeninfo { struct fb_fix_screeninfo {
.visual = FB_VISUAL_STATIC_PSEUDOCOLOR, .visual = FB_VISUAL_STATIC_PSEUDOCOLOR,
} }
for (i = 0; i < 8; i++) for (i = 0; i < 8; i++)
info->cmap.red[i] = (((2*i)+1)*(0xFFFF))/16; info->cmap.red[i] = (((2*i)+1)*(0xFFFF))/16;
memcpy(info->cmap.green, info->cmap.red, sizeof(u16)*8); memcpy(info->cmap.green, info->cmap.red, sizeof(u16)*8);
memcpy(info->cmap.blue, info->cmap.red, sizeof(u16)*8); memcpy(info->cmap.blue, info->cmap.red, sizeof(u16)*8);
- X11 apps do something like the following when trying to use grayscale::
*. X11 apps do something like the following when trying to use grayscale. for (i=0; i < 8; i++) {
for (i=0; i < 8; i++) {
char colorspec[64]; char colorspec[64];
memset(colorspec,0,64); memset(colorspec,0,64);
sprintf(colorspec, "rgb:%x/%x/%x", i*36,i*36,i*36); sprintf(colorspec, "rgb:%x/%x/%x", i*36,i*36,i*36);
...@@ -28,26 +31,26 @@ for (i=0; i < 8; i++) { ...@@ -28,26 +31,26 @@ for (i=0; i < 8; i++) {
printf("Can't get color %s\n",colorspec); printf("Can't get color %s\n",colorspec);
XAllocColor(outputDisplay, testColormap, &wantedColor); XAllocColor(outputDisplay, testColormap, &wantedColor);
grays[i] = wantedColor; grays[i] = wantedColor;
} }
There's also named equivalents like gray1..x provided you have an rgb.txt. There's also named equivalents like gray1..x provided you have an rgb.txt.
Somewhere in X's callchain, this results in a call to X code that handles the Somewhere in X's callchain, this results in a call to X code that handles the
colormap. For example, Xfbdev hits the following: colormap. For example, Xfbdev hits the following:
xc-011010/programs/Xserver/dix/colormap.c: xc-011010/programs/Xserver/dix/colormap.c::
FindBestPixel(pentFirst, size, prgb, channel) FindBestPixel(pentFirst, size, prgb, channel)
dr = (long) pent->co.local.red - prgb->red; dr = (long) pent->co.local.red - prgb->red;
dg = (long) pent->co.local.green - prgb->green; dg = (long) pent->co.local.green - prgb->green;
db = (long) pent->co.local.blue - prgb->blue; db = (long) pent->co.local.blue - prgb->blue;
sq = dr * dr; sq = dr * dr;
UnsignedToBigNum (sq, &sum); UnsignedToBigNum (sq, &sum);
BigNumAdd (&sum, &temp, &sum); BigNumAdd (&sum, &temp, &sum);
co.local.red are entries that were brought in through FBIOGETCMAP which come co.local.red are entries that were brought in through FBIOGETCMAP which come
directly from the info->cmap.red that was listed above. The prgb is the rgb directly from the info->cmap.red that was listed above. The prgb is the rgb
that the app wants to match to. The above code is doing what looks like a least that the app wants to match to. The above code is doing what looks like a least
squares matching function. That's why the cmap entries can't be set to the left squares matching function. That's why the cmap entries can't be set to the left
hand side boundaries of a color range. hand side boundaries of a color range.
Documentation/fb/deferred_io.txt → Documentation/fb/deferred_io.rst
View file @ ab42b818
===========
Deferred IO Deferred IO
----------- ===========
Deferred IO is a way to delay and repurpose IO. It uses host memory as a Deferred IO is a way to delay and repurpose IO. It uses host memory as a
buffer and the MMU pagefault as a pretrigger for when to perform the device buffer and the MMU pagefault as a pretrigger for when to perform the device
...@@ -47,19 +48,20 @@ How to use it: (for fbdev drivers) ...@@ -47,19 +48,20 @@ How to use it: (for fbdev drivers)
---------------------------------- ----------------------------------
The following example may be helpful. The following example may be helpful.
1. Setup your structure. Eg: 1. Setup your structure. Eg::
static struct fb_deferred_io hecubafb_defio = { static struct fb_deferred_io hecubafb_defio = {
.delay = HZ, .delay = HZ,
.deferred_io = hecubafb_dpy_deferred_io, .deferred_io = hecubafb_dpy_deferred_io,
}; };
The delay is the minimum delay between when the page_mkwrite trigger occurs The delay is the minimum delay between when the page_mkwrite trigger occurs
and when the deferred_io callback is called. The deferred_io callback is and when the deferred_io callback is called. The deferred_io callback is
explained below. explained below.
2. Setup your deferred IO callback. Eg: 2. Setup your deferred IO callback. Eg::
static void hecubafb_dpy_deferred_io(struct fb_info *info,
static void hecubafb_dpy_deferred_io(struct fb_info *info,
struct list_head *pagelist) struct list_head *pagelist)
The deferred_io callback is where you would perform all your IO to the display The deferred_io callback is where you would perform all your IO to the display
...@@ -67,9 +69,11 @@ device. You receive the pagelist which is the list of pages that were written ...@@ -67,9 +69,11 @@ device. You receive the pagelist which is the list of pages that were written
to during the delay. You must not modify this list. This callback is called to during the delay. You must not modify this list. This callback is called
from a workqueue. from a workqueue.
3. Call init 3. Call init::
info->fbdefio = &hecubafb_defio; info->fbdefio = &hecubafb_defio;
fb_deferred_io_init(info); fb_deferred_io_init(info);
4. Call cleanup 4. Call cleanup::
fb_deferred_io_cleanup(info); fb_deferred_io_cleanup(info);
Documentation/fb/efifb.txt → Documentation/fb/efifb.rst
View file @ ab42b818
==============
What is efifb? What is efifb?
=============== ==============
This is a generic EFI platform driver for Intel based Apple computers. This is a generic EFI platform driver for Intel based Apple computers.
efifb is only for EFI booted Intel Macs. efifb is only for EFI booted Intel Macs.
...@@ -8,16 +8,17 @@ efifb is only for EFI booted Intel Macs. ...@@ -8,16 +8,17 @@ efifb is only for EFI booted Intel Macs.
Supported Hardware Supported Hardware
================== ==================
iMac 17"/20" - iMac 17"/20"
Macbook - Macbook
Macbook Pro 15"/17" - Macbook Pro 15"/17"
MacMini - MacMini
How to use it? How to use it?
============== ==============
efifb does not have any kind of autodetection of your machine. efifb does not have any kind of autodetection of your machine.
You have to add the following kernel parameters in your elilo.conf: You have to add the following kernel parameters in your elilo.conf::
Macbook : Macbook :
video=efifb:macbook video=efifb:macbook
MacMini : MacMini :
...@@ -29,9 +30,10 @@ You have to add the following kernel parameters in your elilo.conf: ...@@ -29,9 +30,10 @@ You have to add the following kernel parameters in your elilo.conf:
Accepted options: Accepted options:
======= ===========================================================
nowc Don't map the framebuffer write combined. This can be used nowc Don't map the framebuffer write combined. This can be used
to workaround side-effects and slowdowns on other CPU cores to workaround side-effects and slowdowns on other CPU cores
when large amounts of console data are written. when large amounts of console data are written.
======= ===========================================================
--
Edgar Hucek <gimli@dark-green.com> Edgar Hucek <gimli@dark-green.com>
Documentation/fb/ep93xx-fb.txt → Documentation/fb/ep93xx-fb.rst
View file @ ab42b818
...@@ -4,7 +4,7 @@ Driver for EP93xx LCD controller ...@@ -4,7 +4,7 @@ Driver for EP93xx LCD controller
The EP93xx LCD controller can drive both standard desktop monitors and The EP93xx LCD controller can drive both standard desktop monitors and
embedded LCD displays. If you have a standard desktop monitor then you embedded LCD displays. If you have a standard desktop monitor then you
can use the standard Linux video mode database. In your board file: can use the standard Linux video mode database. In your board file::
static struct ep93xxfb_mach_info some_board_fb_info = { static struct ep93xxfb_mach_info some_board_fb_info = {
.num_modes = EP93XXFB_USE_MODEDB, .num_modes = EP93XXFB_USE_MODEDB,
...@@ -12,7 +12,7 @@ can use the standard Linux video mode database. In your board file: ...@@ -12,7 +12,7 @@ can use the standard Linux video mode database. In your board file:
}; };
If you have an embedded LCD display then you need to define a video If you have an embedded LCD display then you need to define a video
mode for it as follows: mode for it as follows::
static struct fb_videomode some_board_video_modes[] = { static struct fb_videomode some_board_video_modes[] = {
{ {
...@@ -23,11 +23,11 @@ mode for it as follows: ...@@ -23,11 +23,11 @@ mode for it as follows:
Note that the pixel clock value is in pico-seconds. You can use the Note that the pixel clock value is in pico-seconds. You can use the
KHZ2PICOS macro to convert the pixel clock value. Most other values KHZ2PICOS macro to convert the pixel clock value. Most other values
are in pixel clocks. See Documentation/fb/framebuffer.txt for further are in pixel clocks. See Documentation/fb/framebuffer.rst for further
details. details.
The ep93xxfb_mach_info structure for your board should look like the The ep93xxfb_mach_info structure for your board should look like the
following: following::
static struct ep93xxfb_mach_info some_board_fb_info = { static struct ep93xxfb_mach_info some_board_fb_info = {
.num_modes = ARRAY_SIZE(some_board_video_modes), .num_modes = ARRAY_SIZE(some_board_video_modes),
...@@ -37,7 +37,7 @@ following: ...@@ -37,7 +37,7 @@ following:
}; };
The framebuffer device can be registered by adding the following to The framebuffer device can be registered by adding the following to
your board initialisation function: your board initialisation function::
ep93xx_register_fb(&some_board_fb_info); ep93xx_register_fb(&some_board_fb_info);
...@@ -50,6 +50,7 @@ to configure the controller. The video attributes flags are fully ...@@ -50,6 +50,7 @@ to configure the controller. The video attributes flags are fully
documented in section 7 of the EP93xx users' guide. The following documented in section 7 of the EP93xx users' guide. The following
flags are available: flags are available:
=============================== ==========================================
EP93XXFB_PCLK_FALLING Clock data on the falling edge of the EP93XXFB_PCLK_FALLING Clock data on the falling edge of the
pixel clock. The default is to clock pixel clock. The default is to clock
data on the rising edge. data on the rising edge.
...@@ -62,10 +63,12 @@ EP93XXFB_SYNC_HORIZ_HIGH Horizontal sync is active high. By ...@@ -62,10 +63,12 @@ EP93XXFB_SYNC_HORIZ_HIGH Horizontal sync is active high. By
EP93XXFB_SYNC_VERT_HIGH Vertical sync is active high. By EP93XXFB_SYNC_VERT_HIGH Vertical sync is active high. By
default the vertical sync is active high. default the vertical sync is active high.
=============================== ==========================================
The physical address of the framebuffer can be controlled using the The physical address of the framebuffer can be controlled using the
following flags: following flags:
=============================== ======================================
EP93XXFB_USE_SDCSN0 Use SDCSn[0] for the framebuffer. This EP93XXFB_USE_SDCSN0 Use SDCSn[0] for the framebuffer. This
is the default setting. is the default setting.
...@@ -74,6 +77,7 @@ EP93XXFB_USE_SDCSN1 Use SDCSn[1] for the framebuffer. ...@@ -74,6 +77,7 @@ EP93XXFB_USE_SDCSN1 Use SDCSn[1] for the framebuffer.
EP93XXFB_USE_SDCSN2 Use SDCSn[2] for the framebuffer. EP93XXFB_USE_SDCSN2 Use SDCSn[2] for the framebuffer.
EP93XXFB_USE_SDCSN3 Use SDCSn[3] for the framebuffer. EP93XXFB_USE_SDCSN3 Use SDCSn[3] for the framebuffer.
=============================== ======================================
================== ==================
Platform callbacks Platform callbacks
...@@ -87,7 +91,7 @@ blanked or unblanked. ...@@ -87,7 +91,7 @@ blanked or unblanked.
The setup and teardown devices pass the platform_device structure as The setup and teardown devices pass the platform_device structure as
an argument. The fb_info and ep93xxfb_mach_info structures can be an argument. The fb_info and ep93xxfb_mach_info structures can be
obtained as follows: obtained as follows::
static int some_board_fb_setup(struct platform_device *pdev) static int some_board_fb_setup(struct platform_device *pdev)
{ {
...@@ -101,17 +105,17 @@ obtained as follows: ...@@ -101,17 +105,17 @@ obtained as follows:
Setting the video mode Setting the video mode
====================== ======================
The video mode is set using the following syntax: The video mode is set using the following syntax::
video=XRESxYRES[-BPP][@REFRESH] video=XRESxYRES[-BPP][@REFRESH]
If the EP93xx video driver is built-in then the video mode is set on If the EP93xx video driver is built-in then the video mode is set on
the Linux kernel command line, for example: the Linux kernel command line, for example::
video=ep93xx-fb:800x600-16@60 video=ep93xx-fb:800x600-16@60
If the EP93xx video driver is built as a module then the video mode is If the EP93xx video driver is built as a module then the video mode is
set when the module is installed: set when the module is installed::
modprobe ep93xx-fb video=320x240 modprobe ep93xx-fb video=320x240
...@@ -121,13 +125,14 @@ Screenpage bug ...@@ -121,13 +125,14 @@ Screenpage bug
At least on the EP9315 there is a silicon bug which causes bit 27 of At least on the EP9315 there is a silicon bug which causes bit 27 of
the VIDSCRNPAGE (framebuffer physical offset) to be tied low. There is the VIDSCRNPAGE (framebuffer physical offset) to be tied low. There is
an unofficial errata for this bug at: an unofficial errata for this bug at::
http://marc.info/?l=linux-arm-kernel&m=110061245502000&w=2 http://marc.info/?l=linux-arm-kernel&m=110061245502000&w=2
By default the EP93xx framebuffer driver checks if the allocated physical By default the EP93xx framebuffer driver checks if the allocated physical
address has bit 27 set. If it does, then the memory is freed and an address has bit 27 set. If it does, then the memory is freed and an
error is returned. The check can be disabled by adding the following error is returned. The check can be disabled by adding the following
option when loading the driver: option when loading the driver::
ep93xx-fb.check_screenpage_bug=0 ep93xx-fb.check_screenpage_bug=0
......
Documentation/fb/fbcon.txt → Documentation/fb/fbcon.rst
View file @ ab42b818
=======================
The Framebuffer Console The Framebuffer Console
======================= =======================
The framebuffer console (fbcon), as its name implies, is a text The framebuffer console (fbcon), as its name implies, is a text
console running on top of the framebuffer device. It has the functionality of console running on top of the framebuffer device. It has the functionality of
any standard text console driver, such as the VGA console, with the added any standard text console driver, such as the VGA console, with the added
features that can be attributed to the graphical nature of the framebuffer. features that can be attributed to the graphical nature of the framebuffer.
In the x86 architecture, the framebuffer console is optional, and In the x86 architecture, the framebuffer console is optional, and
some even treat it as a toy. For other architectures, it is the only available some even treat it as a toy. For other architectures, it is the only available
display device, text or graphical. display device, text or graphical.
What are the features of fbcon? The framebuffer console supports What are the features of fbcon? The framebuffer console supports
high resolutions, varying font types, display rotation, primitive multihead, high resolutions, varying font types, display rotation, primitive multihead,
etc. Theoretically, multi-colored fonts, blending, aliasing, and any feature etc. Theoretically, multi-colored fonts, blending, aliasing, and any feature
made available by the underlying graphics card are also possible. made available by the underlying graphics card are also possible.
A. Configuration A. Configuration
================
The framebuffer console can be enabled by using your favorite kernel The framebuffer console can be enabled by using your favorite kernel
configuration tool. It is under Device Drivers->Graphics Support->Frame configuration tool. It is under Device Drivers->Graphics Support->Frame
buffer Devices->Console display driver support->Framebuffer Console Support. buffer Devices->Console display driver support->Framebuffer Console Support.
Select 'y' to compile support statically or 'm' for module support. The Select 'y' to compile support statically or 'm' for module support. The
module will be fbcon. module will be fbcon.
In order for fbcon to activate, at least one framebuffer driver is In order for fbcon to activate, at least one framebuffer driver is
required, so choose from any of the numerous drivers available. For x86 required, so choose from any of the numerous drivers available. For x86
systems, they almost universally have VGA cards, so vga16fb and vesafb will systems, they almost universally have VGA cards, so vga16fb and vesafb will
always be available. However, using a chipset-specific driver will give you always be available. However, using a chipset-specific driver will give you
more speed and features, such as the ability to change the video mode more speed and features, such as the ability to change the video mode
dynamically. dynamically.
To display the penguin logo, choose any logo available in Graphics To display the penguin logo, choose any logo available in Graphics
support->Bootup logo. support->Bootup logo.
Also, you will need to select at least one compiled-in font, but if Also, you will need to select at least one compiled-in font, but if
you don't do anything, the kernel configuration tool will select one for you, you don't do anything, the kernel configuration tool will select one for you,
usually an 8x16 font. usually an 8x16 font.
...@@ -44,6 +46,7 @@ fortunate to have a driver that does not alter the graphics chip, then you ...@@ -44,6 +46,7 @@ fortunate to have a driver that does not alter the graphics chip, then you
will still get a VGA console. will still get a VGA console.
B. Loading B. Loading
==========
Possible scenarios: Possible scenarios:
...@@ -98,7 +101,7 @@ C. Boot options ...@@ -98,7 +101,7 @@ C. Boot options
which console. The value '0123' is a sequence that gets repeated until which console. The value '0123' is a sequence that gets repeated until
the total length is 64 which is the number of consoles available. In the total length is 64 which is the number of consoles available. In
the above example, it is expanded to 012301230123... and the mapping the above example, it is expanded to 012301230123... and the mapping
will be: will be::
tty | 1 2 3 4 5 6 7 8 9 ... tty | 1 2 3 4 5 6 7 8 9 ...
fb | 0 1 2 3 0 1 2 3 0 ... fb | 0 1 2 3 0 1 2 3 0 ...
...@@ -129,17 +132,17 @@ C. Boot options ...@@ -129,17 +132,17 @@ C. Boot options
This option changes the orientation angle of the console display. The This option changes the orientation angle of the console display. The
value 'n' accepts the following: value 'n' accepts the following:
0 - normal orientation (0 degree) - 0 - normal orientation (0 degree)
1 - clockwise orientation (90 degrees) - 1 - clockwise orientation (90 degrees)
2 - upside down orientation (180 degrees) - 2 - upside down orientation (180 degrees)
3 - counterclockwise orientation (270 degrees) - 3 - counterclockwise orientation (270 degrees)
The angle can be changed anytime afterwards by 'echoing' the same The angle can be changed anytime afterwards by 'echoing' the same
numbers to any one of the 2 attributes found in numbers to any one of the 2 attributes found in
/sys/class/graphics/fbcon: /sys/class/graphics/fbcon:
rotate - rotate the display of the active console - rotate - rotate the display of the active console
rotate_all - rotate the display of all consoles - rotate_all - rotate the display of all consoles
Console rotation will only become available if Framebuffer Console Console rotation will only become available if Framebuffer Console
Rotation support is compiled in your kernel. Rotation support is compiled in your kernel.
...@@ -177,9 +180,9 @@ Before going on to how to attach, detach and unload the framebuffer console, an ...@@ -177,9 +180,9 @@ Before going on to how to attach, detach and unload the framebuffer console, an
illustration of the dependencies may help. illustration of the dependencies may help.
The console layer, as with most subsystems, needs a driver that interfaces with The console layer, as with most subsystems, needs a driver that interfaces with
the hardware. Thus, in a VGA console: the hardware. Thus, in a VGA console::
console ---> VGA driver ---> hardware. console ---> VGA driver ---> hardware.
Assuming the VGA driver can be unloaded, one must first unbind the VGA driver Assuming the VGA driver can be unloaded, one must first unbind the VGA driver
from the console layer before unloading the driver. The VGA driver cannot be from the console layer before unloading the driver. The VGA driver cannot be
...@@ -187,9 +190,9 @@ unloaded if it is still bound to the console layer. (See ...@@ -187,9 +190,9 @@ unloaded if it is still bound to the console layer. (See
Documentation/console/console.txt for more information). Documentation/console/console.txt for more information).
This is more complicated in the case of the framebuffer console (fbcon), This is more complicated in the case of the framebuffer console (fbcon),
because fbcon is an intermediate layer between the console and the drivers: because fbcon is an intermediate layer between the console and the drivers::
console ---> fbcon ---> fbdev drivers ---> hardware console ---> fbcon ---> fbdev drivers ---> hardware
The fbdev drivers cannot be unloaded if bound to fbcon, and fbcon cannot The fbdev drivers cannot be unloaded if bound to fbcon, and fbcon cannot
be unloaded if it's bound to the console layer. be unloaded if it's bound to the console layer.
...@@ -204,11 +207,11 @@ So, how do we unbind fbcon from the console? Part of the answer is in ...@@ -204,11 +207,11 @@ So, how do we unbind fbcon from the console? Part of the answer is in
Documentation/console/console.txt. To summarize: Documentation/console/console.txt. To summarize:
Echo a value to the bind file that represents the framebuffer console Echo a value to the bind file that represents the framebuffer console
driver. So assuming vtcon1 represents fbcon, then: driver. So assuming vtcon1 represents fbcon, then::
echo 1 > sys/class/vtconsole/vtcon1/bind - attach framebuffer console to echo 1 > sys/class/vtconsole/vtcon1/bind - attach framebuffer console to
console layer console layer
echo 0 > sys/class/vtconsole/vtcon1/bind - detach framebuffer console from echo 0 > sys/class/vtconsole/vtcon1/bind - detach framebuffer console from
console layer console layer
If fbcon is detached from the console layer, your boot console driver (which is If fbcon is detached from the console layer, your boot console driver (which is
...@@ -223,7 +226,7 @@ restored properly. The following is one of the several methods that you can do: ...@@ -223,7 +226,7 @@ restored properly. The following is one of the several methods that you can do:
2. In your kernel configuration, ensure that CONFIG_FRAMEBUFFER_CONSOLE is set 2. In your kernel configuration, ensure that CONFIG_FRAMEBUFFER_CONSOLE is set
to 'y' or 'm'. Enable one or more of your favorite framebuffer drivers. to 'y' or 'm'. Enable one or more of your favorite framebuffer drivers.
3. Boot into text mode and as root run: 3. Boot into text mode and as root run::
vbetool vbestate save > <vga state file> vbetool vbestate save > <vga state file>
...@@ -231,11 +234,11 @@ restored properly. The following is one of the several methods that you can do: ...@@ -231,11 +234,11 @@ restored properly. The following is one of the several methods that you can do:
hardware to <vga state file>. You need to do this step only once as hardware to <vga state file>. You need to do this step only once as
the state file can be reused. the state file can be reused.
4. If fbcon is compiled as a module, load fbcon by doing: 4. If fbcon is compiled as a module, load fbcon by doing::
modprobe fbcon modprobe fbcon
5. Now to detach fbcon: 5. Now to detach fbcon::
vbetool vbestate restore < <vga state file> && \ vbetool vbestate restore < <vga state file> && \
echo 0 > /sys/class/vtconsole/vtcon1/bind echo 0 > /sys/class/vtconsole/vtcon1/bind
...@@ -243,7 +246,7 @@ restored properly. The following is one of the several methods that you can do: ...@@ -243,7 +246,7 @@ restored properly. The following is one of the several methods that you can do:
6. That's it, you're back to VGA mode. And if you compiled fbcon as a module, 6. That's it, you're back to VGA mode. And if you compiled fbcon as a module,
you can unload it by 'rmmod fbcon'. you can unload it by 'rmmod fbcon'.
7. To reattach fbcon: 7. To reattach fbcon::
echo 1 > /sys/class/vtconsole/vtcon1/bind echo 1 > /sys/class/vtconsole/vtcon1/bind
...@@ -266,23 +269,23 @@ the following: ...@@ -266,23 +269,23 @@ the following:
Variation 1: Variation 1:
a. Before detaching fbcon, do a. Before detaching fbcon, do::
vbetool vbemode save > <vesa state file> # do once for each vesafb mode, vbetool vbemode save > <vesa state file> # do once for each vesafb mode,
# the file can be reused # the file can be reused
b. Detach fbcon as in step 5. b. Detach fbcon as in step 5.
c. Attach fbcon c. Attach fbcon::
vbetool vbestate restore < <vesa state file> && \ vbetool vbestate restore < <vesa state file> && \
echo 1 > /sys/class/vtconsole/vtcon1/bind echo 1 > /sys/class/vtconsole/vtcon1/bind
Variation 2: Variation 2:
a. Before detaching fbcon, do: a. Before detaching fbcon, do::
echo <ID> > /sys/class/tty/console/bind
echo <ID> > /sys/class/tty/console/bind
vbetool vbemode get vbetool vbemode get
...@@ -290,7 +293,7 @@ Variation 2: ...@@ -290,7 +293,7 @@ Variation 2:
b. Detach fbcon as in step 5. b. Detach fbcon as in step 5.
c. Attach fbcon: c. Attach fbcon::
vbetool vbemode set <mode number> && \ vbetool vbemode set <mode number> && \
echo 1 > /sys/class/vtconsole/vtcon1/bind echo 1 > /sys/class/vtconsole/vtcon1/bind
...@@ -299,22 +302,21 @@ Samples: ...@@ -299,22 +302,21 @@ Samples:
======== ========
Here are 2 sample bash scripts that you can use to bind or unbind the Here are 2 sample bash scripts that you can use to bind or unbind the
framebuffer console driver if you are on an X86 box: framebuffer console driver if you are on an X86 box::
--------------------------------------------------------------------------- #!/bin/bash
#!/bin/bash # Unbind fbcon
# Unbind fbcon
# Change this to where your actual vgastate file is located # Change this to where your actual vgastate file is located
# Or Use VGASTATE=$1 to indicate the state file at runtime # Or Use VGASTATE=$1 to indicate the state file at runtime
VGASTATE=/tmp/vgastate VGASTATE=/tmp/vgastate
# path to vbetool # path to vbetool
VBETOOL=/usr/local/bin VBETOOL=/usr/local/bin
for (( i = 0; i < 16; i++)) for (( i = 0; i < 16; i++))
do do
if test -x /sys/class/vtconsole/vtcon$i; then if test -x /sys/class/vtconsole/vtcon$i; then
if [ `cat /sys/class/vtconsole/vtcon$i/name | grep -c "frame buffer"` \ if [ `cat /sys/class/vtconsole/vtcon$i/name | grep -c "frame buffer"` \
= 1 ]; then = 1 ]; then
...@@ -325,14 +327,17 @@ do ...@@ -325,14 +327,17 @@ do
fi fi
fi fi
fi fi
done done
--------------------------------------------------------------------------- ---------------------------------------------------------------------------
#!/bin/bash
# Bind fbcon
for (( i = 0; i < 16; i++)) ::
do
#!/bin/bash
# Bind fbcon
for (( i = 0; i < 16; i++))
do
if test -x /sys/class/vtconsole/vtcon$i; then if test -x /sys/class/vtconsole/vtcon$i; then
if [ `cat /sys/class/vtconsole/vtcon$i/name | grep -c "frame buffer"` \ if [ `cat /sys/class/vtconsole/vtcon$i/name | grep -c "frame buffer"` \
= 1 ]; then = 1 ]; then
...@@ -340,8 +345,6 @@ do ...@@ -340,8 +345,6 @@ do
echo 1 > /sys/class/vtconsole/vtcon$i/bind echo 1 > /sys/class/vtconsole/vtcon$i/bind
fi fi
fi fi
done done
---------------------------------------------------------------------------
--
Antonino Daplas <adaplas@pol.net> Antonino Daplas <adaplas@pol.net>
Documentation/fb/framebuffer.txt → Documentation/fb/framebuffer.rst
View file @ ab42b818
The Frame Buffer Device =======================
----------------------- The Frame Buffer Device
=======================
Maintained by Geert Uytterhoeven <geert@linux-m68k.org>
Last revised: May 10, 2001 Last revised: May 10, 2001
...@@ -26,7 +26,7 @@ other device in /dev. It's a character device using major 29; the minor ...@@ -26,7 +26,7 @@ other device in /dev. It's a character device using major 29; the minor
specifies the frame buffer number. specifies the frame buffer number.
By convention, the following device nodes are used (numbers indicate the device By convention, the following device nodes are used (numbers indicate the device
minor numbers): minor numbers)::
0 = /dev/fb0 First frame buffer 0 = /dev/fb0 First frame buffer
1 = /dev/fb1 Second frame buffer 1 = /dev/fb1 Second frame buffer
...@@ -34,15 +34,15 @@ minor numbers): ...@@ -34,15 +34,15 @@ minor numbers):
31 = /dev/fb31 32nd frame buffer 31 = /dev/fb31 32nd frame buffer
For backwards compatibility, you may want to create the following symbolic For backwards compatibility, you may want to create the following symbolic
links: links::
/dev/fb0current -> fb0 /dev/fb0current -> fb0
/dev/fb1current -> fb1 /dev/fb1current -> fb1
and so on... and so on...
The frame buffer devices are also `normal' memory devices, this means, you can The frame buffer devices are also `normal` memory devices, this means, you can
read and write their contents. You can, for example, make a screen snapshot by read and write their contents. You can, for example, make a screen snapshot by::
cp /dev/fb0 myfile cp /dev/fb0 myfile
...@@ -54,11 +54,11 @@ Application software that uses the frame buffer device (e.g. the X server) will ...@@ -54,11 +54,11 @@ Application software that uses the frame buffer device (e.g. the X server) will
use /dev/fb0 by default (older software uses /dev/fb0current). You can specify use /dev/fb0 by default (older software uses /dev/fb0current). You can specify
an alternative frame buffer device by setting the environment variable an alternative frame buffer device by setting the environment variable
$FRAMEBUFFER to the path name of a frame buffer device, e.g. (for sh/bash $FRAMEBUFFER to the path name of a frame buffer device, e.g. (for sh/bash
users): users)::
export FRAMEBUFFER=/dev/fb1 export FRAMEBUFFER=/dev/fb1
or (for csh users): or (for csh users)::
setenv FRAMEBUFFER /dev/fb1 setenv FRAMEBUFFER /dev/fb1
...@@ -113,10 +113,10 @@ much trouble... ...@@ -113,10 +113,10 @@ much trouble...
3. Frame Buffer Resolution Maintenance 3. Frame Buffer Resolution Maintenance
-------------------------------------- --------------------------------------
Frame buffer resolutions are maintained using the utility `fbset'. It can Frame buffer resolutions are maintained using the utility `fbset`. It can
change the video mode properties of a frame buffer device. Its main usage is change the video mode properties of a frame buffer device. Its main usage is
to change the current video mode, e.g. during boot up in one of your /etc/rc.* to change the current video mode, e.g. during boot up in one of your `/etc/rc.*`
or /etc/init.d/* files. or `/etc/init.d/*` files.
Fbset uses a video mode database stored in a configuration file, so you can Fbset uses a video mode database stored in a configuration file, so you can
easily add your own modes and refer to them with a simple identifier. easily add your own modes and refer to them with a simple identifier.
...@@ -129,8 +129,8 @@ The X server (XF68_FBDev) is the most notable application program for the frame ...@@ -129,8 +129,8 @@ The X server (XF68_FBDev) is the most notable application program for the frame
buffer device. Starting with XFree86 release 3.2, the X server is part of buffer device. Starting with XFree86 release 3.2, the X server is part of
XFree86 and has 2 modes: XFree86 and has 2 modes:
- If the `Display' subsection for the `fbdev' driver in the /etc/XF86Config - If the `Display` subsection for the `fbdev` driver in the /etc/XF86Config
file contains a file contains a::
Modes "default" Modes "default"
...@@ -146,7 +146,7 @@ XFree86 and has 2 modes: ...@@ -146,7 +146,7 @@ XFree86 and has 2 modes:
same virtual desktop size. The frame buffer device that's used is still same virtual desktop size. The frame buffer device that's used is still
/dev/fb0current (or $FRAMEBUFFER), but the available resolutions are /dev/fb0current (or $FRAMEBUFFER), but the available resolutions are
defined by /etc/XF86Config now. The disadvantage is that you have to defined by /etc/XF86Config now. The disadvantage is that you have to
specify the timings in a different format (but `fbset -x' may help). specify the timings in a different format (but `fbset -x` may help).
To tune a video mode, you can use fbset or xvidtune. Note that xvidtune doesn't To tune a video mode, you can use fbset or xvidtune. Note that xvidtune doesn't
work 100% with XF68_FBDev: the reported clock values are always incorrect. work 100% with XF68_FBDev: the reported clock values are always incorrect.
...@@ -172,29 +172,29 @@ retrace, the electron beam is turned off (blanked). ...@@ -172,29 +172,29 @@ retrace, the electron beam is turned off (blanked).
The speed at which the electron beam paints the pixels is determined by the The speed at which the electron beam paints the pixels is determined by the
dotclock in the graphics board. For a dotclock of e.g. 28.37516 MHz (millions dotclock in the graphics board. For a dotclock of e.g. 28.37516 MHz (millions
of cycles per second), each pixel is 35242 ps (picoseconds) long: of cycles per second), each pixel is 35242 ps (picoseconds) long::
1/(28.37516E6 Hz) = 35.242E-9 s 1/(28.37516E6 Hz) = 35.242E-9 s
If the screen resolution is 640x480, it will take If the screen resolution is 640x480, it will take::
640*35.242E-9 s = 22.555E-6 s 640*35.242E-9 s = 22.555E-6 s
to paint the 640 (xres) pixels on one scanline. But the horizontal retrace to paint the 640 (xres) pixels on one scanline. But the horizontal retrace
also takes time (e.g. 272 `pixels'), so a full scanline takes also takes time (e.g. 272 `pixels`), so a full scanline takes::
(640+272)*35.242E-9 s = 32.141E-6 s (640+272)*35.242E-9 s = 32.141E-6 s
We'll say that the horizontal scanrate is about 31 kHz: We'll say that the horizontal scanrate is about 31 kHz::
1/(32.141E-6 s) = 31.113E3 Hz 1/(32.141E-6 s) = 31.113E3 Hz
A full screen counts 480 (yres) lines, but we have to consider the vertical A full screen counts 480 (yres) lines, but we have to consider the vertical
retrace too (e.g. 49 `lines'). So a full screen will take retrace too (e.g. 49 `lines`). So a full screen will take::
(480+49)*32.141E-6 s = 17.002E-3 s (480+49)*32.141E-6 s = 17.002E-3 s
The vertical scanrate is about 59 Hz: The vertical scanrate is about 59 Hz::
1/(17.002E-3 s) = 58.815 Hz 1/(17.002E-3 s) = 58.815 Hz
...@@ -212,7 +212,7 @@ influenced by the moments at which the synchronization pulses occur. ...@@ -212,7 +212,7 @@ influenced by the moments at which the synchronization pulses occur.
The following picture summarizes all timings. The horizontal retrace time is The following picture summarizes all timings. The horizontal retrace time is
the sum of the left margin, the right margin and the hsync length, while the the sum of the left margin, the right margin and the hsync length, while the
vertical retrace time is the sum of the upper margin, the lower margin and the vertical retrace time is the sum of the upper margin, the lower margin and the
vsync length. vsync length::
+----------+---------------------------------------------+----------+-------+ +----------+---------------------------------------------+----------+-------+
| | ↑ | | | | | ↑ | | |
...@@ -256,7 +256,8 @@ The frame buffer device expects all horizontal timings in number of dotclocks ...@@ -256,7 +256,8 @@ The frame buffer device expects all horizontal timings in number of dotclocks
6. Converting XFree86 timing values info frame buffer device timings 6. Converting XFree86 timing values info frame buffer device timings
-------------------------------------------------------------------- --------------------------------------------------------------------
An XFree86 mode line consists of the following fields: An XFree86 mode line consists of the following fields::
"800x600" 50 800 856 976 1040 600 637 643 666 "800x600" 50 800 856 976 1040 600 637 643 666
< name > DCF HR SH1 SH2 HFL VR SV1 SV2 VFL < name > DCF HR SH1 SH2 HFL VR SV1 SV2 VFL
...@@ -271,19 +272,27 @@ The frame buffer device uses the following fields: ...@@ -271,19 +272,27 @@ The frame buffer device uses the following fields:
- vsync_len: length of vertical sync - vsync_len: length of vertical sync
1) Pixelclock: 1) Pixelclock:
xfree: in MHz xfree: in MHz
fb: in picoseconds (ps) fb: in picoseconds (ps)
pixclock = 1000000 / DCF pixclock = 1000000 / DCF
2) horizontal timings: 2) horizontal timings:
left_margin = HFL - SH2 left_margin = HFL - SH2
right_margin = SH1 - HR right_margin = SH1 - HR
hsync_len = SH2 - SH1 hsync_len = SH2 - SH1
3) vertical timings: 3) vertical timings:
upper_margin = VFL - SV2 upper_margin = VFL - SV2
lower_margin = SV1 - VR lower_margin = SV1 - VR
vsync_len = SV2 - SV1 vsync_len = SV2 - SV1
Good examples for VESA timings can be found in the XFree86 source tree, Good examples for VESA timings can be found in the XFree86 source tree,
...@@ -303,9 +312,10 @@ and to the following documentation: ...@@ -303,9 +312,10 @@ and to the following documentation:
- The manual pages for fbset: fbset(8), fb.modes(5) - The manual pages for fbset: fbset(8), fb.modes(5)
- The manual pages for XFree86: XF68_FBDev(1), XF86Config(4/5) - The manual pages for XFree86: XF68_FBDev(1), XF86Config(4/5)
- The mighty kernel sources: - The mighty kernel sources:
o linux/drivers/video/
o linux/include/linux/fb.h - linux/drivers/video/
o linux/include/video/ - linux/include/linux/fb.h
- linux/include/video/
...@@ -334,10 +344,10 @@ The latest version of fbset can be found at ...@@ -334,10 +344,10 @@ The latest version of fbset can be found at
10. Credits 10. Credits
---------- -----------
This readme was written by Geert Uytterhoeven, partly based on the original This readme was written by Geert Uytterhoeven, partly based on the original
`X-framebuffer.README' by Roman Hodek and Martin Schaller. Section 6 was `X-framebuffer.README` by Roman Hodek and Martin Schaller. Section 6 was
provided by Frank Neumann. provided by Frank Neumann.
The frame buffer device abstraction was designed by Martin Schaller. The frame buffer device abstraction was designed by Martin Schaller.
Documentation/fb/gxfb.txt → Documentation/fb/gxfb.rst
View file @ ab42b818
[This file is cloned from VesaFB/aty128fb] =============
What is gxfb? What is gxfb?
================= =============
.. [This file is cloned from VesaFB/aty128fb]
This is a graphics framebuffer driver for AMD Geode GX2 based processors. This is a graphics framebuffer driver for AMD Geode GX2 based processors.
...@@ -23,9 +24,9 @@ How to use it? ...@@ -23,9 +24,9 @@ How to use it?
============== ==============
Switching modes is done using gxfb.mode_option=<resolution>... boot Switching modes is done using gxfb.mode_option=<resolution>... boot
parameter or using `fbset' program. parameter or using `fbset` program.
See Documentation/fb/modedb.txt for more information on modedb See Documentation/fb/modedb.rst for more information on modedb
resolutions. resolutions.
...@@ -42,11 +43,12 @@ You can pass kernel command line options to gxfb with gxfb.<option>. ...@@ -42,11 +43,12 @@ You can pass kernel command line options to gxfb with gxfb.<option>.
For example, gxfb.mode_option=800x600@75. For example, gxfb.mode_option=800x600@75.
Accepted options: Accepted options:
mode_option - specify the video mode. Of the form ================ ==================================================
mode_option specify the video mode. Of the form
<x>x<y>[-<bpp>][@<refresh>] <x>x<y>[-<bpp>][@<refresh>]
vram - size of video ram (normally auto-detected) vram size of video ram (normally auto-detected)
vt_switch - enable vt switching during suspend/resume. The vt vt_switch enable vt switching during suspend/resume. The vt
switch is slow, but harmless. switch is slow, but harmless.
================ ==================================================
--
Andres Salomon <dilinger@debian.org> Andres Salomon <dilinger@debian.org>
Documentation/fb/index.rst 0 → 100644
View file @ ab42b818
:orphan:
============
Frame Buffer
============
.. toctree::
:maxdepth: 1
api
arkfb
aty128fb
cirrusfb
cmap_xfbdev
deferred_io
efifb
ep93xx-fb
fbcon
framebuffer
gxfb
intel810
intelfb
internals
lxfb
matroxfb
metronomefb
modedb
pvr2fb
pxafb
s3fb
sa1100fb
sh7760fb
sisfb
sm501
sm712fb
sstfb
tgafb
tridentfb
udlfb
uvesafb
vesafb
viafb
vt8623fb
.. only:: subproject and html
Indices
=======
* :ref:`genindex`
Documentation/fb/intel810.txt → Documentation/fb/intel810.rst
View file @ ab42b818
================================
Intel 810/815 Framebuffer driver Intel 810/815 Framebuffer driver
Tony Daplas <adaplas@pol.net> ================================
http://i810fb.sourceforge.net
March 17, 2002 Tony Daplas <adaplas@pol.net>
First Released: July 2001 http://i810fb.sourceforge.net
Last Update: September 12, 2005
================================================================ March 17, 2002
First Released: July 2001
Last Update: September 12, 2005
A. Introduction A. Introduction
===============
This is a framebuffer driver for various Intel 810/815 compatible This is a framebuffer driver for various Intel 810/815 compatible
graphics devices. These include: graphics devices. These include:
Intel 810 - Intel 810
Intel 810E - Intel 810E
Intel 810-DC100 - Intel 810-DC100
Intel 815 Internal graphics only, 100Mhz FSB - Intel 815 Internal graphics only, 100Mhz FSB
Intel 815 Internal graphics only - Intel 815 Internal graphics only
Intel 815 Internal graphics and AGP - Intel 815 Internal graphics and AGP
B. Features B. Features
============
- Choice of using Discrete Video Timings, VESA Generalized Timing - Choice of using Discrete Video Timings, VESA Generalized Timing
Formula, or a framebuffer specific database to set the video mode Formula, or a framebuffer specific database to set the video mode
...@@ -49,6 +54,7 @@ B. Features ...@@ -49,6 +54,7 @@ B. Features
- Supports EDID probing either by DDC/I2C or through the BIOS - Supports EDID probing either by DDC/I2C or through the BIOS
C. List of available options C. List of available options
=============================
a. "video=i810fb" a. "video=i810fb"
enables the i810 driver enables the i810 driver
...@@ -167,21 +173,22 @@ C. List of available options ...@@ -167,21 +173,22 @@ C. List of available options
o. <xres>x<yres>[-<bpp>][@<refresh>] o. <xres>x<yres>[-<bpp>][@<refresh>]
The driver will now accept specification of boot mode option. If this The driver will now accept specification of boot mode option. If this
is specified, the options 'xres' and 'yres' will be ignored. See is specified, the options 'xres' and 'yres' will be ignored. See
Documentation/fb/modedb.txt for usage. Documentation/fb/modedb.rst for usage.
D. Kernel booting D. Kernel booting
=================
Separate each option/option-pair by commas (,) and the option from its value Separate each option/option-pair by commas (,) and the option from its value
with a colon (:) as in the following: with a colon (:) as in the following::
video=i810fb:option1,option2:value2 video=i810fb:option1,option2:value2
Sample Usage Sample Usage
------------ ------------
In /etc/lilo.conf, add the line: In /etc/lilo.conf, add the line::
append="video=i810fb:vram:2,xres:1024,yres:768,bpp:8,hsync1:30,hsync2:55, \ append="video=i810fb:vram:2,xres:1024,yres:768,bpp:8,hsync1:30,hsync2:55, \
vsync1:50,vsync2:85,accel,mtrr" vsync1:50,vsync2:85,accel,mtrr"
This will initialize the framebuffer to 1024x768 at 8bpp. The framebuffer This will initialize the framebuffer to 1024x768 at 8bpp. The framebuffer
...@@ -189,13 +196,14 @@ will use 2 MB of System RAM. MTRR support will be enabled. The refresh rate ...@@ -189,13 +196,14 @@ will use 2 MB of System RAM. MTRR support will be enabled. The refresh rate
will be computed based on the hsync1/hsync2 and vsync1/vsync2 values. will be computed based on the hsync1/hsync2 and vsync1/vsync2 values.
IMPORTANT: IMPORTANT:
You must include hsync1, hsync2, vsync1 and vsync2 to enable video modes You must include hsync1, hsync2, vsync1 and vsync2 to enable video modes
better than 640x480 at 60Hz. HOWEVER, if your chipset/display combination better than 640x480 at 60Hz. HOWEVER, if your chipset/display combination
supports I2C and has an EDID block, you can safely exclude hsync1, hsync2, supports I2C and has an EDID block, you can safely exclude hsync1, hsync2,
vsync1 and vsync2 parameters. These parameters will be taken from the EDID vsync1 and vsync2 parameters. These parameters will be taken from the EDID
block. block.
E. Module options E. Module options
==================
The module parameters are essentially similar to the kernel The module parameters are essentially similar to the kernel
parameters. The main difference is that you need to include a Boolean value parameters. The main difference is that you need to include a Boolean value
...@@ -206,24 +214,25 @@ Example, to enable MTRR, include "mtrr=1". ...@@ -206,24 +214,25 @@ Example, to enable MTRR, include "mtrr=1".
Sample Usage Sample Usage
------------ ------------
Using the same setup as described above, load the module like this: Using the same setup as described above, load the module like this::
modprobe i810fb vram=2 xres=1024 bpp=8 hsync1=30 hsync2=55 vsync1=50 \ modprobe i810fb vram=2 xres=1024 bpp=8 hsync1=30 hsync2=55 vsync1=50 \
vsync2=85 accel=1 mtrr=1 vsync2=85 accel=1 mtrr=1
Or just add the following to a configuration file in /etc/modprobe.d/ Or just add the following to a configuration file in /etc/modprobe.d/::
options i810fb vram=2 xres=1024 bpp=16 hsync1=30 hsync2=55 vsync1=50 \ options i810fb vram=2 xres=1024 bpp=16 hsync1=30 hsync2=55 vsync1=50 \
vsync2=85 accel=1 mtrr=1 vsync2=85 accel=1 mtrr=1
and just do a and just do a::
modprobe i810fb modprobe i810fb
F. Setup F. Setup
=========
a. Do your usual method of configuring the kernel. a. Do your usual method of configuring the kernel
make menuconfig/xconfig/config make menuconfig/xconfig/config
...@@ -253,6 +262,7 @@ F. Setup ...@@ -253,6 +262,7 @@ F. Setup
patch to see the chipset in action (or inaction :-). patch to see the chipset in action (or inaction :-).
G. Acknowledgment: G. Acknowledgment:
===================
1. Geert Uytterhoeven - his excellent howto and the virtual 1. Geert Uytterhoeven - his excellent howto and the virtual
framebuffer driver code made this possible. framebuffer driver code made this possible.
...@@ -269,10 +279,9 @@ G. Acknowledgment: ...@@ -269,10 +279,9 @@ G. Acknowledgment:
optimizations possible. optimizations possible.
H. Home Page: H. Home Page:
==============
A more complete, and probably updated information is provided at A more complete, and probably updated information is provided at
http://i810fb.sourceforge.net. http://i810fb.sourceforge.net.
###########################
Tony Tony
Documentation/fb/intelfb.txt → Documentation/fb/intelfb.rst
View file @ ab42b818
=============================================================
Intel 830M/845G/852GM/855GM/865G/915G/945G Framebuffer driver Intel 830M/845G/852GM/855GM/865G/915G/945G Framebuffer driver
================================================================ =============================================================
A. Introduction A. Introduction
This is a framebuffer driver for various Intel 8xx/9xx compatible ===============
This is a framebuffer driver for various Intel 8xx/9xx compatible
graphics devices. These would include: graphics devices. These would include:
Intel 830M - Intel 830M
Intel 845G - Intel 845G
Intel 852GM - Intel 852GM
Intel 855GM - Intel 855GM
Intel 865G - Intel 865G
Intel 915G - Intel 915G
Intel 915GM - Intel 915GM
Intel 945G - Intel 945G
Intel 945GM - Intel 945GM
Intel 945GME - Intel 945GME
Intel 965G - Intel 965G
Intel 965GM - Intel 965GM
B. List of available options B. List of available options
=============================
a. "video=intelfb" a. "video=intelfb"
enables the intelfb driver enables the intelfb driver
...@@ -80,18 +84,19 @@ B. List of available options ...@@ -80,18 +84,19 @@ B. List of available options
The default parameter (not named) is the mode. The default parameter (not named) is the mode.
C. Kernel booting C. Kernel booting
=================
Separate each option/option-pair by commas (,) and the option from its value Separate each option/option-pair by commas (,) and the option from its value
with an equals sign (=) as in the following: with an equals sign (=) as in the following::
video=intelfb:option1,option2=value2 video=intelfb:option1,option2=value2
Sample Usage Sample Usage
------------ ------------
In /etc/lilo.conf, add the line: In /etc/lilo.conf, add the line::
append="video=intelfb:mode=800x600-32@75,accel,hwcursor,vram=8" append="video=intelfb:mode=800x600-32@75,accel,hwcursor,vram=8"
This will initialize the framebuffer to 800x600 at 32bpp and 75Hz. The This will initialize the framebuffer to 800x600 at 32bpp and 75Hz. The
framebuffer will use 8 MB of System RAM. hw acceleration of text and cursor framebuffer will use 8 MB of System RAM. hw acceleration of text and cursor
...@@ -106,8 +111,9 @@ in this directory. ...@@ -106,8 +111,9 @@ in this directory.
D. Module options D. Module options
==================
The module parameters are essentially similar to the kernel The module parameters are essentially similar to the kernel
parameters. The main difference is that you need to include a Boolean value parameters. The main difference is that you need to include a Boolean value
(1 for TRUE, and 0 for FALSE) for those options which don't need a value. (1 for TRUE, and 0 for FALSE) for those options which don't need a value.
...@@ -116,20 +122,21 @@ Example, to enable MTRR, include "mtrr=1". ...@@ -116,20 +122,21 @@ Example, to enable MTRR, include "mtrr=1".
Sample Usage Sample Usage
------------ ------------
Using the same setup as described above, load the module like this: Using the same setup as described above, load the module like this::
modprobe intelfb mode=800x600-32@75 vram=8 accel=1 hwcursor=1 modprobe intelfb mode=800x600-32@75 vram=8 accel=1 hwcursor=1
Or just add the following to a configuration file in /etc/modprobe.d/ Or just add the following to a configuration file in /etc/modprobe.d/::
options intelfb mode=800x600-32@75 vram=8 accel=1 hwcursor=1 options intelfb mode=800x600-32@75 vram=8 accel=1 hwcursor=1
and just do a and just do a::
modprobe intelfb modprobe intelfb
E. Acknowledgment: E. Acknowledgment:
===================
1. Geert Uytterhoeven - his excellent howto and the virtual 1. Geert Uytterhoeven - his excellent howto and the virtual
framebuffer driver code made this possible. framebuffer driver code made this possible.
...@@ -145,5 +152,4 @@ E. Acknowledgment: ...@@ -145,5 +152,4 @@ E. Acknowledgment:
6. Andrew Morton for his kernel patches maintenance. 6. Andrew Morton for his kernel patches maintenance.
###########################
Sylvain Sylvain
Documentation/fb/internals.txt → Documentation/fb/internals.rst
View file @ ab42b818
=============================
Frame Buffer device internals
=============================
This is a first start for some documentation about frame buffer device This is a first start for some documentation about frame buffer device
internals. internals.
Geert Uytterhoeven <geert@linux-m68k.org>, 21 July 1998 Authors:
James Simmons <jsimmons@user.sf.net>, Nov 26 2002
- Geert Uytterhoeven <geert@linux-m68k.org>, 21 July 1998
- James Simmons <jsimmons@user.sf.net>, Nov 26 2002
-------------------------------------------------------------------------------- --------------------------------------------------------------------------------
*** STRUCTURES USED BY THE FRAME BUFFER DEVICE API *** Structures used by the frame buffer device API
==============================================
The following structures play a role in the game of frame buffer devices. They The following structures play a role in the game of frame buffer devices. They
are defined in <linux/fb.h>. are defined in <linux/fb.h>.
...@@ -40,19 +46,18 @@ are defined in <linux/fb.h>. ...@@ -40,19 +46,18 @@ are defined in <linux/fb.h>.
Generic information, API and low level information about a specific frame Generic information, API and low level information about a specific frame
buffer device instance (slot number, board address, ...). buffer device instance (slot number, board address, ...).
- struct `par' - struct `par`
Device dependent information that uniquely defines the video mode for this Device dependent information that uniquely defines the video mode for this
particular piece of hardware. particular piece of hardware.
-------------------------------------------------------------------------------- Visuals used by the frame buffer device API
===========================================
*** VISUALS USED BY THE FRAME BUFFER DEVICE API ***
Monochrome (FB_VISUAL_MONO01 and FB_VISUAL_MONO10) Monochrome (FB_VISUAL_MONO01 and FB_VISUAL_MONO10)
------------------------------------------------- --------------------------------------------------
Each pixel is either black or white. Each pixel is either black or white.
...@@ -79,4 +84,3 @@ Grayscale displays ...@@ -79,4 +84,3 @@ Grayscale displays
Grayscale and static grayscale are special variants of pseudo color and static Grayscale and static grayscale are special variants of pseudo color and static
pseudo color, where the red, green and blue components are always equal to pseudo color, where the red, green and blue components are always equal to
each other. each other.
Documentation/fb/lxfb.txt → Documentation/fb/lxfb.rst
View file @ ab42b818
[This file is cloned from VesaFB/aty128fb] =============
What is lxfb? What is lxfb?
================= =============
.. [This file is cloned from VesaFB/aty128fb]
This is a graphics framebuffer driver for AMD Geode LX based processors. This is a graphics framebuffer driver for AMD Geode LX based processors.
...@@ -23,9 +25,9 @@ How to use it? ...@@ -23,9 +25,9 @@ How to use it?
============== ==============
Switching modes is done using lxfb.mode_option=<resolution>... boot Switching modes is done using lxfb.mode_option=<resolution>... boot
parameter or using `fbset' program. parameter or using `fbset` program.
See Documentation/fb/modedb.txt for more information on modedb See Documentation/fb/modedb.rst for more information on modedb
resolutions. resolutions.
...@@ -42,11 +44,12 @@ You can pass kernel command line options to lxfb with lxfb.<option>. ...@@ -42,11 +44,12 @@ You can pass kernel command line options to lxfb with lxfb.<option>.
For example, lxfb.mode_option=800x600@75. For example, lxfb.mode_option=800x600@75.
Accepted options: Accepted options:
mode_option - specify the video mode. Of the form ================ ==================================================
mode_option specify the video mode. Of the form
<x>x<y>[-<bpp>][@<refresh>] <x>x<y>[-<bpp>][@<refresh>]
vram - size of video ram (normally auto-detected) vram size of video ram (normally auto-detected)
vt_switch - enable vt switching during suspend/resume. The vt vt_switch enable vt switching during suspend/resume. The vt
switch is slow, but harmless. switch is slow, but harmless.
================ ==================================================
--
Andres Salomon <dilinger@debian.org> Andres Salomon <dilinger@debian.org>
Documentation/fb/metronomefb.txt → Documentation/fb/metronomefb.rst
View file @ ab42b818
Metronomefb ===========
----------- Metronomefb
===========
Maintained by Jaya Kumar <jayakumar.lkml.gmail.com> Maintained by Jaya Kumar <jayakumar.lkml.gmail.com>
Last revised: Mar 10, 2008 Last revised: Mar 10, 2008
Metronomefb is a driver for the Metronome display controller. The controller Metronomefb is a driver for the Metronome display controller. The controller
...@@ -33,4 +36,3 @@ the physical media. ...@@ -33,4 +36,3 @@ the physical media.
Metronomefb uses the deferred IO interface so that it can provide a memory Metronomefb uses the deferred IO interface so that it can provide a memory
mappable frame buffer. It has been tested with tinyx (Xfbdev). It is known mappable frame buffer. It has been tested with tinyx (Xfbdev). It is known
to work at this time with xeyes, xclock, xloadimage, xpdf. to work at this time with xeyes, xclock, xloadimage, xpdf.
Documentation/fb/modedb.txt → Documentation/fb/modedb.rst
View file @ ab42b818
=================================
modedb default video mode support
modedb default video mode support =================================
Currently all frame buffer device drivers have their own video mode databases, Currently all frame buffer device drivers have their own video mode databases,
...@@ -18,7 +18,7 @@ When a frame buffer device receives a video= option it doesn't know, it should ...@@ -18,7 +18,7 @@ When a frame buffer device receives a video= option it doesn't know, it should
consider that to be a video mode option. If no frame buffer device is specified consider that to be a video mode option. If no frame buffer device is specified
in a video= option, fbmem considers that to be a global video mode option. in a video= option, fbmem considers that to be a global video mode option.
Valid mode specifiers (mode_option argument): Valid mode specifiers (mode_option argument)::
<xres>x<yres>[M][R][-<bpp>][@<refresh>][i][m][eDd] <xres>x<yres>[M][R][-<bpp>][@<refresh>][i][m][eDd]
<name>[-<bpp>][@<refresh>] <name>[-<bpp>][@<refresh>]
...@@ -45,15 +45,18 @@ signals (e.g. HDMI and DVI-I). For other outputs it behaves like 'e'. If 'd' ...@@ -45,15 +45,18 @@ signals (e.g. HDMI and DVI-I). For other outputs it behaves like 'e'. If 'd'
is specified the output is disabled. is specified the output is disabled.
You can additionally specify which output the options matches to. You can additionally specify which output the options matches to.
To force the VGA output to be enabled and drive a specific mode say: To force the VGA output to be enabled and drive a specific mode say::
video=VGA-1:1280x1024@60me video=VGA-1:1280x1024@60me
Specifying the option multiple times for different ports is possible, e.g.: Specifying the option multiple times for different ports is possible, e.g.::
video=LVDS-1:d video=HDMI-1:D video=LVDS-1:d video=HDMI-1:D
***** oOo ***** oOo ***** oOo ***** oOo ***** oOo ***** oOo ***** oOo ***** -----------------------------------------------------------------------------
What is the VESA(TM) Coordinated Video Timings (CVT)? What is the VESA(TM) Coordinated Video Timings (CVT)?
=====================================================
From the VESA(TM) Website: From the VESA(TM) Website:
...@@ -90,7 +93,7 @@ determined from its EDID. The version 1.3 of the EDID has extra 128-byte ...@@ -90,7 +93,7 @@ determined from its EDID. The version 1.3 of the EDID has extra 128-byte
blocks where additional timing information is placed. As of this time, there blocks where additional timing information is placed. As of this time, there
is no support yet in the layer to parse this additional blocks.) is no support yet in the layer to parse this additional blocks.)
CVT also introduced a new naming convention (should be seen from dmesg output): CVT also introduced a new naming convention (should be seen from dmesg output)::
<pix>M<a>[-R] <pix>M<a>[-R]
...@@ -110,11 +113,11 @@ Note: VESA(TM) has restrictions on what is a standard CVT timing: ...@@ -110,11 +113,11 @@ Note: VESA(TM) has restrictions on what is a standard CVT timing:
If one of the above are not satisfied, the kernel will print a warning but the If one of the above are not satisfied, the kernel will print a warning but the
timings will still be calculated. timings will still be calculated.
***** oOo ***** oOo ***** oOo ***** oOo ***** oOo ***** oOo ***** oOo ***** -----------------------------------------------------------------------------
To find a suitable video mode, you just call To find a suitable video mode, you just call::
int __init fb_find_mode(struct fb_var_screeninfo *var, int __init fb_find_mode(struct fb_var_screeninfo *var,
struct fb_info *info, const char *mode_option, struct fb_info *info, const char *mode_option,
const struct fb_videomode *db, unsigned int dbsize, const struct fb_videomode *db, unsigned int dbsize,
const struct fb_videomode *default_mode, const struct fb_videomode *default_mode,
...@@ -127,12 +130,13 @@ fb_find_mode() first tries the specified video mode (or any mode that matches, ...@@ -127,12 +130,13 @@ fb_find_mode() first tries the specified video mode (or any mode that matches,
e.g. there can be multiple 640x480 modes, each of them is tried). If that e.g. there can be multiple 640x480 modes, each of them is tried). If that
fails, the default mode is tried. If that fails, it walks over all modes. fails, the default mode is tried. If that fails, it walks over all modes.
To specify a video mode at bootup, use the following boot options: To specify a video mode at bootup, use the following boot options::
video=<driver>:<xres>x<yres>[-<bpp>][@refresh] video=<driver>:<xres>x<yres>[-<bpp>][@refresh]
where <driver> is a name from the table below. Valid default modes can be where <driver> is a name from the table below. Valid default modes can be
found in linux/drivers/video/modedb.c. Check your driver's documentation. found in linux/drivers/video/modedb.c. Check your driver's documentation.
There may be more modes. There may be more modes::
Drivers that support modedb boot options Drivers that support modedb boot options
Boot Name Cards Supported Boot Name Cards Supported
......
Documentation/fb/pvr2fb.txt → Documentation/fb/pvr2fb.rst
View file @ ab42b818
$Id: pvr2fb.txt,v 1.1 2001/05/24 05:09:16 mrbrown Exp $ ===============
What is pvr2fb? What is pvr2fb?
=============== ===============
...@@ -21,15 +20,17 @@ Configuration ...@@ -21,15 +20,17 @@ Configuration
============= =============
You can pass kernel command line options to pvr2fb with You can pass kernel command line options to pvr2fb with
`video=pvr2fb:option1,option2:value2,option3' (multiple options should be `video=pvr2fb:option1,option2:value2,option3` (multiple options should be
separated by comma, values are separated from options by `:'). separated by comma, values are separated from options by `:`).
Accepted options: Accepted options:
font:X - default font to use. All fonts are supported, including the ========== ==================================================================
font:X default font to use. All fonts are supported, including the
SUN12x22 font which is very nice at high resolutions. SUN12x22 font which is very nice at high resolutions.
mode:X - default video mode with format [xres]x[yres]-<bpp>@<refresh rate> mode:X default video mode with format [xres]x[yres]-<bpp>@<refresh rate>
The following video modes are supported: The following video modes are supported:
640x640-16@60, 640x480-24@60, 640x480-32@60. The Dreamcast 640x640-16@60, 640x480-24@60, 640x480-32@60. The Dreamcast
defaults to 640x480-16@60. At the time of writing the defaults to 640x480-16@60. At the time of writing the
...@@ -39,19 +40,20 @@ mode:X - default video mode with format [xres]x[yres]-<bpp>@<refresh rate> ...@@ -39,19 +40,20 @@ mode:X - default video mode with format [xres]x[yres]-<bpp>@<refresh rate>
Note: the 640x240 mode is currently broken, and should not be Note: the 640x240 mode is currently broken, and should not be
used for any reason. It is only mentioned here as a reference. used for any reason. It is only mentioned here as a reference.
inverse - invert colors on screen (for LCD displays) inverse invert colors on screen (for LCD displays)
nomtrr - disables write combining on frame buffer. This slows down driver nomtrr disables write combining on frame buffer. This slows down driver
but there is reported minor incompatibility between GUS DMA and but there is reported minor incompatibility between GUS DMA and
XFree under high loads if write combining is enabled (sound XFree under high loads if write combining is enabled (sound
dropouts). MTRR is enabled by default on systems that have it dropouts). MTRR is enabled by default on systems that have it
configured and that support it. configured and that support it.
cable:X - cable type. This can be any of the following: vga, rgb, and cable:X cable type. This can be any of the following: vga, rgb, and
composite. If none is specified, we guess. composite. If none is specified, we guess.
output:X - output type. This can be any of the following: pal, ntsc, and output:X output type. This can be any of the following: pal, ntsc, and
vga. If none is specified, we guess. vga. If none is specified, we guess.
========== ==================================================================
X11 X11
=== ===
...@@ -59,7 +61,6 @@ X11 ...@@ -59,7 +61,6 @@ X11
XF86_FBDev has been shown to work on the Dreamcast in the past - though not yet XF86_FBDev has been shown to work on the Dreamcast in the past - though not yet
on any 2.6 series kernel. on any 2.6 series kernel.
--
Paul Mundt <lethal@linuxdc.org> Paul Mundt <lethal@linuxdc.org>
Updated by Adrian McMenamin <adrian@mcmen.demon.co.uk>
Updated by Adrian McMenamin <adrian@mcmen.demon.co.uk>
Documentation/fb/pxafb.txt → Documentation/fb/pxafb.rst
View file @ ab42b818
================================
Driver for PXA25x LCD controller Driver for PXA25x LCD controller
================================ ================================
The driver supports the following options, either via The driver supports the following options, either via
options=<OPTIONS> when modular or video=pxafb:<OPTIONS> when built in. options=<OPTIONS> when modular or video=pxafb:<OPTIONS> when built in.
For example: For example::
modprobe pxafb options=vmem:2M,mode:640x480-8,passive modprobe pxafb options=vmem:2M,mode:640x480-8,passive
or on the kernel command line
or on the kernel command line::
video=pxafb:vmem:2M,mode:640x480-8,passive video=pxafb:vmem:2M,mode:640x480-8,passive
vmem: VIDEO_MEM_SIZE vmem: VIDEO_MEM_SIZE
Amount of video memory to allocate (can be suffixed with K or M Amount of video memory to allocate (can be suffixed with K or M
for kilobytes or megabytes) for kilobytes or megabytes)
mode:XRESxYRES[-BPP] mode:XRESxYRES[-BPP]
XRES == LCCR1_PPL + 1 XRES == LCCR1_PPL + 1
YRES == LLCR2_LPP + 1 YRES == LLCR2_LPP + 1
The resolution of the display in pixels The resolution of the display in pixels
BPP == The bit depth. Valid values are 1, 2, 4, 8 and 16. BPP == The bit depth. Valid values are 1, 2, 4, 8 and 16.
pixclock:PIXCLOCK pixclock:PIXCLOCK
Pixel clock in picoseconds Pixel clock in picoseconds
left:LEFT == LCCR1_BLW + 1 left:LEFT == LCCR1_BLW + 1
right:RIGHT == LCCR1_ELW + 1 right:RIGHT == LCCR1_ELW + 1
hsynclen:HSYNC == LCCR1_HSW + 1 hsynclen:HSYNC == LCCR1_HSW + 1
upper:UPPER == LCCR2_BFW upper:UPPER == LCCR2_BFW
lower:LOWER == LCCR2_EFR lower:LOWER == LCCR2_EFR
vsynclen:VSYNC == LCCR2_VSW + 1 vsynclen:VSYNC == LCCR2_VSW + 1
Display margins and sync times Display margins and sync times
color | mono => LCCR0_CMS color | mono => LCCR0_CMS
umm... umm...
active | passive => LCCR0_PAS active | passive => LCCR0_PAS
Active (TFT) or Passive (STN) display Active (TFT) or Passive (STN) display
single | dual => LCCR0_SDS single | dual => LCCR0_SDS
Single or dual panel passive display Single or dual panel passive display
4pix | 8pix => LCCR0_DPD 4pix | 8pix => LCCR0_DPD
4 or 8 pixel monochrome single panel data 4 or 8 pixel monochrome single panel data
hsync:HSYNC hsync:HSYNC, vsync:VSYNC
vsync:VSYNC
Horizontal and vertical sync. 0 => active low, 1 => active Horizontal and vertical sync. 0 => active low, 1 => active
high. high.
dpc:DPC dpc:DPC
Double pixel clock. 1=>true, 0=>false Double pixel clock. 1=>true, 0=>false
outputen:POLARITY outputen:POLARITY
Output Enable Polarity. 0 => active low, 1 => active high Output Enable Polarity. 0 => active low, 1 => active high
pixclockpol:POLARITY pixclockpol:POLARITY
pixel clock polarity pixel clock polarity
0 => falling edge, 1 => rising edge 0 => falling edge, 1 => rising edge
...@@ -76,15 +99,19 @@ Overlay Support for PXA27x and later LCD controllers ...@@ -76,15 +99,19 @@ Overlay Support for PXA27x and later LCD controllers
not for such purpose). not for such purpose).
2. overlay framebuffer is allocated dynamically according to specified 2. overlay framebuffer is allocated dynamically according to specified
'struct fb_var_screeninfo', the amount is decided by: 'struct fb_var_screeninfo', the amount is decided by::
var->xres_virtual * var->yres_virtual * bpp var->xres_virtual * var->yres_virtual * bpp
bpp = 16 -- for RGB565 or RGBT555 bpp = 16 -- for RGB565 or RGBT555
= 24 -- for YUV444 packed
= 24 -- for YUV444 planar bpp = 24 -- for YUV444 packed
= 16 -- for YUV422 planar (1 pixel = 1 Y + 1/2 Cb + 1/2 Cr)
= 12 -- for YUV420 planar (1 pixel = 1 Y + 1/4 Cb + 1/4 Cr) bpp = 24 -- for YUV444 planar
bpp = 16 -- for YUV422 planar (1 pixel = 1 Y + 1/2 Cb + 1/2 Cr)
bpp = 12 -- for YUV420 planar (1 pixel = 1 Y + 1/4 Cb + 1/4 Cr)
NOTE: NOTE:
...@@ -109,11 +136,13 @@ Overlay Support for PXA27x and later LCD controllers ...@@ -109,11 +136,13 @@ Overlay Support for PXA27x and later LCD controllers
a. open("/dev/fb[1-2]", ...) a. open("/dev/fb[1-2]", ...)
b. ioctl(fd, FBIOGET_VSCREENINFO, ...) b. ioctl(fd, FBIOGET_VSCREENINFO, ...)
c. modify 'var' with desired parameters: c. modify 'var' with desired parameters:
1) var->xres and var->yres 1) var->xres and var->yres
2) larger var->yres_virtual if more memory is required, 2) larger var->yres_virtual if more memory is required,
usually for double-buffering usually for double-buffering
3) var->nonstd for starting (x, y) and color format 3) var->nonstd for starting (x, y) and color format
4) var->{red, green, blue, transp} if RGB mode is to be used 4) var->{red, green, blue, transp} if RGB mode is to be used
d. ioctl(fd, FBIOPUT_VSCREENINFO, ...) d. ioctl(fd, FBIOPUT_VSCREENINFO, ...)
e. ioctl(fd, FBIOGET_FSCREENINFO, ...) e. ioctl(fd, FBIOGET_FSCREENINFO, ...)
f. mmap f. mmap
...@@ -124,7 +153,7 @@ Overlay Support for PXA27x and later LCD controllers ...@@ -124,7 +153,7 @@ Overlay Support for PXA27x and later LCD controllers
and lengths of each component within the framebuffer. and lengths of each component within the framebuffer.
4. var->nonstd is used to pass starting (x, y) position and color format, 4. var->nonstd is used to pass starting (x, y) position and color format,
the detailed bit fields are shown below: the detailed bit fields are shown below::
31 23 20 10 0 31 23 20 10 0
+-----------------+---+----------+----------+ +-----------------+---+----------+----------+
...@@ -132,11 +161,13 @@ Overlay Support for PXA27x and later LCD controllers ...@@ -132,11 +161,13 @@ Overlay Support for PXA27x and later LCD controllers
+-----------------+---+----------+----------+ +-----------------+---+----------+----------+
FOR - color format, as defined by OVERLAY_FORMAT_* in pxafb.h FOR - color format, as defined by OVERLAY_FORMAT_* in pxafb.h
0 - RGB
1 - YUV444 PACKED - 0 - RGB
2 - YUV444 PLANAR - 1 - YUV444 PACKED
3 - YUV422 PLANAR - 2 - YUV444 PLANAR
4 - YUR420 PLANAR - 3 - YUV422 PLANAR
- 4 - YUR420 PLANAR
XPOS - starting horizontal position XPOS - starting horizontal position
YPOS - starting vertical position YPOS - starting vertical position
Documentation/fb/s3fb.txt → Documentation/fb/s3fb.rst
View file @ ab42b818
===========================================
s3fb - fbdev driver for S3 Trio/Virge chips s3fb - fbdev driver for S3 Trio/Virge chips
=========================================== ===========================================
Supported Hardware Supported Hardware
......
Documentation/fb/sa1100fb.txt → Documentation/fb/sa1100fb.rst
View file @ ab42b818
[This file is cloned from VesaFB/matroxfb] =================
What is sa1100fb? What is sa1100fb?
================= =================
.. [This file is cloned from VesaFB/matroxfb]
This is a driver for a graphic framebuffer for the SA-1100 LCD This is a driver for a graphic framebuffer for the SA-1100 LCD
controller. controller.
Configuration Configuration
============== ==============
For most common passive displays, giving the option For most common passive displays, giving the option::
video=sa1100fb:bpp:<value>,lccr0:<value>,lccr1:<value>,lccr2:<value>,lccr3:<value> video=sa1100fb:bpp:<value>,lccr0:<value>,lccr1:<value>,lccr2:<value>,lccr3:<value>
on the kernel command line should be enough to configure the on the kernel command line should be enough to configure the
controller. The bits per pixel (bpp) value should be 4, 8, 12, or controller. The bits per pixel (bpp) value should be 4, 8, 12, or
...@@ -27,13 +29,12 @@ sa1100fb_init_fbinfo(), sa1100fb_activate_var(), ...@@ -27,13 +29,12 @@ sa1100fb_init_fbinfo(), sa1100fb_activate_var(),
sa1100fb_disable_lcd_controller(), and sa1100fb_enable_lcd_controller() sa1100fb_disable_lcd_controller(), and sa1100fb_enable_lcd_controller()
will probably be necessary. will probably be necessary.
Accepted options: Accepted options::
bpp:<value> Configure for <value> bits per pixel bpp:<value> Configure for <value> bits per pixel
lccr0:<value> Configure LCD control register 0 (11.7.3) lccr0:<value> Configure LCD control register 0 (11.7.3)
lccr1:<value> Configure LCD control register 1 (11.7.4) lccr1:<value> Configure LCD control register 1 (11.7.4)
lccr2:<value> Configure LCD control register 2 (11.7.5) lccr2:<value> Configure LCD control register 2 (11.7.5)
lccr3:<value> Configure LCD control register 3 (11.7.6) lccr3:<value> Configure LCD control register 3 (11.7.6)
--
Mark Huang <mhuang@livetoy.com> Mark Huang <mhuang@livetoy.com>
Documentation/fb/sh7760fb.txt → Documentation/fb/sh7760fb.rst
View file @ ab42b818
================================================
SH7760/SH7763 integrated LCDC Framebuffer driver SH7760/SH7763 integrated LCDC Framebuffer driver
================================================ ================================================
...@@ -8,6 +9,7 @@ supports (in theory) resolutions ranging from 1x1 to 1024x1024, ...@@ -8,6 +9,7 @@ supports (in theory) resolutions ranging from 1x1 to 1024x1024,
with color depths ranging from 1 to 16 bits, on STN, DSTN and TFT Panels. with color depths ranging from 1 to 16 bits, on STN, DSTN and TFT Panels.
Caveats: Caveats:
* Framebuffer memory must be a large chunk allocated at the top * Framebuffer memory must be a large chunk allocated at the top
of Area3 (HW requirement). Because of this requirement you should NOT of Area3 (HW requirement). Because of this requirement you should NOT
make the driver a module since at runtime it may become impossible to make the driver a module since at runtime it may become impossible to
...@@ -23,9 +25,10 @@ Caveats: ...@@ -23,9 +25,10 @@ Caveats:
* Rotation works only 90degress clockwise, and only if horizontal * Rotation works only 90degress clockwise, and only if horizontal
resolution is <= 320 pixels. resolution is <= 320 pixels.
files: drivers/video/sh7760fb.c Files:
include/asm-sh/sh7760fb.h - drivers/video/sh7760fb.c
Documentation/fb/sh7760fb.txt - include/asm-sh/sh7760fb.h
- Documentation/fb/sh7760fb.rst
1. Platform setup 1. Platform setup
----------------- -----------------
...@@ -50,14 +53,12 @@ Suggest you take a closer look at the SH7760 Manual, Section 30. ...@@ -50,14 +53,12 @@ Suggest you take a closer look at the SH7760 Manual, Section 30.
(http://documentation.renesas.com/eng/products/mpumcu/e602291_sh7760.pdf) (http://documentation.renesas.com/eng/products/mpumcu/e602291_sh7760.pdf)
The following code illustrates what needs to be done to The following code illustrates what needs to be done to
get the framebuffer working on a 640x480 TFT: get the framebuffer working on a 640x480 TFT::
====================== cut here ====================================== #include <linux/fb.h>
#include <asm/sh7760fb.h>
#include <linux/fb.h> /*
#include <asm/sh7760fb.h>
/*
* NEC NL6440bc26-01 640x480 TFT * NEC NL6440bc26-01 640x480 TFT
* dotclock 25175 kHz * dotclock 25175 kHz
* Xres 640 Yres 480 * Xres 640 Yres 480
...@@ -70,7 +71,7 @@ get the framebuffer working on a 640x480 TFT: ...@@ -70,7 +71,7 @@ get the framebuffer working on a 640x480 TFT:
* for the x_margin explain how to calculate those from given * for the x_margin explain how to calculate those from given
* panel sync timings. * panel sync timings.
*/ */
static struct fb_videomode nl6448bc26 = { static struct fb_videomode nl6448bc26 = {
.name = "NL6448BC26", .name = "NL6448BC26",
.refresh = 60, .refresh = 60,
.xres = 640, .xres = 640,
...@@ -85,9 +86,9 @@ static struct fb_videomode nl6448bc26 = { ...@@ -85,9 +86,9 @@ static struct fb_videomode nl6448bc26 = {
.sync = FB_SYNC_HOR_HIGH_ACT | FB_SYNC_VERT_HIGH_ACT, .sync = FB_SYNC_HOR_HIGH_ACT | FB_SYNC_VERT_HIGH_ACT,
.vmode = FB_VMODE_NONINTERLACED, .vmode = FB_VMODE_NONINTERLACED,
.flag = 0, .flag = 0,
}; };
static struct sh7760fb_platdata sh7760fb_nl6448 = { static struct sh7760fb_platdata sh7760fb_nl6448 = {
.def_mode = &nl6448bc26, .def_mode = &nl6448bc26,
.ldmtr = LDMTR_TFT_COLOR_16, /* 16bit TFT panel */ .ldmtr = LDMTR_TFT_COLOR_16, /* 16bit TFT panel */
.lddfr = LDDFR_8BPP, /* we want 8bit output */ .lddfr = LDDFR_8BPP, /* we want 8bit output */
...@@ -99,13 +100,13 @@ static struct sh7760fb_platdata sh7760fb_nl6448 = { ...@@ -99,13 +100,13 @@ static struct sh7760fb_platdata sh7760fb_nl6448 = {
.rotate = 0, .rotate = 0,
.novsync = 1, .novsync = 1,
.blank = NULL, .blank = NULL,
}; };
/* SH7760: /* SH7760:
* 0xFE300800: 256 * 4byte xRGB palette ram * 0xFE300800: 256 * 4byte xRGB palette ram
* 0xFE300C00: 42 bytes ctrl registers * 0xFE300C00: 42 bytes ctrl registers
*/ */
static struct resource sh7760_lcdc_res[] = { static struct resource sh7760_lcdc_res[] = {
[0] = { [0] = {
.start = 0xFE300800, .start = 0xFE300800,
.end = 0xFE300CFF, .end = 0xFE300CFF,
...@@ -116,9 +117,9 @@ static struct resource sh7760_lcdc_res[] = { ...@@ -116,9 +117,9 @@ static struct resource sh7760_lcdc_res[] = {
.end = 65, .end = 65,
.flags = IORESOURCE_IRQ, .flags = IORESOURCE_IRQ,
}, },
}; };
static struct platform_device sh7760_lcdc_dev = { static struct platform_device sh7760_lcdc_dev = {
.dev = { .dev = {
.platform_data = &sh7760fb_nl6448, .platform_data = &sh7760fb_nl6448,
}, },
...@@ -126,6 +127,4 @@ static struct platform_device sh7760_lcdc_dev = { ...@@ -126,6 +127,4 @@ static struct platform_device sh7760_lcdc_dev = {
.id = -1, .id = -1,
.resource = sh7760_lcdc_res, .resource = sh7760_lcdc_res,
.num_resources = ARRAY_SIZE(sh7760_lcdc_res), .num_resources = ARRAY_SIZE(sh7760_lcdc_res),
}; };
====================== cut here ======================================
Documentation/fb/sisfb.txt → Documentation/fb/sisfb.rst
View file @ ab42b818
==============
What is sisfb? What is sisfb?
============== ==============
...@@ -41,11 +41,11 @@ statement to add the parameters to the kernel command line. Please see lilo's ...@@ -41,11 +41,11 @@ statement to add the parameters to the kernel command line. Please see lilo's
parameters are given with the modprobe (or insmod) command. parameters are given with the modprobe (or insmod) command.
Example for sisfb as part of the static kernel: Add the following line to your Example for sisfb as part of the static kernel: Add the following line to your
lilo.conf: lilo.conf::
append="video=sisfb:mode:1024x768x16,mem:12288,rate:75" append="video=sisfb:mode:1024x768x16,mem:12288,rate:75"
Example for sisfb as a module: Start sisfb by typing Example for sisfb as a module: Start sisfb by typing::
modprobe sisfb mode=1024x768x16 rate=75 mem=12288 modprobe sisfb mode=1024x768x16 rate=75 mem=12288
...@@ -57,7 +57,7 @@ described above or the vesa keyword instead of mode). If compiled as a module, ...@@ -57,7 +57,7 @@ described above or the vesa keyword instead of mode). If compiled as a module,
the parameter format reads mode=none or mode=1024x768x16 (or whatever mode you the parameter format reads mode=none or mode=1024x768x16 (or whatever mode you
want to use). Using a "=" for a ":" (and vice versa) is a huge difference! want to use). Using a "=" for a ":" (and vice versa) is a huge difference!
Additionally: If you give more than one argument to the in-kernel sisfb, the Additionally: If you give more than one argument to the in-kernel sisfb, the
arguments are separated with ",". For example: arguments are separated with ",". For example::
video=sisfb:mode:1024x768x16,rate:75,mem:12288 video=sisfb:mode:1024x768x16,rate:75,mem:12288
...@@ -73,6 +73,7 @@ supported options including some explanation. ...@@ -73,6 +73,7 @@ supported options including some explanation.
The desired display mode can be specified using the keyword "mode" with The desired display mode can be specified using the keyword "mode" with
a parameter in one of the following formats: a parameter in one of the following formats:
- XxYxDepth or - XxYxDepth or
- XxY-Depth or - XxY-Depth or
- XxY-Depth@Rate or - XxY-Depth@Rate or
...@@ -130,29 +131,30 @@ Configuration ...@@ -130,29 +131,30 @@ Configuration
(Some) accepted options: (Some) accepted options:
off - Disable sisfb. This option is only understood if sisfb is ========= ==================================================================
off Disable sisfb. This option is only understood if sisfb is
in-kernel, not a module. in-kernel, not a module.
mem:X - size of memory for the console, rest will be used for DRI/DRM. X mem:X size of memory for the console, rest will be used for DRI/DRM. X
is in kilobytes. On 300 series, the default is 4096, 8192 or is in kilobytes. On 300 series, the default is 4096, 8192 or
16384 (each in kilobyte) depending on how much video ram the card 16384 (each in kilobyte) depending on how much video ram the card
has. On 315/330 series, the default is the maximum available ram has. On 315/330 series, the default is the maximum available ram
(since DRI/DRM is not supported for these chipsets). (since DRI/DRM is not supported for these chipsets).
noaccel - do not use 2D acceleration engine. (Default: use acceleration) noaccel do not use 2D acceleration engine. (Default: use acceleration)
noypan - disable y-panning and scroll by redrawing the entire screen. noypan disable y-panning and scroll by redrawing the entire screen.
This is much slower than y-panning. (Default: use y-panning) This is much slower than y-panning. (Default: use y-panning)
vesa:X - selects startup videomode. X is number from 0 to 0x1FF and vesa:X selects startup videomode. X is number from 0 to 0x1FF and
represents the VESA mode number (can be given in decimal or represents the VESA mode number (can be given in decimal or
hexadecimal form, the latter prefixed with "0x"). hexadecimal form, the latter prefixed with "0x").
mode:X - selects startup videomode. Please see above for the format of mode:X selects startup videomode. Please see above for the format of
"X". "X".
========= ==================================================================
Boolean options such as "noaccel" or "noypan" are to be given without a Boolean options such as "noaccel" or "noypan" are to be given without a
parameter if sisfb is in-kernel (for example "video=sisfb:noypan). If parameter if sisfb is in-kernel (for example "video=sisfb:noypan). If
sisfb is a module, these are to be set to 1 (for example "modprobe sisfb sisfb is a module, these are to be set to 1 (for example "modprobe sisfb
noypan=1"). noypan=1").
--
Thomas Winischhofer <thomas@winischhofer.net>
May 27, 2004
Thomas Winischhofer <thomas@winischhofer.net>
May 27, 2004
Documentation/fb/sm501.txt → Documentation/fb/sm501.rst
View file @ ab42b818
=======
sm501fb
=======
Configuration: Configuration:
You can pass the following kernel command line options to sm501 videoframebuffer: You can pass the following kernel command line options to sm501
videoframebuffer::
sm501fb.bpp= SM501 Display driver: sm501fb.bpp= SM501 Display driver:
Specify bits-per-pixel if not specified by 'mode' Specify bits-per-pixel if not specified by 'mode'
......
Documentation/fb/sm712fb.txt → Documentation/fb/sm712fb.rst
View file @ ab42b818
================
What is sm712fb? What is sm712fb?
================= ================
This is a graphics framebuffer driver for Silicon Motion SM712 based processors. This is a graphics framebuffer driver for Silicon Motion SM712 based processors.
...@@ -15,13 +16,16 @@ You should not compile-in vesafb. ...@@ -15,13 +16,16 @@ You should not compile-in vesafb.
Currently supported video modes are: Currently supported video modes are:
[Graphic modes] Graphic modes
-------------
bpp | 640x480 800x600 1024x768 1280x1024 === ======= ======= ======== =========
----+-------------------------------------------- bpp 640x480 800x600 1024x768 1280x1024
8 | 0x301 0x303 0x305 0x307 === ======= ======= ======== =========
16 | 0x311 0x314 0x317 0x31A 8 0x301 0x303 0x305 0x307
24 | 0x312 0x315 0x318 0x31B 16 0x311 0x314 0x317 0x31A
24 0x312 0x315 0x318 0x31B
=== ======= ======= ======== =========
Missing Features Missing Features
================ ================
......
Documentation/fb/sstfb.rst 0 → 100644
View file @ ab42b818
=====
sstfb
=====
Introduction
============
This is a frame buffer device driver for 3dfx' Voodoo Graphics
(aka voodoo 1, aka sst1) and Voodoo² (aka Voodoo 2, aka CVG) based
video boards. It's highly experimental code, but is guaranteed to work
on my computer, with my "Maxi Gamer 3D" and "Maxi Gamer 3d²" boards,
and with me "between chair and keyboard". Some people tested other
combinations and it seems that it works.
The main page is located at <http://sstfb.sourceforge.net>, and if
you want the latest version, check out the CVS, as the driver is a work
in progress, I feel uncomfortable with releasing tarballs of something
not completely working...Don't worry, it's still more than usable
(I eat my own dog food)
Please read the Bug section, and report any success or failure to me
(Ghozlane Toumi <gtoumi@laposte.net>).
BTW, If you have only one monitor , and you don't feel like playing
with the vga passthrou cable, I can only suggest borrowing a screen
somewhere...
Installation
============
This driver (should) work on ix86, with "late" 2.2.x kernel (tested
with x = 19) and "recent" 2.4.x kernel, as a module or compiled in.
It has been included in mainstream kernel since the infamous 2.4.10.
You can apply the patches found in `sstfb/kernel/*-2.{2|4}.x.patch`,
and copy sstfb.c to linux/drivers/video/, or apply a single patch,
`sstfb/patch-2.{2|4}.x-sstfb-yymmdd` to your linux source tree.
Then configure your kernel as usual: choose "m" or "y" to 3Dfx Voodoo
Graphics in section "console". Compile, install, have fun... and please
drop me a report :)
Module Usage
============
.. warning::
#. You should read completely this section before issuing any command.
#. If you have only one monitor to play with, once you insmod the
module, the 3dfx takes control of the output, so you'll have to
plug the monitor to the "normal" video board in order to issue
the commands, or you can blindly use sst_dbg_vgapass
in the tools directory (See Tools). The latest solution is pass the
parameter vgapass=1 when insmodding the driver. (See Kernel/Modules
Options)
Module insertion
----------------
#. insmod sstfb.o
you should see some strange output from the board:
a big blue square, a green and a red small squares and a vertical
white rectangle. why? the function's name is self-explanatory:
"sstfb_test()"...
(if you don't have a second monitor, you'll have to plug your monitor
directly to the 2D videocard to see what you're typing)
#. con2fb /dev/fbx /dev/ttyx
bind a tty to the new frame buffer. if you already have a frame
buffer driver, the voodoo fb will likely be /dev/fb1. if not,
the device will be /dev/fb0. You can check this by doing a
cat /proc/fb. You can find a copy of con2fb in tools/ directory.
if you don't have another fb device, this step is superfluous,
as the console subsystem automagicaly binds ttys to the fb.
#. switch to the virtual console you just mapped. "tadaaa" ...
Module removal
--------------
#. con2fb /dev/fbx /dev/ttyx
bind the tty to the old frame buffer so the module can be removed.
(how does it work with vgacon ? short answer : it doesn't work)
#. rmmod sstfb
Kernel/Modules Options
----------------------
You can pass some options to the sstfb module, and via the kernel
command line when the driver is compiled in:
for module : insmod sstfb.o option1=value1 option2=value2 ...
in kernel : video=sstfb:option1,option2:value2,option3 ...
sstfb supports the following options:
=============== =============== ===============================================
Module Kernel Description
=============== =============== ===============================================
vgapass=0 vganopass Enable or disable VGA passthrou cable.
vgapass=1 vgapass When enabled, the monitor will get the signal
from the VGA board and not from the voodoo.
Default: nopass
mem=x mem:x Force frame buffer memory in MiB
allowed values: 0, 1, 2, 4.
Default: 0 (= autodetect)
inverse=1 inverse Supposed to enable inverse console.
doesn't work yet...
clipping=1 clipping Enable or disable clipping.
clipping=0 noclipping With clipping enabled, all offscreen
reads and writes are discarded.
Default: enable clipping.
gfxclk=x gfxclk:x Force graphic clock frequency (in MHz).
Be careful with this option, it may be
DANGEROUS.
Default: auto
- 50Mhz for Voodoo 1,
- 75MHz for Voodoo 2.
slowpci=1 fastpci Enable or disable fast PCI read/writes.
slowpci=1 slowpci Default : fastpci
dev=x dev:x Attach the driver to device number x.
0 is the first compatible board (in
lspci order)
=============== =============== ===============================================
Tools
=====
These tools are mostly for debugging purposes, but you can
find some of these interesting:
- `con2fb`, maps a tty to a fbramebuffer::
con2fb /dev/fb1 /dev/tty5
- `sst_dbg_vgapass`, changes vga passthrou. You have to recompile the
driver with SST_DEBUG and SST_DEBUG_IOCTL set to 1::
sst_dbg_vgapass /dev/fb1 1 (enables vga cable)
sst_dbg_vgapass /dev/fb1 0 (disables vga cable)
- `glide_reset`, resets the voodoo using glide
use this after rmmoding sstfb, if the module refuses to
reinsert.
Bugs
====
- DO NOT use glide while the sstfb module is in, you'll most likely
hang your computer.
- If you see some artefacts (pixels not cleaning and stuff like that),
try turning off clipping (clipping=0), and/or using slowpci
- the driver don't detect the 4Mb frame buffer voodoos, it seems that
the 2 last Mbs wrap around. looking into that .
- The driver is 16 bpp only, 24/32 won't work.
- The driver is not your_favorite_toy-safe. this includes SMP...
[Actually from inspection it seems to be safe - Alan]
- When using XFree86 FBdev (X over fbdev) you may see strange color
patterns at the border of your windows (the pixels lose the lowest
byte -> basically the blue component and some of the green). I'm unable
to reproduce this with XFree86-3.3, but one of the testers has this
problem with XFree86-4. Apparently recent Xfree86-4.x solve this
problem.
- I didn't really test changing the palette, so you may find some weird
things when playing with that.
- Sometimes the driver will not recognise the DAC, and the
initialisation will fail. This is specifically true for
voodoo 2 boards, but it should be solved in recent versions. Please
contact me.
- The 24/32 is not likely to work anytime soon, knowing that the
hardware does ... unusual things in 24/32 bpp.
- When used with another video board, current limitations of the linux
console subsystem can cause some troubles, specifically, you should
disable software scrollback, as it can oops badly ...
Todo
====
- Get rid of the previous paragraph.
- Buy more coffee.
- test/port to other arch.
- try to add panning using tweeks with front and back buffer .
- try to implement accel on voodoo2, this board can actually do a
lot in 2D even if it was sold as a 3D only board ...
Ghozlane Toumi <gtoumi@laposte.net>
Date: 2002/05/09 20:11:45
http://sstfb.sourceforge.net/README
Documentation/fb/sstfb.txt deleted 100644 → 0
View file @ 10ffebbe
Introduction
This is a frame buffer device driver for 3dfx' Voodoo Graphics
(aka voodoo 1, aka sst1) and Voodoo² (aka Voodoo 2, aka CVG) based
video boards. It's highly experimental code, but is guaranteed to work
on my computer, with my "Maxi Gamer 3D" and "Maxi Gamer 3d²" boards,
and with me "between chair and keyboard". Some people tested other
combinations and it seems that it works.
The main page is located at <http://sstfb.sourceforge.net>, and if
you want the latest version, check out the CVS, as the driver is a work
in progress, I feel uncomfortable with releasing tarballs of something
not completely working...Don't worry, it's still more than usable
(I eat my own dog food)
Please read the Bug section, and report any success or failure to me
(Ghozlane Toumi <gtoumi@laposte.net>).
BTW, If you have only one monitor , and you don't feel like playing
with the vga passthrou cable, I can only suggest borrowing a screen
somewhere...
Installation
This driver (should) work on ix86, with "late" 2.2.x kernel (tested
with x = 19) and "recent" 2.4.x kernel, as a module or compiled in.
It has been included in mainstream kernel since the infamous 2.4.10.
You can apply the patches found in sstfb/kernel/*-2.{2|4}.x.patch,
and copy sstfb.c to linux/drivers/video/, or apply a single patch,
sstfb/patch-2.{2|4}.x-sstfb-yymmdd to your linux source tree.
Then configure your kernel as usual: choose "m" or "y" to 3Dfx Voodoo
Graphics in section "console". Compile, install, have fun... and please
drop me a report :)
Module Usage
Warnings.
# You should read completely this section before issuing any command.
# If you have only one monitor to play with, once you insmod the
module, the 3dfx takes control of the output, so you'll have to
plug the monitor to the "normal" video board in order to issue
the commands, or you can blindly use sst_dbg_vgapass
in the tools directory (See Tools). The latest solution is pass the
parameter vgapass=1 when insmodding the driver. (See Kernel/Modules
Options)
Module insertion:
# insmod sstfb.o
you should see some strange output from the board:
a big blue square, a green and a red small squares and a vertical
white rectangle. why? the function's name is self-explanatory:
"sstfb_test()"...
(if you don't have a second monitor, you'll have to plug your monitor
directly to the 2D videocard to see what you're typing)
# con2fb /dev/fbx /dev/ttyx
bind a tty to the new frame buffer. if you already have a frame
buffer driver, the voodoo fb will likely be /dev/fb1. if not,
the device will be /dev/fb0. You can check this by doing a
cat /proc/fb. You can find a copy of con2fb in tools/ directory.
if you don't have another fb device, this step is superfluous,
as the console subsystem automagicaly binds ttys to the fb.
# switch to the virtual console you just mapped. "tadaaa" ...
Module removal:
# con2fb /dev/fbx /dev/ttyx
bind the tty to the old frame buffer so the module can be removed.
(how does it work with vgacon ? short answer : it doesn't work)
# rmmod sstfb
Kernel/Modules Options
You can pass some options to the sstfb module, and via the kernel
command line when the driver is compiled in:
for module : insmod sstfb.o option1=value1 option2=value2 ...
in kernel : video=sstfb:option1,option2:value2,option3 ...
sstfb supports the following options :
Module Kernel Description
vgapass=0 vganopass Enable or disable VGA passthrou cable.
vgapass=1 vgapass When enabled, the monitor will get the signal
from the VGA board and not from the voodoo.
Default: nopass
mem=x mem:x Force frame buffer memory in MiB
allowed values: 0, 1, 2, 4.
Default: 0 (= autodetect)
inverse=1 inverse Supposed to enable inverse console.
doesn't work yet...
clipping=1 clipping Enable or disable clipping.
clipping=0 noclipping With clipping enabled, all offscreen
reads and writes are discarded.
Default: enable clipping.
gfxclk=x gfxclk:x Force graphic clock frequency (in MHz).
Be careful with this option, it may be
DANGEROUS.
Default: auto
50Mhz for Voodoo 1,
75MHz for Voodoo 2.
slowpci=1 fastpci Enable or disable fast PCI read/writes.
slowpci=1 slowpci Default : fastpci
dev=x dev:x Attach the driver to device number x.
0 is the first compatible board (in
lspci order)
Tools
These tools are mostly for debugging purposes, but you can
find some of these interesting :
- con2fb , maps a tty to a fbramebuffer .
con2fb /dev/fb1 /dev/tty5
- sst_dbg_vgapass , changes vga passthrou. You have to recompile the
driver with SST_DEBUG and SST_DEBUG_IOCTL set to 1
sst_dbg_vgapass /dev/fb1 1 (enables vga cable)
sst_dbg_vgapass /dev/fb1 0 (disables vga cable)
- glide_reset , resets the voodoo using glide
use this after rmmoding sstfb, if the module refuses to
reinsert .
Bugs
- DO NOT use glide while the sstfb module is in, you'll most likely
hang your computer.
- If you see some artefacts (pixels not cleaning and stuff like that),
try turning off clipping (clipping=0), and/or using slowpci
- the driver don't detect the 4Mb frame buffer voodoos, it seems that
the 2 last Mbs wrap around. looking into that .
- The driver is 16 bpp only, 24/32 won't work.
- The driver is not your_favorite_toy-safe. this includes SMP...
[Actually from inspection it seems to be safe - Alan]
- When using XFree86 FBdev (X over fbdev) you may see strange color
patterns at the border of your windows (the pixels lose the lowest
byte -> basically the blue component and some of the green). I'm unable
to reproduce this with XFree86-3.3, but one of the testers has this
problem with XFree86-4. Apparently recent Xfree86-4.x solve this
problem.
- I didn't really test changing the palette, so you may find some weird
things when playing with that.
- Sometimes the driver will not recognise the DAC, and the
initialisation will fail. This is specifically true for
voodoo 2 boards, but it should be solved in recent versions. Please
contact me.
- The 24/32 is not likely to work anytime soon, knowing that the
hardware does ... unusual things in 24/32 bpp.
- When used with another video board, current limitations of the linux
console subsystem can cause some troubles, specifically, you should
disable software scrollback, as it can oops badly ...
Todo
- Get rid of the previous paragraph.
- Buy more coffee.
- test/port to other arch.
- try to add panning using tweeks with front and back buffer .
- try to implement accel on voodoo2, this board can actually do a
lot in 2D even if it was sold as a 3D only board ...
ghoz.
--
Ghozlane Toumi <gtoumi@laposte.net>
$Date: 2002/05/09 20:11:45 $
http://sstfb.sourceforge.net/README
Documentation/fb/tgafb.txt → Documentation/fb/tgafb.rst
View file @ ab42b818
$Id: tgafb.txt,v 1.1.2.2 2000/04/04 06:50:18 mato Exp $ ==============
What is tgafb? What is tgafb?
=============== ==============
This is a driver for DECChip 21030 based graphics framebuffers, a.k.a. TGA This is a driver for DECChip 21030 based graphics framebuffers, a.k.a. TGA
cards, which are usually found in older Digital Alpha systems. The cards, which are usually found in older Digital Alpha systems. The
following models are supported: following models are supported:
ZLxP-E1 (8bpp, 2 MB VRAM) - ZLxP-E1 (8bpp, 2 MB VRAM)
ZLxP-E2 (32bpp, 8 MB VRAM) - ZLxP-E2 (32bpp, 8 MB VRAM)
ZLxP-E3 (32bpp, 16 MB VRAM, Zbuffer) - ZLxP-E3 (32bpp, 16 MB VRAM, Zbuffer)
This version is an almost complete rewrite of the code written by Geert This version is an almost complete rewrite of the code written by Geert
Uytterhoeven, which was based on the original TGA console code written by Uytterhoeven, which was based on the original TGA console code written by
...@@ -36,18 +35,21 @@ Configuration ...@@ -36,18 +35,21 @@ Configuration
============= =============
You can pass kernel command line options to tgafb with You can pass kernel command line options to tgafb with
`video=tgafb:option1,option2:value2,option3' (multiple options should be `video=tgafb:option1,option2:value2,option3` (multiple options should be
separated by comma, values are separated from options by `:'). separated by comma, values are separated from options by `:`).
Accepted options: Accepted options:
font:X - default font to use. All fonts are supported, including the ========== ============================================================
font:X default font to use. All fonts are supported, including the
SUN12x22 font which is very nice at high resolutions. SUN12x22 font which is very nice at high resolutions.
mode:X - default video mode. The following video modes are supported: mode:X default video mode. The following video modes are supported:
640x480-60, 800x600-56, 640x480-72, 800x600-60, 800x600-72, 640x480-60, 800x600-56, 640x480-72, 800x600-60, 800x600-72,
1024x768-60, 1152x864-60, 1024x768-70, 1024x768-76, 1024x768-60, 1152x864-60, 1024x768-70, 1024x768-76,
1152x864-70, 1280x1024-61, 1024x768-85, 1280x1024-70, 1152x864-70, 1280x1024-61, 1024x768-85, 1280x1024-70,
1152x864-84, 1280x1024-76, 1280x1024-85 1152x864-84, 1280x1024-76, 1280x1024-85
========== ============================================================
Known Issues Known Issues
......
Documentation/fb/tridentfb.txt → Documentation/fb/tridentfb.rst
View file @ ab42b818
=========
Tridentfb
=========
Tridentfb is a framebuffer driver for some Trident chip based cards. Tridentfb is a framebuffer driver for some Trident chip based cards.
The following list of chips is thought to be supported although not all are The following list of chips is thought to be supported although not all are
...@@ -17,6 +21,7 @@ limited comparing to the range if acceleration is disabled (see list ...@@ -17,6 +21,7 @@ limited comparing to the range if acceleration is disabled (see list
of parameters below). of parameters below).
Known bugs: Known bugs:
1. The driver randomly locks up on 3DImage975 chip with acceleration 1. The driver randomly locks up on 3DImage975 chip with acceleration
enabled. The same happens in X11 (Xorg). enabled. The same happens in X11 (Xorg).
2. The ramdac speeds require some more fine tuning. It is possible to 2. The ramdac speeds require some more fine tuning. It is possible to
...@@ -26,28 +31,30 @@ Known bugs: ...@@ -26,28 +31,30 @@ Known bugs:
How to use it? How to use it?
============== ==============
When booting you can pass the video parameter. When booting you can pass the video parameter::
video=tridentfb
video=tridentfb
The parameters for tridentfb are concatenated with a ':' as in this example. The parameters for tridentfb are concatenated with a ':' as in this example::
video=tridentfb:800x600-16@75,noaccel video=tridentfb:800x600-16@75,noaccel
The second level parameters that tridentfb understands are: The second level parameters that tridentfb understands are:
noaccel - turns off acceleration (when it doesn't work for your card) ======== =====================================================================
noaccel turns off acceleration (when it doesn't work for your card)
fp - use flat panel related stuff fp use flat panel related stuff
crt - assume monitor is present instead of fp crt assume monitor is present instead of fp
center - for flat panels and resolutions smaller than native size center the center for flat panels and resolutions smaller than native size center the
image, otherwise use image, otherwise use
stretch stretch
memsize - integer value in KB, use if your card's memory size is misdetected. memsize integer value in KB, use if your card's memory size is misdetected.
look at the driver output to see what it says when initializing. look at the driver output to see what it says when initializing.
memdiff - integer value in KB, should be nonzero if your card reports memdiff integer value in KB, should be nonzero if your card reports
more memory than it actually has. For instance mine is 192K less than more memory than it actually has. For instance mine is 192K less than
detection says in all three BIOS selectable situations 2M, 4M, 8M. detection says in all three BIOS selectable situations 2M, 4M, 8M.
Only use if your video memory is taken from main memory hence of Only use if your video memory is taken from main memory hence of
...@@ -56,12 +63,13 @@ memdiff - integer value in KB, should be nonzero if your card reports ...@@ -56,12 +63,13 @@ memdiff - integer value in KB, should be nonzero if your card reports
at the bottom this might help by not letting change to that mode at the bottom this might help by not letting change to that mode
anymore. anymore.
nativex - the width in pixels of the flat panel.If you know it (usually 1024 nativex the width in pixels of the flat panel.If you know it (usually 1024
800 or 1280) and it is not what the driver seems to detect use it. 800 or 1280) and it is not what the driver seems to detect use it.
bpp - bits per pixel (8,16 or 32) bpp bits per pixel (8,16 or 32)
mode - a mode name like 800x600-8@75 as described in mode a mode name like 800x600-8@75 as described in
Documentation/fb/modedb.txt Documentation/fb/modedb.rst
======== =====================================================================
Using insane values for the above parameters will probably result in driver Using insane values for the above parameters will probably result in driver
misbehaviour so take care(for instance memsize=12345678 or memdiff=23784 or misbehaviour so take care(for instance memsize=12345678 or memdiff=23784 or
......
Documentation/fb/udlfb.txt → Documentation/fb/udlfb.rst
View file @ ab42b818
==============
What is udlfb? What is udlfb?
=============== ==============
This is a driver for DisplayLink USB 2.0 era graphics chips. This is a driver for DisplayLink USB 2.0 era graphics chips.
...@@ -100,6 +100,7 @@ options udlfb fb_defio=0 console=1 shadow=1 ...@@ -100,6 +100,7 @@ options udlfb fb_defio=0 console=1 shadow=1
Accepted boolean options: Accepted boolean options:
=============== ================================================================
fb_defio Make use of the fb_defio (CONFIG_FB_DEFERRED_IO) kernel fb_defio Make use of the fb_defio (CONFIG_FB_DEFERRED_IO) kernel
module to track changed areas of the framebuffer by page faults. module to track changed areas of the framebuffer by page faults.
Standard fbdev applications that use mmap but that do not Standard fbdev applications that use mmap but that do not
...@@ -119,6 +120,7 @@ shadow Allocate a 2nd framebuffer to shadow what's currently across ...@@ -119,6 +120,7 @@ shadow Allocate a 2nd framebuffer to shadow what's currently across
do not transmit. Spends host memory to save USB transfers. do not transmit. Spends host memory to save USB transfers.
Enabled by default. Only disable on very low memory systems. Enabled by default. Only disable on very low memory systems.
default: shadow=1 default: shadow=1
=============== ================================================================
Sysfs Attributes Sysfs Attributes
================ ================
...@@ -126,6 +128,7 @@ Sysfs Attributes ...@@ -126,6 +128,7 @@ Sysfs Attributes
Udlfb creates several files in /sys/class/graphics/fb? Udlfb creates several files in /sys/class/graphics/fb?
Where ? is the sequential framebuffer id of the particular DisplayLink device Where ? is the sequential framebuffer id of the particular DisplayLink device
======================== ========================================================
edid If a valid EDID blob is written to this file (typically edid If a valid EDID blob is written to this file (typically
by a udev rule), then udlfb will use this EDID as a by a udev rule), then udlfb will use this EDID as a
backup in case reading the actual EDID of the monitor backup in case reading the actual EDID of the monitor
...@@ -154,6 +157,6 @@ metrics_reset Write-only. Any write to this file resets all metrics ...@@ -154,6 +157,6 @@ metrics_reset Write-only. Any write to this file resets all metrics
roll over very quickly. To get reliable results, design roll over very quickly. To get reliable results, design
performance tests to start and finish in a very short performance tests to start and finish in a very short
period of time (one minute or less is safe). period of time (one minute or less is safe).
======================== ========================================================
--
Bernie Thompson <bernie@plugable.com> Bernie Thompson <bernie@plugable.com>
Documentation/fb/uvesafb.txt → Documentation/fb/uvesafb.rst
View file @ ab42b818
==========================================================
uvesafb - A Generic Driver for VBE2+ compliant video cards uvesafb - A Generic Driver for VBE2+ compliant video cards
========================================================== ==========================================================
...@@ -49,7 +49,7 @@ The most important limitations are: ...@@ -49,7 +49,7 @@ The most important limitations are:
uvesafb can be compiled either as a module, or directly into the kernel. uvesafb can be compiled either as a module, or directly into the kernel.
In both cases it supports the same set of configuration options, which In both cases it supports the same set of configuration options, which
are either given on the kernel command line or as module parameters, e.g.: are either given on the kernel command line or as module parameters, e.g.::
video=uvesafb:1024x768-32,mtrr:3,ywrap (compiled into the kernel) video=uvesafb:1024x768-32,mtrr:3,ywrap (compiled into the kernel)
...@@ -57,6 +57,7 @@ are either given on the kernel command line or as module parameters, e.g.: ...@@ -57,6 +57,7 @@ are either given on the kernel command line or as module parameters, e.g.:
Accepted options: Accepted options:
======= =========================================================
ypan Enable display panning using the VESA protected mode ypan Enable display panning using the VESA protected mode
interface. The visible screen is just a window of the interface. The visible screen is just a window of the
video memory, console scrolling is done by changing the video memory, console scrolling is done by changing the
...@@ -70,10 +71,12 @@ ywrap Same as ypan, but assumes your gfx board can wrap-around ...@@ -70,10 +71,12 @@ ywrap Same as ypan, but assumes your gfx board can wrap-around
redraw Scroll by redrawing the affected part of the screen, this redraw Scroll by redrawing the affected part of the screen, this
is the default on non-x86. is the default on non-x86.
======= =========================================================
(If you're using uvesafb as a module, the above three options are (If you're using uvesafb as a module, the above three options are
used a parameter of the scroll option, e.g. scroll=ypan.) used a parameter of the scroll option, e.g. scroll=ypan.)
=========== ====================================================================
vgapal Use the standard VGA registers for palette changes. vgapal Use the standard VGA registers for palette changes.
pmipal Use the protected mode interface for palette changes. pmipal Use the protected mode interface for palette changes.
...@@ -82,8 +85,9 @@ pmipal Use the protected mode interface for palette changes. ...@@ -82,8 +85,9 @@ pmipal Use the protected mode interface for palette changes.
mtrr:n Setup memory type range registers for the framebuffer mtrr:n Setup memory type range registers for the framebuffer
where n: where n:
0 - disabled (equivalent to nomtrr)
3 - write-combining (default) - 0 - disabled (equivalent to nomtrr)
- 3 - write-combining (default)
Values other than 0 and 3 will result in a warning and will be Values other than 0 and 3 will result in a warning and will be
treated just like 3. treated just like 3.
...@@ -94,8 +98,7 @@ vremap:n ...@@ -94,8 +98,7 @@ vremap:n
Remap 'n' MiB of video RAM. If 0 or not specified, remap memory Remap 'n' MiB of video RAM. If 0 or not specified, remap memory
according to video mode. according to video mode.
vtotal:n vtotal:n If the video BIOS of your card incorrectly determines the total
If the video BIOS of your card incorrectly determines the total
amount of video RAM, use this option to override the BIOS (in MiB). amount of video RAM, use this option to override the BIOS (in MiB).
<mode> The mode you want to set, in the standard modedb format. Refer to <mode> The mode you want to set, in the standard modedb format. Refer to
...@@ -103,8 +106,7 @@ vtotal:n ...@@ -103,8 +106,7 @@ vtotal:n
a module, the mode string should be provided as a value of the a module, the mode string should be provided as a value of the
'mode_option' option. 'mode_option' option.
vbemode:x vbemode:x Force the use of VBE mode x. The mode will only be set if it's
Force the use of VBE mode x. The mode will only be set if it's
found in the VBE-provided list of supported modes. found in the VBE-provided list of supported modes.
NOTE: The mode number 'x' should be specified in VESA mode number NOTE: The mode number 'x' should be specified in VESA mode number
notation, not the Linux kernel one (eg. 257 instead of 769). notation, not the Linux kernel one (eg. 257 instead of 769).
...@@ -117,25 +119,28 @@ nocrtc Do not use CRTC timings while setting the video mode. This option ...@@ -117,25 +119,28 @@ nocrtc Do not use CRTC timings while setting the video mode. This option
has any effect only if the Video BIOS is VBE 3.0 compliant. Use it has any effect only if the Video BIOS is VBE 3.0 compliant. Use it
if you have problems with modes set the standard way. Note that if you have problems with modes set the standard way. Note that
using this option implies that any refresh rate adjustments will using this option implies that any refresh rate adjustments will
be ignored and the refresh rate will stay at your BIOS default (60 Hz). be ignored and the refresh rate will stay at your BIOS default
(60 Hz).
noedid Do not try to fetch and use EDID-provided modes. noedid Do not try to fetch and use EDID-provided modes.
noblank Disable hardware blanking. noblank Disable hardware blanking.
v86d:path v86d:path Set path to the v86d executable. This option is only available as
Set path to the v86d executable. This option is only available as
a module parameter, and not as a part of the video= string. If you a module parameter, and not as a part of the video= string. If you
need to use it and have uvesafb built into the kernel, use need to use it and have uvesafb built into the kernel, use
uvesafb.v86d="path". uvesafb.v86d="path".
=========== ====================================================================
Additionally, the following parameters may be provided. They all override the Additionally, the following parameters may be provided. They all override the
EDID-provided values and BIOS defaults. Refer to your monitor's specs to get EDID-provided values and BIOS defaults. Refer to your monitor's specs to get
the correct values for maxhf, maxvf and maxclk for your hardware. the correct values for maxhf, maxvf and maxclk for your hardware.
=========== ======================================
maxhf:n Maximum horizontal frequency (in kHz). maxhf:n Maximum horizontal frequency (in kHz).
maxvf:n Maximum vertical frequency (in Hz). maxvf:n Maximum vertical frequency (in Hz).
maxclk:n Maximum pixel clock (in MHz). maxclk:n Maximum pixel clock (in MHz).
=========== ======================================
4. The sysfs interface 4. The sysfs interface
---------------------- ----------------------
...@@ -146,27 +151,26 @@ additional information. ...@@ -146,27 +151,26 @@ additional information.
Driver attributes: Driver attributes:
/sys/bus/platform/drivers/uvesafb /sys/bus/platform/drivers/uvesafb
- v86d (default: /sbin/v86d) v86d
(default: /sbin/v86d)
Path to the v86d executable. v86d is started by uvesafb Path to the v86d executable. v86d is started by uvesafb
if an instance of the daemon isn't already running. if an instance of the daemon isn't already running.
Device attributes: Device attributes:
/sys/bus/platform/drivers/uvesafb/uvesafb.0 /sys/bus/platform/drivers/uvesafb/uvesafb.0
- nocrtc nocrtc
Use the default refresh rate (60 Hz) if set to 1. Use the default refresh rate (60 Hz) if set to 1.
- oem_product_name oem_product_name, oem_product_rev, oem_string, oem_vendor
- oem_product_rev
- oem_string
- oem_vendor
Information about the card and its maker. Information about the card and its maker.
- vbe_modes vbe_modes
A list of video modes supported by the Video BIOS along with their A list of video modes supported by the Video BIOS along with their
VBE mode numbers in hex. VBE mode numbers in hex.
- vbe_version vbe_version
A BCD value indicating the implemented VBE standard. A BCD value indicating the implemented VBE standard.
5. Miscellaneous 5. Miscellaneous
...@@ -176,9 +180,9 @@ Uvesafb will set a video mode with the default refresh rate and timings ...@@ -176,9 +180,9 @@ Uvesafb will set a video mode with the default refresh rate and timings
from the Video BIOS if you set pixclock to 0 in fb_var_screeninfo. from the Video BIOS if you set pixclock to 0 in fb_var_screeninfo.
--
Michal Januszewski <spock@gentoo.org> Michal Januszewski <spock@gentoo.org>
Last updated: 2017-10-10 Last updated: 2017-10-10
Documentation of the uvesafb options is loosely based on vesafb.txt. Documentation of the uvesafb options is loosely based on vesafb.txt.
Documentation/fb/vesafb.txt → Documentation/fb/vesafb.rst
View file @ ab42b818
===============
What is vesafb? What is vesafb?
=============== ===============
...@@ -40,26 +40,31 @@ The graphic modes are NOT in the list which you get if you boot with ...@@ -40,26 +40,31 @@ 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 vga=ask and hit return. The mode you wish to use is derived from the
VESA mode number. Here are those VESA mode numbers: VESA mode number. Here are those VESA mode numbers:
| 640x480 800x600 1024x768 1280x1024 ====== ======= ======= ======== =========
----+------------------------------------- colors 640x480 800x600 1024x768 1280x1024
256 | 0x101 0x103 0x105 0x107 ====== ======= ======= ======== =========
32k | 0x110 0x113 0x116 0x119 256 0x101 0x103 0x105 0x107
64k | 0x111 0x114 0x117 0x11A 32k 0x110 0x113 0x116 0x119
16M | 0x112 0x115 0x118 0x11B 64k 0x111 0x114 0x117 0x11A
16M 0x112 0x115 0x118 0x11B
====== ======= ======= ======== =========
The video mode number of the Linux kernel is the VESA mode number plus The video mode number of the Linux kernel is the VESA mode number plus
0x200. 0x200:
Linux_kernel_mode_number = VESA_mode_number + 0x200 Linux_kernel_mode_number = VESA_mode_number + 0x200
So the table for the Kernel mode numbers are: So the table for the Kernel mode numbers are:
| 640x480 800x600 1024x768 1280x1024 ====== ======= ======= ======== =========
----+------------------------------------- colors 640x480 800x600 1024x768 1280x1024
256 | 0x301 0x303 0x305 0x307 ====== ======= ======= ======== =========
32k | 0x310 0x313 0x316 0x319 256 0x301 0x303 0x305 0x307
64k | 0x311 0x314 0x317 0x31A 32k 0x310 0x313 0x316 0x319
16M | 0x312 0x315 0x318 0x31B 64k 0x311 0x314 0x317 0x31A
16M 0x312 0x315 0x318 0x31B
====== ======= ======= ======== =========
To enable one of those modes you have to specify "vga=ask" in the 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 lilo.conf file and rerun LILO. Then you can type in the desired
...@@ -120,15 +125,22 @@ Accepted options: ...@@ -120,15 +125,22 @@ Accepted options:
inverse use inverse color map inverse use inverse color map
========= ======================================================================
ypan enable display panning using the VESA protected mode ypan enable display panning using the VESA protected mode
interface. The visible screen is just a window of the interface. The visible screen is just a window of the
video memory, console scrolling is done by changing the video memory, console scrolling is done by changing the
start of the window. start of the window.
pro: * scrolling (fullscreen) is fast, because there is
pro:
* scrolling (fullscreen) is fast, because there is
no need to copy around data. 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 the video memory can be used as scrollback buffer
kontra: * scrolling only parts of the screen causes some
kontra:
* scrolling only parts of the screen causes some
ugly flicker effects (boot logo flickers for ugly flicker effects (boot logo flickers for
example). example).
...@@ -136,7 +148,7 @@ ywrap Same as ypan, but assumes your gfx board can wrap-around ...@@ -136,7 +148,7 @@ ywrap Same as ypan, but assumes your gfx board can wrap-around
the video memory (i.e. starts reading from top if it the video memory (i.e. starts reading from top if it
reaches the end of video memory). Faster than ypan. reaches the end of video memory). Faster than ypan.
redraw scroll by redrawing the affected part of the screen, this redraw Scroll by redrawing the affected part of the screen, this
is the safe (and slow) default. is the safe (and slow) default.
...@@ -144,37 +156,36 @@ vgapal Use the standard vga registers for palette changes. ...@@ -144,37 +156,36 @@ vgapal Use the standard vga registers for palette changes.
This is the default. This is the default.
pmipal Use the protected mode interface for palette changes. pmipal Use the protected mode interface for palette changes.
mtrr:n setup memory type range registers for the vesafb framebuffer mtrr:n Setup memory type range registers for the vesafb framebuffer
where n: where n:
0 - disabled (equivalent to nomtrr) (default)
1 - uncachable - 0 - disabled (equivalent to nomtrr) (default)
2 - write-back - 1 - uncachable
3 - write-combining - 2 - write-back
4 - write-through - 3 - write-combining
- 4 - write-through
If you see the following in dmesg, choose the type that matches the If you see the following in dmesg, choose the type that matches the
old one. In this example, use "mtrr:2". old one. In this example, use "mtrr:2".
... ...
mtrr: type mismatch for e0000000,8000000 old: write-back new: write-combining mtrr: type mismatch for e0000000,8000000 old: write-back new:
write-combining
... ...
nomtrr disable mtrr nomtrr disable mtrr
vremap:n vremap:n
remap 'n' MiB of video RAM. If 0 or not specified, remap memory 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 according to video mode. (2.5.66 patch/idea by Antonino Daplas
reversed to give override possibility (allocate more fb memory reversed to give override possibility (allocate more fb memory
than the kernel would) to 2.4 by tmb@iki.fi) than the kernel would) to 2.4 by tmb@iki.fi)
vtotal:n vtotal:n If the video BIOS of your card incorrectly determines the total
if the video BIOS of your card incorrectly determines the total
amount of video RAM, use this option to override the BIOS (in MiB). amount of video RAM, use this option to override the BIOS (in MiB).
========= ======================================================================
Have fun! Have fun!
Gerd
--
Gerd Knorr <kraxel@goldbach.in-berlin.de> Gerd Knorr <kraxel@goldbach.in-berlin.de>
Minor (mostly typo) changes Minor (mostly typo) changes
......
Documentation/fb/viafb.rst 0 → 100644
View file @ ab42b818
=======================================================
VIA Integration Graphic Chip Console Framebuffer Driver
=======================================================
Platform
--------
The console framebuffer driver is for graphics chips of
VIA UniChrome Family
(CLE266, PM800 / CN400 / CN300,
P4M800CE / P4M800Pro / CN700 / VN800,
CX700 / VX700, K8M890, P4M890,
CN896 / P4M900, VX800, VX855)
Driver features
---------------
Device: CRT, LCD, DVI
Support viafb_mode::
CRT:
640x480(60, 75, 85, 100, 120 Hz), 720x480(60 Hz),
720x576(60 Hz), 800x600(60, 75, 85, 100, 120 Hz),
848x480(60 Hz), 856x480(60 Hz), 1024x512(60 Hz),
1024x768(60, 75, 85, 100 Hz), 1152x864(75 Hz),
1280x768(60 Hz), 1280x960(60 Hz), 1280x1024(60, 75, 85 Hz),
1440x1050(60 Hz), 1600x1200(60, 75 Hz), 1280x720(60 Hz),
1920x1080(60 Hz), 1400x1050(60 Hz), 800x480(60 Hz)
color depth: 8 bpp, 16 bpp, 32 bpp supports.
Support 2D hardware accelerator.
Using the viafb module
----------------------
Start viafb with default settings::
#modprobe viafb
Start viafb with user options::
#modprobe viafb viafb_mode=800x600 viafb_bpp=16 viafb_refresh=60
viafb_active_dev=CRT+DVI viafb_dvi_port=DVP1
viafb_mode1=1024x768 viafb_bpp=16 viafb_refresh1=60
viafb_SAMM_ON=1
viafb_mode:
- 640x480 (default)
- 720x480
- 800x600
- 1024x768
viafb_bpp:
- 8, 16, 32 (default:32)
viafb_refresh:
- 60, 75, 85, 100, 120 (default:60)
viafb_lcd_dsp_method:
- 0 : expansion (default)
- 1 : centering
viafb_lcd_mode:
0 : LCD panel with LSB data format input (default)
1 : LCD panel with MSB data format input
viafb_lcd_panel_id:
- 0 : Resolution: 640x480, Channel: single, Dithering: Enable
- 1 : Resolution: 800x600, Channel: single, Dithering: Enable
- 2 : Resolution: 1024x768, Channel: single, Dithering: Enable (default)
- 3 : Resolution: 1280x768, Channel: single, Dithering: Enable
- 4 : Resolution: 1280x1024, Channel: dual, Dithering: Enable
- 5 : Resolution: 1400x1050, Channel: dual, Dithering: Enable
- 6 : Resolution: 1600x1200, Channel: dual, Dithering: Enable
- 8 : Resolution: 800x480, Channel: single, Dithering: Enable
- 9 : Resolution: 1024x768, Channel: dual, Dithering: Enable
- 10: Resolution: 1024x768, Channel: single, Dithering: Disable
- 11: Resolution: 1024x768, Channel: dual, Dithering: Disable
- 12: Resolution: 1280x768, Channel: single, Dithering: Disable
- 13: Resolution: 1280x1024, Channel: dual, Dithering: Disable
- 14: Resolution: 1400x1050, Channel: dual, Dithering: Disable
- 15: Resolution: 1600x1200, Channel: dual, Dithering: Disable
- 16: Resolution: 1366x768, Channel: single, Dithering: Disable
- 17: Resolution: 1024x600, Channel: single, Dithering: Enable
- 18: Resolution: 1280x768, Channel: dual, Dithering: Enable
- 19: Resolution: 1280x800, Channel: single, Dithering: Enable
viafb_accel:
- 0 : No 2D Hardware Acceleration
- 1 : 2D Hardware Acceleration (default)
viafb_SAMM_ON:
- 0 : viafb_SAMM_ON disable (default)
- 1 : viafb_SAMM_ON enable
viafb_mode1: (secondary display device)
- 640x480 (default)
- 720x480
- 800x600
- 1024x768
viafb_bpp1: (secondary display device)
- 8, 16, 32 (default:32)
viafb_refresh1: (secondary display device)
- 60, 75, 85, 100, 120 (default:60)
viafb_active_dev:
This option is used to specify active devices.(CRT, DVI, CRT+LCD...)
DVI stands for DVI or HDMI, E.g., If you want to enable HDMI,
set viafb_active_dev=DVI. In SAMM case, the previous of
viafb_active_dev is primary device, and the following is
secondary device.
For example:
To enable one device, such as DVI only, we can use::
modprobe viafb viafb_active_dev=DVI
To enable two devices, such as CRT+DVI::
modprobe viafb viafb_active_dev=CRT+DVI;
For DuoView case, we can use::
modprobe viafb viafb_active_dev=CRT+DVI
OR::
modprobe viafb viafb_active_dev=DVI+CRT...
For SAMM case:
If CRT is primary and DVI is secondary, we should use::
modprobe viafb viafb_active_dev=CRT+DVI viafb_SAMM_ON=1...
If DVI is primary and CRT is secondary, we should use::
modprobe viafb viafb_active_dev=DVI+CRT viafb_SAMM_ON=1...
viafb_display_hardware_layout:
This option is used to specify display hardware layout for CX700 chip.
- 1 : LCD only
- 2 : DVI only
- 3 : LCD+DVI (default)
- 4 : LCD1+LCD2 (internal + internal)
- 16: LCD1+ExternalLCD2 (internal + external)
viafb_second_size:
This option is used to set second device memory size(MB) in SAMM case.
The minimal size is 16.
viafb_platform_epia_dvi:
This option is used to enable DVI on EPIA - M
- 0 : No DVI on EPIA - M (default)
- 1 : DVI on EPIA - M
viafb_bus_width:
When using 24 - Bit Bus Width Digital Interface,
this option should be set.
- 12: 12-Bit LVDS or 12-Bit TMDS (default)
- 24: 24-Bit LVDS or 24-Bit TMDS
viafb_device_lcd_dualedge:
When using Dual Edge Panel, this option should be set.
- 0 : No Dual Edge Panel (default)
- 1 : Dual Edge Panel
viafb_lcd_port:
This option is used to specify LCD output port,
available values are "DVP0" "DVP1" "DFP_HIGHLOW" "DFP_HIGH" "DFP_LOW".
for external LCD + external DVI on CX700(External LCD is on DVP0),
we should use::
modprobe viafb viafb_lcd_port=DVP0...
Notes:
1. CRT may not display properly for DuoView CRT & DVI display at
the "640x480" PAL mode with DVI overscan enabled.
2. SAMM stands for single adapter multi monitors. It is different from
multi-head since SAMM support multi monitor at driver layers, thus fbcon
layer doesn't even know about it; SAMM's second screen doesn't have a
device node file, thus a user mode application can't access it directly.
When SAMM is enabled, viafb_mode and viafb_mode1, viafb_bpp and
viafb_bpp1, viafb_refresh and viafb_refresh1 can be different.
3. When console is depending on viafbinfo1, dynamically change resolution
and bpp, need to call VIAFB specified ioctl interface VIAFB_SET_DEVICE
instead of calling common ioctl function FBIOPUT_VSCREENINFO since
viafb doesn't support multi-head well, or it will cause screen crush.
Configure viafb with "fbset" tool
---------------------------------
"fbset" is an inbox utility of Linux.
1. Inquire current viafb information, type::
# fbset -i
2. Set various resolutions and viafb_refresh rates::
# fbset <resolution-vertical_sync>
example::
# fbset "1024x768-75"
or::
# fbset -g 1024 768 1024 768 32
Check the file "/etc/fb.modes" to find display modes available.
3. Set the color depth::
# fbset -depth <value>
example::
# fbset -depth 16
Configure viafb via /proc
-------------------------
The following files exist in /proc/viafb
supported_output_devices
This read-only file contains a full ',' separated list containing all
output devices that could be available on your platform. It is likely
that not all of those have a connector on your hardware but it should
provide a good starting point to figure out which of those names match
a real connector.
Example::
# cat /proc/viafb/supported_output_devices
iga1/output_devices, iga2/output_devices
These two files are readable and writable. iga1 and iga2 are the two
independent units that produce the screen image. Those images can be
forwarded to one or more output devices. Reading those files is a way
to query which output devices are currently used by an iga.
Example::
# cat /proc/viafb/iga1/output_devices
If there are no output devices printed the output of this iga is lost.
This can happen for example if only one (the other) iga is used.
Writing to these files allows adjusting the output devices during
runtime. One can add new devices, remove existing ones or switch
between igas. Essentially you can write a ',' separated list of device
names (or a single one) in the same format as the output to those
files. You can add a '+' or '-' as a prefix allowing simple addition
and removal of devices. So a prefix '+' adds the devices from your list
to the already existing ones, '-' removes the listed devices from the
existing ones and if no prefix is given it replaces all existing ones
with the listed ones. If you remove devices they are expected to turn
off. If you add devices that are already part of the other iga they are
removed there and added to the new one.
Examples:
Add CRT as output device to iga1::
# echo +CRT > /proc/viafb/iga1/output_devices
Remove (turn off) DVP1 and LVDS1 as output devices of iga2::
# echo -DVP1,LVDS1 > /proc/viafb/iga2/output_devices
Replace all iga1 output devices by CRT::
# echo CRT > /proc/viafb/iga1/output_devices
Bootup with viafb
-----------------
Add the following line to your grub.conf::
append = "video=viafb:viafb_mode=1024x768,viafb_bpp=32,viafb_refresh=85"
VIA Framebuffer modes
=====================
.. include:: viafb.modes
:literal:
Documentation/fb/viafb.txt deleted 100644 → 0
View file @ 10ffebbe
VIA Integration Graphic Chip Console Framebuffer Driver
[Platform]
-----------------------
The console framebuffer driver is for graphics chips of
VIA UniChrome Family(CLE266, PM800 / CN400 / CN300,
P4M800CE / P4M800Pro / CN700 / VN800,
CX700 / VX700, K8M890, P4M890,
CN896 / P4M900, VX800, VX855)
[Driver features]
------------------------
Device: CRT, LCD, DVI
Support viafb_mode:
CRT:
640x480(60, 75, 85, 100, 120 Hz), 720x480(60 Hz),
720x576(60 Hz), 800x600(60, 75, 85, 100, 120 Hz),
848x480(60 Hz), 856x480(60 Hz), 1024x512(60 Hz),
1024x768(60, 75, 85, 100 Hz), 1152x864(75 Hz),
1280x768(60 Hz), 1280x960(60 Hz), 1280x1024(60, 75, 85 Hz),
1440x1050(60 Hz), 1600x1200(60, 75 Hz), 1280x720(60 Hz),
1920x1080(60 Hz), 1400x1050(60 Hz), 800x480(60 Hz)
color depth: 8 bpp, 16 bpp, 32 bpp supports.
Support 2D hardware accelerator.
[Using the viafb module]
-- -- --------------------
Start viafb with default settings:
#modprobe viafb
Start viafb with user options:
#modprobe viafb viafb_mode=800x600 viafb_bpp=16 viafb_refresh=60
viafb_active_dev=CRT+DVI viafb_dvi_port=DVP1
viafb_mode1=1024x768 viafb_bpp=16 viafb_refresh1=60
viafb_SAMM_ON=1
viafb_mode:
640x480 (default)
720x480
800x600
1024x768
......
viafb_bpp:
8, 16, 32 (default:32)
viafb_refresh:
60, 75, 85, 100, 120 (default:60)
viafb_lcd_dsp_method:
0 : expansion (default)
1 : centering
viafb_lcd_mode:
0 : LCD panel with LSB data format input (default)
1 : LCD panel with MSB data format input
viafb_lcd_panel_id:
0 : Resolution: 640x480, Channel: single, Dithering: Enable
1 : Resolution: 800x600, Channel: single, Dithering: Enable
2 : Resolution: 1024x768, Channel: single, Dithering: Enable (default)
3 : Resolution: 1280x768, Channel: single, Dithering: Enable
4 : Resolution: 1280x1024, Channel: dual, Dithering: Enable
5 : Resolution: 1400x1050, Channel: dual, Dithering: Enable
6 : Resolution: 1600x1200, Channel: dual, Dithering: Enable
8 : Resolution: 800x480, Channel: single, Dithering: Enable
9 : Resolution: 1024x768, Channel: dual, Dithering: Enable
10: Resolution: 1024x768, Channel: single, Dithering: Disable
11: Resolution: 1024x768, Channel: dual, Dithering: Disable
12: Resolution: 1280x768, Channel: single, Dithering: Disable
13: Resolution: 1280x1024, Channel: dual, Dithering: Disable
14: Resolution: 1400x1050, Channel: dual, Dithering: Disable
15: Resolution: 1600x1200, Channel: dual, Dithering: Disable
16: Resolution: 1366x768, Channel: single, Dithering: Disable
17: Resolution: 1024x600, Channel: single, Dithering: Enable
18: Resolution: 1280x768, Channel: dual, Dithering: Enable
19: Resolution: 1280x800, Channel: single, Dithering: Enable
viafb_accel:
0 : No 2D Hardware Acceleration
1 : 2D Hardware Acceleration (default)
viafb_SAMM_ON:
0 : viafb_SAMM_ON disable (default)
1 : viafb_SAMM_ON enable
viafb_mode1: (secondary display device)
640x480 (default)
720x480
800x600
1024x768
... ...
viafb_bpp1: (secondary display device)
8, 16, 32 (default:32)
viafb_refresh1: (secondary display device)
60, 75, 85, 100, 120 (default:60)
viafb_active_dev:
This option is used to specify active devices.(CRT, DVI, CRT+LCD...)
DVI stands for DVI or HDMI, E.g., If you want to enable HDMI,
set viafb_active_dev=DVI. In SAMM case, the previous of
viafb_active_dev is primary device, and the following is
secondary device.
For example:
To enable one device, such as DVI only, we can use:
modprobe viafb viafb_active_dev=DVI
To enable two devices, such as CRT+DVI:
modprobe viafb viafb_active_dev=CRT+DVI;
For DuoView case, we can use:
modprobe viafb viafb_active_dev=CRT+DVI
OR
modprobe viafb viafb_active_dev=DVI+CRT...
For SAMM case:
If CRT is primary and DVI is secondary, we should use:
modprobe viafb viafb_active_dev=CRT+DVI viafb_SAMM_ON=1...
If DVI is primary and CRT is secondary, we should use:
modprobe viafb viafb_active_dev=DVI+CRT viafb_SAMM_ON=1...
viafb_display_hardware_layout:
This option is used to specify display hardware layout for CX700 chip.
1 : LCD only
2 : DVI only
3 : LCD+DVI (default)
4 : LCD1+LCD2 (internal + internal)
16: LCD1+ExternalLCD2 (internal + external)
viafb_second_size:
This option is used to set second device memory size(MB) in SAMM case.
The minimal size is 16.
viafb_platform_epia_dvi:
This option is used to enable DVI on EPIA - M
0 : No DVI on EPIA - M (default)
1 : DVI on EPIA - M
viafb_bus_width:
When using 24 - Bit Bus Width Digital Interface,
this option should be set.
12: 12-Bit LVDS or 12-Bit TMDS (default)
24: 24-Bit LVDS or 24-Bit TMDS
viafb_device_lcd_dualedge:
When using Dual Edge Panel, this option should be set.
0 : No Dual Edge Panel (default)
1 : Dual Edge Panel
viafb_lcd_port:
This option is used to specify LCD output port,
available values are "DVP0" "DVP1" "DFP_HIGHLOW" "DFP_HIGH" "DFP_LOW".
for external LCD + external DVI on CX700(External LCD is on DVP0),
we should use:
modprobe viafb viafb_lcd_port=DVP0...
Notes:
1. CRT may not display properly for DuoView CRT & DVI display at
the "640x480" PAL mode with DVI overscan enabled.
2. SAMM stands for single adapter multi monitors. It is different from
multi-head since SAMM support multi monitor at driver layers, thus fbcon
layer doesn't even know about it; SAMM's second screen doesn't have a
device node file, thus a user mode application can't access it directly.
When SAMM is enabled, viafb_mode and viafb_mode1, viafb_bpp and
viafb_bpp1, viafb_refresh and viafb_refresh1 can be different.
3. When console is depending on viafbinfo1, dynamically change resolution
and bpp, need to call VIAFB specified ioctl interface VIAFB_SET_DEVICE
instead of calling common ioctl function FBIOPUT_VSCREENINFO since
viafb doesn't support multi-head well, or it will cause screen crush.
[Configure viafb with "fbset" tool]
-----------------------------------
"fbset" is an inbox utility of Linux.
1. Inquire current viafb information, type,
# fbset -i
2. Set various resolutions and viafb_refresh rates,
# fbset <resolution-vertical_sync>
example,
# fbset "1024x768-75"
or
# fbset -g 1024 768 1024 768 32
Check the file "/etc/fb.modes" to find display modes available.
3. Set the color depth,
# fbset -depth <value>
example,
# fbset -depth 16
[Configure viafb via /proc]
---------------------------
The following files exist in /proc/viafb
supported_output_devices
This read-only file contains a full ',' separated list containing all
output devices that could be available on your platform. It is likely
that not all of those have a connector on your hardware but it should
provide a good starting point to figure out which of those names match
a real connector.
Example:
# cat /proc/viafb/supported_output_devices
iga1/output_devices
iga2/output_devices
These two files are readable and writable. iga1 and iga2 are the two
independent units that produce the screen image. Those images can be
forwarded to one or more output devices. Reading those files is a way
to query which output devices are currently used by an iga.
Example:
# cat /proc/viafb/iga1/output_devices
If there are no output devices printed the output of this iga is lost.
This can happen for example if only one (the other) iga is used.
Writing to these files allows adjusting the output devices during
runtime. One can add new devices, remove existing ones or switch
between igas. Essentially you can write a ',' separated list of device
names (or a single one) in the same format as the output to those
files. You can add a '+' or '-' as a prefix allowing simple addition
and removal of devices. So a prefix '+' adds the devices from your list
to the already existing ones, '-' removes the listed devices from the
existing ones and if no prefix is given it replaces all existing ones
with the listed ones. If you remove devices they are expected to turn
off. If you add devices that are already part of the other iga they are
removed there and added to the new one.
Examples:
Add CRT as output device to iga1
# echo +CRT > /proc/viafb/iga1/output_devices
Remove (turn off) DVP1 and LVDS1 as output devices of iga2
# echo -DVP1,LVDS1 > /proc/viafb/iga2/output_devices
Replace all iga1 output devices by CRT
# echo CRT > /proc/viafb/iga1/output_devices
[Bootup with viafb]:
--------------------
Add the following line to your grub.conf:
append = "video=viafb:viafb_mode=1024x768,viafb_bpp=32,viafb_refresh=85"
Documentation/fb/vt8623fb.txt → Documentation/fb/vt8623fb.rst
View file @ ab42b818
===============================================================
vt8623fb - fbdev driver for graphics core in VIA VT8623 chipset vt8623fb - fbdev driver for graphics core in VIA VT8623 chipset
=============================================================== ===============================================================
Supported Hardware Supported Hardware
================== ==================
VIA VT8623 [CLE266] chipset and its graphics core VIA VT8623 [CLE266] chipset and its graphics core
(known as CastleRock or Unichrome) (known as CastleRock or Unichrome)
I tested vt8623fb on VIA EPIA ML-6000 I tested vt8623fb on VIA EPIA ML-6000
......
MAINTAINERS
View file @ ab42b818
...@@ -4789,7 +4789,7 @@ S: Maintained ...@@ -4789,7 +4789,7 @@ S: Maintained
W: http://plugable.com/category/projects/udlfb/ W: http://plugable.com/category/projects/udlfb/
F: drivers/video/fbdev/udlfb.c F: drivers/video/fbdev/udlfb.c
F: include/video/udlfb.h F: include/video/udlfb.h
F: Documentation/fb/udlfb.txt F: Documentation/fb/udlfb.rst
DISTRIBUTED LOCK MANAGER (DLM) DISTRIBUTED LOCK MANAGER (DLM)
M: Christine Caulfield <ccaulfie@redhat.com> M: Christine Caulfield <ccaulfie@redhat.com>
...@@ -7923,7 +7923,7 @@ INTEL FRAMEBUFFER DRIVER (excluding 810 and 815) ...@@ -7923,7 +7923,7 @@ INTEL FRAMEBUFFER DRIVER (excluding 810 and 815)
M: Maik Broemme <mbroemme@libmpq.org> M: Maik Broemme <mbroemme@libmpq.org>
L: linux-fbdev@vger.kernel.org L: linux-fbdev@vger.kernel.org
S: Maintained S: Maintained
F: Documentation/fb/intelfb.txt F: Documentation/fb/intelfb.rst
F: drivers/video/fbdev/intelfb/ F: drivers/video/fbdev/intelfb/
INTEL GPIO DRIVERS INTEL GPIO DRIVERS
...@@ -14350,7 +14350,7 @@ M: Sudip Mukherjee <sudip.mukherjee@codethink.co.uk> ...@@ -14350,7 +14350,7 @@ M: Sudip Mukherjee <sudip.mukherjee@codethink.co.uk>
L: linux-fbdev@vger.kernel.org L: linux-fbdev@vger.kernel.org
S: Maintained S: Maintained
F: drivers/video/fbdev/sm712* F: drivers/video/fbdev/sm712*
F: Documentation/fb/sm712fb.txt F: Documentation/fb/sm712fb.rst
SIMPLE FIRMWARE INTERFACE (SFI) SIMPLE FIRMWARE INTERFACE (SFI)
M: Len Brown <lenb@kernel.org> M: Len Brown <lenb@kernel.org>
...@@ -14420,7 +14420,7 @@ SIS FRAMEBUFFER DRIVER ...@@ -14420,7 +14420,7 @@ SIS FRAMEBUFFER DRIVER
M: Thomas Winischhofer <thomas@winischhofer.net> M: Thomas Winischhofer <thomas@winischhofer.net>
W: http://www.winischhofer.net/linuxsisvga.shtml W: http://www.winischhofer.net/linuxsisvga.shtml
S: Maintained S: Maintained
F: Documentation/fb/sisfb.txt F: Documentation/fb/sisfb.rst
F: drivers/video/fbdev/sis/ F: drivers/video/fbdev/sis/
F: include/video/sisfb.h F: include/video/sisfb.h
...@@ -16608,7 +16608,7 @@ M: Michal Januszewski <spock@gentoo.org> ...@@ -16608,7 +16608,7 @@ M: Michal Januszewski <spock@gentoo.org>
L: linux-fbdev@vger.kernel.org L: linux-fbdev@vger.kernel.org
W: https://github.com/mjanusz/v86d W: https://github.com/mjanusz/v86d
S: Maintained S: Maintained
F: Documentation/fb/uvesafb.txt F: Documentation/fb/uvesafb.rst
F: drivers/video/fbdev/uvesafb.* F: drivers/video/fbdev/uvesafb.*
VF610 NAND DRIVER VF610 NAND DRIVER
......
drivers/tty/Kconfig
View file @ ab42b818
...@@ -95,7 +95,7 @@ config VT_HW_CONSOLE_BINDING ...@@ -95,7 +95,7 @@ config VT_HW_CONSOLE_BINDING
See <file:Documentation/console/console.txt> for more See <file:Documentation/console/console.txt> for more
information. For framebuffer console users, please refer to information. For framebuffer console users, please refer to
<file:Documentation/fb/fbcon.txt>. <file:Documentation/fb/fbcon.rst>.
config UNIX98_PTYS config UNIX98_PTYS
bool "Unix98 PTY support" if EXPERT bool "Unix98 PTY support" if EXPERT
......
drivers/video/fbdev/Kconfig
View file @ ab42b818
...@@ -31,7 +31,7 @@ menuconfig FB ...@@ -31,7 +31,7 @@ menuconfig FB
in the /dev directory, i.e. /dev/fb*. in the /dev directory, i.e. /dev/fb*.
You need an utility program called fbset to make full use of frame You need an utility program called fbset to make full use of frame
buffer devices. Please read <file:Documentation/fb/framebuffer.txt> buffer devices. Please read <file:Documentation/fb/framebuffer.rst>
and the Framebuffer-HOWTO at and the Framebuffer-HOWTO at
<http://www.munted.org.uk/programming/Framebuffer-HOWTO-1.3.html> for more <http://www.munted.org.uk/programming/Framebuffer-HOWTO-1.3.html> for more
information. information.
...@@ -241,7 +241,7 @@ config FB_CIRRUS ...@@ -241,7 +241,7 @@ config FB_CIRRUS
If you have a PCI-based system, this enables support for these If you have a PCI-based system, this enables support for these
chips: GD-543x, GD-544x, GD-5480. chips: GD-543x, GD-544x, GD-5480.
Please read the file <file:Documentation/fb/cirrusfb.txt>. Please read the file <file:Documentation/fb/cirrusfb.rst>.
Say N unless you have such a graphics board or plan to get one Say N unless you have such a graphics board or plan to get one
before you next recompile the kernel. before you next recompile the kernel.
...@@ -614,7 +614,7 @@ config FB_UVESA ...@@ -614,7 +614,7 @@ config FB_UVESA
This driver generally provides more features than vesafb but This driver generally provides more features than vesafb but
requires a userspace helper application called 'v86d'. See requires a userspace helper application called 'v86d'. See
<file:Documentation/fb/uvesafb.txt> for more information. <file:Documentation/fb/uvesafb.rst> for more information.
If unsure, say N. If unsure, say N.
...@@ -629,7 +629,7 @@ config FB_VESA ...@@ -629,7 +629,7 @@ config FB_VESA
This is the frame buffer device driver for generic VESA 2.0 This is the frame buffer device driver for generic VESA 2.0
compliant graphic cards. The older VESA 1.2 cards are not supported. 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 You will get a boot time penguin logo at no additional cost. Please
read <file:Documentation/fb/vesafb.txt>. If unsure, say Y. read <file:Documentation/fb/vesafb.rst>. If unsure, say Y.
config FB_EFI config FB_EFI
bool "EFI-based Framebuffer Support" bool "EFI-based Framebuffer Support"
...@@ -825,7 +825,7 @@ config FB_PVR2 ...@@ -825,7 +825,7 @@ config FB_PVR2
module load time. The parameters look like "video=pvr2:XXX", where module load time. The parameters look like "video=pvr2:XXX", where
the meaning of XXX can be found at the end of the main source file the meaning of XXX can be found at the end of the main source file
(<file:drivers/video/pvr2fb.c>). Please see the file (<file:drivers/video/pvr2fb.c>). Please see the file
<file:Documentation/fb/pvr2fb.txt>. <file:Documentation/fb/pvr2fb.rst>.
config FB_OPENCORES config FB_OPENCORES
tristate "OpenCores VGA/LCD core 2.0 framebuffer support" tristate "OpenCores VGA/LCD core 2.0 framebuffer support"
...@@ -987,7 +987,7 @@ config FB_I810 ...@@ -987,7 +987,7 @@ config FB_I810
module will be called i810fb. module will be called i810fb.
For more information, please read For more information, please read
<file:Documentation/fb/intel810.txt> <file:Documentation/fb/intel810.rst>
config FB_I810_GTF config FB_I810_GTF
bool "use VESA Generalized Timing Formula" bool "use VESA Generalized Timing Formula"
...@@ -1057,7 +1057,7 @@ config FB_INTEL ...@@ -1057,7 +1057,7 @@ config FB_INTEL
To compile this driver as a module, choose M here: the To compile this driver as a module, choose M here: the
module will be called intelfb. module will be called intelfb.
For more information, please read <file:Documentation/fb/intelfb.txt> For more information, please read <file:Documentation/fb/intelfb.rst>
config FB_INTEL_DEBUG config FB_INTEL_DEBUG
bool "Intel driver Debug Messages" bool "Intel driver Debug Messages"
...@@ -1094,7 +1094,7 @@ config FB_MATROX ...@@ -1094,7 +1094,7 @@ config FB_MATROX
You can pass several parameters to the driver at boot time or at You can pass several parameters to the driver at boot time or at
module load time. The parameters look like "video=matroxfb:XXX", and module load time. The parameters look like "video=matroxfb:XXX", and
are described in <file:Documentation/fb/matroxfb.txt>. are described in <file:Documentation/fb/matroxfb.rst>.
config FB_MATROX_MILLENIUM config FB_MATROX_MILLENIUM
bool "Millennium I/II support" bool "Millennium I/II support"
...@@ -1245,7 +1245,7 @@ config FB_ATY128 ...@@ -1245,7 +1245,7 @@ config FB_ATY128
help help
This driver supports graphics boards with the ATI Rage128 chips. This driver supports graphics boards with the ATI Rage128 chips.
Say Y if you have such a graphics board and read Say Y if you have such a graphics board and read
<file:Documentation/fb/aty128fb.txt>. <file:Documentation/fb/aty128fb.rst>.
To compile this driver as a module, choose M here: the To compile this driver as a module, choose M here: the
module will be called aty128fb. module will be called aty128fb.
...@@ -1507,7 +1507,7 @@ config FB_VOODOO1 ...@@ -1507,7 +1507,7 @@ config FB_VOODOO1
WARNING: Do not use any application that uses the 3D engine WARNING: Do not use any application that uses the 3D engine
(namely glide) while using this driver. (namely glide) while using this driver.
Please read the <file:Documentation/fb/sstfb.txt> for supported Please read the <file:Documentation/fb/sstfb.rst> for supported
options and other important info support. options and other important info support.
config FB_VT8623 config FB_VT8623
...@@ -1539,7 +1539,7 @@ config FB_TRIDENT ...@@ -1539,7 +1539,7 @@ config FB_TRIDENT
There are also integrated versions of these chips called CyberXXXX, There are also integrated versions of these chips called CyberXXXX,
CyberImage or CyberBlade. These chips are mostly found in laptops CyberImage or CyberBlade. These chips are mostly found in laptops
but also on some motherboards including early VIA EPIA motherboards. but also on some motherboards including early VIA EPIA motherboards.
For more information, read <file:Documentation/fb/tridentfb.txt> For more information, read <file:Documentation/fb/tridentfb.rst>
Say Y if you have such a graphics board. Say Y if you have such a graphics board.
...@@ -1778,7 +1778,7 @@ config FB_PXA_PARAMETERS ...@@ -1778,7 +1778,7 @@ config FB_PXA_PARAMETERS
single model of flatpanel then you can safely leave this single model of flatpanel then you can safely leave this
option disabled. option disabled.
<file:Documentation/fb/pxafb.txt> describes the available parameters. <file:Documentation/fb/pxafb.rst> describes the available parameters.
config PXA3XX_GCU config PXA3XX_GCU
tristate "PXA3xx 2D graphics accelerator driver" tristate "PXA3xx 2D graphics accelerator driver"
......
drivers/video/fbdev/matrox/matroxfb_base.c
View file @ ab42b818
...@@ -2502,7 +2502,7 @@ MODULE_PARM_DESC(nobios, "Disables ROM BIOS (0 or 1=disabled) (default=do not ch ...@@ -2502,7 +2502,7 @@ MODULE_PARM_DESC(nobios, "Disables ROM BIOS (0 or 1=disabled) (default=do not ch
module_param(noinit, int, 0); module_param(noinit, int, 0);
MODULE_PARM_DESC(noinit, "Disables W/SG/SD-RAM and bus interface initialization (0 or 1=do not initialize) (default=0)"); MODULE_PARM_DESC(noinit, "Disables W/SG/SD-RAM and bus interface initialization (0 or 1=do not initialize) (default=0)");
module_param(memtype, int, 0); module_param(memtype, int, 0);
MODULE_PARM_DESC(memtype, "Memory type for G200/G400 (see Documentation/fb/matroxfb.txt for explanation) (default=3 for G200, 0 for G400)"); MODULE_PARM_DESC(memtype, "Memory type for G200/G400 (see Documentation/fb/matroxfb.rst for explanation) (default=3 for G200, 0 for G400)");
module_param(mtrr, int, 0); module_param(mtrr, int, 0);
MODULE_PARM_DESC(mtrr, "This speeds up video memory accesses (0=disabled or 1) (default=1)"); MODULE_PARM_DESC(mtrr, "This speeds up video memory accesses (0=disabled or 1) (default=1)");
module_param(sgram, int, 0); module_param(sgram, int, 0);
......
drivers/video/fbdev/pxafb.c
View file @ ab42b818
...@@ -2068,7 +2068,7 @@ static int __init pxafb_setup_options(void) ...@@ -2068,7 +2068,7 @@ static int __init pxafb_setup_options(void)
#define pxafb_setup_options() (0) #define pxafb_setup_options() (0)
module_param_string(options, g_options, sizeof(g_options), 0); module_param_string(options, g_options, sizeof(g_options), 0);
MODULE_PARM_DESC(options, "LCD parameters (see Documentation/fb/pxafb.txt)"); MODULE_PARM_DESC(options, "LCD parameters (see Documentation/fb/pxafb.rst)");
#endif #endif
#else #else
......
drivers/video/fbdev/sh7760fb.c
View file @ ab42b818
...@@ -6,7 +6,7 @@ ...@@ -6,7 +6,7 @@
* Manuel Lauss <mano@roarinelk.homelinux.net> * Manuel Lauss <mano@roarinelk.homelinux.net>
* (c) 2008 Nobuhiro Iwamatsu <iwamatsu.nobuhiro@renesas.com> * (c) 2008 Nobuhiro Iwamatsu <iwamatsu.nobuhiro@renesas.com>
* *
* PLEASE HAVE A LOOK AT Documentation/fb/sh7760fb.txt! * PLEASE HAVE A LOOK AT Documentation/fb/sh7760fb.rst!
* *
* Thanks to Siegfried Schaefer <s.schaefer at schaefer-edv.de> * Thanks to Siegfried Schaefer <s.schaefer at schaefer-edv.de>
* for his original source and testing! * for his original source and testing!
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment
GitLab Nexedi Edition | About GitLab | About Nexedi | 沪ICP备2021021310号-2 | 沪ICP备2021021310号-7