3Dlabs Wildcat Realizm Driver for Linux Driver Version: 2.0.1 Release number: 05 In this release is: General expanded Linux OS support (Novell Linux Desktop 9 (64-bit) OpenGL 1.5 HLSL (across all supported Linux drivers) Performance improvements and optimizations Multiview, Genlock and Framelock for the Wildcat Realizm 200 and 800 across all supported Linux OS. ------------------------------------------------------------------------------ Legal Notices ------------------------------------------------------------------------------ Copyright(c) 2005 3Dlabs, Inc. All rights reserved. Including software, file formats, and audio-visual displays; may be used pursuant to applicable software license agreement; contains confidential and proprietary information of 3Dlabs and/or third parties which is protected by copyright and trade secret law and may not be provided or otherwise made available without proper authorization. Restricted Rights Legend. Use duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (c) (1) and (2) of Commercial Computer Software -- Restricted Rights at 48 CFR 52.227-19, as applicable. Unpublished -- rights reserved under the copyright laws of the United States. ------------------------------------------------------------------------------ System Requirements ------------------------------------------------------------------------------ Hardware x86 system (Intel Pentium4 or equivalent) Software Novell Linux Desktop 9 Linux 2.6.X version kernels only. XFree86 Version 4.3 XFree86 Development package. GCC compiler package. Kernel development package. Kernel source package for the current installed kernel. ------------------------------------------------------------------------------ Configuration Requirements ------------------------------------------------------------------------------ XFree86 Configuration Requirements The Wildcat Realizm card only supports 32 bit color. Changing the display from the X desktop to a setting less than "millions of colors" will not work correctly. The display color depth should be set to 24 in the XF86Config file. (See the "XXFree86 Configuration" section below.) ------------------------------------------------------------------------------ Installation Help ------------------------------------------------------------------------------ Installing the Wildcat Realizm Driver Root privileges are needed to install, update or remove the driver. 1. Query all installed versions of the Wildcat Realizm driver. rpm -qa | grep wildcat 2. Remove ALL previously installed versions of the Wildcat Realizm driver. Execute this command for each driver version returned from the query. rpm -e 3. Install the new Wildcat Realizm driver. /bin/sh Where is the file name of the driver package you are installing. 4. Modify the XF86Config file. (See "X Configuration" section below.) Starting the Wildcat Realizm Driver 1. Start the Wildcat Realizm driver by starting X. This command does not typically require root privileges. startx Verifying the Wildcat Realizm Driver 1. To verify that the driver has started, execute the following command. lsmod | grep wildcat 2. If the driver is not found (or returns a value of 0), manually install the driver from the text mode console. This sequence requires root privileges. cd /lib/modules/$(uname -r)/kernel/drivers/char/drm insmod wildcat.o 3. Start the Wildcat Realizm driver by starting X. startx If the driver did not start after performing the manual steps, please contact 3Dlabs customer support. (See "Support Information" section below.) ------------------------------------------------------------------------------ XXFree86 Configuration ------------------------------------------------------------------------------ Modify the sections in your XF86Config file using the sample configuration file "XF86Config.sample" that is placed in the /etc/X11 directory when the Wildcat Realizm driver is installed. **** Do NOT copy XF86Config.sample over the original XF86Config file. **** The sample file may not work if the system's input devices are different than those defined in the sample file. Backup the original /etc/X11/XF86Config file before making any modifications. Below are summary descriptions of the XF86Config file sections relevant to graphics configuration. For more detailed information, see the SaX utility documentation and the XF86Config man page. Module section: The "Module" section contains a list of modules that will be loaded when X starts. This example defines the modules needed by the Wildcat Realizm driver. Section "Module" Load "dbe" Load "type1" Load "speedo" Load "freetype" Load "extmod" Load "glx" Load "GLcore" Load "fbdevhw" Load "record" Load "dri" EndSection Monitor section: The "Monitor" section contains information about the display monitor. This example defines a generic monitor configuration suitable for most monitors. Section "Monitor" DisplaySize 400 300 HorizSync 31-115 Identifier "Monitor[0]" ModelName "Generic Model" VendorName "Generic Vendor" VertRefresh 50-160 UseModes "Modes[0]" EndSection Monitor section: The "Modes" section contains information for the video modes for a specific monitor. Below are some examples. Section "Modes" Identifier "Modes[0]" Modeline "1280x1024" 105.15 1280 1360 1496 1712 1024 1025 1028 1059 Modeline "1280x1024" 125.14 1280 1368 1504 1728 1024 1025 1028 1065 Modeline "1280x1024" 145.69 1280 1376 1512 1744 1024 1025 1028 1071 Modeline "1280x1024" 165.29 1280 1376 1512 1744 1024 1025 1028 1077 Modeline "1280x1024" 186.80 1280 1376 1520 1760 1024 1025 1028 1083 Modeline "1280x1024" 198.96 1280 1376 1520 1760 1024 1025 1028 1087 Modeline "1024x768" 61.89 1024 1080 1184 1344 768 769 772 794 Modeline "1024x768" 73.89 1024 1080 1192 1360 768 769 772 799 Modeline "1024x768" 86.18 1024 1088 1200 1376 768 769 772 803 Modeline "1024x768" 97.84 1024 1088 1200 1376 768 769 772 808 Modeline "1024x768" 110.91 1024 1096 1208 1392 768 769 772 813 Modeline "1024x768" 122.97 1024 1096 1208 1392 768 769 772 818 Modeline "1024x768" 136.57 1024 1104 1216 1408 768 769 772 822 Modeline "1024x768" 149.05 1024 1104 1216 1408 768 769 772 827 Modeline "1024x768" 160.49 1024 1104 1216 1408 768 769 772 832 Modeline "800x600" 36.88 800 832 912 1024 600 601 604 621 Modeline "800x600" 44.13 800 840 920 1040 600 601 604 624 Modeline "800x600" 51.73 800 840 928 1056 600 601 604 628 Modeline "800x600" 58.73 800 840 928 1056 600 601 604 632 Modeline "800x600" 66.71 800 848 936 1072 600 601 604 635 Modeline "800x600" 73.98 800 848 936 1072 600 601 604 639 Modeline "800x600" 82.55 800 856 944 1088 600 601 604 643 Modeline "800x600" 90.10 800 856 944 1088 600 601 604 647 Modeline "800x600" 97.59 800 856 944 1088 600 601 604 650 Modeline "640x480" 23.06 640 656 720 800 480 481 484 497 Modeline "640x480" 27.74 640 664 728 816 480 481 484 500 Modeline "640x480" 32.64 640 672 736 832 480 481 484 503 Modeline "640x480" 36.97 640 672 736 832 480 481 484 505 Modeline "640x480" 42.22 640 680 744 848 480 481 484 508 Modeline "640x480" 46.80 640 680 744 848 480 481 484 511 Modeline "640x480" 51.43 640 680 744 848 480 481 484 514 Modeline "640x480" 57.18 640 680 752 864 480 481 484 517 Modeline "640x480" 62.12 640 680 752 864 480 481 484 521 EndSection Screen section: The "Screen" section listed below shows the default settings for a Wildcat Realizm graphics card. This contains information about the display resolution and color depth. The identifier entry should match the Screen entry in the ServerLayout section. The Monitor entry should match the Identifier entry in the Monitor section. Ensure that monitor supports the display modes included in the Screen section. Section "Screen" DefaultDepth 24 SubSection "Display" Depth 24 Modes "1280x1024" "1024x768" "800x600" "640x480" EndSubSection Device "Device[0]" Identifier "Screen[0]" Monitor "Monitor[0]" EndSection Device section: The "Device" section contains information about the graphics device. This defines the basic configuration for the Wildcat Realizm graphics device. Section "Device" BoardName "Wildcat RealiZm" BusID "1:0:0" Driver "wildcat" Identifier "Device[0]" VendorName "3DLabs" EndSection SeverLayout section: The "ServerLayout" section binds the Screen identifier to defined input devices. The Screen entry identifies the default screen that will be set up when running X and directs the X server to look for a section "Screen0" (in this example) for graphics screen setup. A corresponding "Screen0" section should be configured for Wildcat Realizm. Section "ServerLayout" Identifier "Layout[all]" InputDevice "Keyboard[0]" "CoreKeyboard" InputDevice "Mouse[1]" "CorePointer" Option "Clone" "off" Option "Xinerama" "off" Screen "Screen[0]" EndSection DRI section: The "DRI" section is required for OpenGL support. The Mode value should be 0666 as shown. Section "DRI" Group "video" Mode 0666 EndSection ------------------------------------------------------------------------------ Support Information ------------------------------------------------------------------------------ For driver support and contact information, please visit our web site at www.3dlabs.com