HP 7500 PCI Installation Manual

ATI RADEON 7500 PCI Graphics Controller Installation Guide First Edition Revision A Manufacturing Part Number: AB551- 96002 – Revision A April 2005 © Copyright 2004-2005 H ewlett-Packa r d Development Company, L.P.
Legal Notices Copyright Notices . © Copyright 2004-2005 Hewlett-Pa ck ard Development Company, L.P. The information c ontained herein is subject t o ch ange witho ut notice. The only warranties for HP products and services are set forth in the expre ss limited warranty statements accompanyin g such products and services. Nothing her ein should be co nstrued as constitut ing an additional warrant y. HP shall not be liable for t echnical or editorial errors or omissions contain ed herein. i
Contents 1 OVERVIEW ................................................................................................................ 1 Introduction ...................................................................................................................................................... 1 Module Description .......................................................................................................................................... 1 Connector Pinouts ............................................................................................................................................ 3 2 INSTALLATION ........................................................................................................ 5 Introduction ...................................................................................................................................................... 5 Unpacking ........................................................................................................................................................ 5 Installation Procedure ..................................................................................................................................... 5 3 HP OPENVMS I64 – GRAPHICS SOFTWARE INSTALLATION AND CUSTOMIZATION .......................................................................................................... 7 Video Resolutio ns Supported .......................................................................................................................... 7 Restrictions, Limitat ions and Defaults .......................................................................................................... 8 Minimum Console Revision ......................................................................................................................... 8 No VGA Console Supp ort ............................................................................................................................ 8 HP Integrity Platform Slot Restriction s ..................................................................................................... 8 Default Depth (24 Bits Per Pixel) ............................................................................................................... 8 Multiple Colormaps (8 B its Per Pixel) ........................................................................................................ 9 Single Pixel Depth (N o Mixed Depth Windo ws) ........................................................................................ 9 Visual Types ................................................................................................................................................. 9 PCI Bus Performance Under Load .............................................................................................................. 9 Open3D Support ........................................................................................................................................... 9 Transformation, Clipping and Lighting Support ..................................................................................... 10 Threads Restriction ............................................................................................................................... ..... 10 No Backing Store/Save U nder for 3D Windows ....................................................................................... 10 Multiple Graphics Cards Support ................................................................................................................ 10 Multi-Screen Versus XIN ERAMA ............................................................................................................. 10 Screen Order and Forcing Single Headed Operation .............................................................................. 11 Modifying the Graphi cs Configuration ......................................................................................................... 11 ATI RADEON 7500 Default Graphics Settings ....................................................................................... 11 Determining Curren t Settings .................................................................................................................. 11 Overriding the Default S ettings ................................................................................................................ 11 Server Startup and Configuration Messages ............................................................................................... 12 Troubleshooting ............................................................................................................................... .............. 13 4 HP-UX CONFIGURATION .................................................................................... 15 Verificati on of Software Instal lation ............................................................................................................ 15 Changing the Boot Consol e ........................................................................................................................... 16 Verification of Hardwar e Installation .......................................................................................................... 17 ATI RADEON 7500 as Default Xserver Device ........................................................................................... 17 Resolutions ............................................................................................................................... ...................... 18 Restrictions and Limitations ........................................................................................................................ 18 No Accelerated 3D Support ....................................................................................................................... 18 Minimum Console Revision ....................................................................................................................... 18 Multiple Colormaps ............................................................................................................................... ..... 18 ii
Contents ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide Default Visual Information ....................................................................................................................... 18 Configuring Graph ics Resolution or Vertic al Refresh Rate for HP-UX ..................................................... 19 Current Graphics Resolutio n .................................................................................................................... 19 How to Change th e Resolution and Re fresh Rate .................................................................................... 19 Multihead Supp ort ............................................................................................................................... .......... 20 Dual-screen ............................................................................................................................... .................. 20 XF86Config Changes ............................................................................................................................... .. 20 Messages ............................................................................................................................... ......................... 22 Troubleshooting ............................................................................................................................... .............. 22 FIGURES 1-1 ATI RADEON 7500 PCI Graphics Controller ........................................................................................ 2 TABLES 1-1 Option Numbers ....................................................................................................................................... 1 1-2 Standard 15-Pin VGA Connector Pinout ................................................................................................ 3 3-1 Supported Video Modes – OpenVMS ...................................................................................................... 7 3-2 Troubleshooting Criteri a ........................................................................................................................ 13 4-1 Standard Supported Video Modes – HP-UX ......................................................................................... 18 4-2 Troubleshooting Criteri a ........................................................................................................................ 22 iii
Preface This preface contains the foll owing sections: • Intended Audience • Document Structure • Notational Convent ions • Reader Comments and Feedbac k • Related Information • Printing History Intended Audience This manual is for managers and operators of HP AlphaServer systems with ATI RADEON 7500 PCI graphics controllers. Document Structure This manual has the following chapters. Chapter 1, Overview , provid es a brief overview o f the ATI RADEON 7500 PCI gra phics controllers. Chapter 2, Installation , describes t he installat ion of the A TI RADEON 75 00 PCI grap hics controller module in a supported HP product. Chapter 3, OpenVMS I64 - Graphics Soft ware Installatio n and Customization , provides information for installin g and modifying the softwar e required to support 2D (two-dimensi onal) and 3D graphics with the ATI RAD EON 7500 PCI graphics controll ers under the HP OpenVMS I64 operatin g system. Chapter 4, HP-UX - Gra phics Software Installa tion and Customizat ion , provides information for installing and modif ying the software re quired to support 2D (tw o-dimensional) gra phics with the ATI RADEON 7500 PCI graphics controllers under the HP-U X operating system. Notational Conventions The following notati onal conventi ons are used in this publicati on. CAUTION: A caution provides information required to avoid losing data or avoid lo sing system functionality. NOTE A note highlights useful information such as restrictions, recom mendations, or important details about HP product features. • Commands and options are represented using this font . • Text that you type exactly as shown is represented using this font . • Text to be replaced with text that you supply is represented using this font . iv
Preface ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide Example: “Enter the ls -l filename command” means you must replace filename with your own text. • Keyboard keys and graphical interface items (such as bu ttons, tabs, and menu items) are represented using this font . Examples: The Control key, the OK button, the General tab, the Options menu. • Menu —> Submenu represents a menu selection you can perform. Example: “Select the Partition —> Create Partition action” means you must select the Create Partition menu item from the Partition menu. • Example screen output is represented using this font . Reader Comments and Feedback HP welcomes your feedback on this publication. Please addr ess your comments to edit@presskit.rsn.hp.com and note that you will not receiv e an immediate reply. All comments are appreciated. Related Information Visit the HP Web site at www.hp.c om for service tools and more information abou t ATI RADEON 7500 PCI graphics controller. You can find other information on HP server hardware management, Mi crosoft® Windo ws®, and diagnostic support to ols in the following publica tions. Web Site for HP Technical Documentation: http://docs.hp.com The main Web site for HP technical d ocumentation is http://docs.hp.com , which has complete information available for free. Server Hardware Information: http://docs.hp.com/hpux/hw/ The http://docs.hp.com/hpux/hw/ Web site is the systems hardwa re portion of the docs.hp.com and provides HP nPartition server hardwar e ma nagement details, includin g site preparation, installation, and more. v
Preface ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide Diagnostics and Event Monitori ng: Hardware Support Tools Complete information a bout HP’s hardware support tool s, inclu ding online and offlin e diagnostics and event monitoring too ls, is at the http://docs.hp.com/hpux/diag/ Web site. This site has manuals, tutorials, FAQs, and ot her reference material. Web Site for HP Technical Support: http://us-support2.external.hp.com HP’s IT resource center Web site at http://us-support2.external.hp.com/ provides comprehensive support informat ion for IT pro fessionals o n a wide v ariety of to pics, including software, hardware, and networking. Books about HP-UX Published by Prentice Hall The http://www.hp.com/hpbooks/ Web site lists the HP books that Prentice Hall currently publishes, such as HP-UX books including: HP-UX 11i System Administration Handbook http://www.hp.com/hpbooks/prentice/ptr_0130600814.html HP-UX Virtual Partitions http://www.hp.com/hpbooks/prentice/ptr_0130352128.html HP books are available worldwide through booksto res, online booksell ers, and office and computer stores. Printing History The printing history b elow identifi es the edit ion dates of this manual. Updates are made to this publication on an unscheduled, as needed , basis. First Ed ition .................................................................................................................. ............... April 2005 vi
1 Overview Introduction This chapter provides a brie f overview of th e ATI RADEON 7500 PCI grap hics controller . Module Description The ATI RADEON 7500 PCI graphics controller/acc elerator module is a single expansion-slot 32 bit, 66/33 MHz Universal PCI option that provides 2D and 3D graphics accelerat ion for supported HP systems running HP OpenVMS I64 an d 2D for supported HP-UX systems The ATI RADEON 7500 graphic card is based on ATI’s RV2 00 graphics chip. Table 1-1 Option Numbers Option Description AB551A ATI RADEON 7500 PCI gra phics controller with 64 MB of DDR SDRAM memory. For current minimum operating sy stem and firmware revision inform ation supported for the ATI RADEON 7500 graphics controllers, refer to the system Quic kSpecs located at http://www.hp.com . Chapter 1 1
Overview ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide Figure 1-1 ATI RADEON 7500 P CI Graphics Controller S-VIDOUT R CRT 27300 DVI MR0494 2 1 5 4 3 X ATI RADEON 7500 PCI graphics controller Y DVI-I VGA connector ada ptor Z S-Video connect or [ DVI-I connector \ Standard 15-pin VGA connect or The ATI RADEON 7500 PCI graphics controller has a standar d 15-pin VGA connect or, a DVI-I connector and an S-Vid eo connector. The S- Video functionalit y is not supported b y either Open VMS or HP-UX. There is no VGA switch; VGA functions ar e automatically con figured through the consol e firmware and softwar e. DVI-I to VGA Connector Adapto r OpenVMS does not support direct DVI to DVI operation on the ATI RAD EON 7500 card. The DVI port is only useable by using a DVI to analog (VGA) ada pter or cable (this part was supplied on the AlphaServer version of the card, but is not supplied for HP Itani um). If a DVI to analog adapter or cable is used, OpenV MS drives both th e VG A and DVI int erface with the sam e image. HP-UX does support all v ideo connections, including direct D VI to DVI, DVI to analog (VGA) and VGA to VGA. 2 Chapter 1
Overview ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide Connector Pinouts Table 1-2 contains a listing of the pins and sign als found on the standard 15-pin VG A connector and the DVI-I to VGA adapt or (part number 209815-001 not included in kit). Table 1-2 Standard 15-Pin VGA Connector Pinout Pin No. Signal 1 RED VIDEO 2 GREEN VIDEO 3 BLUE VIDEO 4 No connector 5 GROUND 6 GROUND 7 GROUND 8 GROUND 9 5V SUPPLY 10 GROUND 11 No connector 12 BI-DIRECTIONAL DATA 13 HORIZONTAL SYNC or COMPOSITE SYNC 14 VERTICAL SYNC (VCLK) 15 DATA CLOCK Chapter 1 3
Overview ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide This Page Intentionally Left Blank 4 Chapter 1
2 Installation Introduction This chapter provides information on unpack ing the graphic controller and in stalling the ATI RADEON 7500 PCI graphics controller mo dule in a suppor ted HP product. Unpacking The graphics option hardware is packaged in a single carton that contains one graphic controller and one installati on guide. Qty Description Part Number 1 ATI RADEON Grap hics Control ler, 64MB PCI AB 551A 1 ATI RADEON Installation Guide AB551-96002 1 ESD strap kit A3024-80004 Installation Procedure CAUTION: Static electricity can damage sens itive electr onic components. When handling your graphics option, use an anti-stati c wrist strap that is connected to a grounded surface on yo ur computer system. NOTE : Before installing the m odule, check your monit or specification f or signal compatibilit y and supported features offered by th e ATI RADEON 7500 PCI graphics contr ollers. The following section describes how t o install the ATI RADEON 7500 PCI graphics contro ller. To install the module, perform the f ollowing steps: 1. Perform a normal power-down of your computer system and disconnect th e monitor cable. 2. Disconnect all AC power cables from the wall outlet (or turn off the circu it breakers if applica ble to your system) to remove power from the system. 3. Remove the cover from your compute r (refer to your system documentati on). 4. Put on an anti-static wrist strap. 5. If your computer has an existi ng graphics module, re move the screw that secures it an d then remove the module. 6. The slot to be select ed depends on the graphic controller you ar e about t o install. If your system had a previously installe d graphics op tion, you can use that expansion slot. Remove the slot cove r if you are using a new slot. Refe r to your system owner’s guid e for information abou t graphics option slots. Chapter 2 5
Installation ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide 7. Grasp the top edge of the graphics option, carefull y insert it into the slot, and seat it firmly. 8. Secure the module with the screw. 9. Replace the computer cover. 10. Ensure that the monit or cable is connected to th e video out put connector loc ated on the back of the graphics option. 11. Reconnect th e AC power cables to the wall outlet ( or turn on the circuit breakers if a pplicable to your system) to restor e power to the system. 12. Perform a normal power-up of your computer syst em. 13. If the system is an HP-UX system, you must switch the system console ov er to a serial con sole. See “Changing the Boot Conso le” on page 16. 6 Chapter 2
3 HP OpenVMS I64 – Graphics Software Installation and Customization This chapter provides informati on for installing and modifying t he software required to suppor t 2D and 3D graphics with the ATI RAD EON 7500 PCI graphics contr oller under the HP OpenVMS I64 operating system. The ATI RADEON 7500 PCI graphics controller is directly supported by OpenVMS I64 wi thout additional software. Bu g fixes and new feature supp ort are supplied using the standard OpenVMS downloadable patch support mech anism, and wi th new versions of the Op erating System. The behavior of th e ATI RADEON 7500 PCI graphi cs controller’s support sof tware may be modified after installation on Op enVMS by editi ng the appropriat e files and issuing DCL command s (see “Multiple Graphics Cards Support” on page 10). Video Resolutions Supporte d The ATI RADEON 7500 PCI graphics controller is capab le of supportin g the graphics resolutions, color depths, and refresh rates shown in Table 3-1: Table 3-1 Supported Video Modes – OpenVMS Resolution Color Depths (Bits per Pixel) Refresh Ra tes (Hertz) 640 x 480 8, 16, 24 60, 72, 75, 85 800 x 600 8, 16, 24 60, 72, 75, 85 1024 x 768 8, 16, 24 60, 70, 75, 85 1024 x 864 8, 16, 24 60, 70, 75, 85 1152 x 864 8, 16, 24 60 1280 x 1024 8, 16, 24 60, 72, 75, 85 1600 x 1200 8, 16, 24 60, 65, 75, 85 1792 x 1344 8, 16, 24 60, 75 1856 x 1392 8, 16, 24 60, 75 1920 x 1080 8, 16, 24 60, 75 1920 x 1200 8, 16, 24 60, 75 1920 x 1440 8, 16, 24 60, 75 2048 x 1536 8, 16, 24 60, 65, 70, 75 2048 x 2048 8, 16, 24 57 The video mode chosen should match your monitor’s c apabilities. In general, refresh rates below 70 Hz are discouraged on CRT monitors, as they tend to show flick er based on the lighting source and surrounding equipm ent. Flat Panel displa ys generally pr efer a 60Hz refresh rate. The available res olutions are mon itor dependen t. The default video mod e is 1024X768 @70HZ and 24 bits per pixel depth. Chapter 3 7
HP OpenVMS I64 – Graphics Software Installa tion & Customization ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide Restrictions, Limitations and Defaults This section of the document cont ains limitations, re strictions and d efaults fo r the ATI RADE ON 7500 hardware and softwar e. Minimum Console Revision The minimum console firmware v ersion for support of the ATI RADEON 7500 graphics c ontroller under OpenVMS I64 is system d ependent. Please consult yo ur platform option in formation for minimum requirements. No VGA Console Support The initial Open VMS I64 production r elease (V8.2) does n ot support the use of a gr aphics card (VGA mode) as a console terminal device. This is expect ed to be allowed in a subsequent release. A serial lin e console, or other Mana gement Processor attach ed device is require d. HP Integrity Platform Slot Restrictions The Version V8.2 release of OpenVMS supports thr ee HP Itanium platform typ es: The RX1600, RX2600 and RX4640 (along wit h speed and CPU variants ). The following are the known restrictions on populating slots with ATI RADEON 7500 cards: • RX1600 – Only one slot (the top slot) allows an ATI RADEON 7500 card, the bott om slot is mechanically obstructed. Do not attempt to force a card in to the lower slot. • RX2600 – No restrictions. Up to four ATI RAD EON 7500 cards may be placed in any of t he slots. • RX4640 – Up to 4 ATI RADEON 750 0 cards may be used, with restrictions on the use of slot s 3 and 4, and 5 and 6: o One card in slot 3 or 4, but not both o One card in slot 5 or 6, but not both o One card in slot 7 o One card in slot 8 If ATI RADEON 7500 cards are plugged in to slot 3 and 4, or 5 and 6, the following error message may be displayed during system startup, and the syst em will not function correctly: WARNING[2]: Insufficient re sourc es to assign one or more I/O devices Default Depth (24 Bits Per Pixel) OpenVMS has traditionally set the defau lt pixel depth to 8 bits per pixel on 2D gra phics options, and 24 bits per pixel on 3D options. With the expandin g use of applications such as MOZILLA and increased use of various types of images such as GIF and JPEG, the default depth for both 2D and 3D has been changed to 24 bits per pixel. NOTE : Many older applications may assume a specific d epth and visual type – in particular 8 bits per pixel and PsuedoColor. If your graphic s application or a utility dep ends upon the depth, you can either modify the a pplication, or c hange the default pixe l depth. For exam ple, the PAINT program which ships on DECwindows Mot if currently only support 8 bits per pixel. For instructions on changing th e pixel depth, see “Overrid ing the Default Settings” on page 11. 8 Chapter 3
HP OpenVMS I64 – Graphics Software Installa tion & Customization ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide Multiple Colormaps (8 Bits Per Pixel) Multiple colormaps are not supported by the hardwa re. The ATI RADEON 7500 PCI grap hics controllers support on ly one installed colormap at on e time. Exceedin g this limit in 8 bits per pixel depth, may cause colormap ‘flashin g’, also known as "Technicolor". Applications should not install or de-in stall colormaps themselve s. The window manager should perform these acti ons. However, the a pplication is responsib le for providing the window manager wit h hints as to which colormaps to insta ll or de-install. Single Pixel Depth (No Mixed Depth Windows) Some workstation 3D gra phics options in the past pr ovided the abil ity to mix windows of d ifferent pixel depths on the same screen. The ATI R ADEON 7500 board can only sup port a single pixel depth at a time. This means that all windows on a specific sc reen must all have the same pi xel depth (no mixed depth windows). Visual Types A visual type def ines how the X11 serv er interprets the conte nts of a pixel. While th e ATI RADEON 7500 hardware only sup ports a single pixel format at a time, the X11 server can emulat e various visual types depending on the pi xel depth. For example, when using 24 bits per pixel both Dir ectColor and TrueColor can be used, and at 8 bits pe r pixel all visual types are availa ble. The default visual types are: TrueColor for 16 and 24 bits per pixel, and Ps eudoColor for 8 bits per pixel. For information on changing the defau lt visual, see “Overriding the Defa ult Settings” on page 11. PCI Bus Performance Under Load Under heav y load - ty pically mixe d high outp ut 2D and 3D - the RADEON 75 00 may consume too much bus bandwidth, and has been observed to sometimes hang the gr aphics output. The DMA fetch siz e can be adjusted to use less bandwidth, at the cost of per formance (typically 3D pe rformance). To reduce the DMA fetch size, modify DECW$PR IVATE_SERVER_SETUP.C OM to include the line : $ DEFINE/SYSTEM DECW$RADEON_FAST_DMA 0 This can be set to the values 0-2, wher e 0 is the lowest DMA fetch size. The default on Itanium systems is fast (2). Open3D Support The ATI RADEON 7500 supports hardwar e accelerated 3D support when th e pixel depth is set to 24 bits per pixel. Hardware 3D drawing is not av ailable when using 8 or 16 bits per pixel. Previous versions of OpenVMS provided har dware a ccelerated 3D graphics an d an OpenGL compatible programming interface for selected option cards through the Open3D license. Starting with OpenVMS V8.2 on both Alpha and I64 systems, the Open3 D lic ense will no longer b e required for 3D op eration (for POWERSTORM 300 and 350, and ATI RADEON 7000 and 7500 graphics controllers). The license for use of 3D is include d as part of the base O perating System. The OpenVMS ATI RADEON 7500 graph ics support includes a Mesa 3D based graphic s library providing an OpenGL V1.2 compat ible programming interface, a nd GLX V1.2. Among other features, Chapter 3 9
HP OpenVMS I64 – Graphics Software Installa tion & Customization ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide the libraries provide support for the ATI RAD EON 7500 TCL hardware, hardwar e alpha and stencil planes, 3D multi-texturing, and 3D cu be map textures. The RADEON 7500 Mesa3D softwar e will, by default, force a di rect-rendere d 3D context whenever the 3D client requests connection to th e X11 server using the LOCAL transport. Direct rendering is a highly desirable per formance feature for 3D ap plications. You can override this default behavior and force the default to alway s be indirect renderin g (indirect rendering means tha t all 3D operation s are executed by th e X11 OpenGL server extension) by defining the following logical name before running the 3D application: $ DEFINE LIBGL_ALWAYS_INDIRECT 1 This can also be achieved by using the DECN ET or TCPIP transports. Hardware acceleration can be disabled entir ely by defining the system l ogical: $ DEFINE/SYSTEM/NOLOG DECW$SERVER_NOACCEL TRUE HP recommends that the direct rendering inter face be used for 3D operation. Transformation, Clipping and Lighting Support The Mesa3D driver for the RADEON 7500 conta ins su pport for the on-board transformati on, clipping, and lighting (TCL) hardw are of the RADEO N 7500 for increased primit ive rendering per formance. The embedded graphics typic ally found on HP Integr ity system s is based on the ATI RADEON 7000, and also provides 3D cap ability, but d oes not have TCL hardware capabilit y. Threads Restriction The RADEON 7500 Mesa3D librar y for OpenVMS is not thread safe. However, Mesa3D can be used in a multithreaded program if the use of Mesa3D is r est ricted to a single thread within the p rogram. No Backing Store/Save Under for 3D Windows Backing store and sa ve under features are not supported wh en 3D is in use. Multiple Graphics Cards Support The ATI RADEON 7500 softwar e has been tested for up t o 4 cards per system. All operat ions, including hardware accelerated 3D graphics, are support ed on every card in the system. Consult your Integrity system options documentation for de tailed inform ation on number of cards supported and configuration limitations. The embedded graphics availa ble on most HP Inte grity systems based on the ATI RADEON 7000 is compatible with multi-h ead operation with th e ATI RADEON 7500 option ca rd, and can be combined when using multi-head operation. Multi-Screen Versus XINERAMA By default, multiple screens are h andled as traditional X1 1 multiple screens. However, the screens can be handled as a single “virtual” screen using th e XI NERAMA extension. This is documented both in the DECW$PRIVATE_SERVER_ SETUP.COM procedure, and in the Motif docume ntation. NOTE : Only 2D operation is possible when usin g XINERAMA. 3D operation will not function correctly, or will use softwar e only (no acce leration). 10 Chapter 3
HP OpenVMS I64 – Graphics Software Installa tion & Customization ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide Screen Order and Forcing Single Headed Operation Screen order is determined by th e bus ordering of devices, and will vary across platforms. The DECW$PRIVATE_SERVER_ SETUP.COM file allows the user to override the o rdering of screens, or to force single head ed operation. Se e the documentati on in the file, and in the Mo tif documentation f or more information. For e xample, to force a specifi c graphics option to be used in single head mode (in this case GHB0), add the lin e: $ DEFINE/SYSTEM/NOLOG DECW$PRIMARY_DEVI CE “GHB0” Modifying the Graphi cs Configuration ATI RADEON 7500 Default Graphics Settings The default graphics reso lution is 1024 x 768. The de fault refresh rate is 70 Hz. The defa ult pixel depth is 24 bits per pixel and the defa u lt visual type is TrueColor. Determining Current Settings To find the current settin gs under OpenVMS, issue the following comman ds, in order, at the D CL prompt: $ @decw$utils:decw$define_utils $ xdpyinfo In addition, you can show the fo llowing logical names at the DCL prompt: $ SHOW LOGICAL/SYSTEM DECW$SERVER_PIXEL_DEPTH $ SHOW LOGICAL/SYSTEM DECW$SERVER_REFRESH_RATE $ SHOW LOGICAL/TABLE=DECW$SERVER* DECW$XSIZE_IN_PIXELS $ SHOW LOGICAL/TABLE=DECW$SERVER* DECW$YSIZE_IN_PIXELS $ SHOW LOGICAL/TAB=DECW$SERVER* DECW$SERVER_DEFAULT_VISUAL_CLASS If any logical name is not defined, then the respective default is in effect. You can also confirm the sett ings and any errors in the setu p by examinin g the server error log file: $ TYPE SYS$MANAGER:DECW$SERVER_0_ERROR.LOG Overriding the Default Settings The SYS$MANAGER:DECW$PRIVATE_S ERVER_SETUP.COM pr ocedure contains documentation for many of the defa ult X11 ser ver settings that may be changed. For more information on making changes to the defaul t settings, symbols, and system-w ide logical names, refe r to the manual titled Manag ing DECwindows Motif for OpenV MS Systems. An online version of this docum ent is available at: http://h71000.www7.hp.com/DOC/7 3final/6300/6300PRO.HTML A complete list of av ailable DECw indows Motif V1. 3-1 documentati on is available at: http://h71000.www7.hp.com/DOC/decwin131.html For newer releases of docume ntation, check the main HP OpenVMS Systems Documentation site at: http://h71000.www7.hp.com/doc/index.html OpenVMS Alpha and I64 use the same implementation of X11 and Motif and documentation for one generall y applies to the ot her, unless otherwise not ed. Chapter 3 11
HP OpenVMS I64 – Graphics Software Installa tion & Customization ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide To override the default se ttings, follow these st eps: 1. Copy or re name the SYS$M ANAGER:DECW$PRIVATE_SERVER_ SETUP.TEMPLATE file to create a new command (.com) file ca lled DECW$PRIVATE_SERVER_ SETUP.COM. 2. Now make the edits for the settings you want to change usin g a text editor, and save the file. 3. For the changes to take effect i mmediately you must restart the X server so that the n ew command file and changed settings will b e used. The command to do this is as fo llows: $ @SYS$MANAGER:DECW$STARTUP RESTART The new file settings will now override the or iginal default sett ings. NOTE : By renaming this template file to .COM you will enable multi-head operation. Many HP Integrity servers pr ovide an embedded graph ics option (currently base d on the ATI RADEON 7000). The order of the screens is based on the bu s order of th e options, and will vary based on platform. See “Restrictions, Limitations an d Defaults” on page 8 for in formation and restrictions on configuring mu ltiple heads. See “Screen Order an d Forcing Single Headed Operation” on page 11 for information on ho w to force single hea ded operatio n. Additional system l ogical names are described in SYS$MANAGER:DECW$DEVICE_CONFIG_GH.COM However, this file should not be modified. If you wish to make changes to the default logical names, redefine them i n the DECW$PRIVATE_SER VER_SETU P.COM file . These changes will supersede the values assigned in the device conf iguration file. Many common items are changed by symbolic valu es in this file, however item s are graphics card specific, and are modifi ed by defining system log ical names. The settings incl ude the following it ems: DECW$XSIZE_IN_PIXELS DECW$YSIZE_IN_PIXELS DECW$SERVER_REFRESH_RATE DECW$SERVER_PIXEL_DEPTH For example, to change the default set tings from 1024x768, 24 bits per pixel and 70Hz to 1 280x1024, 8 bits per pixel and 60Hz: $ DEFINE/SYSTEM/EXEC/NOLOG DECW$XSIZE_IN_PIXELS 1280 $ DEFINE/SYSTEM/EXEC/NOLOG DECW$YSIZE_IN_PIXELS 1024 $ DEFINE/SYSTEM/EXEC/NOLOG DECW$SERVER_PIXEL_DEPTH 8 $ DEFINE/SYSTEM/EXEC/NOLOG DECW$SERVER_REFRESH_RATE 60 Note that all of these log ical names can also be spec ified as a comma separat ed list of values. A single value will be applied to all screens. If a list of va lues is provid ed they are applied to the individ ual screens in order starting at screen 0. Note that the visual class automatically defau lts to PseudoColor at the 8 depth, which is generally what most users want. To change the visu al type to TrueColor for example, add: $ DECW$SERVER_DEFAULT_VISUAL_CLASS == 4 Server Startup and Configuration Messages Server messages are typi cally logged to the DECW$ SERVER_0_ERROR.LOG file located i n the SYS$MANAGER directory. When having problems during se tting up the X11 serv er defaults, or when a problem is encounter ed during normal use, be sure to check this fi le first for messages. 12 Chapter 3
HP OpenVMS I64 – Graphics Software Installa tion & Customization ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide More extensive l ogging of serv er events can be en abled by modi fying the DECW$PRIVATE_SERVER_SE TUP.COM DCL procedure and setting: $ DECW$SERVER_AUDIT_LEVEL == “n” Where n is a value between 0 and 4 (with 0 being none, and 4 being high). Troubleshooting Table 3-2 Troubleshooting Criteria Problem Description Solution Cannot boot using VGA console The EFI console displays and takes input by default from all connected console devices. However, OpenVMS only supports use of serial cons oles (or a network console using the server management opt ion. Connect a serial console, or s etup a network console. X11/Motif does not start on the graphics display, and th e screen remains blank. After booting OpenVMS, no DECW$SERVER process is seen. Did you install Motif when OpenVMS was instal led? Check the console log for incorrect SYSGEN parameters or quotas. Is a Keyboard and Mouse connected? Both must be connected when X11 /Motif is started. Messages will be displayed on the console for 15 seconds waiting for the devices . This can sometimes b e caused by KVM switches. Look at the contents of: SYS$MANAGER:DECW$SERVER_0_ ERROR.LOG for possible error messages. No Motif login box is displayed After booting OpenVMS, DECW$SERVER is running, but there is no login box Check for a valid Motif license using the command LICENSE LIST Check the console log for incorrect SYSGEN parameters or quotas. Some 2D applications do not run Application errors with Bad Window, or colormap errors Your application may be expecting an 8-bit PseudoColor default. The ATI RADEON 7500 defaults to 24-bit TrueColor. Either change the setting (see earlier chapters) or fix the application. OpenGL applications do not work 3D applications fail to run 3D requires 24-bit TrueColor mode to be set. Blank or corrupt screen di splay The DECW$SERVER_0 process is running, as is DTGREET, but the screen is bla nk or corrupt. Is the screen saver a ctive? Press a KB key or move the mouse. Is the monitor connected to t he VGA output on the ATI RADEON 7500? Does the monitor support the Chapter 3 13
HP OpenVMS I64 – Graphics Software Installa tion & Customization ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide Problem Description Solution resolution and refresh rate being used? Some monitors may need to be manually adjusted usi ng their front panel controls. Are you connected to th e ATI RADEON 7500 or to the embedded graphics option? Visual noise or anomalies on the screen Flashes of dots, or other random artifacts on the screen At high resolutions and refre sh rates, this type of problem can arise. Use only high quality cable s and connectors. Re-orient the monitor which may be seeing RF interference. Lower the refresh rate, or t he resolution. 14 Chapter 3
4 HP-UX Configuration This chapter describes how to configur e the ATI RADEON 7500 graphics controller in a system running the HP-UX operating system. NOTE : Chapter 4 pertains t o the HP-UX oper ating system onl y; if you are running the OpenVMS operating system, see C hapter 3 The examples in this manual show version num bers applicab le at publication. To determine the most recent version of the operating system or video driv er, refer to the Rel ease Notes on the CD-ROM or on th e Web at www.hp.com. Verification of Software Installation To use the ATI RADEON 7500 gr aphics controller, you must have installed t he Xserver fileset with a patch version of PHSS_31252 or later. To check the patch vers ion, run the following command: swlist –l patch | grep Xserver cumulative patch The output will look similar to this output: # PHSS_31252 B.11.23.12 Xserver cumulative patch The patch version will have a format of PHSS_???? ? , where ????? is the patch number. If this version is equal or greater than PHSS_31 252, the system is ready to use the ATI RAD EON 7500. If the patch version is less than PHSS_31 252, install the latest Xser ver patch. 1. Log into the HP patch catalog. The URL is www2.itrc.hp.com/service/patch/ mainPage.do 2. Go to the find a specific patch search, e nter PHSS_31252 and press Enter . This brings up a new screen. If there is a newer patch that supers edes this patch, it will be listed under the Most Recent headi ng. You will need to d ownload th e newest patch. 3. Click in the box next to the patch and click the add to selected patch list button. This brings up a new screen that displays the patch along wit h any other dependent patches. 4. Click the download select ed button. This brings up a new screen. 5. Choose the server to use and th e format of the patc h bundle. Once thes e options are chos en, click the download button. 6. This downloads the patch bundle to your system . Save the patch bundle to a convenient place on your system. For this example , we will a ssume the patch bundle is downloaded into the /tmp/PHSS_31252 directo ry. 7. Once the patch bundle is downloaded, unzip/g unzip/tar the pa tch bundle depe nding on the format of the patch bundle. This extra cts the patch bundle. Each bundle is a shar file. To create a depot for loading, run t he create_de pot_hp-ux_ 11 script as root. This creates a bundle in /tmp/PHSS_31252/depot. 8. As root, run the swinstall command using the newly created bundle. swinstall –s /tmp/PHSS_31252/depot Chapter 4 15
HP-UX Configuration ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide Changing the Boot Console When an ATI RADEON 7500 is installed in the sys tem, the only supported console is the serial console. Use the following instruc tions to switch the cons ole to the serial devic e. NOTE: Before switching the consol e over to the ser ial console, make s ure the seria l port is connected to the serial port of anoth er system (or to a dedi cated serial terminal) or you will not be able to see any of the cons ole output. 1. Reboot the system 2. While the EFI boot loader is still running , the f ollowing menu displ ays: EFI Boot Manager ver 1.10 [14.61] Firmware ver 2.31 [4 411] Please select a boot option HP-UX Primary Boot: 0/1/1/0.0.0 EFI Shell [Built-in] boot lan Boot Option Maintenance Menu System Configuration Menu 3. Using the arrow keys, choose Boot Option Maintenance Menu , and press Enter . The following me nu displays: Boot from a File Add a Boot Option Delete Boot Option(s) Change Boot Order Manage NextBo ot setting Set Auto Boot TimeOut Select Active Console Output Devices Select Active Console Input Devices Select Active Standard Error Devices Cold Reset Exit 4. Choose Select Active Console Output Devices , and press Enter . This brings up a new menu of possible device s. The current device(s) are marked with a *. The option you w ill choose is as follows: Acpi(PNP0501,0)/Uart(9600, N81)/VenMsg(PcAnsi) Choose this opti on press Enter . There is a * next to this opti on. If there is not a * , press Enter again. Deselect any other entry that has a * next to it (do not desele ct the Acpi(PNP0501,0)/Uart(9600, N81)/VenMsg(PcAnsi) entry. When ther e is only one entr y marked with a * , save the device to NVRAM by choosing Save Settings to NVRAM and pressing Enter . Choose Exit and press Enter to go back to the previous menu. 5. Repeat step 5, but choose Select Active Standard Error Devices . 6. After leaving the standard erro r devic es menu, you will be ba ck in the menu from step 4. Choose Cold Reset . This resets the system and sends the consol e output to the serial co nsole. 16 Chapter 4
HP-UX Configuration ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide Verification of Hardware Installation After the ATI RADEON 7500 gr aphics controller has be en installed an d the system has rebooted, verify the graphics card was correctly inst alled and identi fy wh ich device file co rresponds to which card. 1. Run the command ioscan –fun –C graphics Output similar to the following should appear. There should be one line for ever y graphics device in the system. Each device should have gvid_core for a driver and the S/W State should be CLAIMED . Class I H/W Path Driver S/ W State H/W Type Description graphics 0 0/3/1/0 gvid_core CLAIM ED INTERACE PCI Display (10025157) graphics 1 0/6/2/0 gvid_core CLAIMED INTERACE PCI Display (10025159) 2. Display the contents of /dev/gvid_in fo by running the comman d cat /dev/gvid_info Output similar to the following should appear. Ther e should be one line (i.e. one devic e file) for every graphics dev ice in the system. /dev/gvid0 /dev/gvid1 3. Determine the association of physica l graphics cards to spec ial device files (/de v/gvid?) by running the command Setmon –N / dev / gvid0 The output should l ook something like Device / dev / gvid0 is a ATI Radeon 7000 Ii the device is the Manageabilit y card or Device / dev / gvid0 is a ATI Radeon 7500 QW if the device is the ATI RAD EON 7500 graphics card. ATI RADEON 7500 as Default Xserver Device The program sam can be used to make the ATI R ADEON 7500 graphics con troller the default Xs erver device. This is for a single -screen Xserver c onfiguration. For a multihead Xs erver configurati on, see “Multihead Support” on page 20. 1. Log in as root 2. Run /usr/sbin/sam . Choose Display->Xserver Con figuration . All graphics cards in the sys tem are listed. Choose the gr aphics device that is the c urrent Xserver devic e. This device may or may not be the ATI RADEON 7500. From the pu ll-down menu, select Actions->Remove Scre en from Configuration . Choose the new de vice you would lik e to be the defa ult Xserver device. The new device should b e one of the ATI RAD EON 7500 device entr ies. From the pull-down m enu, choose Actions->Add Screen to Configuration . 3. Restart the Xserver. Chapter 4 17
HP-UX Configuration ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide Resolutions ATI RADEON 7500 graphics controllers can support va rious gr aphics resolutions and refresh rates as shown in Table 4-1. In addition to these standard resolutions and refresh rate s, the ATI RADE ON 7500 graphics controller will also supp ort any resolution s an d refresh rates that are supp orted by the specific monitor that it is connect ed to the ATI RADEON 7 500 card. Table 4-1 Standard Supported Video Modes – HP-UX Resolution Color Depths (Bits per Pixel) Refresh Ra tes 1024x768 8, 24 60, 70, 75, 85 Hz 1280x1024 8, 24 60, 75, 85 Hz 1600x1200 8, 24 60, 65, 75, 85 Hz 1920x1200 8, 24 60, 75 Hz Restrictions and Limitations This section provides information on the limi tation s and restrictions of the ATI RADEO N 7500 hardware and softwar e. No Accelerated 3D Support The ATI RADEON 7500 graphics controller does n o t support accelerated 3D (e.g. Op enGL). Minimum Console Revision The minimum firmware version for ATI RADEON 7500 graph ics controller single head s upport is V1.0 on HP Itanium Integrity systems. Multiple Colormaps Multiple colormaps are not supported. The ATI RADEON 7500 graphics controllers supp ort only one installed colormap at one time. Exceeding this lim it will cause colormap fl ashing, also known as "Technicolor". Applications should not install or de-in stall colormaps themselve s. The window manager should perform these acti ons. However, the a pplication is responsib le for providing the window manager wit h hints as to which colormaps to insta ll or de-install. You provide this in formation using th e Xlib function XSetWMColormapWindows() . This function sets the WM_COLORMAP_WINDOWS property for a given window. Default Visual Information The ATI RADEON 7500 graph ics controller can only support one visual type at on e time. Supported default visual types are 8-bit PseudoColor and 24-bit TrueColor. The defa ult depth and visual class is 24-bit TrueColor. To change the d efault visual, you must edit the Xs erver's configuration file which is located at /etc/X11/XF86Config. The depth is set in the Screen secti on of the Xf86 configurat ion file. There als o needs to be a Display subsection with the corre ct depth. For example, th e following lines will select a 24-bit default d epth visual: 18 Chapter 4
HP-UX Configuration ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide Section “Screen” Identifier “Screen 0” DefaultDepth 24 […] SubSection “Display” Depth 24 […] EndSubSection SubSection “Display” Depth 8 […] EndSubSection EndSection The following lines will select an 8-bit default depth visual: Section “Screen” Identifier “Screen 0” DefaultD epth 8 […] SubSection “Display” Depth 24 […] EndSubSection SubSection “Display” Depth 8 […] EndSubSection EndSection Restart the Xserver a fter editin g the Xserver conf iguration file for th e new default dep th to take affect. Configuring Graphics Resolution or Vertical Refresh Rate for HP- UX Use the sam program to modify th e graphics resoluti on or refresh rate. Current Graphics Resolution The default graphics reso lution and refresh ra te are 1280x1024 at 75Hz. The current gra phics resolution and refresh rate of a running syst em can be obtained by exec uting the command /opt/graphics/common/bin/setmon –p . How to Change the Resolution and Refresh Rate 1. Log in to the system as root . 2. Run /usr/sbin/sam . Choose Display-> Monitor Configu ration . All graphics cards in the system are listed. Choose the graphic s device that is to be updated. From the pull-down menu, choose Actions- >Modify Monitor Type . A new menu appears that contains all of t he possible resolutions and refr esh rates. Choose the ne w setting and press OK . The selected values wil l be the new resoluti on and refresh rate for the Xserver. NOTE: See Table 4-1 for supported re s olutions and refresh rates. 3. Restart the Xserver. Chapter 4 19
HP-UX Configuration ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide Multihead Support Multihead support is pro vided through chang es to the Xserver’s configuration file wh ich is located at /etc/X11/XF86Config. In orde r to do this correctly, yo u will need to know wh ich device files to use. See “Verification of Hardware Installation” on page 17 fo r details on how to determ ine which device files to use. Dual-screen By default, an ATI RADEON 7500 appears as a single screen de vice. You can configur e your system so two screens are created with the signal of the first screen (:0.0) comin g out the VGA port and th e signal of the second screen (:0. 1) coming out the DVI-I p ort. Configurin g your system for two screens on th e single ATI RADEON 75 00 board is referred to as dual-screen mode. XF86Config Changes There are three secti ons in the conf iguration file you need to change: 1. ServerLayout section. The ServerLayout section contains references to the S creen: sections. 2. Screen sections. The Screen sections in turn contain references to the Device sections. 3. Device se ctions. For this example, we will assume there are two ATI RADEON 7 500 graphics controllers in the system. These graphics cards have the d evice files /dev/gvid0 and /dev/gvid1 . We will change the XF86Config file to allow for a three-scree ned multihead system. The first graphics card (e.g. /dev/gvid0) is dual- screened and the sec ond graphics card is single-screen ed. The lowest level is the Devic e section. This maps a physical devi ce to a device identi fier. The three Device sections for this example are as follows: Section “Device” Identifier “ATI Radeon 7500 QW(0) Connector 1” DeviceFile “/dev/gvid0” EndSection Section “Device” Identifier “ATI Radeon 7500 QW(0) Connector 2” DeviceFile “/dev/gvid0” Screen 1 EndSection Section “Device” Identifier “ATI Radeon 7500 QW(1) Connector 1” DeviceFile “/dev/gvid1” EndSection The first device, ATI Radeo n 7500 QW(0) Connec ter 1 is the first screen on the first d evice. The seco nd device, ATI Radeon 7500 QW(0 ) Connecter 2 is the seco nd screen on the first device. Note that it has the Screen 1 field, which s elects the second vid eo output on the graphics car d. If this field is omitt ed, it is assumed the device is using th e first video output on the graphics card. The thir d device, ATI Radeon 7500 QW(1) Connecter 1 is the first screen on th e second device. Once the Device sect ions are defined, you can defi ne the Screen section, wh ich maps a screen to a physical device. The Screen sections use the Identifi er field that was defin ed for each of the Devic e sections. The three Scre en sections for this example are as follows: 20 Chapter 4
HP-UX Configuration ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide Section Screen Identifier “Screen 0-1” Device “ATI Radeon 7500 QW(0) Connector 1” Monitor “Monitor 0” # Include other Screen info here, including other S ubSections EndSection Section Screen Identifier “Screen 0-2” Device “ATI Radeon 7500 QW(0) Connector 2 Monitor “Monitor 0” # Include other Screen info here, including other S ubSections EndSection Section Screen Identifier “Screen 1-1” Device “ATI Radeon 7500 QW(1) Connector 1” Monitor “Monitor 0” # Include other Screen info here, including other S ubSections EndSection The first Screen section maps the screen Screen 0-1 to the physical de vice ATI Radeon 7500 QW(0) Connector 1 . The second Screen section maps the screen Screen 0-2 to th e physi cal dev ice ATI Radeon 7500 QW(0) Connector 2 . The third Screen section maps the screen Screen 1-1 to the physical d evice ATI Radeon 7500 QW(1) Connector 1 . Once you have the Screen sections set up, you can set up the Server Layout section. The ServerLayout section uses the Identifie r field that was defin ed for each of the Screen sections. The ServerLayout section describes all of th e screens used by the Xserver. The S erverLayout section for th is example is a s follows: Section ServerLayout Identifier “Main Layout” Screen 0 “Screen 0-1” 0 0 Screen 1 “Screen 0-2” RightOf “Screen 0-1” Screen 2 “Screen 1-1” RightOf “Screen 0-2” InputDevice “Mouse0” “CorePointer” InputDevice “Keyboard0” “CoreKeyboard” EndSection This ServerLayout has three scr eens associated with it. These screens are accessed throu gh the 0.0, 0.1 and 0.2 displays. The first screen is associated with the Screen 0-1 Section and is the anchor screen (at location 0, 0). The second screen is associated with the Screen 0-2 Section an d its screen coordinates are to the right of the first screen. The third screen is associated with the Screen 1-1 Section and its screen coordinates are to th e right of the sec ond screen. This example shows how to build up a ServerLa yout th at uses a specific Screen which in t urn uses a specific physical de vice. Chapter 4 21
HP-UX Configuration ATI RADEON 7500 PCI Graphics Co ntroller Installation Guide Messages Xserver messages are ty pically logged to /var/X11/Xserver/logs. The two files that conta in the messages are: /var/X11/Xserver/logs/Xf86.*.log /var/X11/Xserver/logs/Xstartup. *.log Where * is the display instance of the Xserver, wh ich is usually 0. The Xstartup.*.log file c ontains messages from the X loader. The Xf86. *.log file cont ains messages from the Xf86 Xs erver. The Xf86.*.log file is the fi le that should be checked first, should problems aris e. Troubleshooting Table 4-2 Troubleshooting Criteria Problem Description Solution Can not boot using VGA console. The EFI console has the ability to display output to a ny of the VGA devices. Console out put is only supported on the serial console for systems with ATI Radeon 7500 cards installed. Connect a serial console and choose the serial console device as the Console Output at the EFI level. CDE does not start on the graphics display. After booting CDE does not come up on the ATI Rad eon 7500 display. Is a keyboard and mouse attached? The Xserv er will not start unless a mouse and keyboard are attached. Is the Xserver configur ed with the correct /dev/g vid devices? OpenGL applications do not work. 3D applications fail t o run or run very slowly. Accelerated 3D is not supported on the ATI Radeon 7500 graphics card. Some 3D applications may run through emulation mode at greatly reduced performance. Blank or corrupt screen. The dtlogin process is running but the monitor is blank or corrupted. Is the monitor connected to the correct display connection on the ATI Radeon 7500 gra phics card? Does the monitor support the resolution and refresh rate that the Xserver is running at? Visual noise is pres ent on the monitor. Flashes, dots, or other ran dom artifacts are present on t he monitor. At high resolutions and refresh rates this type of problem can occur on some monitors. Use only the cabl es provided with the monitors. Lower the refresh rate an d/or resolution. 22 Chapter 4