Changeset ac38e9dc for x/installing/x7driver-ati.xml

Timestamp:

08/01/2015 04:26:22 AM (9 years ago)

Author:

Douglas R. Reno <renodr@…>

Branches:

systemd-13485

Children:

ad6910d

Parents:

4a83293

Message:

Import back into SVN from Github

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@16309 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• x/installing/x7driver-ati.xml (modified) (8 diffs)

x/installing/x7driver-ati.xml

@@ -36 +36 @@
       </para>
 
-      &lfs76_checked;
+      &lfs77_checked;
 
       <note>
         <para>
-          For Direct Rendering to work with newer Radeon Cards (R300 and later chipsets),
-          you need to enable the r300, r600 and radeonsi Gallium drivers at
-          <xref linkend="mesalib"/> build time. Also, some cards require Firmware to be
-          available when the kernel driver is loaded. Firmware can be obtained from
-          <ulink url="http://people.freedesktop.org/~agd5f/radeon_ucode/">
-          this</ulink> site. See "Kernel Configuration for additional firmware" below.
+          For Direct Rendering to work with newer Radeon Cards (R300 and later
+          chipsets), you need to enable the r300, r600 and radeonsi Gallium
+          drivers at <xref linkend="mesalib"/> build time. Also, some cards
+          require Firmware to be available when the kernel driver is loaded.
+          Firmware can be obtained from <ulink
+          url="http://anduin.linuxfromscratch.org/sources/linux-firmware/"/>.
+          See <xref linkend="xorg-ati-firmware-kernel"/> below for additional
+          firmware.
         </para>
       </note>
@@ -87 +89 @@
       <bridgehead renderas="sect5">Required</bridgehead>
       <para role="required">
-        <xref linkend="xorg-server"/>
+        <xref linkend="xorg-server"/> (recommended to be built with glamor enabled)
       </para>
 
@@ -94 +96 @@
           Glamor is <emphasis>required for "Southern Islands" and later
           GPUs</emphasis> but optional for R300 to R700, Evergreen and
-          "Northern Islands" GPUs - see the link under "Glamor
-          Acceleration" below.
+          "Northern Islands" GPUs - see the link in <xref
+          linkend="ati-glamor-accel"/> below.
         </para>
       </note>
@@ -108 +110 @@
 
       <para>
-        Enable the following options in the kernel configuration and recompile the
-        kernel if necessary:
+        Enable the following options in the kernel configuration and recompile
+        the kernel if necessary:
       </para>
 
 <screen><literal>Device Drivers  ---&gt;
   Graphics support ---&gt;
-    ATI Radeon: Y or M</literal></screen>
+    Direct rendering Manager ---&gt;
+      &lt;*&gt; Direct Rendering Manager (XFree86 ... support) ---&gt; [CONFIG_DRM]
+      &lt;*&gt; ATI Radeon                                          [CONFIG_DRM_RADEON]</literal></screen>
 
       <indexterm zone="xorg-ati-driver xorg-ati-driver-kernel">
@@ -140 +144 @@
       </para>
 
-<screen><literal>CONFIG_EXTRA_FIRMWARE="radeon/BTC_rlc.bin radeon/CAICOS_mc.bin radeon/CAICOS_me.bin radeon/CAICOS_pfp.bin radeon/CAICOS_smc.bin rtl_nic/rtl8168e-3.fw"
+<screen><literal>CONFIG_EXTRA_FIRMWARE="radeon/BTC_rlc.bin radeon/CAICOS_mc.bin radeon/CAICOS_me.bin
+radeon/CAICOS_pfp.bin radeon/CAICOS_smc.bin rtl_nic/rtl8168e-3.fw"
 CONFIG_EXTRA_FIRMWARE_DIR="/lib/firmware"</literal></screen>
+
+     <note>
+       <para>
+         CONFIG_EXTRA_FIRMWARE should all be on one line. It
+         is shown above as two lines for presentation only.
+       </para>
+     </note>
 
       <tip>
@@ -150 +162 @@
       </tip>
 
+      <para>
+        Alternatively, if you change CONFIG_DRM_RADEON to '=m' in your .config
+        the firmware can be loaded automatically from /lib/firmware/radeon when
+        it installs the module. This offers a tiny space saving, but also means
+        that the screen will be blank for a longer time before the framebuffer
+        appears. Distros take this approach because it is not practical to
+        specify every possible firmware and the kernel would be excessively big.
+      </para>
+
       <indexterm zone="xorg-ati-driver xorg-ati-firmware-kernel">
         <primary sortas="d-xorg-ati-firmware">xorg-ati-firmware</primary>
@@ -177 +198 @@
     </sect3>
 
-    <sect3>
+    <sect3 id="ati-glamor-accel">
       <title>Glamor Acceleration</title>
 
@@ -189 +210 @@
         Decoder ring for engineering vs marketing names</ulink>. Please note
         that Glamor acceleration can be used with other chips as well, from the
-        R300 onwards, but it has not been tested recently.
+        R300 onwards. On at least some Northern Islands chips it is beneficial.
       </para>
 
       <para>
         Glamor acceleration is not enabled by default for chipsets that don't
-        use "radeonsi" Gallium3D driver. You have to use a
-        <filename>xorg.conf</filename> file to enable it. To enable
-        Glamor for cards other than "Southern Islands" and later, create the
-        following <filename>/etc/X11/xorg.conf</filename> as the
-        <systemitem class="username">root</systemitem> user:
-      </para>
-
-<screen role="root"><userinput>cat &gt;&gt; /etc/X11/xorg.conf &lt;&lt; "EOF"
-<literal>Section "Module"
-        Load "dri2"
-        Load "glamoregl"
-EndSection
-
-Section "Device"
+        use "radeonsi" Gallium3D driver. You have to use an
+        <filename>xorg.conf</filename> file to enable it. To enable Glamor for
+        cards other than "Southern Islands" and later, create the following
+        file in <filename class="directory">/etc/X11/xorg.conf.d</filename>
+        as the <systemitem class="username">root</systemitem> user:
+      </para>
+
+<screen role="root"><userinput>cat &gt;&gt; /etc/X11/xorg.conf.d/20-glamor.conf &lt;&lt; "EOF"
+<literal>Section "Device"
         Identifier "radeon"
         Driver "radeon"