Raptor OpenWindows for Solaris Installation and Reference Manual Publication: 65-0228-01 Copyright © 2005 Tech Source, Inc. 442 S. North Lake Blvd.
Addendum Information Date Released May 6, 2005 Changes made to: REVISION NUMBER A B C D E F CHANGES Initial Release Raptor 2500 Support Added T-Class Cards Integrated MOX on T & I-Class Cards Raptor 2500T Support and Solaris 2.5.1 Support Added Raptor 2500T-DL DATE 07-02-01 01-10-02 09-27-02 05-14-03 02-05-04 05-06-05 The Tech Source logo, and Tech Source Raptor are trademarks of Tech Source, Inc. X Window System is a trademark and product of X.org.
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 OpenWindows for Solaris Installation for use with the Tech Source, Inc. Raptor cards. This manual is intended for users who incorporate the Tech Source, Inc. Raptor Cards into Sun PCI systems. This is a guide to the installation of the Raptor OpenWindows for Solaris software. All systems vary to a degree.
Customers will be charged an hourly rate plus materials ($300.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.
TABLE OF CONTENTS INTRODUCTION 1.1 Overvi ew 1.2 Conventions 1-1 1-1 1-3 HARDWARE INSTALLATION 2.1 Hardware Configurations Supported 2.2 Installation Instructions 2.3 Raptor 2100/2500 installation 2-1 2-1 2-1 2-3 SOFTWARE INSTALLATION FOR I-CLASS CARDS 3.1 Overview 3.2 Requirements 3.3 Installing I-Class Card Driver Software 3.4 Changing Resolution and Bit-Depth 3.4.1 Resolution on Raptor 2000 and Raptor 2500 3.4.2 Resolution on Raptor 1000 3.4.3 Raptorconfig Utility 3.
TABLE OF CONTENTS CONT’D 4.5 Trzconfig Utility 4-4 4.5.1 Interactive Configuration 4-5 4.6 Setting Raptor as the Console (Optional) 4-7 4.6.1 Raptor as the Only Framebuffer 4-7 4.6.1.1 Sun Blade 100 and Sun Blade 150 4-7 4.6.1.2 Ultra 5 and Ultra 10 4-8 4.6.1.3 Sun Blade 1000, Sun Blade 2000, Ultra 80, E250, and E450 4-8 4.6.2 Raptor with a Secondary Framebuffer 4-9 4.6.2.1 Other PCI Framebuffers 4-10 OPENWINDOWS 5.1 Overview 5.1.1 Raptor as the Console 5.1.2 Raptor as the Secondary Framebuffer 5.
TABLE OF CONTENTS CONT’D CHANGING THE CONSOLE RESOLUTION A.1 Overview A.2 Output-Device Method A.3 Video-Mode Method A.4 Video-Timing Method A.5 Troubleshooting A-1 A-1 A-2 A-3 A-4 A-6 USING NVEDIT TO MODIFY NVRAM B.1 NVRAM Edit Commands B-1 B-1 CARD SPECIFICATIONS C.1 Raptor 2100T Specifications C.2 Raptor 1100T Specifications C.3 Raptor 2500T Specifications C.4 Raptor 2500T-DL C.5 Raptor 2000 Specifications C.5.1 Raptor 2000-24M C.5.2 Raptor 2000-12M C.6 Raptor 1000 Specifications C.
This page intentionally left blank.
Chapter 1 INTRODUCTION 1.1 Overview Thank you for purchasing a Tech Source, Inc. Raptor graphics card for use with your Sun desktop/server. This manual describes the installation and configuration of the Raptor graphics card and the accompanying software. This software runs on Sun PCI desktops/servers and supports two classes of Raptor graphics cards.
Raptor OpenWindows for Solaris Installation and Reference Manual Raptor 2500T Supports either 2560x2048 (digital) or 2048x2048 resolution (digital), depending upon the hardware configuration. Raptor 2500T-DL Supports either 2560x2048 (digital) or 2048x2048 resolution (digital), depending upon the hardware configuration. The appropriate configuration supports the Tech-Source 2500FPS or 2100FPS respectively. This card replaces the Raptor 2500T.
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 OpenWindows for Solaris Installation and Reference Manual This page intentionally left blank.
Chapter 2 HARDWARE INSTALLATION 2.1 Hardware Configurations Supported The Raptor cards have been tested on and currently support the following PCI based systems. • • • • • • • • • • Sun Blade 100 Sun Blade 150 Sun Blade 1000 Sun Blade 2000 Sun Blade 2500 Ultra 5 Ultra 10 Ultra 80 Enterprise 250 Enterprise 450 NOTE: If your Sun PCI system is not listed here, please contact Tech Source. 2.2 Installation Instructions Installing a Raptor card is simple and consists of a few easy steps.
Raptor OpenWindows for Solaris Installation and Reference Manual 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 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 slot. Take care to press it evenly and snugly into the 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 Dual-Link DVI cable to connect them together.
Raptor OpenWindows for Solaris Installation and Reference Manual This page intentionally left blank.
Chapter 3 SOFTWARE INSTALLATION FOR I-CLASS CARDS 3.1 Overview This chapter describes how to install and configure I-Class Raptor cards. Installation of T-Class Raptor cards is covered in Chapter 4. The following is a list of I-Class cards: • • • Raptor 1000 Raptor 2000 Raptor 2500 NOTE: This software must be installed on your system prior to running OpenWindows on these cards.
Raptor OpenWindows for Solaris Installation and Reference Manual • • • OpenWindows Version 3.5 or higher has already been installed on the system. This is typically bundled with the OS. At least 2MB of disk space is available in /usr and /. One or more of the cards listed in Section 3.1 are presently installed in the workstation. 3.3 Installing I-Class Card Driver Software The following are step-by-step instructions for installing the Raptor OpenWindows for Solaris Software from a CD-ROM. 1.
Chapter 3 – Software Installation for I-Class Cards prompt# mount -F hsfs -O -o ro \ /dev/dsk/c0t6d0s0 /cdrom prompt# cd /cdrom/I-Class 6. To install the software, type: prompt# ./install_all This script will ask you a number of yes-or-no questions (generated by Sun's pkgadd installation program). Answer these questions appropriately. 7.
Raptor OpenWindows for Solaris Installation and Reference Manual 3.4 Changing Resolution and Bit-Depth After installation you will need to configure the OpenWindows screen resolution, bit-depth, and refresh rate for your monitor. (This resolution is different from the console resolution. Appendix A discusses changing the console resolution.) At any time after installation you can change these parameters by using the raptorconfig utility. NOTE: You must be logged in as root to execute this program. 3.4.
Chapter 3 – Software Installation for I-Class Cards The Raptor device(s) will be listed in the left column of the configuration screen displayed by raptorconfig. (See Figure 3.1). Figure 3.1 Raptorconfig A description of the commands is as follows: Up/Down Arrow selects the desired device to modify graphics Left/Right Arrow selects the parameter to modify (e.g.
Raptor OpenWindows for Solaris Installation and Reference Manual ‘t’ puts a test pattern on the entire display (hit any key to return to the main screen) ‘s’ saves current settings and exits ‘h’ help ‘q’ exits the program without saving any changes 3.5 Setting Raptor (Optional) as the Console This section describes how to configure the Raptor as the console device in your system. For information on setting the resolution in console mode, please refer to Appendix A. 3.5.
Chapter 3 – Software Installation for I-Class Cards 2. Type the letter that corresponds to the Raptor card that you want to use as the console device. Raptor cards can be identified by looking for the string TSI or raptor in the list of device names. 3. Type setenv output-device . When you type , the display that was selected in the previous step will be inserted in the command line. 4. Power off the system 5.
Raptor OpenWindows for Solaris Installation and Reference Manual 3.5.1.3 Sun Blade 1000, Sun Blade 2000, Ultra 80, E250, and E450 If no other framebuffers are present in a Sun Blade 1000, Sun Blade 2000, Ultra 80, E250, or E450 then the Raptor will be the console by default, provided the board is in a valid probed PCI slot. 3.5.2 Raptor with a Secondary Framebuffer NOTE: This section does not apply to Sun Blade machines. The information in Section 3.5.1.
Chapter 3 – Software Installation for I-Class Cards ok setenv output-device /pci@1f,4000/TSI,raptor@# ok reset-all Once the system is reset, all console messages will be directed to the selected Raptor card. NOTE: To restore the default graphics device as the console for any reason, simply set the output-device variable back to its default value of screen as below: ok setenv output-device screen ok reset-all 3.5.2.
Raptor OpenWindows for Solaris Installation and Reference Manual This page intentionally left blank.
Chapter 4 SOFTWARE INSTALLATION FOR T-CLASS CARDS 4.1 Overview This Chapter describes how to install and configure T-Class Raptor cards. Installation of I- Class Raptor cards is covered in Chapter 3. The following is a list of T-Class cards: • • • • Raptor Raptor Raptor Raptor 2100T 1100T 2500T 2500T-DL NOTE: This software must be installed on your system prior to running OpenWindows on these cards.
Raptor OpenWindows for Solaris Installation and Reference Manual • • At least 2MB of disk space is available in /usr and /. One or more of the cards listed in Section 4.1 are presently installed in the system. 4.3 Installing T -Class Card Driver Software The following are step-by-step instructions for installing the Raptor OpenWindows for Solaris Software from a CD-ROM. 1. Install a Raptor card in the computer as described in Chapter 2. 2.
Chapter 4 – Software Installation for T-Class Cards If /cdrom/cdrom0 does not exist, mount the CD-ROM by typing the following: prompt# mount -F hsfs -O -o ro \ /dev/dsk/c0t6d0s0 /cdrom prompt# cd /cdrom/T-Class 6. To install the software, type: prompt# ./install_all This script will ask you a number of yes-or-no questions (generated by Sun's pkgadd installation program). Answer these questions appropriately. 7.
Raptor OpenWindows for Solaris Installation and Reference Manual 4.4 Changing Resolution and Bit-Depths 4.4.1 Raptor 1100T The default resolution of the Raptor 1100T is set to 1280x1024. The resolution of this card can be changed through the trzconfig utility. This utility can also be used to change the bit-depths. Refer to Section 4.5 for details on using trzconfig. 4.4.2 Raptor 2100T The resolution of the Raptor 2100T is fixed at 2048x2048. However, the bit-depth can be changed.
Chapter 4 – Software Installation for T-Class Cards Raptor cards support the following bit-depths: 8 8+24 24 8+8 mox16 mox24 mox32 8-bit PsuedoColor Simultaneous 8-bit PsuedoColor and True Color 24-bit True Color Two 8-bit PseudoColor visuals MOX, 8-bit Normal, 13-bit Group, Absolute MOX, 8-bit Normal, 21-bit Group, Absolute MOX, 8-bit Normal, 24-bit Group, Absolute 24-bit 5-bit 13-bit 21-bit The next section describes how to use trzconfig to configure the Raptor card. 4.5.
Raptor OpenWindows for Solaris Installation and Reference Manual Figure 4.1 - Trzconfig A description of the commands is as follows: Up/Down Arrow selects the desired device to modify graphics Left/Right Arrow selects the parameter to modify (e.g.
Chapter 4 – Software Installation for T-Class Cards ‘h’ help ‘q’ exits the program without saving any changes 4.6 Setting Raptor (Optional) as the Console This section describes how to configure the Raptor as the console device in your system. NOTE: If the procedure for your system is not described below, please contact Tech Source. 4.6.1 Raptor as the Only Framebuffer 4.6.1.
Raptor OpenWindows for Solaris Installation and Reference Manual 4. Power off the system 5. Connect your monitor cable to the onboard VGA connector on your system back panel 6. Power on the system. 4.6.1.2 Ultra 5 and Ultra 10 To use the Raptor as the system console on an Ultra 5 or Ultra 10 as the only framebuffer, first disable the graphics device which comes built-in to the Ultra 5 and Ultra 10.
Chapter 4 – Software Installation for T-Class Cards 4.6.2 Raptor with a Secondary Framebuffer NOTE: This section does not apply to Sun Blade machines. The information in section 4.6.1 applies to all Sun Blades with multiple framebuffers. The Raptor can be made the console device when other secondary framebuffers are present in the system.
Raptor OpenWindows for Solaris Installation and Reference Manual Once the system is reset, all console messages will be directed to the selected Raptor card. NOTE: To restore the default graphics device as the console for any reason, simply set the output-device variable back to its default value of screen as below: ok setenv output-device screen ok reset-all 4.6.2.
Chapter 5 OPENWINDOWS 5.1 Overview This section describes how to start up OpenWindows on the Raptor cards. The examples in this chapter use raptor0 as the device name but the device name of your card may be different. The following table lists the different Raptor cards and their corresponding device names. The device name will have the card’s instance number appended to it. For example, the first instance of a Raptor 2000 will have a device name of raptor0.
Raptor OpenWindows for Solaris Installation and Reference Manual prompt# openwin -dev /dev/fbs/m640 \ -dev /dev/fbs/raptor0 The assigned OpenWindows screen numbers correspond to the order of the devices on the command line. NOTE: In the above example, the raptor device instance number is 0. This may be different in your configuration. Please check in /dev/fbs/ or dmesg for the correct device instance numbers on your system. 5.
Chapter 5 – OpenWindows 5.3 Setting Bit-Depth on I-Class Cards I-Class cards support 8-bit mox16 and mox24 modes. By default X windows comes up in 8-bit mode on these cards. The bit-depth can be selected by using the raptorconfig utility (see Section 3.4.3.) For an explanation of the various MOX modes, please see Section 5.5. 5.4 Setting Bit-Depth on T-Class Cards Raptor 1100T, 2100T, 2500T and Raptor 2500T-DL cards support 8-bit, 24-bit, 8+8-bit, 8+24-bit, mox16, mox24 and mox32 modes.
Raptor OpenWindows for Solaris Installation and Reference Manual This page intentionally left blank.
Chapter 6 UNINSTALLING RAPTOR SOFTWARE 6.1 Uninstalling Raptor Software To uninstall the packages comprising the Raptor software, first determine which packages were installed by typing: prompt# pkginfo | grep TSI This will list the packages from Tech Source that are installed on your system. Please take note of these packages, and then type one of the following commands to remove the I-Class or T-Class software in the proper order.
Raptor OpenWindows for Solaris Installation and 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 OpenWindows for Solaris Installation/Reference Manual 7.3 Website Detailed product information and Frequently Asked Questions (FAQs), are available on our website located at: http://www.techsource.
Appendix A CHANGING THE CONSOLE RESOLUTION A.1 Overview Normally the default console resolution is sufficient for most users but if the monitor does not “sync-up” you may need to change the console resolution. NOTE: It is recommended that you use raptorconfig to test a resolution before configuring the console to that resolution. The Raptor card can be configured to be the console in the UltraSPARC workstation.
Raptor OpenWindows for Solaris Installation and Reference Manual The display resolution of the Raptor 2000, Raptor 2500, Raptor 2100T, Raptor 2500T and Raptor 2500T-DL cards cannot be changed. It is possible to change the console resolution on the Raptor 1000 and Raptor 1100T cards.
Appendix A - Changing the Console Resolution A.3 Video-Mode Method At the ok prompt in Boot PROM mode, the console resolution can easily be set on the Raptor 1000 and Raptor 1100T cards by using one of the preinstalled resolution modes.
Raptor OpenWindows for Solaris Installation and Reference Manual 30 31 32 33 34 1600x1200x65 1600x1200x70 1600x1200x75 1600x1200x85 + 1600x1280x76 * NOTE: The resolutions followed by an * use composite sync. The resolutions followed by a + are not supported on the Raptor 1100T. Use nvedit to set the video-mode variable in NVRAM to the number that corresponds to the desired video mode in the preceding table.
Appendix A - Changing the Console Resolution NOTE: Please refer to Appendix B for a description of nvedit commands. For example, to set the console resolution to 1280x1024x76, type the following: ok nvedit 0: : video-timing " 1280, 384, 32, 64, 1024, 43, 3, 8, 135000000, 0" ; 1: ok nvstore ok setenv use-nvramrc? true ok reset NOTE: The syntax is very important. The spaces must be present exactly as they appear in the example. NOTE: The last three commands enable the NVRAM.
Raptor OpenWindows for Solaris Installation and Reference Manual The sync values can be added together to select more than one of the above. NOTE: To obtain the timing parameters required to use the video-timing method, please contact Tech Source with your monitor's requirements. A.5 Troubleshooting Problem: The Video-Mode method described in Appendix A was used to change the console resolution but the card does not come up in the desired resolution.
Appendix A - Changing the Console Resolution Use nvedit to remove the video-timing variable from NVRAM using the following procedure: 1. Type nvedit at the ok prompt in Boot PROM mode. 2. Use to move to the next line until the cursor is on the line where video-timing is defined. 3. Type to delete the line. 4. Type to exit the nvedit editor. 5. Type nvstore to save the changes. 6. Type setenv NVRAM. 7. Type reset-all to restart the system.
Raptor OpenWindows for Solaris Installation and Reference Manual This page intentionally left blank.
Appendix B USING NVEDIT TO MODIFY NVRAM B.1 NVRAM Edit Commands This section discusses the use of NVRAM. The NVRAM is used for setting resolution in the Video-Mode and Video-Timing methods. To edit the NVRAM, type nvedit at the ok prompt.
Raptor OpenWindows for Solaris Installation and Reference Manual This page intentionally left blank.
Appendix C CARD SPECIFICATIONS C.
Raptor OpenWindows for Solaris Installation and Reference Manual C.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 C – Card Specifications C.
Raptor OpenWindows for Solaris Installation and Reference Manual C.
Appendix C – Card Specifications C.5 Raptor 2000 Specifications C.5.
Raptor OpenWindows for Solaris Installation and Reference Manual C.5.
Appendix C – Card Specifications C.
Raptor OpenWindows for Solaris Installation and Reference Manual C.
Appendix D X Windows System Screen Dump Utility D.1 Overview D.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 32bit planes, including the contents of layers created through the Multiple Overlay eXtension (MOX). D.
Raptor OpenWindows for Solaris Installation & Reference Manual Alternately, an exact region of the screen can be captured by specifying the region's geometry using the geometry option. The "x" and "y" specify the upper left-hand corner of the region, which, along with "width" and "height", describe the rectangular area to be captured. However chosen, the captured image is saved as a PNG file by default.
NOTES
NOTES
NOTES
Publication: 65-0228-01
