Linux Certif

Toute la documentation sur la certification Linux LPI

unichrome

NAME

via - VIA Unichrome video driver

SYNOPSIS

Section "Device"

  Identifier "devname"

  Driver "via"

  ...

EndSection

DESCRIPTION

via is an Xorg driver for VIA Unichrome integrated graphics.

The via 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:  VN800, P4M800Pro (Unichrome Pro).

    VT3157:  CX700 (Unichrome Pro - not yet released).

    VT3130:  K8M890 (Chrome9 IGP).

    VT3343:  P4M890 (Unichrome Pro - not yet released).



VT3118 through VT3343 support is currently non-existent, as the developer

has no direct access to this hardware yet.



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-users@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 "NoAccel" "boolean"

Disable or enable acceleration. Default: acceleration is enabled.

Option "HWCursor" "boolean"

Disable or enable use of hardware cursors. The default is enabled.

Option "SWCursor" "boolean"

Disable or enable the use of a software cursor. The default is disabled.

Option "ShadowFB" "boolean"

Use a shadow frame buffer. This is required when rotating the display, but otherwise defaults to disabled.

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 "DRIXINERAMA" "boolean"

Set DRI Xinerama mode. Currently unsupported.

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.

Option "EnableAGPDMA" "boolean"

Enable the AGP DMA functionality in DRM. This requires that DRI is enabled and will force 2D, and 3D acceleration to use AGP DMA.

Option "NoAGPFor2D" "boolean"

With this option on, 2D acceleration will not use AGP DMA even if it is enabled.

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 usually 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".

BUGS

Plenty. Feel free to file more at the http://unichrome.sf.net/ bug tracker.

SEE ALSO

Xorg(1), xorg.conf(5), xorgconfig(1), Xserver(1), X(7)

AUTHORS

Authors include: Luc Verhaegen (libv@skynet.be)