Software Installation Guide For HP-UX 9.03, 9.05, 9.07,and 10.10 CD-ROM Release 1.0
Part No. 917-050569, Rev. A
Welcome!Congratulations on your purchase of one of Parallax Graphics premier workstation video cards. Please check the Release Notes for important updates, install your video card (see your Hardware Installation Guide), then use this guide to lead you through the software installation process. © Copyright Parallax Graphics, Inc. 1996.All rights reserved. Printed in the USA. Parallax Graphics, Inc., 2500 Walsh Street, Santa Clara, CA 95051 USA, Phone 408-727-2220, Fax 408-727-2367, World Wide Web: http://www.parallax.com, E-mail: email@example.com No part of this manual or the accompanying software may be reproduced or transmitted in any form or by any means--electronic or mechanical, including photocopying and recording--without the prior written permission of Parallax Graphics, Inc. VideoStream, XVideo, XVideo Xtra,PowerVideo, MultiVideo, Video Development Environment, Software Essentials, MovieTool, VideoTool, and Parallax Graphics are trademarks or registered trademarks of Parallax Graphics, Inc. All other trademarks or servicemarks are owned by their respective holders.
Table of ContentsBefore You Install Required Hardware, Software, et Cetera Removing A Previous Version of Parallax Software Installation Installing the Software Calibrating the Digital Video Image Installing from a Remote CD-ROM Troubleshooting
What's on This CD
No figure available.
10. The Update_Filesets_Main_Menu screen appears. Use the arrow keys or space bar to move the selection bar to Select_All_Filesets_on_the_Source_Media. Press the Return key.
11. The Select_All_Filesets_on_the_Source_Media screen appears. The Start_Loading_Now option is highlighted. Press the Return key to start loading software.
12. A warning box appears. Press "n" to continue installation.
NOTE: If you press "y", a screen appears that provides more information about the software installation. 13. Another warning box appears. This is your last chance to discontinue the software installation. Press "y" to continue.
14. The Loading_Partitions_and_Filesets screen appears. Wait a few minutes for the software installation to complete. The system will automatically rebuild the kernel and reboot the system.
NOTE: If the kernel build fails, follow the steps for rebuilding the kernel in Troubleshooting.
Before you can use video, you need to set up your environment so it will run Parallax Graphics server extension and driver modules. The best place to set this environment is in your .cshrc or .profile file.
Shown here arerecommended sample lines for users of the C Shell, Bourne Shell, and Korn Shell. "/opt/parallax" is the location of the Parallax software.
C Shell users:
1. Log in and move to your home directory. Use your preferred editor to add the following to the end of your .cshrc file:
setenv PARALLAX_HOME /opt/parallax
set path=($PARALLAX_HOME/bin $path)
2. When you are finished, source the newly compiled changes to reset your environment:
% source .cshrc
Bourne Shell and Korn Shell users:
1. Log in and move to your home directory. Use your preferred editor to add the following to the end of your .profile file:
export PARALLAX_HOME PATH
2. When you are finished, source the newly compiled changes to reset your environment:
% . ./.profile
# eisa_config This program will list the eisa slots (0, 1, 2, etc.) and the eisa cards that are installed in your system. Check that all the Parallax Graphics video cards that you have installed appear on this listing (they will appear as ``!PLX0001''). Note which slot numbers have video cards in them.
If any video card is not listed, you need to add it with the command, EISA: add !PLX0001 <slot number>
NOTE: The slot numbers with video cards are listed by eisa_config above. eisa_config also refers to slot numbers as "board numbers." 2. Set up the memory space and interrupt levels. In eisa_config, type the command below. You will get a listing that looks like the one following.
# EISA: show board <slot number> XVideo Overlay CFG file: !PLX0001 Slot 2 Manufacturer ................. Parallax ID ........................... PLX0001 Board type ................... OTH (Other) Board slot type .............. EISA Readable ID .................. Yes Skirt ........................ No Length ....................... 213 millimeters Current Required ............. 3100 milliamps Function names and possible choices: F1: Parallax Memory Space Select CH1: Video Memory Space 01000000h [** current **] CH2: Video Memory Space 01800000h CH3: Video Memory Space 02000000h CH4: Video Memory Space 02800000h F2: Interrupt Level Select CH1: IRQ Select 5 [** current **] CH2: IRQ Select 9 CH3: IRQ Select 10 CH4: IRQ Select 15 3. Check that the Parallax Memory Space Select matches the Interrupt Level Select (they should both have the same choice number: CH#). For example, the above listing is correct, because both of these are using CH3.
4. Repeat steps 2. and 3. for each of the video cards. In addition to checking that the CH#s are consistent for each individual card, you also need to check that no two cards are using the same memory space and interrupt levels (if one card uses CH1, another card can't use CH1 but must use CH2, CH3, or CH4 instead).
5. If you detect any problems in steps 3. and 4. above, you should remove all the video cards from the eisa_config list and then add them again (in ascending numerical order of slot numbers) as in this example (the video cards are in slots 2, 3, and 4):
EISA: remove 2 EISA: remove 3 EISA: remove 4 EISA: add !PLX0001 2 EISA: add !PLX0001 3 EISA: add !PLX0001 4 Repeat steps 1. through 3. to verify that the video cards are allocated the right memory space and interrupt levels.
6. When you are done modifying the configuration, type:
EISA: save 7. Exit the eisa_config program:
Check to see that the device nodes are set up. Type:
You should get a listing that looks similar to this:
This is set up for a one, two, or three video card system, and you do not need to change it. For example, if you are setting up a 2-card system, you will only need "/dev/plxv0" and "/dev/plxv2", but the unused node "/dev/plxv4" will not be active, so you can ignore it.
If you have accidentally deleted a node and need to re-create it or you need additional nodes, follow this example. This example creates a node called "/dev/plxv2" for Parallax version 9.x:
You need to modify xvconfig to take care of these needs.
Open the "/etc/xvconfig" file. When you open it, it should look like this:
As shown above, xvconfig is set up to run one video card.
To use two video cards, you need to un-comment the second line. To use three video cards, you need to un-comment the second and third lines.
Calibration involves adjusting the horizontal and vertical alignment of the Parallax Graphics video overlay card (magenta grid) with the host framebuffer card (green grid). You have achieved proper alignment when the magenta and green grids overlay each other, producing a single white grid. Calibration must be done for both standard (Zoom 1x) video display and Zoom 2x video display.
If you have more than one video card in your system, you must calibrate each one separately.
For multiple video cards in one system: Edit the "/etc/xvconfig" file so all lines are commented out except the line ending in ".../plxv2" for a two-video-card system or ".../plxv4" for a three-card system (the last board must be calibrated first). Re-start the window server.
Before you start Calibrate, you must be in the window server. If needed, start the window server.
Start the Calibrate program with the following command:
The Calibrate window appears.
View the Default_Settings scroll menu. Select your display resolution and frequency. Click OK to apply the default settings for your choice.
No figure available.
If you see any magenta or green grid lines in your Calibrate window, you need to move the magenta (video overlay) grid onto the green (framebuffer) grid until all the grid lines are on top of each other and look white. If your grid is already 100% white, go to step 8.
Correct the vertical alignment by using the <up/down arrow> keys to move the magenta grid onto the green grid, until the horizontal lines are white.
Correct the horizontal alignment of the vertical grid line closest to the right edge of your display (move the farthest right magenta line onto the farthest right green line) by using the <left/right arrow> keys for large adjustments, and then <shift><left/right arrow> for fine adjustments, until the farthest right vertical grid line is white.
Correct the horizontal size of the magenta grid by using the <s> and <shift><s> keys to align the farthest left magenta line onto the farthest left green line. <s> moves the magenta line to the left, and <shift><s> moves the magenta line right. When you are fin-ished with this step, all of the grid lines should be lined up and white.
So you won't need to re-calibrate every time you log in, pull down the File menu and select "Save" to save the Calibration settings.
Pull down the Zoom menu (in the upper left corner of the Calibrate window) and choose Zoom_2.
Use the arrow keys to align the two grids (repeat step 7 for Zoom_2).
Pull down the File menu and select Save to save the Calibration settings for Zoom_2.
Pull down the File menu again and select Exit to exit Calibrate.
For multiple cards in one system: Change directories to "/opt/parallax/etc" and rename ("mv") the file "plxv0" to either "plxv2" if you just calibrated the second card, or "plxv4" if you calibrated the third card. If you just calibrated the first card, do not rename the file.
For multiple cards in one system: If you have not calibrated all of the video cards yet, edit the "/etc/xvconfig" file, comment out the line for the video card you just calibrated, and uncomment the line before it. Re-start the server. Repeat steps 3 through 14.
If you have already calibrated all the video cards, edit the "/etc/xvconfig" file and uncomment the lines for each video card (".../plxv0" and ".../plxv2" for two cards, plus ".../plxv4" for three cards).
Restart the server. Congratulations! You are now ready to use video.
On the system with the CD-ROM drive (the "server"), add and export the CD-ROM file system to the system with the video card (the "client").
On the "client" system with the video card, mount the exported CD-ROM file system, and install the software:
World Wide Web: http://www.parallax.com/support/
Parallax Graphics Technical Support, Herndon, Virginia
Phone: 703-450-7718, Fax: 703-450-7719
Exit the shell by typing "y"
Change the directory by typing the command "# cd /etc/conf "
Use the text editor of your choice to open the file called "dfile".
Below the last line of text in the file, add the line "plxv"
Save dfile and exit the text editor.
Exit the shell by typing the command "# exit"
A message box appears asking if you wish to proceed with the update and
build a new kernel.
Continue with the update by typing "y"
The Loading_Partitions_and_Filesets screen appears. If the software installation continues to fail or the system does not reboot, check that the Parallax board is installed correctly. Call Parallax Graphics technical support for assistance.
In the "/opt/parallax/diag" directory, there is a program called "why_no_xv". Its output will provide information such as your system configuration, and if you had problems with installation, useful information about what may be in error.
Launch Calibrate with the command, "Calibrate -hv". This will allow the following additional measures to align the grids:
Calibrate Step 7-a:
If the magenta grid is rolling or jittering vertically, use the <v> and <shift><v> keys to stabilize it. <v> adds 5 pixels vertically; <shift><v> removes 5 pixels. Once you get the magenta grid locked in place vertically, then use the up and down arrow keys to align it with the green grid.
Calibrate Step 7-c:
If the magenta grid is not the same horizontal size as the green grid and the difference is such that <s> and <shift><s> commands are inadequate, you can use <h> and <shift><h>. <h> adds 5 horizontal pixels. <shift><h> removes 5 horizontal pixels. Use <h> and <shift><h> to resize the grid to the correct width, then use the left and right arrows to align the grids.
Complete the Calibration as usual.
Part No. 917-050560, Rev. A