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
Xorg mailing list:
linux-sunxi mailing list:
http://lists.freedesktop.org/mailman/listinfo/xorg
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
https://groups.google.com/d/forum/linux-sunxi
......@@ -22,10 +22,10 @@
# Initialize Autoconf
AC_PREREQ([2.60])
AC_INIT([xf86-video-fbdev],
[0.4.3],
[https://bugs.freedesktop.org/enter_bug.cgi?product=xorg],
[xf86-video-fbdev])
AC_INIT([xf86-video-sunxifb],
[0.0.1],
[https://github.com/ssvb/xf86-video-sunxifb],
[xf86-video-sunxifb])
AC_CONFIG_SRCDIR([Makefile.am])
AC_CONFIG_HEADERS([config.h])
AC_CONFIG_AUX_DIR(.)
......@@ -84,7 +84,7 @@ fi
AC_SUBST([moduledir])
DRIVER_NAME=fbdev
DRIVER_NAME=sunxifb
AC_SUBST([DRIVER_NAME])
AC_CONFIG_FILES([
......
.\" shorthand for double quote that works everywhere.
.ds q \N'34'
.TH FBDEV __drivermansuffix__ __vendorversion__
.TH SUNXIFB __drivermansuffix__ __vendorversion__
.SH NAME
fbdev \- video driver for framebuffer device
sunxifb \- video driver for the devices based on Allwinner A10/A13 SoC
.SH SYNOPSIS
.nf
.B "Section \*qDevice\*q"
.BI " Identifier \*q" devname \*q
.B " Driver \*qfbdev\*q"
.BI " BusID \*qpci:" bus : dev : func \*q
.B " Driver \*qsunxifb\*q"
\ \ ...
.B EndSection
.fi
.SH DESCRIPTION
.B sunxifb
is an __xservername__ driver for the devices based on Allwinner A10/A13 SoC,
derived from
.B fbdev
is an __xservername__ driver for framebuffer devices. This is a non-accelerated
driver, the following framebuffer depths are supported: 8, 15, 16, 24.
All visual types are supported for depth 8, and TrueColor visual is
supported for the other depths. Multi-head configurations are supported.
driver.
With the regards to 2D graphics, currently it only supports sofware rendering.
However at least it tries to let the SIMD (ARM NEON) accelerated code from the
.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
The
.B fbdev
driver supports all hardware where a framebuffer driver is available.
fbdev uses the os-specific submodule fbdevhw(__drivermansuffix__) to talk
.B sunxifb
driver supports all hardware where a framebuffer driver is available and
uses the os-specific submodule fbdevhw(__drivermansuffix__) to talk
to the kernel
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
Please refer to __xconfigfile__(__filemansuffix__) for general configuration
details. This section only covers configuration details specific to
......@@ -32,13 +44,10 @@ this driver.
.PP
For this driver it is not required to specify modes in the screen
section of the config file. The
.B fbdev
.B sunxifb
driver can pick up the currently used video mode from the framebuffer
driver and will use it if there are no video modes configured.
.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
.B Options
are supported:
......@@ -57,4 +66,4 @@ Enable rotation of the display. The supported values are "CW" (clockwise,
__xservername__(__appmansuffix__), __xconfigfile__(__filemansuffix__), Xserver(__appmansuffix__),
X(__miscmansuffix__), fbdevhw(__drivermansuffix__)
.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 @@
# _ladir passes a dummy rpath to libtool so the thing will actually link
# TODO: -nostdlib/-Bstatic/-lgcc platform magic, not installing the .a, etc.
AM_CFLAGS = @XORG_CFLAGS@
fbdev_drv_la_LTLIBRARIES = fbdev_drv.la
fbdev_drv_la_LDFLAGS = -module -avoid-version
fbdev_drv_ladir = @moduledir@/drivers
sunxifb_drv_la_LTLIBRARIES = sunxifb_drv.la
sunxifb_drv_la_LDFLAGS = -module -avoid-version
sunxifb_drv_ladir = @moduledir@/drivers
fbdev_drv_la_SOURCES = \
sunxifb_drv_la_SOURCES = \
compat-api.h \
fbdev.c
......@@ -41,11 +41,11 @@
static Bool debug = 0;
#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) \
do { if (debug) ErrorF("fbdev: " str " done\n"); } while (0)
do { if (debug) ErrorF("sunxifb: " str " done\n"); } while (0)
#define TRACE(str) \
do { if (debug) ErrorF("fbdev trace: " str "\n"); } while (0)
do { if (debug) ErrorF("sunxifb trace: " str "\n"); } while (0)
/* -------------------------------------------------------------------- */
/* prototypes */
......@@ -80,8 +80,8 @@ enum { FBDEV_ROTATE_NONE=0, FBDEV_ROTATE_CW=270, FBDEV_ROTATE_UD=180, FBDEV_ROTA
static int pix24bpp = 0;
#define FBDEV_VERSION 4000
#define FBDEV_NAME "FBDEV"
#define FBDEV_DRIVER_NAME "fbdev"
#define FBDEV_NAME "SUNXIFB"
#define FBDEV_DRIVER_NAME "sunxifb"
#ifdef XSERVER_LIBPCIACCESS
static const struct pci_id_match fbdev_device_match[] = {
......@@ -115,7 +115,7 @@ _X_EXPORT DriverRec FBDEV = {
/* Supported "chipsets" */
static SymTabRec FBDevChipsets[] = {
{ 0, "fbdev" },
{ 0, "sunxifb" },
{-1, NULL }
};
......@@ -143,7 +143,7 @@ MODULESETUPPROTO(FBDevSetup);
static XF86ModuleVersionInfo FBDevVersRec =
{
"fbdev",
"sunxifb",
MODULEVENDORSTRING,
MODINFOSTRING1,
MODINFOSTRING2,
......@@ -155,7 +155,7 @@ static XF86ModuleVersionInfo FBDevVersRec =
{0,0,0,0}
};
_X_EXPORT XF86ModuleData fbdevModuleData = { &FBDevVersRec, FBDevSetup, NULL };
_X_EXPORT XF86ModuleData sunxifbModuleData = { &FBDevVersRec, FBDevSetup, NULL };
pointer
FBDevSetup(pointer module, pointer opts, int *errmaj, int *errmin)
......@@ -465,7 +465,7 @@ FBDevPreInit(ScrnInfoPtr pScrn, int flags)
pScrn->progClock = TRUE;
pScrn->rgbBits = 8;
pScrn->chipset = "fbdev";
pScrn->chipset = "sunxifb";
pScrn->videoRam = fbdevHWGetVidmem(pScrn);
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