The Tech Source logo and Tech Source Raptor are trademarks of
Tech Source, Inc.
Sun, Sun Microsystems, Sun Ultra, Sun Enterprise, Sun Blade,
and Solaris are trademarks or registered trademarks of Sun
Microsystems, Inc.
All other products or services mentioned in this document are
identified by the trademarks or service marks of their respective
companies or organizations. Tech Source, Inc. disclaims any
responsibility for any references to those trademarks herein.
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 U.S. Government is subject to restrictions of FAR 52.22714(g)(2)(6/87) and FAR 52.227-19 (6/87); or DFAR 252.2277015(b)(6/95) and DFAR 227.7202-3(a).
ii
The product described in this manual may be protected by one or
more U.S. patents, foreign patents, and/or pending patent
applications.
PREFACE
This publication documents the Tech Source, Inc. Raptor
4000/4000e series cards. This manual is intended for users who
incorporate the Tech Source, Inc. Raptor Cards into Sun PCI and
PCI Express systems.
This also serves as a guide to configuring and using X Windows
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 two (2) years from date of
shipment. During the warranty period, Tech Source, Inc. will, at its
discretion, repair or replace a defective component at its expense.
Freight charges associated with the repair or replacement of
components under warranty are to be shared by Tech Source, Inc.
and the customer. All customers, domestic and international, shall
bear the freight charges for the product return. Tech Source, Inc.
shall bear the outbound freight charges up to $20.00 (USD) per
returned product, whether domestic or international. Any
additional freight charge shall be the responsibility of the customer.
We suggest that you contact your dealer first with any questions
you may have about the product. Unlimited technical support (via
telephone/facsimile/email) is provided for one (1) year from date of
shipment. 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
($350.00 USD minimum) for repairs and/or maintenance
performed by Tech Source, Inc. that are not covered by a Tech
Source, Inc. warranty or maintenance contract.
DOCUMENTATION IS PROVIDED “AS IS” AND ALL
EXPRESSED OR IMPLIED CONDITIONS, REPRESENTATIONS
AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE
EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE
LEGALLY INVALID.
3.6 Setting Raptor 4000/4000e as the Console (Optional) 11
4 Starting X 13
4.1 Overview 13
4.1.1 Starting the X server 13
4.1.2 xinit 14
4.1.3 Raptor as the Secondary Framebuffer 15
4.2 Common Desktop Environment (CDE) 15
4.3 Setting Bit-Depth on 4000/4000e Cards 16
4.4 MOX Modes 16
5 Uninstalling Software 17
5.1 Uninstalling Raptor Software 17
6 Technical Assistance 19
Appendix A: Console Resolution 21
TABLE OF CONTENTS (Cont'd)
Appendix B: Using Nvedit 29
B.1 NVRAM Edit Commands 29
Appendix C: Card Specifications 31
C.1 Raptor 4000 Specifications 31
ii
1 Introduction
1.1 Overview
Thank you for purchasing a Tech Source, Inc. Raptor graphics
card for use with your Sun PCI/PCI Express desktop/server. This
manual describes the installation and configuration of the Raptor
graphics card and the accompanying software. All systems vary
somewhat, therefore some knowledge of the features of your
system and a basic understanding of UNIX shell commands are
helpful during the software installation process.
From this point forward, Tech Source, Inc. will be referred to as
Tech Source or TSI.
The software runs on Sun PCI desktops/servers and supports the
Raptor 4000/4000e graphics cards. The software is provided on a
CD-ROM and consists of:
• Raptor device drivers for Solaris
• Raptor loadable module (DDX) for X Windows
• MOX extension loadable module and libraries
The following products are supported:
Raptor 4000 Supports 2048x2048 resolutions (digital and
analog) on a PCI bus.
Raptor 4000/e Supports 2048x2048 resolutions (digital and
analog) on a PCI Express bus.
The software supports Solaris 9 and 10. Please contact Tech
Source at: hotline@techsource.com if you need support for a
different version of Solaris OS.
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. The entire transcript will be in a mono-spaced
font with the prompt in a normal weight and the user's entries in
bold.
The prompt used in a transcript varies depending on the
circumstances. The following are some common prompts and
when they are used:
prompt#used when the user is required to have root
privileges
prompt%used when the user is not required to have root
privileges
okprompt displayed when the user is in Boot PROM
mode
2
2 Hardware Installation
2.1 Hardware Configurations Supported
The Raptor cards have been tested on and currently support the
following Sun Microsystems workstations:
• Ultra 25
• Ultra 45
NOTE: If your Sun hardware (workstation) is not listed here, please
contact Tech Source for compatibility verification.
2.2 Installation Instructions
Installing a Raptor card is simple and consists of a few easy steps.
NOTE: Remember which cables go to which connectors. You
may want to label the cables and connectors before
disconnecting them.
Step 1: Shut down the system and turn the power OFF. Remove
the system’s cover along with any cables that prevent you
from doing so. Find an available PCI or PCI Express slot,
and remove the bracket and screw. Ground yourself by
touching the metal part of the case.
Step 2: Install the Raptor card firmly into the PCI or PCI Express
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.
Step 3: Secure the system cover and reattach any previously
removed cables, and connect the video cable to the
monitor.
NOTE: Installation of Raptor4000/4000e driver software is
discussed in Section 3.3
NOTE: If the system is currently using a secondary TSI graphics
device, refer to Appendix A for configuring one of the cards as the
console. The console device is the screen on which the boot up
messages will appear. The monitor must be connected to the
console device before you proceed to one of the following software
installation chapters.
The Raptor card is now installed and the system is ready for
software installation. Refer to Chapter 3 for instructions on
installing the software.
4
3 Software Installation
3.1 Overview
This Chapter describes how to install and configure the Raptor
4000/4000/4000e cards. The software called “Raptor 4000/4000e
Drivers (Solaris)” currently supports the following cards:
• Raptor 4000 (PCI card)
• Raptor 4000e (PCI Express card)
NOTE: This software must be installed on your system prior to
running X Windows on these cards.
The software for the Raptor 4000/4000e cards is provided on a
CD-ROM or is available by FTP and is composed of the following
packages:
• TSIafp Device drivers for the Raptor 4000 cards.
• TSIafpw DDX for the Raptor 4000 cards.
• TSImox Device driver package for MOX capability.
NOTE: The current version of this software supports only the high
resolution head, which is the head closest to the PCI/PCI Express
bus.
3.2 Requirements
The following are prerequisites for installing the Raptor
4000/4000e drivers for Solaris: