UNICHROME(4)UNICHROME(4)NAMEunichrome - VIA Unichrome video driver
SYNOPSIS
Section "Device"
Identifier "devname"
Driver "unichrome"
...
EndSection
DESCRIPTIONunichrome is an Xorg driver for VIA Unichrome integrated graphics.
The unichrome driver supports the following devices:
VT3122: CLE266 (CastleRock).
VT7205: KM400, KM400A, KN400, P4M800 (Unichrome).
VT3108: K8M800, K8N800, K8N800A (Unichrome Pro, aka Pro B).
VT3118: CN400, PM800, PM880, PN800 (Unichrome Pro A).
VT3344: CN700, VN800, P4M800Pro, P4M800CE (Unichrome Pro).
VT3157: CX700, CX700M, VX700, CX700-M2 (Unichrome Pro).
VT3130: K8M890 (Chrome9 IGP).
VT3343: P4M890, VN890 (Unichrome Pro).
VT3371: P4M900, VN896, CN896 (Chrome 9 HC IGP).
VT1122: VX800, VX820 (Chrome 9 HC3 IGP).
VT5122: VX855 (Chrome 9 HCM IGP) [UNRELEASED].
While all released hardware is available to the main developer of this
driver, actual driver support may vary.
This driver is being developed at http://unichrome.sourceforge.net/.
It is not endorsed or supported by VIA Technologies. For support, refer
to http://unichrome.sourceforge.net/ or unichrome-devel@lists.sf.net
directly.
CONFIGURATION DETAILS
Please refer to xorg.conf(5) for general configuration details. This
section only covers configuration details specific to this driver.
The following driver options are supported
Option "ActiveDevice" "string"
Specify the active device combination. Any string containing
"CRT", "DFP" (for Digital Flat Panel), "TV" should be possible.
The default is to use everything that is detected. The driver
tries to most ideally mix and match outputs between CRTCs
(heads).
Option "SWCursor" "boolean"
Disable the hardware cursor and use software cursor rendering
instead.
Option "AccelMethod" "string"
Select any of "None", "ShadowFB" or "XAA" as an Acceleration
Method. The default is "XAA".
Option "DirectFB" "boolean"
Force Direct FB access for the CPU on or off. Default for non-
HyperTransport chipsets is whatever the BIOS set up. For K8M800
(VT3108), the default is on.
Option "Rotate" "string"
Rotate the display either clockwise ("CW") or counter clockwise
("CCW"). Rotation is only supported unaccelerated.
Option "DisableVQ" "boolean"
Disable or enable the use of VQ. VQ is enabled by default.
Option "DisableIRQ" "boolean"
Disables Vblank IRQ. A workaround for some mainboards that have
problems with IRQs from the unichrome chip. With IRQ disabled,
DRI clients have no way to sync drawing to Vblank.
Note that the DRM in many linux kernels is broken, and this
option will result in a lock-up of your machine. This is due to
an inconsistency between upstream drm and the version in the
linux kernel. While the upstream fix was there since 2005, the
kernel side was only put right with 2.6.24. So either use
upstream drm or linux 2.6.24 if you need this option.
Option "DisableCommandBuffer" "boolean"
Disable the AGP Command Buffer functionality in DRM. This forces
the 2D and 3D acceleration to use direct register writing
instead of the less cpu intensive hardware command buffer.
Option "DisableCommandBufferFor2D" "boolean"
This disables the use of the command buffer for 2D acceleration.
Option "UseDMACopy" "boolean"
Use the DRM DMA blit to copy the Xv buffer to framebuffer,
enabled per default.
CRTC2 Specific Options
CRTC2 is the second head of the unichrome. This allows seperate timing
from the primary head, and also allows for scaling up a mode.
Option "CRTC2Scale" "string"
Option "CRTC2HScale" "string"
Option "CRTC2VScale" "string"
These specify the type of scaling done, either "Interpolation"
(default) or "Duplication". The Option "CRTC2Scale" overrules
both the options "CRTC2HScale" and "CRTC2VScale".
CRT Specific Options
With CRT we mean every monitor that's connected to the analog-out meant
for CRTs. This irrespective of whether this monitor is panel based or
not. It is automatically enabled when a CRT is attached.
Option "CRTBandWidth" "integer"
This specifies the maximum bandwidth a CRT allows and limits the
mode's dotclock. This integer value should be provided in kHz
and should normally range somewhere between 20000 and 300000.
This information is usually provided as part of DDC/EDID data
and thus autodetected.
Panel Specific Options
Unichromes can have directly connected panels or have separate LVDS
encoders like the VT1631 and VT1636. Note that this differs from panels
connected through the CRT or DVI (TMDS) outputs.
Panels are enabled on the basis of available hardware information (like
pci-ids) .
Option "PanelSize" "string"
Specify the size (width x height) of the LCD panel attached to
the system. Sizes 640x480, 800x600, 1024x768, 1280x1024, and
1400x1050 are supported. This shouldn't be required as this usu‐
ally is a BIOS initialised value.
Supported TV Encoders
Unichromes tend to be paired with several different TV Encoders. The
presence of these TV encoders is detected. They are automatically
enabled when a TV is attached.
Chrontel CH7011
Supports the following modes: "640x480", "800x600", "1024x768". Use
"640x480Over", "800x600Over" and "1024x768Over" for vertical overscan.
These modes are made available by the driver and modelines provided in
xorg.conf will be ignored when the TV encoder is used.
Option "TVOutput" "string"
Specify which TV output to use. The driver supports "S-Video",
"Composite", "SC", "RGB" and "YCbCr" outputs. The default is to
use the cable type that is detected.
Option "TVStandard" "string"
Specify TV Standard. The CH7011 currently supports "NTSC" and
"PAL".
VIA Technologies VT1622, VT1622A, VT1623
Supports the following modes: "640x480", "800x600", "1024x768",
"848x480", "720x480" (NTSC only) and "720x576" (PAL only). Use
"640x480Over", "800x600Over", "1024x768Over", "848x480Over",
"720x480Over" (NTSC) and "720x576Over" (PAL) for vertical overscan.
The modes "720x480Noscale" (NTSC VT1622 only) and "720x576Noscale" (PAL
VT1622 and VT1622a only) provide cleaner TV output (unscaled with only
minimal overscan). These modes are made available by the driver and
modelines provided in xorg.conf will be ignored when the TV encoder is
used.
Option "TVDeflicker" "integer"
Specify deflicker setting for TV output. Valid values are 0,1,2
0) No deflicker, 1) 1:1:1 deflicker, 2) 1:2:1 deflicker.
Option "TVDotCrawl" "boolean"
Disable or enable dotcrawl. This is available for NTSC modes
only.
Option "TVOutput" "string"
Specify which TV output to use. The driver supports "S-Video",
"Composite", "SC", "RGB" and "YCbCr" outputs. The default is to
use the cable type that is detected.
Option "TVStandard" "string"
Specify TV Standard. The driver currently supports "NTSC" and
"PAL".
XvMC Support
This graphics driver supports MPEG2 Slice decoding for VT3122 and
VT3108 through the XvMC VLD interface. It provides its own X extension
to be able to coordinate the mpeg engine and the overlays working as a
backend to XvMC-vld.
Option "XvMCBrokenXine" "boolean"
The xine xxmc video_out module is broken in many ways, this is
one of its issues. When it exits with:
abort: video_out_xxmc.c:622: create_ximage: Aborting.
Then enable this option to fool this code into working just
fine.
BUGS
Plenty. Feel free to file more at the http://unichrome.sf.net/ bug
tracker.
SEE ALSOXorg(1), xorg.conf(5), xorgconfig(1), Xserver(1), X(7)AUTHORS
Authors include: Luc Verhaegen (libv@skynet.be)
X Version 11 xf86-video-unichrome 0.2.0.0 UNICHROME(4)
