Raptor X Servers for Tru64 UNIX Installation and Reference Manual Publication # 65-0207-01 Copyright © 2005 by Tech Source, Inc. 442 S. North Lake Blvd.
Addendum Information Date Released April 29, 2005 Changes made to: REVISION NUMBER CHANGES DATE A Initial Release 12-06-96 B Added CD-ROM Installation 02-13-97 C Changed CD-ROM Mount Command 03-21-97 D Changed prompt command on software installation 08-06-97 E Added Raptor GFX-8M and Raptor 2000 03-29-98 F Add 8-bit multiple resolution support 04-30-98 G New Layout and major updates to content 01-23-01 H Change in Software Installation 03-15-01 J Raptor 2500, Raptor 1100T, Rapt
All rights reserved. No part of this work may be reproduced in any form or by any means without prior written permission of the copyright owner. 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 (October 1988) and FAR 52.227-19 (June 1987). The product described in this manual may be protected by one or more U.S.
The installation of any Tech Source, Inc. hardware/software product is the sole responsibility of the customer. Tech Source, Inc. offers a continuing hardware/software support program that provides telephone consultation and any required hardware repair after the expiration of the warranty period. This is a billable annual maintenance contract. Contact Tech Source, Inc. for the available maintenance plans. Customers will be charged an hourly rate plus materials ($300.
TABLE OF CONTENTS INTRODUCTION .................................................................. 1-1 1.1 Overview .................................................................. 1-1 1.2 Conventions ............................................................. 1-3 HARDWARE INSTALLATION ............................................... 2-1 2.1 Hardware Configurations Supported............................ 2-1 2.2 Installation Instructions ............................................. 2-1 2.
TABLE OF CONTENTS CONT’D 5.5 Flash Erase............................................................. 5-2 5.6 The 8+24 Simultaneous Visuals................................. 5-3 UNINSTALLING RAPTOR SOFTWARE................................. 6-1 6.1 Uninstalling Raptor X Servers for Tru64 UNIX ............... 6-1 TECHNICAL ASSISTANCE................................................... 7-1 7.1 Who to Call for Help.................................................. 7-1 7.2 Email Address ...........................
Chapter 1 INTRODUCTION 1.1 Overview Thank you for purchasing a Tech Source, Inc. Raptor graphics card for use with your HP/Compaq Alpha based workstations. This manual describes the installation and configuration of the Raptor graphics card and the accompanying software. This software runs on HP/Compaq Alpha based workstations and supports two classes of Raptor graphics cards.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual Raptor 2500T-DL Supports 2048x2048 resolutions (digital) and drives the Raptor 2100 and Raptor 2500 LCD Flat Panels. For applications that require a graphics boot console at a low resolution, as an alternative to Powerstorm & Elsa-Gloria cards, Tech Source provides a low cost solution called the Raptor GFX8PD NOTE: This software supports Tru64 UNIX 4.0f and higher. Tru64 UNIX was formerly called Digital UNIX.
Chapter 1 - Introduction 1.2 Conventions This manual will follow certain conventions throughout. 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.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual This page intentionally left blank.
Chapter 2 HARDWARE INSTALLATION 2.1 Hardware Configurations Supported The software has been tested on and currently supports the following PCI based system: • • • HP Alpha Workstation XP 1000 HP Alpha Workstation DS10 & DS25 HP Alpha Workstation 433au Other similar PCI workstations are expected to work as well. Please email hotline@techsource.com if you run into any issues.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual NOTE: Remember which cables go to which connectors. You may want to label the cables and connectors before disconnecting them. Step 1: Shutdown the system and turn the power OFF, remove the system’s cover, find an available PCI Local Bus slot, and remove the bracket and screw. Ground yourself by touching the metal part on the case. Step 2: Install the Raptor card firmly into the PCI Local Bus slot.
Chapter 2 – Hardware Installation 2.3 Raptor 2100/2500 FPS Installation Figure 2-1 – Raptor 2100 Digital Flat Panel Subsystem Tech Source offers two flat panel subsystems: the Raptor 2100FPS with a resolution of 2048x2048 (4MP), and the Raptor 2500FPS with a resolution of 2560x2048 (5MP). Each subsystem is comprised of one LCD flat panel (4MP or 5MP), one Raptor 2500T-DL graphics card, and a standard DualLink DVI cable to connect them together.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual This page intentionally left blank.
Chapter 3 SOFTWARE INSTALLATION 3.1 Installation The software is installed using the standard Tru64 UNIX utility setld. You must be logged in as super-user or root when doing the installation. NOTE: If you had already installed Raptor software earlier, trying to install the new software will give you the following message: setld: All subsets on the kit are already installed. You need to uninstall the previous Raptor software in order to install the new version.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual It is only necessary to install the package for the card you wish to use. 3.1.1 Installation From CD-ROM 3.1.1.1 Installation on Tru64 UNIX v4.0 This driver software supports Tru64 UNIX v4.0f and higher. To install from a CD-ROM, follow the procedure below. 1. Insert the CD-ROM into the drive. 2. Create a mount point for the CD-ROM, such as /cdrom. prompt# mkdir /cdrom 3. Mount the CD-ROM on /cdrom.
Chapter 3 – Software Installation c. To install the software for Raptor 2100T, Raptor 1100T and Raptor 2500T-DL, type: prompt# cd /cdrom/RAPFT prompt# setld -l . d. To install the RAPMOX503 package, type: prompt# cd /cdrom/RAPMOX prompt# setld -l . NOTE: You must install the RAPMOX package if you plan to use MOX ( Multiple Overlay Extension) features 5. You will need to reboot the system for the installation to take effect. 6. To list the installed graphics cards, type: prompt# sizer –gt 7.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual 3. Mount the CD-ROM on /cdrom. For example, if the CDROM device is located at the /dev/disk/cdrom0c, type: prompt# mount -t cdfs -o rrip \ /dev/disk/cdrom0c /cdrom 4. a. To install the software for Raptor 2000 and Raptor 1000 type: prompt# cd /cdrom/RAPTOR prompt# setld -l . b. To install the Raptor GFX-8PD software package, type: prompt# cd /cdrom/GFX prompt# setld –l . c.
Chapter 3 – Software Installation 6. To list the installed graphics cards, type: prompt# sizer –gt 7. When setld is done, unmount the CD-ROM: prompt# umount /cdrom 3.2 Changing the Resolution Resolutions can be changed on some Raptor cards. The table below illustrates the configurability of various cards. The procedures to change resolutions are described in the sections listed in the last column of the table.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual This page intentionally left blank.
Chapter 4 INVOKING X WINDOWS 4.1 Overview There are several ways to start up X Windows on your HP Alpha system. • • • Invoking X from Command Line xdm CDE This chapter assumes the use of csh environment. 4.2 Invoking X from Command Line To start up X Windows from the command line, simply type: prompt# /usr/bin/X11/X This will start windows on all the graphics cards in the system in multi-screen mode. The screen-order is determined by which graphics card is first identified by the system.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual To disable X Windows on a selected -disableScreen option. For example, card, use the prompt# X –disableScreen1 This will start up X on the cards associated with screen 0, screen 2, screen 3, etc. NOTE: The -screenOrder option should list all the screens. Omitting any screen will cause the X Server to crash. To bring up X Windows on a selected card only, use the -onlyScreen option and refer to the screen number of that card.
Chapter 4 – Invoking X Windows 4.3.1 Resolution Options for the Raptor 1000 and Raptor 1100T The X Windows resolution of the Raptor 1000 and Raptor 1100T can be set through the -screen and -vsync command line options and by editing the XServers.conf. If no option is used, the resolution defaults to 1280x1024@60 for Raptor 1000 and 1280x1024@60 for Raptor 1100T. For a list of valid resolutions, please refer to Appendix A.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual To start X Windows on the Raptor GFX-8PD in 24-bit only mode, on Tru64 5.0 and later type: prompt# /usr/bin/X11/X -depth 24 -lbx On Tru64 4.0f type: prompt# /usr/bin/X11/X –depth 24 To start X Windows on the Raptor GFX-8PD in 8+24 bit mode, on Tru64 5.0a and later type: prompt# /usr/bin/X11/X -depth 32 -lbx On Tru64 4.
Chapter 4 – Invoking X Windows The X Windows resolution of the Raptor GFX-8PD can be set through the -screen and -vsync command line options. If no option is used, the resolution is set to 1280x1024@60. For a list of valid resolutions, please refer to Appendix A. If the specified resolution does not match one from the list, the default resolution will be used.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual To start X Windows in 8-bit only mode, set the STARSMODE environment variable to +8 before starting up the X Server. prompt# setenv STARSMODE +8 To start X Windows in 8+8-bit mode, set the STARSMODE environment variable to +8+8 before starting up the X Server. prompt# setenv STARSMODE +8+8 To start X Windows in 8+24-bit mode, set the STARSMODE environment variable to +8+24 before starting up the X Server.
Chapter 4 – Invoking X Windows 4.3.4 Depth Options for I-Class Cards I-Class Cards can be started up in 8-bit and MOX modes. On these cards X Windows starts up in 8-bit mode by default. An explanation of different MOX modes can be found in Section 4.4. To start X Windows in MOX16 mode, set the STARSMODE environment variable to +mox16 before starting up the X Server.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual To specify a screen number you may modify the configuration file /var/X11/Xserver.conf as follows: args< -screen1 1600x1200 –vsync 60 –pn > For the GFX-8PD the bit depth can also be specified in Xserver.conf. To start X Windows on the Raptor GFX-8PD in 24-bit only mode on the first screen (screen 0), modify the Xserver.
Chapter 4 – Invoking X Windows MOX16 MOX24 MOX, 8-bit Normal, 13-bit Group, 5-bit Absolute MOX, 8-bit Normal, 21-bit Group,13-bit Absolute The following additional MOX mode applies to the Raptor 1100T, Raptor 2100T and Raptor 2500T-DL cards: MOX32 MOX, 8-bit Normal, 32-bit group, 24-bit absolute 4.5 Configuring with an Elsa Gloria Card All Raptor cards can be used with the Elsa Gloria card in multiscreen mode.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual 4.6 Configuring Raptor with Radeon Cards Raptor cards can be used with the Radeon cards in a multiscreen configuration. However, for the Radeon cards to work properly in the multi-screen mode, the latest Radeon kit labeled V1.3A (RAD543A) must be installed. Some components, most notably the CDE desktop, do not handle multiple screens very well.
Chapter 4 – Invoking X Windows screen is desired. A typical Xservers file is shown below: :0 local /usr/bin/X11/X This will start up X Windows on all graphics cards in the default mode. Command line arguments as described in Sections 4.2 and 4.3 can be appended to this line. For more information on xdm, refer to the xdm man pages. 4.7.1 MOX Mode Using xdm In order to run MOX under xdm you must make use of the StartWin script installed in /usr/bin/X11.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual :0 Local local@console /usr/bin/X11/X :0 This will start up X Windows on all the graphics cards in the system. Command line options as described in Sections 4.2 and 4.3 can be appended to this line. 4.8.1 MOX Mode Using CDE You must use the StartWin script (in /usr/bin/X11) in order to run MOX under CDE.
Chapter 5 ADVANCED FEATURES 5.1 Overview The Raptor cards have several advanced features available through the X Server. They are discussed in the subsections below. 5.2 The 8+8 Mode This mode is available on Raptor 2100T, Raptor 2500T-DL and Raptor 1100T cards and offers two PseudoColor visuals on the same screen. Each of these 8-bit visuals offers their own set of planes and colormap and can be accessed using the standard X Window function calls such as XGetVisualInfo and XMatchVisual.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual In normal X Servers, when planes are allocated, the available colors are significantly reduced. For example, in an 8-bit X Server, if we allocate two 4-bit layers, the total number of colors available are only 16+15=31 in contrast to the original 256 colors. MOX allows efficient use of a colormap that has up to 2048 entries. The MOX hardware on the Raptor cards does efficient mapping of these LUT entries to the corresponding planes. Section 4.
Chapter 5 – Advanced Features ideal for use with double buffering to clear the entire back buffer or to clear select planes from the back buffer. Flash Erase is available transparently through the XFillRectangle function. It is available to use for any rectangle whose width spans the entire screen since the area to be cleared is defined by scan lines.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual This page intentionally left blank.
Chapter 6 UNINSTALLING RAPTOR SOFTWARE 6.1 Uninstalling Raptor X Servers for Tru64 UNIX The Tru64 UNIX utility, setld, must be used for uninstalling the software. To check if you have Raptor software installed on your machine, type: prompt# setld –i | grep RAP This will print out all Raptor patches like RAPFT, RAPTOR & RAPMOX.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual This page intentionally left blank.
Chapter 7 TECHNICAL ASSISTANCE 7.1 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 X Servers for Tru64 UNIX Installation & Reference Manual 7.3 Website Detailed product information, Frequently Asked Questions (FAQs), are available on our website located at: http://www.techsource.
Appendix A LIST OF RESOLUTIONS A.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual 1600x1200x80 1600x1200x85 1600x1000x66 1600x1000x76 1440x900x76 1280x800x76 1920x1080x70 1920x1200x70 A.
Appendix A – List of Resolutions 1280x1024x60 1280x1024x67 1280x1024x75 1280x1024x76 1280x1024x85* 1600x1000x66* 1600x1000x76* 1600x1200x60* 1600x1200x65* 1600x1200x70* 1600x1200x75* 1600x1200x85* 1600x1280x76* *Indicates that this resolution is supported at 8-bit depth only.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual This page is intentionally left blank.
Appendix B CARD SPECIFICATIONS B.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual B.2 Raptor 1100T Specifications Frame Buffer: 32MB SGRAM MOX Hardware: Tech Source MOX ASIC; 32 layer Priority Management, 2 blending layers Hardware Cursor: Up to 3 cursors.
Appendix B – Card Specifications B.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual B.4 Raptor 2000 Specifications B.4.
Appendix B – Card Specifications B.4.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual B.
Appendix B – Card Specifications B.6 Raptor GFX-8PD Specifications .
Raptor X Servers for Tru64 UNIX Installation & 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. This utility differs from xwd in that tsiwd captures the data/contents from up to 32-bit planes, including the contents of layers created through the Multiple Overlay eXtension (MOX). The tsiwd utility is installed in /usr/bin/X11 directory. C.
Raptor X Servers for Tru64 UNIX Installation & Reference Manual colormap is used for the image display window. If this option is not provided, the default colormap is used. 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.
NOTES
NOTES
NOTES
Publication # 65-0207-01
