Commit 703aea28 authored by Siarhei Siamashka's avatar Siarhei Siamashka
Browse files

Rename "fbdev" -> "sunxifb" and update man page

As there is no way for the hardware specific bits to be accepted
in xf86-video-fbdev, we need a new driver with its own name.
parent ac293412
xf86-video-fbdev - video driver for framebuffer device xf86-video-sunxifb - video driver for the devices based on Allwinner A10/A13 SoC
Please submit bugs & patches to the Xorg bugzilla: Please submit bugs & patches to:
https://bugs.freedesktop.org/enter_bug.cgi?product=xorg https://github.com/ssvb/xf86-video-sunxifb
All questions regarding this software should be directed at the All questions regarding this software should be directed at the
Xorg mailing list: linux-sunxi mailing list:
http://lists.freedesktop.org/mailman/listinfo/xorg https://groups.google.com/d/forum/linux-sunxi
The master development code repository can be found at:
git://anongit.freedesktop.org/git/xorg/driver/xf86-video-fbdev
http://cgit.freedesktop.org/xorg/driver/xf86-video-fbdev
For more information on the git code manager, see:
http://wiki.x.org/wiki/GitPage
...@@ -22,10 +22,10 @@ ...@@ -22,10 +22,10 @@
# Initialize Autoconf # Initialize Autoconf
AC_PREREQ([2.60]) AC_PREREQ([2.60])
AC_INIT([xf86-video-fbdev], AC_INIT([xf86-video-sunxifb],
[0.4.3], [0.0.1],
[https://bugs.freedesktop.org/enter_bug.cgi?product=xorg], [https://github.com/ssvb/xf86-video-sunxifb],
[xf86-video-fbdev]) [xf86-video-sunxifb])
AC_CONFIG_SRCDIR([Makefile.am]) AC_CONFIG_SRCDIR([Makefile.am])
AC_CONFIG_HEADERS([config.h]) AC_CONFIG_HEADERS([config.h])
AC_CONFIG_AUX_DIR(.) AC_CONFIG_AUX_DIR(.)
...@@ -84,7 +84,7 @@ fi ...@@ -84,7 +84,7 @@ fi
AC_SUBST([moduledir]) AC_SUBST([moduledir])
DRIVER_NAME=fbdev DRIVER_NAME=sunxifb
AC_SUBST([DRIVER_NAME]) AC_SUBST([DRIVER_NAME])
AC_CONFIG_FILES([ AC_CONFIG_FILES([
......
.\" shorthand for double quote that works everywhere. .\" shorthand for double quote that works everywhere.
.ds q \N'34' .ds q \N'34'
.TH FBDEV __drivermansuffix__ __vendorversion__ .TH SUNXIFB __drivermansuffix__ __vendorversion__
.SH NAME .SH NAME
fbdev \- video driver for framebuffer device sunxifb \- video driver for the devices based on Allwinner A10/A13 SoC
.SH SYNOPSIS .SH SYNOPSIS
.nf .nf
.B "Section \*qDevice\*q" .B "Section \*qDevice\*q"
.BI " Identifier \*q" devname \*q .BI " Identifier \*q" devname \*q
.B " Driver \*qfbdev\*q" .B " Driver \*qsunxifb\*q"
.BI " BusID \*qpci:" bus : dev : func \*q
\ \ ... \ \ ...
.B EndSection .B EndSection
.fi .fi
.SH DESCRIPTION .SH DESCRIPTION
.B sunxifb
is an __xservername__ driver for the devices based on Allwinner A10/A13 SoC,
derived from
.B fbdev .B fbdev
is an __xservername__ driver for framebuffer devices. This is a non-accelerated driver.
driver, the following framebuffer depths are supported: 8, 15, 16, 24. With the regards to 2D graphics, currently it only supports sofware rendering.
All visual types are supported for depth 8, and TrueColor visual is However at least it tries to let the SIMD (ARM NEON) accelerated code from the
supported for the other depths. Multi-head configurations are supported. .B pixman
library run at full speed without any unnecessary overhead. The recommended
framebuffer color depths are 16 (RGB565) and 24 (XRGB8888), the other color
depths may be supported too. Multi-head configurations are supported.
.SH SUPPORTED HARDWARE .SH SUPPORTED HARDWARE
The The
.B fbdev .B sunxifb
driver supports all hardware where a framebuffer driver is available. driver supports all hardware where a framebuffer driver is available and
fbdev uses the os-specific submodule fbdevhw(__drivermansuffix__) to talk uses the os-specific submodule fbdevhw(__drivermansuffix__) to talk
to the kernel to the kernel
device driver. Currently a fbdevhw module is available for linux. device driver. Currently a fbdevhw module is available for linux.
Additionally it is intended to use some of the display controller features
from Allwinner A10/A13 SoC and provide the necessary DRI2 integration with
the proprietary OpenGL ES binary blobs for Mali400 GPU (if they are installed
in the system). The part related to Mali400 GPU support is derived from
the vendor provided open source
.B xf86-video-mali
driver.
.SH CONFIGURATION DETAILS .SH CONFIGURATION DETAILS
Please refer to __xconfigfile__(__filemansuffix__) for general configuration Please refer to __xconfigfile__(__filemansuffix__) for general configuration
details. This section only covers configuration details specific to details. This section only covers configuration details specific to
...@@ -32,13 +44,10 @@ this driver. ...@@ -32,13 +44,10 @@ this driver.
.PP .PP
For this driver it is not required to specify modes in the screen For this driver it is not required to specify modes in the screen
section of the config file. The section of the config file. The
.B fbdev .B sunxifb
driver can pick up the currently used video mode from the framebuffer driver can pick up the currently used video mode from the framebuffer
driver and will use it if there are no video modes configured. driver and will use it if there are no video modes configured.
.PP .PP
For PCI boards you might have to add a BusID line to the Device
section. See above for a sample line.
.PP
The following driver The following driver
.B Options .B Options
are supported: are supported:
...@@ -57,4 +66,4 @@ Enable rotation of the display. The supported values are "CW" (clockwise, ...@@ -57,4 +66,4 @@ Enable rotation of the display. The supported values are "CW" (clockwise,
__xservername__(__appmansuffix__), __xconfigfile__(__filemansuffix__), Xserver(__appmansuffix__), __xservername__(__appmansuffix__), __xconfigfile__(__filemansuffix__), Xserver(__appmansuffix__),
X(__miscmansuffix__), fbdevhw(__drivermansuffix__) X(__miscmansuffix__), fbdevhw(__drivermansuffix__)
.SH AUTHORS .SH AUTHORS
Authors include: Gerd Knorr, Michel D\(:anzer, Geert Uytterhoeven Authors include: Gerd Knorr, Michel D\(:anzer, Geert Uytterhoeven, Siarhei Siamashka
...@@ -24,10 +24,10 @@ ...@@ -24,10 +24,10 @@
# _ladir passes a dummy rpath to libtool so the thing will actually link # _ladir passes a dummy rpath to libtool so the thing will actually link
# TODO: -nostdlib/-Bstatic/-lgcc platform magic, not installing the .a, etc. # TODO: -nostdlib/-Bstatic/-lgcc platform magic, not installing the .a, etc.
AM_CFLAGS = @XORG_CFLAGS@ AM_CFLAGS = @XORG_CFLAGS@
fbdev_drv_la_LTLIBRARIES = fbdev_drv.la sunxifb_drv_la_LTLIBRARIES = sunxifb_drv.la
fbdev_drv_la_LDFLAGS = -module -avoid-version sunxifb_drv_la_LDFLAGS = -module -avoid-version
fbdev_drv_ladir = @moduledir@/drivers sunxifb_drv_ladir = @moduledir@/drivers
fbdev_drv_la_SOURCES = \ sunxifb_drv_la_SOURCES = \
compat-api.h \ compat-api.h \
fbdev.c fbdev.c
...@@ -41,11 +41,11 @@ ...@@ -41,11 +41,11 @@
static Bool debug = 0; static Bool debug = 0;
#define TRACE_ENTER(str) \ #define TRACE_ENTER(str) \
do { if (debug) ErrorF("fbdev: " str " %d\n",pScrn->scrnIndex); } while (0) do { if (debug) ErrorF("sunxifb: " str " %d\n",pScrn->scrnIndex); } while (0)
#define TRACE_EXIT(str) \ #define TRACE_EXIT(str) \
do { if (debug) ErrorF("fbdev: " str " done\n"); } while (0) do { if (debug) ErrorF("sunxifb: " str " done\n"); } while (0)
#define TRACE(str) \ #define TRACE(str) \
do { if (debug) ErrorF("fbdev trace: " str "\n"); } while (0) do { if (debug) ErrorF("sunxifb trace: " str "\n"); } while (0)
/* -------------------------------------------------------------------- */ /* -------------------------------------------------------------------- */
/* prototypes */ /* prototypes */
...@@ -80,8 +80,8 @@ enum { FBDEV_ROTATE_NONE=0, FBDEV_ROTATE_CW=270, FBDEV_ROTATE_UD=180, FBDEV_ROTA ...@@ -80,8 +80,8 @@ enum { FBDEV_ROTATE_NONE=0, FBDEV_ROTATE_CW=270, FBDEV_ROTATE_UD=180, FBDEV_ROTA
static int pix24bpp = 0; static int pix24bpp = 0;
#define FBDEV_VERSION 4000 #define FBDEV_VERSION 4000
#define FBDEV_NAME "FBDEV" #define FBDEV_NAME "SUNXIFB"
#define FBDEV_DRIVER_NAME "fbdev" #define FBDEV_DRIVER_NAME "sunxifb"
#ifdef XSERVER_LIBPCIACCESS #ifdef XSERVER_LIBPCIACCESS
static const struct pci_id_match fbdev_device_match[] = { static const struct pci_id_match fbdev_device_match[] = {
...@@ -115,7 +115,7 @@ _X_EXPORT DriverRec FBDEV = { ...@@ -115,7 +115,7 @@ _X_EXPORT DriverRec FBDEV = {
/* Supported "chipsets" */ /* Supported "chipsets" */
static SymTabRec FBDevChipsets[] = { static SymTabRec FBDevChipsets[] = {
{ 0, "fbdev" }, { 0, "sunxifb" },
{-1, NULL } {-1, NULL }
}; };
...@@ -143,7 +143,7 @@ MODULESETUPPROTO(FBDevSetup); ...@@ -143,7 +143,7 @@ MODULESETUPPROTO(FBDevSetup);
static XF86ModuleVersionInfo FBDevVersRec = static XF86ModuleVersionInfo FBDevVersRec =
{ {
"fbdev", "sunxifb",
MODULEVENDORSTRING, MODULEVENDORSTRING,
MODINFOSTRING1, MODINFOSTRING1,
MODINFOSTRING2, MODINFOSTRING2,
...@@ -155,7 +155,7 @@ static XF86ModuleVersionInfo FBDevVersRec = ...@@ -155,7 +155,7 @@ static XF86ModuleVersionInfo FBDevVersRec =
{0,0,0,0} {0,0,0,0}
}; };
_X_EXPORT XF86ModuleData fbdevModuleData = { &FBDevVersRec, FBDevSetup, NULL }; _X_EXPORT XF86ModuleData sunxifbModuleData = { &FBDevVersRec, FBDevSetup, NULL };
pointer pointer
FBDevSetup(pointer module, pointer opts, int *errmaj, int *errmin) FBDevSetup(pointer module, pointer opts, int *errmaj, int *errmin)
...@@ -465,7 +465,7 @@ FBDevPreInit(ScrnInfoPtr pScrn, int flags) ...@@ -465,7 +465,7 @@ FBDevPreInit(ScrnInfoPtr pScrn, int flags)
pScrn->progClock = TRUE; pScrn->progClock = TRUE;
pScrn->rgbBits = 8; pScrn->rgbBits = 8;
pScrn->chipset = "fbdev"; pScrn->chipset = "sunxifb";
pScrn->videoRam = fbdevHWGetVidmem(pScrn); pScrn->videoRam = fbdevHWGetVidmem(pScrn);
xf86DrvMsg(pScrn->scrnIndex, X_INFO, "hardware: %s (video memory:" xf86DrvMsg(pScrn->scrnIndex, X_INFO, "hardware: %s (video memory:"
......
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