Page 2
Addendum Information Date Released January 5, 2005 Changes made to: REVISION CHANGES DATE NUMBER Initial Release 07-27-01 Raptor 2500 Support 12-17-01 SuSE, 1100T and 2100T Support 10-03-02 Raptor 2100D, MOX, Red Hat 8.0 and 03-06-03 Raptor 3840T Support Raptor 2500T & Red Hat 9.0 Suppor 04-28-03 Supports Radar Data 12-15-03...
Page 3
This is a guide to the installation of the Raptor Drivers for Linux software. All systems vary to a degree. Knowledge of the features of your system is helpful during the installation process. WARRANTY The Raptor cards are warranted for one (1) year from date of shipment.
TABLE OF CONTENTS (CONT’D) INVOKING THE X SERVER 5.1 Overview 5.2 startx 5.3 xinit 5.4 xdm 5.5 Starting the X Server in Multi-Screen Mode 5.6 Selecting Bit-Depths 5.6.1 Setting Bit-Depth on I-Class Cards 5.6.2 Setting Bit-Dept on T-Class Cards 5.6.3 MOX Modes 5.7 Setting Resolution on Raptor 1100T &...
Chapter 1 INTRODUCTION Overview Thank you for purchasing a Tech Source Raptor graphics card for use with your x86 PC workstation/server. This manual describes the installation of the Raptor hardware and the Linux drivers for the Raptor products. The “Raptor Drivers for Linux” software runs on x86 PC workstations/servers and supports two classes of Tech Source graphics cards.
Raptor Drivers for Linux Installation and Reference Manual From this point forward, Tech Source, Inc. will be referred to as Tech Source or TSI. The Raptor Drivers for Linux are provided on a CD-ROM which consists of: • Tech Source Raptor device drivers for Linux •...
Page 9
Chapter 1 – Introduction Whenever a variable name, command name, directory, or filename is used in a paragraph it will appear in a mono-spaced font. At times the reader will be instructed to enter commands at a prompt. In this case a transcript of a sample session will be provided where a prompt will be followed by the commands the reader is to enter.
Page 10
Raptor Drivers for Linux Installation and Reference Manual This page intentionally left blank.
Chapter 2 HARDWARE INSTALLATION Hardware Configurations Supported The Raptor card and software accompanying this manual have been tested on and currently support Intel and AMD x86 based computer systems running Linux. Raptor cards and software supporting other computer systems are available from Tech Source.
Raptor Drivers for Linux Installation and Reference Manual Step 2: Install the Raptor graphics card firmly into the PCI slot. Take care to press it evenly and snugly into the slot. Once you are certain the card is installed properly in the slot, secure it with the bracket screw.
Chapter 2 – Hardware Installation Figure 2-1 – 2500 FPS Digital Flat Panel Subsystem Installation of the Raptor 2100 FPS The Raptor 2100 FPS is comprised of the Raptor 2500T graphics card (configured for 2048x2048 resolution) and the Tech Source 2100 FPS digital flat panel, along with associated cables and software.
Page 14
Raptor Drivers for Linux Installation and Reference Manual The Raptor 2500T card has one connector on the front bracket. One side of the provided cable has the LFH60 connector that connects to the graphics card. The cable splits into two with MDR26 connectors on the opposite end.
Chapter 3 SOFTWARE INSTALLATION FOR I-CLASS CARDS Overview This installation chapter describes how to install and configure the drivers for I-Class Raptor cards. The I-Class Raptor cards that are currently supported with this software are the Raptor 2000 and Raptor 2500. Installation of T-Class Raptor cards is covered in Chapter 4.
Raptor Drivers for Linux Installation and Reference Manual The software has been fully tested under Red Hat 7.3, Red Hat 8.0, Red Hat 9.0, Red Hat Enterprise Linux (32-bit only) and SuSE 8.2. Updating or recompiling the kernel or the XFree86 distribution may cause the driver and DDX to fail to load.
Page 17
Chapter 3 – Software Installation for I-Class Cards prompt# mount /dev/cdrom /mnt/cdrom prompt# cd /mnt/cdrom/linux/i-class 5. The packages are in Red Hat's RPM format. For information on downloading, installing, and using the RPM utility, please refer to Red Hat's website and the related FAQ and HOWTO.
Raptor Drivers for Linux Installation and Reference Manual NOTE: You must install the MOX package if you plan on running the cards in MOX mode. The MOX package is common to both I-Class and T-Class cards. New Device One new device name is created in the /dev directory for each Raptor card.
Page 19
Chapter 3 – Software Installation for I-Class Cards /etc/X11/XF86Config.raptor /etc/X11/XF86Config.rapqfp NOTE: From this point on, the name XF86Config will be used to refer to the config file used by the XFree86 server. The sections for Raptor 2000 are listed below. Similar sections are added for the Raptor 2500.
Raptor Drivers for Linux Installation and Reference Manual 3.6.1 Monitor Section This section for Raptor cards should remain unchanged. 3.6.2 Device Section Identifier: Each Raptor card instance should have a unique identifier. This identifer is used in the Screen section. NOTE: The BusID value in the configuration file must be changed manually.
Chapter 3 – Software Installation for I-Class Cards Option "Device": This field specifies the device name of the Raptor card. The first Raptor card seen by the system will be /dev/raptor0 and the second will be /dev/raptor1 and so on. For Raptor 2500, the device name will be rapqfp0 and so on.
Raptor Drivers for Linux Installation and Reference Manual 3.6.4 ServerLayout Section This is the section which specifies the server layout for either single-screen or multi-screen configuration. NOTE: The ServerLayout section should already exist in your XF86Config file. It must be modified manually to include the Raptor card.
Chapter 4 SOFTWARE INSTALLATION FOR T-CLASS CARDS Overview This installation chapter describes how to install and configure the drivers for T-Class Raptor cards. This class of cards includes the following: • Raptor 2100T • Raptor 2500T • Raptor 1100T • Raptor 3840T The installation of I-Class Raptor cards is covered in Chapter 3.
Raptor Drivers for Linux Installation and Reference Manual The software has been fully tested under Red Hat 7.3, Red Hat 8.0, Red Hat 9.0, Red Hat Enterprise Linux, Red Hat Enterprise Linux 64-bit, and SuSE 8.2. Updating or recompiling the kernel or the XFree86 distribution may cause the driver and DDX to fail to load.
Page 25
Chapter 4 – Software Installation for T-Class Cards 4. If the CD-ROM is not already mounted, type: prompt# mount /dev/cdrom /mnt/cdrom prompt# cd /mnt/cdrom/linux/t-class 5. The packages are in Red Hat's RPM format. For information on downloading, installing, and using the RPM utility, please refer to Red Hat's website and the related FAQ and HOWTO.
Raptor Drivers for Linux Installation and Reference Manual 8. To install the MOX package, type: prompt# cd /mnt/cdrom/linux/moxlib prompt# rpm -Uvh tsimox-*.rpm NOTE: You must install the MOX package if you plan on running the cards in MOX mode. The MOX package is common to both I-Class and T-Class cards.
Chapter 4 – Software Installation for T-Class Cards Configuring XFree86 Server for PC Graphics Hardware This section assumes that the XF86Config file was configured to work properly with your existing VGA/SVGA cards. For documentation on how to install and configure your VGA/SVGA card, please refer to the XFree86 documentation.
Page 29
Chapter 4 – Software Installation for T-Class Cards BusID: Depending on the machine and the slot the card is in, it might receive a unique BusID. When the driver attaches, it will print out the device name and BusID. To check the BusID, type dmesg|grep rap.
Raptor Drivers for Linux Installation and Reference Manual Option This boolean field is useful when monitors of “ScaleCursPos”: different screen sizes are used together in a multi-screen configuration. When the cursor crosses screen boundaries, its position on the new screen will be adjusted to be proportional to where it was on the previous screen.
Page 31
Chapter 4 – Software Installation for T-Class Cards Monitor: This field should remain unchanged for the Raptor 2100T, Raptor 3840T and the Raptor 2500T. For the Raptor 1100T, this field should contain the identifier of the Monitor section that will be used with this card. Refer to the XFree86 documentation for instructions on how to create a custom Monitor section.
Raptor Drivers for Linux Installation and Reference Manual If multiple Raptor cards are installed, additional Screen sections should be created. Other fields should remain unchanged. For more information please refer to Section 5.5. 4.6.4 ServerLayout Section This is the section which specifies the server layout for either single-screen or multi-screen configuration.
Chapter 5 INVOKING THE X SERVER Overview There are several ways to invoke the X server on your system: • startx script provided in /usr/X11R6/bin • xinit • • Multi-screen operation This section assumes the use of the csh environment. If you prefer a different shell, make the appropriate changes to the examples.
Raptor Drivers for Linux Installation and Reference Manual startx This is the easiest way to start up the X server. The startx script is provided in $X11R6HOME/bin directory. To start up the X server in the default mode type: prompt% startx You may add any other standard command line arguments to the end of the line as neccessary.
Chapter 5 – Invoking The X Server NOTE: Make sure that the environment is set as described in Section 5.1. To start up the server using xinit, type: prompt% xinit -- $X11R6HOME/bin/X You may also add any other standard command line arguments to the end of the line.
Raptor Drivers for Linux Installation and Reference Manual Starting the X Server in Multi-Screen Mode The XF86Config file determines whether the X server starts up in single-screen mode or multi-screen mode. Once the XF86Config file is set up, the procedure for starting the X server (whether in single-screen or multi-screen mode) will be the same.
Chapter 5 – Invoking The X Server 5.6.2 Setting Bit-Depth on T-Class Cards The T-Class cards support the 8-bit, 24-bit, 8+24-bit, 8+8, mox16, mox24 and mox32 modes. Radar Scan capable versions of T-Class cards additionally support mox16radar, mox24radar and 8radar. By default these cards start up in 8-bit mode.
Page 40
Raptor Drivers for Linux Installation and Reference Manual To run X server in 8+24-bit mode with the 24-bit TrueColor visual as default, set the DefaultDepth option in the Screen section to 24 as shown. Section "Device" Identifier "Raptor1.1KT" Driver "rapt" Card "TSI Raptor 1100T"...
Chapter 5 – Invoking The X Server Other bit-depths can be selected in a similar manner. 5.6.3 MOX Modes MOX (Multiple Overlay Extension) provides support for multiple drawing layers on graphics cards. MOX is available on all Raptor cards. Details about MOX can be obtained in a technical white paper available separately from Tech Source.
Raptor Drivers for Linux Installation and Reference Manual If you need to support a resolution or refresh rate that is not listed, please contact Tech Source (see Chapter 7). 5.7.1 Setting Resolution To select a specific resolution modify the "Modes" option in the Screen section of the config file.
Chapter 5 – Invoking The X Server 5.7.2 Setting Resolution and Refresh Rate To select both a specific resolution and a specific refresh rate, both the Monitor and the Screen sections of the config file need to be modified. A list of supported resolutions along with their corresponding timing numbers is available in the file Extract the desired entry from /etc/X11/tsi_modeline.
Page 44
Raptor Drivers for Linux Installation and Reference Manual This page intentionally left blank. 5-12...
Chapter 7 TECHNICAL ASSISTANCE Who to Call for Help If you need help, please call our Technical Support Team at (800) 330-8301, or directly at (407) 262-7100 between the hours of 9:30am - 5:30pm EST Monday through Friday. Please have the software part number, version, and serial number for your Raptor card(s) available when contacting Tech Source in order to expedite support.
Raptor Drivers for Linux Installation and Reference Manual Website Detailed product information and Frequently Asked Questions (FAQs), are available on our website located at: http://www.techsource.com...
Raptor Drivers for Linux Installation and Reference Manual A.1.1.2 Raptor 2000-12M Specifications Frame Buffer: 8-bit single or double buffered; 12 Megabytes VRAM MOX Hardware: Tech Source MOX ASIC; 24 layer Priority Management Hardware Cursor: 3 color, 64 x 64 bitmap Color Lookup Table(s): 1024 entries...
Page 51
Appendix A – Card Specifications A.1.2 Raptor 2500 Specifications Frame Buffer: 24 MB VRAM MOX Hardware: Tech Source MOX 32 ASIC; 24 layer Priority Management Hardware Cursor: 3 color, 64 x 64 bitmap Color Lookup Primary color map with 2048 Tables: entries and two auxiliary color maps with 256 entries...
Page 52
Raptor Drivers for Linux Installation and Reference Manual A.2 T-Class Products A.2.1 Raptor 2100T Specifications Frame Buffer: 64MB SGRAM; 100 MHz MOX Hardware: Tech Source MOX ASIC; 32 layer Priority Management, 2 blending layers Hardware Cursor: Up to 3 cursors Color Lookup Primary color map with 2048 Tables:...
Appendix A – Card Specifications A.2.2 Raptor 1100T Specifications Frame Buffer: 32MB SGRAM; 100 MHz MOX Hardware: Tech Source MOX ASIC; 32 layer Priority Management, 2 blending layers Hardware Cursor: Up to 3 cursors Color Lookup Primary color map with 2048 Tables: entries and two auxiliary color maps with 256 entries each...
Raptor Drivers for Linux Installation and Reference Manual A.2.3 Raptor 2500T Specifications Frame Buffer: 64MB SGRAM MOX Hardware: Tech Source MOX ASIC; 32 layer Priority Management, 2 blending layers Hardware Cursor: Up to 3 cursors Color Lookup Primary color map with 2048 Tables: entries and two auxiliary color maps with 256 entries each...
Appendix A – Card Specifications A.2.4 Raptor 3840T Specifications Frame Buffer: 256MB SDRAM Hardware Cursor: Up to 3 cursors PCI Interface: 33/66 MHz, 32/64-bit Universal Signaling Video Interface: Quad Head DVI Video Connector: One Low Force Helix 60-pin (LFH60) connector [all digital interface] Temperature to 50...
Page 56
Raptor Drivers for Linux Installation and Reference Manual This page intentionally left blank.
Appendix C X Windows System Screen Dump Utility C.1 Overview C.1.1 TSI Screen Capture Utility tsiwd is a utility that dumps the contents of portions of the X Window screen to a file. It stores the data in a graphics file format that uses 24-bit lossless compression.
Page 60
Raptor Drivers for Linux Installation & Reference Manual The utility has two basic modes of operation: • window capture • region capture To capture the contents of a particular window, run tsiwd without the geometry argument. The cursor will change shape to resemble a cross, at which point the user can left-click on the window that is selected for capture.
Need help?
Do you have a question about the RAPTOR 1100T - DRIVERS FOR LINUX INSTALLATION-REFERENCE and is the answer not in the manual?
Questions and answers