KOH_Linux_Xorg_config

Xorg* Configuration Options

Intel® EMGD provides a format syntax for Linux* configuration options. The syntax is similar to the Microsoft Windows* INF file and is as follows:

All/<ConfigID>/<block name>/<option name>

Intel® EMGD parses the configuration options and looks for “new-style” 4.0 and later options. If it does not find any, then it falls back to processing old-style options.

Device configuration must contain the “pcfversion” option with value “0x700”. This indicates to the driver the options format to use. Earlier pcfversions (0 and 0x400) are supported for backward compatibility.

The Intel® EMGD supports multiple sets of installed configuration options that may be selected at runtime.

Configuration ID 0 is used unless otherwise specified in the configuration file or supplied by the system BIOS.

The table below shows the supported driver options.

Table 32. Supported Driver Options

Option

Description

Option “PcfVersion” “integer”

This option indicates that the new Intel® EMGD format is being used for the Linux* Configuration files (xorg.conf). The new format is hierarchical (similar to the Microsoft Windows* INF file) and allows both global and per-configuration information to be stored in the X server’s configuration file (xorg.conf) rather than having per-configuration information stored separately in the EDIDx.bin file.

This option is usually set to 0700 hex (1792 decimal) and is required for the new format.

Option “All/<ConfigID>/General/SWCursor” “boolean”

Enable the use of the software cursor. Default is off and the hardware cursor is used.

Option “All/<ConfigID>/General/ShadowFB” “boolean”

Enable or disable double buffering on the framebuffer. Default disables double buffering.

Option “All/<ConfigID>/General/XVideo” “boolean”

Disable or enable XVideo support. In a dual independent head configuration, either the first display or the second display support XVideo. Both displays cannot support XVideo simultaneously. Default enables XVideo support.

Option “All/<ConfigID>/General/XVideoBlend” “boolean”

Disable or enable XVideo support using the 3D blend manager. This provides XVideo support in configurations that cannot be supported with overlay. For example, this is supported on both displays in a dual independent head setup. It is also supported when the display is rotated or flipped. Color key is only supported if ShadowFB is enabled and the VideoKey is defined. By default XVideoBlend support is enabled.

Option “ALL/<ConfigID>/General/PuntTo3dBlit” “boolean”

Enable or disable use of the 3D engine for blitting. Useful for cases where 2D memory is insufficient. By default PuntTo3dBlit support is disabled.

Option “ALL/<configID>/General/VideoColorCorrect” “boolean”

Enable or disable overlay plane/sprite-C color correction (brightness, contrast, saturation, gamma, hue) at runtime.

Option “ConfigID” “integer”

This option identifies the configuration.

Option “All/<ConfigID>/Name” “string”

A quoted string used to identify the configuration name.

Option “All/<ConfigID>/Comment” “string”

A quoted string used to identify the configuration file.

Comment is a required field for Linux* configurations.

Option “All/<ConfigID>/General/PortOrder” “string”

This option changes the default port allocation order. The default order can vary depending on chipset. List the port type numbers in the priority order starting from first to last. The port type numbers are as follows:

1 - Integrated TV Encoder (mobile chipsets only)

2 - sDVO B port

3 - sDVO C port

4 - Integrated LVDS port (mobile chipsets only)

5 - Analog CRT port

To set the order as Integrated TV Encoder, ANALOG, LVDS, sDVO C, sDVO B set the PortOrder string to “15432”. Zeros can be used to specify don’t care. Setting this option incorrectly can result in port allocation failures.

Option “All/<ConfigID>/Port/<port number>/General/Rotation” “integer”

Rotate the display. Valid values are 0, 90, 180, 270.

Option “All/<ConfigID>/Port/<port number>/General/Flip” “boolean”

Invert the display horizontally.

Option “All/<ConfigID>/General/VideoKey” “integer”

This sets the color key for XVideo and XVideoBlend. This value is either a 24-bit value or a 16-bit value, depending on the pixel depth of the screen. The color key is always enabled for XVideo, even when it is not defined. The color key is always disabled for XVideoBlend unless both this option is defined and the ShadowFB option is enabled. The default color key for XVideo is 0x0000ff00. For XVideoBlend, the color key is disabled by default.

Option “All/<ConfigID>/General/CloneWidth” “integer”

This sets the display width for a clone port when CloneDisplay is active. Default is 640.

Option “All/<ConfigID>/General/CloneHeight” “integer”

This sets the display height for a clone port when CloneDisplay is active. Default is 480.

Option “All/<ConfigID>/General/CloneRefresh” “integer”

This sets the display vertical refresh rate for a clone port when CloneDisplay is active. Default is 60 Hz.

Option “All/<ConfigID>/Port/<port number>/General/EDID” “boolean”

Enable or disable reading of EDID data from the output port device. Note that if the EDID option is specified in the config file (xorg.conf), all per-port EDID options in the configuration are overwritten by the EDID option specified in the config file.

Option “All/<ConfigID>/General/Accel” “boolean”

Enable 2D acceleration. Default is enabled.

Option “All/<ConfigID>/General/DRI2” “boolean”

Enable DRI2 support for OGL. Default is enabled.

Option “All/<configID>/General/ DihCloneEnable” “boolean”

Enable run-time VEXT or DIH to Clone display mode transition. Default is disabled.

Option “All/<configID>/General/FreezeFB” “boolean”

Enable freeze frame buffer feature. See Runtime Freeze and UnFreeze Display (Framebuffer and Overlay/Sprite-C)

Option “All/<ConfigID>/General/OverlayGammaCorrectR” “integer”

Gamma correction value for overlay (red) in 24i8f format.

Option “All/<ConfigID>/General/OverlayGammaCorrectG” “integer”

Gamma correction value for overlay (green) in 24i8f format.

Option “All/<ConfigID>/General/OverlayGammaCorrectB” “integer”

Gamma correction value for overlay (blue) in 24i8f format.

Option “All/<ConfigID>/General/OverlayBrightnessCorrect” “integer”

Overlay brightness adjustments.

Option “All/<ConfigID>/General/OverlayContrastCorrect” “integer”

Overlay contrast adjustments.

Option “All/<ConfigID>/General/OverlaySaturationCorrect” “integer”

Overlay saturation adjustments.

Option “All/<ConfigID>/General/GlTextureStream” “integer”

Enable or disable GL texture streaming support. Default value is 0, disabled. Valid values are 0 or 1.

Option “All/<ConfigID>/Port/<port number>/General/Name” “string”

A quoted string used to identify the port name, for example, “sdvo”.

Option “All/<ConfigID>/Port/<port number>/General/”EdidAvail “string”

Specifies how standard and user-defined modes are used when EDID is available. Default is 0.

Option “All/<ConfigID>/Port/<port number>/General/”EdidNotAvail “string”

Specifies how standard and user-defined modes are used when EDID is not available. Default is 0.

Option “All/<ConfigID>/Port/<port number>/General/CenterOff” “boolean”

When this option is enabled it DISABLES centering. Also, depending on the combination of “edid” + “user-dtd” + connected hardware, Intel® EMGD will add missing compatibility modes (6x4, 8x6, 10x7& 12x10) via centering. Use this option to disable this feature.

Option “ALL/<ConfigID>/General/RefFreq” “integer”

Internal timing frequency for the sDVO Clip software workaround algorithm. Default is 199500 in KHz. Range 190000KHz -210000KHz.

Option “All/<ConfigID>/Port/<port number>/Dvo/I2cDab” “string”

I2c device address.

Option “All/<ConfigID>/Port/<port number>/Dvo/I2cSpeed” “string”

I2c bus speed.

Option “All/<ConfigID>/Port/<port number>/Dvo/DdcSpeed” “string”

DDC bus speed.

Option “All/<ConfigID>/Port/<port number>/Dvo/DdcDab” “string”

DDC device address.

Option “All/<ConfigID>/Port/<port number>/Dtd/PixelClock” “integer”

Pixel clock frequency in kHz.

Option “All/<ConfigID>/Port/<port number>/Dtd/HorzActive” “integer”

The active horizontal area in pixels.

Option “All/<ConfigID>/Port/<port number>/Dtd/HorzSync” “integer”

Starting pixel for horizontal sync pulse.

Option “All/<ConfigID>/Port/<port number>/Dtd/HorzSyncPulse” “integer”

Width of the horizontal sync pulse pixels.

Option “All/<ConfigID>/Port/<port number>/Dtd/HorzBlank” “integer”

Width of the horizontal blanking period in pixels.

Option “All/<ConfigID>/Port/<port number>/Dtd/VertActive” “integer”

The active vertical area in pixels.

Option “All/<ConfigID>/Port/<port number>/Dtd/VertSync” “integer”

Starting pixel for vertical sync pulse.

Option “All/<ConfigID>/Port/<port number>/Dtd/VertSyncPulse” “integer”

Width of the vertical sync pulse in pixels.

Option “All/<ConfigID>/Port/<port number>/Dtd/VertBlank” “integer”

Width of the vertical blanking period in pixels.

Option “All/<ConfigID>/Port/<port number>/Dtd/Flags” “integer”

Additional interlaced timing information.

Option “All/<ConfigID>/Port/<port number>/FpInfo/BkltMethod” “integer”

Specifies the backlight method.

Option “All/<ConfigID>/Port/<port number>/FpInfo/BkltT1” “integer”

Specifies backlight timing T1.

Option “All/<ConfigID>/Port/<port number>/FpInfo/BkltT2” “integer”

Specifies backlight timing T2.

Option “All/<ConfigID>/Port/<port number>/FpInfo/BkltT3” “integer”

Specifies backlight timing T3.

Option “All/<ConfigID>/Port/<port number>/FpInfo/BkltT4” “integer”

Specifies backlight timing T4.

Option “All/<ConfigID>/Port/<port number>/FpInfo/BkltT5” “integer”

Specifies backlight timing T5.




*Other names and brands may be claimed as the property of others.
Revised April 2013