background image

 

Chapter 1 - Introduction 

 

 

1-3 

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.  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 

ok

 

prompt displayed when the user is in Boot PROM 
mode 

 

Summary of Contents for RAPTOR 1000 - OPENWINDOWS FOR SOLARIS INSTALLATION-REFERENCE

Page 1: ...Raptor OpenWindows for Solaris Installation and Reference Manual Copyright 2005 Tech Source Inc 442 S North Lake Blvd Altamonte Springs FL 32701 407 262 7100 Publication 65 0228 01 Rev F May 6 2005 ...

Page 2: ... architecture developed by Sun Microsystems 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 t...

Page 3: ... 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 13 00 USD per returned product whether domestic or international Any additional freight charge shall be the responsibility of the cust...

Page 4: ...ered 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 ...

Page 5: ... 3 4 2 Resolution on Raptor 1000 3 4 3 4 3 Raptorconfig Utility 3 4 3 5 Setting Raptor as the Console Optional 3 6 3 5 1 Raptor as the Only Framebuffer 3 6 3 5 1 1 Sun Blade 100 and Sun Blade 150 3 6 3 5 1 2 Ultra 5 and Ultra 10 3 7 3 5 1 3 Sun Blade 1000 Sun Blade 2000 Ultra 80 E250 and E450 3 8 3 5 2 Raptor with a Secondary Framebuffer 3 8 3 5 2 1 Other PCI Framebuffers 3 9 SOFTWARE INSTALLATION...

Page 6: ...nd 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 5 1 Overview 5 1 5 1 1 Raptor as the Console 5 1 5 1 2 Raptor as the Secondary Framebuffer 5 1 5 2 Common Desktop Environment CDE 5 2 5 3 Setting Bit Depth on I Class Cards 5 3 5 4 Setting Bit Depth on T Class Cards 5 3 5 5 MOX Modes 5 3 UNINSTALLING RAPTOR SOFTWARE 6 1 6 1 Uninstalling Ra...

Page 7: ...t Commands B 1 CARD SPECIFICATIONS C 1 C 1 Raptor 2100T Specifications C 1 C 2 Raptor 1100T Specifications C 2 C 3 Raptor 2500T Specifications C 3 C 4 Raptor 2500T DL C 4 C 5 Raptor 2000 Specifications C 5 C 5 1 Raptor 2000 24M C 5 C 5 2 Raptor 2000 12M C 6 C 6 Raptor 1000 Specifications C 7 C 7 Raptor 2500 Specifications C 8 X WINDOWS SYSTEM SCREEN DUMP UTILITY D 1 D 1 Overview D 1 D 1 1 TSI Scre...

Page 8: ...iv This page intentionally left blank ...

Page 9: ...following products Raptor 2000 Supports 2048x2048 resolution analog Designed to support Sony DDM monitor Raptor 1000 Supports multiple resolutions up to 1920x1200x60 analog Raptor 2500 Supports 2560x2048 resolution and drives the Tech Source 2500FPS Digital Flat Panel using a digital interface The T Class graphics cards are based on the Tech Source proprietary TROZ graphics processor and include t...

Page 10: ...you are installing Read the label on the back of your Raptor graphics card to determine the model of card that you have Alternatively you can also look at Appendix C and identify your card based on the drawings and descriptions 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 installat...

Page 11: ...ession 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 privi...

Page 12: ...Raptor OpenWindows for Solaris Installation and Reference Manual 1 4 This page intentionally left blank ...

Page 13: ...un Blade 1000 Sun Blade 2000 Sun Blade 2500 Ultra 5 Ultra 10 Ultra 80 Enterprise 250 Enterprise 450 2 2 Installation Instructions Installing a Raptor card is simple and consists of a few easy steps NOTE If your Sun PCI system is not listed here please contact Tech Source NOTE Remember which cables go to which connectors You may want to label the cables and connectors before disconnecting them ...

Page 14: ...rew Step 3 Secure the system s cover and reattach any previously removed cables and connect the video cable to the monitor NOTE Installation of Raptor 2100 2500 FPS is discussed in Section 2 3 NOTE If the system is currently using a secondary TSI graphics device read section 3 5 or 4 6 on configuring one of the cards as the console The console device is the screen on which the boot up messages wil...

Page 15: ...flat panel 4MP or 5MP one Raptor 2500T DL graphics card and a standard Dual Link DVI cable to connect them together On the back of the Raptor LCD panel are two DVI inputs labeled A and B Plug the Dual Link DVI cable into either port Optionally connect a second Raptor 2500T DL card to the remaining port Select which signal to display by accessing the OSD on screen display or by sending the appropri...

Page 16: ...Raptor OpenWindows for Solaris Installation and Reference Manual 2 4 This page intentionally left blank ...

Page 17: ...ndows on these cards The software for the I Class cards is provided on CD ROM or by FTP and is composed of the following packages TSIrapw OpenWindows software TSIrcfg Raptor configuration program TSIrap 32 bit device driver for Raptor 1000 2000 cards TSIrapx 64 bit device driver for Raptor 1000 2000 cards TSIrapqfpx 64 bit device driver for Raptor 2500 TSIrapqfp 32 bit device driver for Raptor 250...

Page 18: ...a Raptor card in the computer as described in Chapter 2 2 Boot the computer with the r reconfiguration option To do this on an UltraSPARC workstation perform the following steps Power ON the computer Wait until you see boot messages displaying on the screen then press and hold the Stop L1 key and then press the A key At the ok prompt type boot r 3 After the system comes up log in as root 4 Insert ...

Page 19: ...d libraries type prompt cd cdrom cdrom0 mox or prompt cd cdrom mox if the CD ROM was mounted as outlined in Step 5 above prompt pkgadd d TSImox Note You must install the MOX package in order to use the MOX extension 8 Reboot the system to complete the installation One new device name is created in the dev fbs directory for each Raptor card It is denoted by rapqfp for Raptor 2500 and raptor for oth...

Page 20: ...48 for the Sony DDM 2800 monitor The resolution of the Raptor 2500 card is fixed at 2560x2048 3 4 2 Resolution on Raptor 1000 The Raptor 1000 supports multiple resolutions The resolution can be selected through the raptorconfig utility 3 4 3 Raptorconfig Utility The raptorconfig utility has an interactive menu style interface See Figure 3 1 It can be used to set resolution bit depth and refresh ra...

Page 21: ...d by raptorconfig See Figure 3 1 Figure 3 1 Raptorconfig A description of the commands is as follows Up Down Arrow selects the desired graphics device to modify Left Right Arrow selects the parameter to modify e g resolution bit depth or sync Space Bar modifies the parameter for the selected graphics device will bring up a menu when applicable ...

Page 22: ...ure 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 1 Raptor as the Only Framebuffer 3 5 1 1 Sun Blade 100 and Sun Blade 150 To use the Raptor as the system console on a Sun Blade 100 or Sun Blade 150 use the following procedure 1 At the ok prompt type show displays This will list the installed graphics device...

Page 23: ...onnect your monitor cable to the onboard VGA connector on your system back panel 6 Power on the system 3 5 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 At the ok prompt type ok setenv pcib probe list 1 3 ok reset all Once the system is reset all c...

Page 24: ...ce variable in NVRAM must be changed to the actual path of the desired Raptor cards This path can best be determined by searching for the string TSI in the tree at the ok prompt To find the PCI devices at the ok prompt type the following ok show devs You should see at least one entry containing the string TSI For example TSI raptor where will be a digit representing your Raptor s PCI number Use th...

Page 25: ...cable Determine the slot numbers that correspond to these framebuffers and then ensure that the Raptor slot number precedes them in the pcia probe list For example if the Raptor is located in slot 3 and a secondary framebuffer is located in slot 1 then update the pcia probe list so that slot 3 is probed BEFORE slot 1 A possible configuration may resemble the following ok setenv pcia probe list 3 2...

Page 26: ...Raptor OpenWindows for Solaris Installation and Reference Manual 3 10 This page intentionally left blank ...

Page 27: ... your system prior to running OpenWindows on these cards The software for the T Class cards is provided on CD ROM or by FTP and is composed of the following packages TSItrz u Device drivers for the Raptor T Class cards TSItrzw OpenWindows DDX for the Raptor T Class cards 4 2 Requirements The following are prerequisites for installing the Raptor OpenWindows for Solaris Software The system is runnin...

Page 28: ...Raptor card in the computer as described in Chapter 2 2 Boot the computer w ith the r reconfiguration option by performing the following steps Power ON the computer Wait until you see boot messages displaying on the screen then press and hold the Stop L1 key and then press the A key At the ok prompt type boot r 3 After the system comes up log in as root 4 Insert the CD ROM labeled Raptor OpenWindo...

Page 29: ...ot install the MOX module and libraries in Chapter 3 you can install them now by typing prompt cd cdrom cdrom0 mox or prompt cd cdrom mox if the CD ROM was mounted as outlined in Step 5 above prompt pkgadd d TSImox Note You must install the MOX package in order to use the MOX extension 8 Reboot the system to complete the installation One new device name is created in the dev fbs directory for each...

Page 30: ...he trzconfig utility Refer to Section 4 5 for details 4 4 3 Raptor 2500T and Raptor 2500T DL The Raptor 2500T and Raptor 2500T DL are configured in hardware to support either 2048x2048 or 2560x2048 resolutions Therefore depending on your flat panel subsystem it will support the appropriate resolution For example Raptor 2500 FPS supports 2560x2048 and Raptor 2100 FPS supports 2048x2048 4 5 Trzconfi...

Page 31: ...e The next section describes how to use trzconfig to configure the Raptor card 4 5 1 Interactive Configuration The trzconfig utility has an interactive menu style interface See Figure 4 1 To use this program to configure your Raptor card type prompt trzconfig NOTE If X Windows is running on the Raptor card s to be configured please exit out of it before running trzconfig Failure to do so could res...

Page 32: ...selects the desired graphics device to modify Left Right Arrow selects the parameter to modify e g resolution bit depth or sync Space Bar modifies the parameter for the selected graphics device will bring up a menu when applicable t puts a test pattern on the entire display hit any key to return to the main screen s saves current settings and exits ...

Page 33: ...n Blade 150 use the following procedure 1 At the ok prompt type show displays This will list the installed graphics devices and a prompt to enter a selection 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 in the list of device names 3 Type setenv output device Control Y When you type Cont...

Page 34: ... and Ultra 10 At the ok prompt type ok setenv pcib probe list 1 3 ok reset all Once the system is reset all console messages will be directed to the Raptor card 4 6 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 30 E250 or E450 then the Raptor will be the console by default provided the board is in a valid prob...

Page 35: ...prompt To find the PCI devices at the ok prompt type the following ok show devs You should see at least one entry containing the string TSI For example TSI rapifp where will be a digit representing your Raptor s PCI slot number Use this entry as the console device for your desired Raptor card For example if the path is pci 1f 4000 to the Raptor 3840T device TSI rapifp type the following command ok...

Page 36: ...slot numbers that correspond to these framebuffers then ensure that the Raptor slot number precedes them in the pcia probe list For example if the Raptor is located in slot 3 and a secondary framebuffer is located in slot 1 then update the pcia probe list so that slot 3 is probed BEFORE slot 1 A possible configuration may resemble the following ok setenv pcia probe list 3 2 1 4 ok reset all Once t...

Page 37: ...ll 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 Card Device Name 1000 raptor 2000 raptor 2500 rapqfp 1100T rap1kt 2100T rap2kt 2500T raptfp 2500T DL raptfp 5 1 1 Raptor as the Console If the Raptor is the console type prompt openwin 5 1 2 Raptor as the Secondary Framebuffer If the PGX Sun Microsystem s on b...

Page 38: ... independent of the Raptor software If you have installed CDE and would like the CDE login screen to appear on the Raptor display you will need to change your etc dt config Xservers file to include the following line 0 Local local uid console root usr openwin bin Xsun 0 dev dev fbs raptor0 You may add any other command line arguments to the end of the line In addition since the graphics devices ar...

Page 39: ...it mox16 mox24 and mox32 modes By default X Windows comes up in 8 bit mode on these cards The bit depth can be selected by using the trzconfig utility see Section 4 5 For an explanation of the various MOX modes please see Section 5 5 5 5 MOX Modes The following MOX modes apply to all Raptor cards mox16 MOX 8 bit Normal 13 bit Group 5 bit Absolute mox24 MOX 8 bit Normal 21 bit Group 13 bit Absolute...

Page 40: ...Raptor OpenWindows for Solaris Installation and Reference Manual 5 4 This page intentionally left blank ...

Page 41: ...e of these packages and then type one of the following commands to remove the I Class or T Class software in the proper order For I Class cards type prompt pkgrm TSIrapw TSIrapx TSIrap TSIrcfg TSIrapqfpx TSIrapqfp prompt pkgrm TSImox For T Class cards type prompt pkgrm TSItrzw TSItrz prompt pkgrm TSImox WARNING This uninstall procedure is not for use with older versions of the Raptor software It i...

Page 42: ...Raptor OpenWindows for Solaris Installation and Reference Manual 6 2 This page intentionally left blank ...

Page 43: ... card s available when contacting Tech Source in order to expedite support Please make a note of this information in the area below DETAILS OF YOUR CARD S P N _________________________________ Model Name ___________________________ Serial Number s ____________________ 7 2 Email Address Our email address is hotline techsource com International customers should use email or our fax line at 407 339 2...

Page 44: ...ptor OpenWindows for Solaris Installation Reference Manual 7 2 7 3 Website Detailed product information and Frequently Asked Questions FAQs are available on our website located at http www techsource com ...

Page 45: ...ult console resolution and default depth as shown in the following table Board Resolution Refresh Bits Pixels Sync Raptor 1000 1280x1024 67Hz 8 Separate Raptor 1100T 1280x1024 67Hz 8 Separate Raptor 2000 2048x2048 60Hz 8 Separate Raptor 2100T 2048x2048 60Hz 8 Separate Raptor 2500 2560x2048 60Hz 8 Separate Raptor 2500T 2560x2048 or 2048x2048 60Hz 8 Seperate Raptor 2500T DL 2560x2048 or 2048x2048 60...

Page 46: ...put Device Method To specify the console resolution of a Raptor card via the output device environment variable use the format screen rAxBxC where A is the desired horizontal resolution B is the desired vertical resolution C is the desired refresh rate The system will check these values against an internal list of resolutions see section A 3 for valid list and use the corresponding entry as the co...

Page 47: ...the following video modes Raptor 1000 1100T Video Modes 1 640x480x72 2 640x480x75 3 640x480x85 4 800x600x60 5 800x600x72 6 800x600x75 7 800x600x85 8 1024x768x60 9 1024x768x70 10 1024x768x75 11 1024x768x77 12 1024x768x85 13 1024x800x85 14 1152x900x60 15 1152x900x66 16 1152x900x70 17 1152x900x75 18 1152x900x76 19 1152x900x85 20 1280x800x76 21 1280x1024x60 22 1280x1024x66 23 1280x1024x67 24 1280x1024...

Page 48: ... Please refer to Appendix B for a description of nvedit commands ok nvedit 0 8 value video mode 1 ctrl c ok nvstore ok setenv use nvramrc true ok reset NOTE The last three commands enable the NVRAM Without these lines the changes you make with nvedit will be ignored A 4 Video Timing Method If the previously described method fails for your configuration it is possible to specify the exact timing nu...

Page 49: ...xactly as they appear in the example NOTE The last three commands enable the NVRAM Without these lines the changes you make with nvedit will be ignored The following is a brief description of the 10 parameters used in this method horizontal resolution in pixels horizontal blanking total horizontal front porch horizontal sync width vertical resolution in lines vertical blanking total vertical front...

Page 50: ...ve been set at the ok prompt or the video timing variable may be set in NVRAM The resolution specified by the output device variable and the video timing variable takes precedence over the resolution specified by the video mode variable If a resolution has not been specified by any of these variables then the card s default resolution is used The order of precedence from highest to lowest is as fo...

Page 51: ...e next line until the cursor is on the line where video timing is defined 3 Type Ctrl u Ctrl k to delete the line 4 Type Ctrl c to exit the nvedit editor 5 Type nvstore to save the changes 6 Type setenv use nvramrc true to enable the NVRAM 7 Type reset all to restart the system This procedure can also be used to remove the video mode variable if necessary See Appendix B for more information on nve...

Page 52: ...Raptor OpenWindows for Solaris Installation and Reference Manual A 8 This page intentionally left blank ...

Page 53: ...the previous line Ctrl n moves to the next line Ctrl b moves to the previous character Ctrl f moves to the next character Ctrl u deletes to the beginning of the line Ctrl k joins the current and next line Ctrl u Ctrl k deletes the current line Ctrl c exits the NVRAM editor back to the ok prompt The changes will only take effect if they are stored using the nvstore command entered at the ok prompt ...

Page 54: ...Raptor OpenWindows for Solaris Installation and Reference Manual B 2 This page intentionally left blank ...

Page 55: ...color map with 2048 Tables entries and two auxiliary color maps with 256 entries each PCI Interface 33 66 MHz 32 64 bit Universal Signaling Video Interface Red Green Blue at RS 343 50 ohm Video Sync Separate sync at TTL levels 75 ohm Video Connector DB 5W5 Temperature 10 0 to 50 0 C operating Rating 10 0 to 70 0 C non operating Humidity Rating 5 to 90 non condensing Power Rating 5 5 Amps Dimension...

Page 56: ...Primary color map with 2048 Tables entries and two auxiliary color maps with 256 entries each PCI Interface 33 66 MHz 32 64 bit Universal Signaling Video Interface Red Green Blue at RS 343A 75 ohm Video Sync Separate or composite syncs at TTL levels 75 ohm Video Connector DB 13W3 Temperature 10 0 to 50 0 C operating Rating 10 0 to 70 0 C non operating Humidity Rating 5 to 90 non condensing Power R...

Page 57: ...r Lookup Primary color map with 2048 Tables entries and two auxiliary color maps with 256 entries each PCI Interface 33 66 MHz 32 64 bit Universal Signaling Video Connector One Low Force Helix 60 pin LFH60 connector all digital interface Temperature 10 0 to 50 0 C operating Rating 10 0 to 70 0 C non operating Humidity Rating 5 to 90 non condensing Power Rating 5V 5 Amps Dimensions 312mm x 107mm 12...

Page 58: ...g 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 PCI Interface 33 66 MHz 32 64 bit Universal Signaling Video Connector DVI Dual Link Temperature 10 0 to 50 0 C operating Rating 10 0 to 70 0 C non operating Humidity Rating 5 to 90 non condensing Power Rating 5V 5 Amps Dimensions 312mm x 107mm 12 28 x ...

Page 59: ...gement Hardware Cursor 3 color 64 x 64 bitmap Color Lookup Table s 1024 entries PCI Interface 33 MHz 32 bit Video Interface Red Green Blue at RS 343 50 ohms Video Sync Separate sync at TTL levels 75 ohms Video Connector DB 5W5 Temperature 10 0 to 50 0 C operating Rating 10 0 to 70 0 C non operating Humidity Rating 5 to 90 non condensi ng Power Rating 5V 4 Amps 12V 100mA Dimensions 312mm x 107mm 12...

Page 60: ...nagement Hardware Cursor 3 color 64 x 64 bitmap Color Lookup Table s 1024 entries PCI Interface 33 MHz 32 bit Video Interface Red Green Blue at RS 343 50 ohms Video Sync Separate sync at TTL levels 75 ohms Video Connector DB 5W5 Temperature 10 0 to 50 0 C operating Rating 10 0 to 70 0 C non operating Humidity Rating 5 to 90 non condensing Power Rating 5V 4 Amps 12V 100mA Dimensions 312mm x 107mm 1...

Page 61: ...gement Hardware Cursor 3 color 64 x 64 bitmap Color Lookup Table s 1024 entries PCI Interface 33 MHz 32 bit Video Interface Red Green Blue at RS 343 75 ohm Video Sync Composite or Separate Video Connector DB 13W3 Temperature 10 0 to 50 0 C operating Rating 10 0 to 70 0 C non operating Humidity Rating 5 to 90 non condensing Power Rating 5V 2 5 Amps Dimensions 312mm x 107mm 12 28 x 4 2 ...

Page 62: ...nt 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 each PCI Interface 33 MHz 32 bit Universal Video Connector Dual MDR 26 2 Temperature 10 0 to 50 0 C operating Rating 10 0 to 70 0 C non operating Humidity Rating 5 to 90 non condensing Power Rating 5V 5 Amps Dimensions 312mm x 107mm 12 28 x 4 2 ...

Page 63: ... created through the Multiple Overlay eXtension MOX D 2 Usage Usage usr openwin bin tsiwd geometry x y width height dev path ppm bmp filename The tsiwd utility saves the contents of an X window or other region to filename The utility has two basic modes of operation window capture and region capture To capture the contents of a particular window run tsiwd without the geometry argument The cursor w...

Page 64: ...ngular area to be captured However chosen the captured image is saved as a PNG file by default PNGs provide lossless compression 24 bit color and may be viewed with a variety of common imaging applications If PNG is not prefered then either BMP or PPM can be selected instead by including either of the switches bmp or ppm The dev option specifies the graphics device but is not needed with most vers...

Page 65: ...NOTES ...

Page 66: ...NOTES ...

Page 67: ...NOTES ...

Page 68: ...Publication 65 0228 01 ...

Reviews: