<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<TITLE>Configuring X for Your Hardware</TITLE>
</HEAD>
<BODY BGCOLOR="#efefef" TEXT="black" LINK="blue" VLINK="#551A8B" ALINK="red">

<A HREF="OpenBSD.html"><EM>README for XFree86 on OpenBSD</EM></A>
 <b>:</b> <EM>Configuring X for Your Hardware</EM><BR>
<b>Previous:</b> <A HREF="OpenBSD5.html"><EM>Installing the Binaries</EM></A><BR>
<b>Next:</b> <A HREF="OpenBSD7.html"><EM>Running X</EM></A>


<HR NOSHADE>
  <H2><A NAME="6"></A>6. Configuring X for Your Hardware</H2>
<p>The <code>/etc/XF86Config</code> file tells the X server what kind of
monitor, 
video card and mouse you have.  You <em>must</em> create it to tell the
server what specific hardware you have.</p>
<p>The easiest way to create this file is to run the <b>XF86Setup</b>
utility as root. Refer to <A href="QuickStart.html">QuickStart.doc</A> for details about its use.</p>
<p>You'll need info on your hardware:
<ul>
<li>Your mouse type, baud rate and its /dev entry.</li>
<li>The video card's chipset (e.g. ET4000, S3, etc).</li>
<li>Your monitor's sync frequencies.</li>
</ul>
</p>
<p>The recommended way to generate an <code>XF86Config</code> file is to use the
<code>XF86Setup</code> 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 <code>/usr/X11R6/lib/X11/XF86Config.eg</code>,
which can be used as a starting point.</p>
<p>For details about the <code>XF86Config</code> file format, refer to the
<em>XF86Config(5)</em> manual page.</p>
<p>Once you've set up a XF86Config file, you can fine tune the video
modes with the <code>xvidtune</code> utility. </p>


<H3><A NAME="7"></A>6.1. About mouse configuration</H3>
<p>If your serial mouse does not work try using <code>kermit</code> or
<code>tip</code> to connect to the mouse serial port and verify that it
does indeed generate characters.</p>
<p>The OpenBSD pms driver  provides both ``raw'' and ``cooked''
(translated) modes.  ``raw'' mode does not do protocol translation, so
XFree86 would use the <b>PS/2</b> 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 <code>/dev/psm0</code>
device name.</p>
<p>On OpenBSD 2.2, only standard PS/2 mice are supported by this
driver. </p>
<p>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). </p>
<p>See <A href="mouse.html">README.mouse</A>  for general
instruction on mouse configuration in XFree86.</p>

<H3><A NAME="8"></A>6.2. Other input devices</H3>
<p>XFree86  supports the dynamic loading of drivers for external
input devices using the <code>XInput</code> extension. Currently supported
devices are:
<ul>
<li>Joystick (<code>xf86Jstk.so</code>)</li>
<li>Wacom tablets (Wacom IV protocol only, <code>xf86Wacom.so</code>)</li>
<li>SummaSketch tablets (<code>xf86Summa.so</code>)</li>
<li>Elographics touchscreen (<code>xf86Elo.so</code>)</li>
</ul>
</p>
<p>To use a specific device, add the line
<blockquote><code>
<code>load</code> <code>"</code><em>module</em><code>"</code>
</code></blockquote>

in the <b>Module</b> section of <code>XF86Config</code>, where <em>module</em> is
the name of the <code>.so</code> file corresponding to your device.
You also need to set up a <b>XInput</b> section in <code>XF86Config</code>. 
Refer to the <em>XF86Config(5)</em> man page for detailed
configuration instructions.</p>
<p>You can then change the device used to drive the X pointer with the
<em>xsetpointer(1)</em> command.</p>
<p>For joystick support, you'll need to enable the joystick device
driver in the kernel.  See <em>joy(4)</em> for details.</p>

<H3><A NAME="9"></A>6.3. Configuring PEX and XIE extensions</H3>
<p>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 <b>Module</b> section of <code>XF86Config</code>:
<blockquote><code>
<pre>
   load    "pex5.so"
   load    "xie.so"
</pre>
</code></blockquote>
</p>

 <HR NOSHADE>
<A HREF="OpenBSD.html"><EM>README for XFree86 on OpenBSD</EM></A>
 <b>:</b> <EM>Configuring X for Your Hardware</EM><BR>
<b>Previous:</b> <A HREF="OpenBSD5.html"><EM>Installing the Binaries</EM></A><BR>
<b>Next:</b> <A HREF="OpenBSD7.html"><EM>Running X</EM></A>



</BODY>
</HTML>
