general options in the XF86Config file

Information for Tseng Chipset Users : general options in the `XF86Config` file
Previous: Basic configuration
Next: linear memory base address (MemBase) issues

## 6. general options in the `XF86Config` file

The following options are of particular interest to the Tseng driver. Each of them must be specified in the `svga`' driver section of the `XF86Config` file, within the `Screen` subsections of the depths to which they are applicable (you can enable options for all depths by specifying them in the Device section).

Option "noaccel"

  (ET4000W32p, et6000) This option will disable the use of any accelerated functions. This is likely to help with some problems related to DRAM timing, high dot clocks, and bugs in accelerated functions, at the cost of performance (which will still be reasonable on a local or PCI bus). This option applies only to those chips where acceleration is supported (currently ET4000W32p and ET6000).

Option "fast_dram" "slow_dram"

  These options set the DRAM speed of certain cards where it applies.

  The `"slow_dram"` option is always enabled on ET4000, and ET4000W32. If enabled, it slows down DRAM timing, which may avoid some memory-related problems. If your card starts up with a black screen (and possibly a system hang), this option might be needed. Not supported on ET6000.

  The `"fast_dram"` option will cause the driver to speed up DRAM timings, which may also avoid screen-related problems (streaking, stripes, garbage, ...). It may also increase those very same effects. Not supported on ET6000.

videoram 1024 (or another value) (all chips)

  This option will override the detected amount of video memory, and pretend the given amount of memory is present on the card. This is useful on cards with 2Mbyte of memory whose DRAM configuration is not compatible with the way the driver enables the upper megabyte of memory, or if the memory detection goes wrong. It must be specified in the Device section.

Clockchip "et6000" (et6000)

  This enables programmable clocks, but obviously only on the et6000. It must be specified in the Device section. Normally the server will automatically use this feature when it detects an ET6000. Use it only when you suspect auto-detection is not working. Note that some frequencies may be unstable (resulting in a `Wavy' screen). Only tried and tested frequencies (like the default clocks) are guaranteed to be stable. If this happens, try a slightly different frequency in the modeline (like 0.5 MHz more or less). The monitor should still be capable of syncing to this frequency, but the clockchip may already be outside an unstable region.

Option "linear" (ET4000W32i, ET4000W32p, ET6000)

  This enables linear addressing, which is the mapping of the entire framebuffer to a high address beyond system memory, making the full length of the framebuffer directly accessible. In this way, slow SVGA bank switching (where only a small fraction of the framebuffer is visible at one time) is not necessary. It enhances performance at 256 colors, and is currently required for 16bpp, 24bpp, and 32bpp.

MemBase 0xE0000000. (or a different address) (ET4000W32, ET6000)

  This sets the physical memory base address of the linear framebuffer. It must be specified in the Device section. It may be required for non-PCI linear addressing configurations, and might be useful for PCI-based systems where auto-detection fails. However, almost all PCI systems will not need this.

  Read the section on linear memory base address issues below!

  Read the section on linear memory base address issues below! (Message repeated on purpose)

  Use this option ONLY if you have trouble with the default MemBase used by the server, or if the server explicitly states that you must provide one.

Option "pci_retry" (ET4000W32p on PCI bus, ET6000)

  This enables the PCI bus retry function, which is a performance enhancing mode for PCI bus-based systems, where the VGA controller will put the PCI bus in a hold state (sort of like wait-states) when the server tries to start a new accelerated operation but the accelerator is still busy with the previous operation.

  This is the fastest way to drive a VGA card (no busy-waiting loops needed), but it also stresses some hardware that is timing-dependent (tape drives, sound cards, etc). See also the trouble shooting section.

Information for Tseng Chipset Users : general options in the `XF86Config` file
Previous: Basic configuration
Next: linear memory base address (MemBase) issues