README for XFree86 on OpenBSD : Configuring X for Your Hardware
Previous: Installing the Binaries
Next: Running X

6. Configuring X for Your Hardware

The /etc/XF86Config file tells the X server what kind of monitor, video card and mouse you have. You must create it to tell the server what specific hardware you have.

The easiest way to create this file is to run the XF86Setup utility as root. Refer to QuickStart.doc for details about its use.

You'll need info on your hardware:

The recommended way to generate an XF86Config file is to use the XF86Setup utility. The xf86config text utility is still there for the (few) cases where XF86Setup can't be used. Also, there is a sample file installed as /usr/X11R6/lib/X11/XF86Config.eg, which can be used as a starting point.

For details about the XF86Config file format, refer to the XF86Config(5) manual page.

Once you've set up a XF86Config file, you can fine tune the video modes with the xvidtune utility.

6.1. About mouse configuration

If your serial mouse does not work try using kermit or tip to connect to the mouse serial port and verify that it does indeed generate characters.

The OpenBSD pms driver provides both ``raw'' and ``cooked'' (translated) modes. ``raw'' mode does not do protocol translation, so XFree86 would use the PS/2 protocol for talking to the device in that mode. ``Cooked'' mode is the old BusMouse translation. The driver runs in ``raw'' mode when using the /dev/psm0 device name.

On OpenBSD 2.2, only standard PS/2 mice are supported by this driver.

On OpenBSD 2.3 and later include there is support for recent PS/2 mice that send more than three bytes at a time (especially intellimouse, or mouseman+ with a "3D" roller).

See README.mouse for general instruction on mouse configuration in XFree86.

6.2. Other input devices

XFree86 supports the dynamic loading of drivers for external input devices using the XInput extension. Currently supported devices are:

To use a specific device, add the line

load "module"
in the Module section of XF86Config, where module is the name of the .so file corresponding to your device. You also need to set up a XInput section in XF86Config. Refer to the XF86Config(5) man page for detailed configuration instructions.

You can then change the device used to drive the X pointer with the xsetpointer(1) command.

For joystick support, you'll need to enable the joystick device driver in the kernel. See joy(4) for details.

6.3. Configuring PEX and XIE extensions

The PEX and XIE extensions are supported as external modules. If you want to have access to these extensions, add the following lines to the Module section of XF86Config:

   load    "pex5.so"
   load    "xie.so"


README for XFree86 on OpenBSD : Configuring X for Your Hardware
Previous: Installing the Binaries
Next: Running X