Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no Front-Cover Texts, and with no
Back-Cover Texts. A copy of the license is included in <xreflinkend="gfdl"/>,
entitled "GNU Free Documentation License".
</para>
</chapter>
<chapterid="sysreq">
<title>System Requirements</title>
<para>For this HOWTO to apply to you, you'll need the following hardware/software
up and running:</para>
<para>Hardware</para>
<itemizedlist>
<listitem><para>ATI R200 (Radeon 8xxx) based AGP card</para></listitem>
</itemizedlist>
<para>Software</para>
<itemizedlist>
<listitem><para>Linux kernel 2.4.x (check with <userinput>uname -r</userinput>)</para></listitem>
<listitem><para>Glibc 2.2 (check with <userinput>/lib/libc.so.X</userinput> where X is a decimal number)</para></listitem>
<listitem><para>XFree86 4.2.x for alternative 1 (check with <userinput>X -version</userinput>)</para></listitem>
<listitem><para>XFree86 4.1.x for alternatives 2, 3 and 5 (check with <userinput>X -version</userinput>)</para></listitem>
<listitem><para>XFree86 4.x for alternative 4 (check with <userinput>X -version</userinput>)</para></listitem>
</itemizedlist>
<important>
<para>If you run XFree86 4.1.x/4.0.x on your computer, you can NOT use alternative 1, as shown above. Of course you can try it, but it won't work (or at least it didn't for me). Also, if you read <ulinkurl="http://www.xfree86.org/">The XFree86 Project</ulink>'s <ulinkurl="http://www.xfree86.org/4.1.0/RELNOTES.html">release notes</ulink> for XFree 4.1.x, you'll see that the R200 chipset is not listed as a supported chipset for the <filenameclass="libraryfile">radeon_drv.o</filename> driver, which means that the Radeon 8xxx is NOT supported. However, if you read the <ulinkurl="http://www.xfree86.org/4.2.0/RELNOTES.html">release notes</ulink> for XFree 4.2.x, you'll see that the chipset IS supported by the same driver.</para>
</important>
<para>Once you have met the system requirements, it's time to decide which of
the available alternatives to choose.</para>
</chapter>
<chapterid="alternatives">
<title>The alternatives</title>
<para>As you could see in <xreflinkend="sysreq"/>, the alternatives you can
choose may be limited by the XFree86 version you are running.
It is very important that you check the dependencies first. If you don't meet
the requirements, this HOWTO will not apply to you, and you may and probably will
suffer a system crash if proceeding.</para>
<para>The various alternatives of this HOWTO will give variable results. I haven't
tested every possible use of the card, but I have had a few experiences, and the drivers
also provide some information.</para>
<sect1id="alt1">
<title>Experiences with XFree86's driver</title>
<para>This alternative is by far the simplest and safest way to set up your Radeon if you
use XFree86. The bad news is that this driver only supports 2D (meaning DRI won't work).</para>
</sect1>
<sect1id="alt2">
<title>Experiences with ATI's own driver</title>
<para>This alternative uses ATIs own drivers for the Linux operating system. The drivers are developed by 3rd party Linux developers for ATI. The driver supports some 3D acceleration, and works almost "out of the box".</para>
</sect1>
<sect1id="alt3">
<title>Experiences with DRI's driver</title>
<para>This alternative seemed like a good idea after running tired on the DRI problems
with both previous driver alternatives. DRI is the 3D part of XFree86, and is an independent
project, releasing it's own drivers. XFree86 has DRI implemented, but the drivers aren't the
same. In fact, DRI has developed their own driver specifically for the R200 chipset, meaning
it is a driver that supports 3D and works fine with X. Still, the driver supports hardly any
of the later GL extensions, meaning more recent games like UT2003 won't run with it.</para>
</sect1>
<sect1id="alt4">
<title>Experiences with the GATOS project's driver</title>
<para>This alternative is a 3rd party alternative, meaning it can result
in a much more unstable (and possibly damaged) system. I found this alternative to work rather well.
The 3D support was equivalent with that of DRI (at least when I tried it), meaning this and the DRI
alternative are almost equivalent.
</para>
</sect1>
<sect1id="alt5">
<title>Thoughts on Schneider Digital's driver</title>
<para>This alternative is another 3rd party alternative, but this one's rather good.
<ulinkurl="http://www.schneider-digital.de/">Schneider Digital</ulink> provides drivers for various
cards, among them <ulinkurl="http://www.schneider-digital.de/html/download_ati.html">ATI R200/R300</ulink>. The drivers are made for XFree 4.1+, and seem rather well developed.
Note though that I haven't yet tried these drivers myself, but I still thinkt they look like a very
decent alternative.
</para>
</sect1>
<sect1id="choice_rec">
<title>Still Haven't Chosen One?</title>
<para>I'd recommend you to use the DRI driver. I've had great experiences with this driver, although
its GL support is somewhat narrow. If a more worthy 3D system is what you want,
I'd recommend you to make the upgrades necesseary and go for Schneider Digitals driver or XFree86's
own driver, but please give me some feedback if you do.</para>
<para>Now that you've been given the information you need to choose a driver, choose one and move on!</para>
</sect1>
</chapter>
<chapterid="instructions">
<title>Step-by-step instructions</title>
<sect1id="using_xf_driver">
<title>Alternative 1: Using XFree86's Radeon driver</title>
<para>This alternative requires XFree 4.2 or later, and the installation or upgrade to this version is beyond the scope of this HOWTO (visit <ulinkurl="http://www.xfree86.org/">The XFree86 Project</ulink> for further information on how to upgrade or install XFree86). When XFree is installed and/or upgraded to the correct version, all you need to do is configure it. There are two ways of doing this that apply to all Linux distributions. You can either run <command>xf86onfig</command>, which is XFree86's own text-based configuration tool, or you can edit the configuration file by hand. Keep in mind that this HOWTO only describes how to configure the Radeon card, and XFree86 needs a lot more configuration than that to work.</para>
<para>If you choose to run <command>xf86config</command>, you will sooner or later come to the question, <quote>Do you want to look at the card database? (y/n)</quote>. Answer <userinput>y</userinput> (yes), and press <userinput>ENTER</userinput>. Choose one of the cards that use the <literal>ati</literal> driver by keying in the number to its left and then pressing <userinput>ENTER</userinput>. Which card you choose does not matter, as long as you choose a card that runs the <literal>ati</literal> driver. You will then be asked to give an identifier string for your card. You can type anything you want, but I recommend you type something descriptive, such as <quote>Radeon card</quote>. Finish the configuration process.</para>
<para>If you want to edit the configuration file manually, locate it (usually <filename>/etc/X11/XF86Config</filename>), and open it in your favorite editor. Find the place that says <literal>Section "Device"</literal>. In this section, there should be a line saying <literal>Driver "somedrivername"</literal>. Edit this line so it says <literal>Driver "ati"</literal>. Comment out all other lines in the Device section (add a # in front of them). Your device section should now look like this:
</para>
<screen>
Section "Driver"
Identifier "some_identifier" (the identifier is your choice, but if you edit it,
make sure you update every reference to it in the config file).
Driver "ati"
# ...
# ...
</screen>
<para>You are now ready to run!</para>
<para>Configure the rest of XFree86, and you're ready to run!</para>
</sect1>
<sect1id="using_ati_driver">
<title>Alternative 2: Using ATI's own R200 Driver</title>
<para>ATI's R200 driver comes in three distributions - one for XFree4.1, one for XFree4.2 and one for XFree4.3. You can download ATIs driver from <ulinkurl="http://mirror.ati.com/support/drivers/linux/radeon-linux.html">here</ulink>. Sadly, for those of us who do not use a RedHat-based or other RPM-supporting distribution, the package is only available in RPM format. For those of us who do not have RPM support, <literal>alien</literal> is the program to use. Alien converts between various package formats. To convert the ATI driver package to a <filename>.deb</filename> package, use <command>alien --to-deb packagename.rpm</command>. To convert it to a <filename>.tgz</filename> package, use <command>alien --to-tgz packagename.rpm</command>.</para>
<para>You are now ready to install the driver. To install it, use:</para>
<itemizedlist>
<listitem><para><command>rpm -i --force /path/to/packagename.rpm</command>, if you are installing the rpm package</para></listitem>
<listitem><para><command>dpkg -i --force-overwrite /path/to/packagename.deb</command>, if you made a .deb package</para></listitem>
<listitem><para><command>cd / && tar zxvf /path/to/packagename.tgz</command>, if you made a .tgz package.</para></listitem>
</itemizedlist>
<para>You are now ready to configure the driver. To install it, issue the following commands as root:</para>
<screen>
cd /lib/modules/fglr200/build_mod/
./make.sh
cd /lib/modules/fglr200/
./make_install.sh
</screen>
<para>The driver is now ready for use.</para>
<important><para>The driver will not load unless you tell your Linux system to load it every time
at startup. To do this, you must find out where to tell your Linux which modules to load at startup. In Debian, you must add the followng line to <filename>/etc/modules</filename>:</para>
<screen>
fglr200
</screen>
<para>Add the line to the end of the file. You are now ready to configure XFree86.</para>
</important>
<para>XFree86 can be configured in two ways: either by running <command>fglrxconfig</command> (supplied by the ATI driver), or by editing the <filename>XF86Config</filename> file manually.</para>
<para>If you choose to run <command>fglrxconfig</command>, the process is similar to a regular <command>xf86config</command> run, except for the choice of which screen card driver to use (which will automatically be set to the ATI Radeon driver).</para>
<para>If you want to edit the configuration file manually, locate it (usually <filename>/etc/X11/XF86Config</filename>), and open it in your favorite editor. Find the place saying <literal>Section "Device"</literal>. In this section, there should be a line saying <literal>Driver "somedrivername"</literal>. Edit this line so it says <literal>Driver "fglr200"</literal> and add the following lines right below that line: </para>
<screen>
Option "no_accel" "no"
Option "no_dri" "no"
Option "overlay" "off"
</screen>
<para>Comment out all other lines in the Device section (add a # in front of them). Your device section should now look like this:</para>
<screen>
Section "Driver"
Identifier "some_identifier" (the identifier is your choice, but if you edit it,
make sure you update every reference to it in the config file).
Driver "fglr200"
Option "no_accel" "no"
Option "no_dri" "no"
Option "overlay" "no"
# ...
# ...
</screen>
<para>You are now ready to run!</para>
</sect1>
<sect1id="using_dri_driver">
<title>Alternative 3: Using DRI's Latest Radeon Driver</title>
<para>The first thing you must do is to download the driver. You can download it from <ulinkurl="http://dri.sourceforge.net/download.phtml">here</ulink> (make sure you download the <filename>r200-XXXXXXXX-i386.tar.bz2</filename> package). After you have downloaded the driver, go to the directory you saved it in and type <command>tar jxvf packagename.tar.bz2</command>. Go to the new directory, (<command>cd dripkg/</command>), and type <command>./install.sh</command>. This will install the driver for you. You are now ready to configure XFree86, either by running <command>xf86config</command> or by editing the config file manually. The configuration process is exactly the same as in <xreflinkend="using_xf_driver"/>, so just follow the configuration steps there.</para>
<para>You are now ready to run XFree86!</para>
</sect1>
<sect1id="using_gatos_drivers">
<title>Alternative 4: Using the GATOS Project's Latest Driver</title>
<para>The GATOS project is an independent developer team. They develop drivers and utilities for ATI cards. To install their driver with DRI-support, you need to download it from <ulinkurl="http://gatos.sourceforge.net/project/showfiles.php?group_id=12629">here</ulink>. Download the <filename>ati.2</filename> file for your appropriate XFree86 version. You also need a set of files to enable dri support. These files are called the drm-kernel module. They can only be downloaded from CVS. To download them, issue the following commands:</para>
<para>You now need to make Linux load the module gatosdrm each time at startup. To do this, find out where your Linux distribution keeps the list of modules to load at startup and add the line <literal>gatosdrm</literal> to the end of that file (in Debian, the file is <filename>/etc/modules</filename>).</para>
<para>You are now ready to install the GATOS driver for the Radeon card. To do so, type the following commands: </para>
<screen>
cd /usr
tar zxvf /path/to/name-of-ati.2-package.tar.gz
</screen>
<para>The driver is now installed.</para>
<para> You are now ready to configure XFree86. This can be done by running <command>xf86config</command>, or by editing the XFree86 configuration file manually. The configuration process is the same as for XFree86's own driver in <xreflinkend="using_xf_driver"/>, so go back to that point and follow the XFree86 configuration process described there.</para>
<para>You are now ready to run XFree86!</para>
</sect1>
<sect1id="using_schneider_drivers">
<title>Alternative 5: Using Schneider Digital's drivers</title>
<para>Schneider Digital's driver is the one driver I haven't tried myself, but it seems
like a serious attempt on making a decent ATI Radeon driver for Linux. Well, enough chatting, let's get down to business.</para>
<para>The installation instructions for this driver are exactly the same as for <xreflinkend="using_ati_driver"/>, so follow those.
</para>
<para>Congratulations, you are now up and running! Please let me know about your experiences with this driver, as I didn't try it myself.</para>
</sect1>
</chapter>
<chapterid="links">
<title>Links</title>
<itemizedlist>
<listitem><para><ulinkurl="http://mirror.ati.com/support/drivers/linux/radeon-linux.html">http://mirror.ati.com/support/drivers/linux/radeon-linux.html</ulink> - ATIs R200 driver for XFree86 4.1.x/4.2.x </para></listitem>
<listitem><para><ulinkurl="http://gatos.sf.net/">http://gatos.sf.net/</ulink> - The GATOS Projects homepage - ATI drivers and utilities</para></listitem>
<listitem><para><ulinkurl="http://gatos.sourceforge.net/project/showfiles.php?group_id=12629">http://gatos.sourceforge.net/project/showfiles.php?group_id=12629</ulink> - The download section of the GATOS project's website.</para></listitem>
<listitem><para><ulinkurl="http://dri.sf.net/">http://dri.sf.net/</ulink> - The DRI Project, the Direct Rendering Infrastructure for XFree86. 3D Support, drivers and documentation.</para></listitem>
<listitem><para><ulinkurl="http://dri.sourceforge.net/download.phtml">http://dri.sourceforge.net/download.phtml</ulink> - The download section of the DRI's website.</para></listitem>
<listitem><para><ulinkurl="http://www.cloudchaser.net/projects/ati-howto/">http://www.cloudchaser.net/projects/ati-howto/</ulink> - The homepage of the HOWTO</para></listitem>