test

SunVideo Plus 1.3 User's Guide

Chapter 2 Installing SunVideo Plus

This chapter contains information for installing and setting environments for the SunVideo Plus hardware and software. It also describes how to connect video input devices to your Sun system through the SunVideo Plus board.

You must be able to become superuser to successfully install SunVideo Plus. If you do not know the root password of the system on which you are installing SunVideo Plus, contact your system administrator.

Installation Kit

The SunVideo Plus 1.3 Installation Kit includes:

Installation Requirements

To successfully install SunVideo Plus, you need a SPARC(TM) system running Solaris 2.5.1, Solaris 2.6, or Solaris 7 operating enironments..

Unpacking the SunVideo Plus Card

The SunVideo Plus board is packaged and shipped in an antistatic envelope that protects it from static electricity. Be sure to save this envelope and all shipping package materials; these materials must be used if re-shipment is necessary. When handling the board, use extreme care and avoid touching delicate electronic components. When unpacking the board, do the following:

  1. Immediately inspect the shipping container for evidence of damage. If the carrier's agent is not present when the container is opened and the contents are found to be damaged, keep all contents packing materials for the agent's inspection.

  2. If you find no evidence of damage, carefully remove the card from its container.

    Caution - Caution -

    Printed circuit boards, such as SunVideo Plus, are made of delicate electronic components that are extremely sensitive to static electricity. Ordinary amounts of static from your clothes or work environment can damage them. Handle these boards only by the non-conducting edges. Do not touch the components on the board or any metal parts. Wear a grounding strap when handling the board. Do not disconnect the power from your system power receptacle. This connection provides the ground path necessary so that you can safely remove and install the board and other components. Be sure that the system power is turned off.

Installing the SunVideo Plus Card

  1. Install the SunVideo Plus card according to the installation procedures for PCI-bus cards provided with your Sun(TM) system.

  2. After installing the SunVideo Plus card and securing your system enclosure, boot your system by typing:


    hostname# reboot -- -r

SunVideo Plus 1.3 Software Contents

Your SunVideo Plus subsystem includes the following software installed during the the pkgadd process:

Table 2-1 SunVideo Plus 1.3 Software Contents

Contents 

Description 

Solaris Software Support 

Docs/

 C/

 de/

 es/

 fr/

 it/

 ja/

 ko/

 sv/

 zh/

 zh_TW.BIG5

Translated User's Guide 

English 

German 

Spanish 

French 

Italian 

Japanese 

Korean 

Swedish 

Simplified Chinese 

Traditional Chinse (BIG5) 

Common to each Solaris release. 

Common/ 

 Packages/  

 SUNWo1kpu

 SUNWopi

 SUNWopi1k

 SUNWsvpab

 SUNWvtsvp

 

 

Runtime libraries 

OPI runtime libraries 

OPI device support 

AnswerBook 

SunVTS test 

All packages under the Common/ directory support Solaris 2.5.1, Solaris 2.6, and Solaris 7.

Solaris_2.5.1/

 Packages/

 SUNWo1kpd.u

 SUNWo1kpx

 

 

Device driver 

XIL1.2 Runtime 

Solaris 2.5.1 Hardware: 4/97, 8/97, and 11/97 

Solaris_2.6/

 Packages/

 SUNWo1kpd.u

 SUNWo1kpx

 

 

Device driver 

XIL1.3 Runtime 

Solaris 2.6 and Hardware: 3/98 and 5/98 

Solaris_7/

 Packages/

 SUNWo1kpd.u

 SUNWo1kpx

 

 

Device driver 

XIL1.3 Runtime 

Solaris 7 and Hardware: 3/99, 5/99, 8/99 and 11/99 

Once installed, the SunVideo Plus 1.3 software resides in /etc/opt/SUNWo1kp, /opt/SUNo1kp, and /opt/SUNWopi. The XIL Runtime pipeline software resides in /usr/openwin.

Removing Previous Software Releases

You must remove any previous releases of the SunVideo Plus software before installing any new software packages.

  1. Log in as superuser.

  2. Uninstall the SunVideo Plus 1.0, 1.1, or 1.2 software packages.

    Note -

    SUNWo1kpu and SUNWo1kpd are core packages; hence, be sure that these packages are removed last by the pkgrm command.

    • Remove SunVideo Plus 1.0 by typing:


      hostname# /usr/sbin/pkgrm SUNWvtsvp SUNWsvpab SUNWo1kpu SUNWo1kpd

    • Remove SunVideo Plus 1.1 or 1.2 by typing


      hostname# /usr/sbin/pkgrm SUNWvtsvp SUNWsvpab SUNWo1kpx SUNWo1kpu SUNWo1kpd
      :

Installing the SunVideo Plus Software

The SunVideo Plus 1.3 software is provided on the CD included with your SunVideo Plus 1.3 installation kit.

  1. Log in superuser (root).

  2. Insert the SunVideo Plus 1.3 CD into the CD-ROM drive connected to your system.

    • If your system is running Volume Manager, it should automatically mount the CD-ROM to the /cdrom/sunvideo_plus_1_3 directory.

    • If your system is not running Volume Manager, mount the CD-ROM as follows:


      hostname# mkdir -p /cdrom/sunvideo_plus_1_3
hostname# mount -F hsfs -r /dev/dsk/c0t6d0s2 

/cdrom/sunvideo_plus_1_3

  3. Install the SunVideo Plus 1.3 software using the pkgadd command:

    1. Install the base software packages for the Solaris 2.5.1, Solaris 2.6, and Solaris 7 operating environments:


      hostname# cd /cdrom/sunvideo_plus_1_3/Common/Packages
hostname# /usr/sbin/pkgadd -d .

      Choose all to install the base packages.

    2. Proceed to install specific Solaris release software packages (Step b for Solaris 2.5.1, Step c for Solaris 2.6, and Step d for Solaris 7).

      • To install the Solaris 2.5.1 Hardware: 4/97, 8/97, and 11/97 operating environment, type:


        hostname# cd /cdrom/sunvideo_plus_1_3/Solaris_2.5.1/Packages
hostname# /usr/sbin/pkgadd -d .

Choose all.

Choose all.

Choose all.

  1. After the software has been installed, unmount and eject the CD-ROM:


    hostname# cd /
hostname# umount /cdrom/sunvideo_plus_1_3
hostname# eject cdrom

  2. Reboot your workstation:


    hostname# reboot -- -r

This enables the operating system to recognize the SunVideo Plus card.

Setting Your Environment

The demonstration applications that are shipped with SunVideo Plus are designed to search the /opt/SUNWo1kp/lib directory for the SunVideo Plus libraries. If the SunVideo Plus software has been installed in a location other than /opt/SUNWo1kp, or if you are using other SunVideo Plus applications that do not automatically search this default directory, you must include the path to the SunVideo Plus libraries libo1kusr and libotiaudio in your LD_LIBRARY_PATH pathname.

Setting O1KHOME

The environment variable 01KHOME must also be set to the installation subdirectory. The default installation is shown below. If the SunVideo Plus software was installed in a different subdirectory, the O1KHOME value must be set to the path of that subdirectory.

Modifying the PATH Variable

For ease of operation, you may want to include the path to the SunVideo Plus applications in your PATH environmental variable.

Setting XIL Environment Variables

Examples that use the Sun XIL(TM) library require that certain XIL environment variables are set. The following entries show how to set these variables assuming XIL was installed in the default location and that the variables are not already set.

Assigning Device Numbers

The operating system assigns device numbers for cards based on the card type, as well as the order that the cards were placed into the PCI-bus slots. When the first SunVideo Plus card is installed into an open slot, the operating system identifies the card as device /dev/olk0. If a second card is placed in an open slot, it is assigned device number /dev/olk1, and so on.

The operating system remembers the order of slots and SunVideo Plus device numbers, even if a card is removed and later replaced. So if the first SunVideo Plus card is moved to another slot, then the operating system will identify that card as /dev/olk2. If a new SunVideo Plus card is then placed into the same slot that the first SunVideo Plus card originally occupied, this new card will be known as /dev/olk0. Once a slot is named as a SunVideo Plus card slot, it retains that same address, regardless of which card actually occupies the slot.

Installation Quick Test

To verify proper installation and operation of the SunVideo Plus card and software, do the following:

  1. Complete the installation of the SunVideo Plus card and software, and ensure that the XIL environment variables are correctly set.

  2. Connect a video source to the Composite Port 1 of the card.

    Note -

    If your video source is an S-Video device, connect the S-Video cable to the SunVideo Plus S-Video connector.

  3. Run the xil_display program to test the video capabilities of the card. Type:


    hostname% xil_display

    This will display 99 frames, then it will exit.

    If your video source is an S-Video device, type the following to use the S-Video source: 


    hostname% xil_display -I 0

  4. Connect an audio line input device to the audio input jack and connect speakers to the audio line output jack.

  5. Run the olk_audloop program to test the audio capabilities of the card. Type:


    hostname% o1k_audloop

  6. Press Control-c when finished.