Eizo DL-Lite Owner's manual

Raptor DL-Lite X11R6.1 for AIX

Installation and Reference

Manual

Copyright  2005 Tech Source Inc.

442 S. North Lake Blvd.

Altamonte Springs, FL 32701

(407) 262-7100

Publication #65-0261-03 Rev A February 22, 2005

Addendum Information

Date Released February 22, 2005

Changes made to:

REVISION

NUMBER

CHANGES

DATE

A

Initial Release

02-22-05

The Tech Source logo, Tech Source and Tech Source Raptor are

trademarks of Tech Source, Inc. X Window System is a trademark

and product of X.org.

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 to those trademarks herein.

form or by any means without prior written permission of the

copyright owner.

RESTRICTED RIGHTS LEGEND: Use, duplication, or disclosure by

the U.S. Government is subject to restrictions of FAR 52.227-

14(g)(2)(6/87) and FAR 52.227-19 (6/87); or DFAR 252.227-

7015(b)(6/95) and DFAR 227.7202-3(a).

The product described in this manual may be protected by one or

more U.S. patents, foreign patents, and/or pending patent

applications.

PREFACE

This publication documents the Tech Source Raptor X11R6.1 for

AIX Installation for use with the Tech Source, Inc. Raptor DL-Lite

card. This manual is intended for users who incorporate the Tech

Source Raptor cards into IBM RS/6000 workstations running AIX

operating systems.

This is a guide to the installation of the Raptor software. All

systems vary to a degree. Knowledge of the features of your

system and an understanding of UNIX shell scripts are helpful

during the installation process.

WARRANTY

The Raptor cards are warranted for one (1) year from date of

shipment. During the warranty period, Tech Source, Inc. will, at its

discretion, repair or replace a defective component at its expense.

Freight charges associated with 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 customer. We

suggest that you contact your dealer first with any questions you

may have about the product. Unlimited technical support (via

telephone/facsimile/email) is provided for one (1) year from date of

shipment. The installation of any Tech Source, Inc.

hardware/software product is the sole responsibility of the customer.

Tech Source, Inc. offers a continuing hardware/software support

program that provides telephone consultation and any required

hardware repair after the expiration of the warranty period. This is a

billable annual maintenance contract. Contact Tech Source, Inc. for

the available maintenance plans.

Customers will be charged an hourly rate plus materials ($300.00

USD minimum) for repairs and/or maintenance performed by Tech

Source, Inc. that are not covered by a Tech Source, Inc. warranty or

maintenance contract.

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.

TABLE OF CONTENTS

INTRODUCTION 1-1

1.1 Overview 1-1

1.2 MOX Extension Support 1-2

1.3 Conventions 1-2

HARDWARE INSTALLATION 2-1

2.1 Hardware Configurations Supported 2-1

2.2 Installation Instructions 2-1

SOFTWARE INSTALLATION 3-1

3.1 Requirements 3-1

3.2 CD-ROM Installation 3-1

3.3 Configuring the Raptor as LFT Display 3-3

3.4 Supported Resolutions 3-4

INVOKING X11R6.1 4-1

4.1 Overview 4-1

4.2 xinit 4-1

4.3 Setting Bit-Depth and Resolution 4-3

4.3.1. Setting Bit-Depth 4-3

4.3.1.1 STARSMODE Variable 4-4

4.3.1.2 Config File 4-4

4.3.2 Setting the Resolution 4-5

4.4 Enabling MOX Extension During X11R6.1 Server Startup 4-5

4.5 xdm 4-5

4.5.1 MOX Mode Using xdm 4-6

4.6 Common Desktop Environment (CDE) 4-7

4.6.1 MOX Mode Using CDE 4-7

TABLE OF CONTENTS

UNINSTALLING RAPTOR DL-Lite X11R6.1 FOR AIX 5-1

5.1 Uninstall Using SMIT 5-1

TECHNICAL ASSISTANCE 6-1

6.1 Who to Call For Help 6-1

6.2 Email Address 6-1

6.3 Website 6-2

APPENDIX A - CARD SPECIFICATIONS A-1

A.1 Raptor DL-Lite Specifications A-1

1-1

Chapter 1

INTRODUCTION

1.1 Overview

This manual describes the installation for Raptor DL-Lite X11R6.1

for AIX. This software supports the following cards:

• Raptor DL-Lite

In this manual, the Raptor DL-Lite card will be referred to as the

“Raptor” card. Knowledge of the AIX operating system and the

SMIT installation tool will be useful during this installation. The AIX

versions currently supported are AIX 4.3.3, AIX 5.1 and AIX 5.2.

From this point forward, Tech Source, Inc. will be referred to as

Tech Source or TSI.

The software is provided on a CD-ROM and consists of the

following:

• Tech Source Raptor DL-Lite device-drivers for AIX

• X11R6.1 binary distribution (clients, libraries, fonts, etc.)

• X11R6.1 server for Tech Source Raptor cards

• MOX (Multiple Overlay eXtension) Client libraries, include files

and examples

Raptor DL-Lite X11R6.1 for AIX Installation Manual

1-2

Note: Before installing this software, you must uninstall any

previous versions of the software.

1.2 MOX Extension Support

Tech Source supports an X-server extension called MOX (Multiple

Overlay eXtension) on the Raptor graphics cards. The underlying

software (available as a server extension and a client library)

needed for MOX support has been included as a part of this Raptor

DL-Lite X11R6.1 for AIX software product. Enabling of this

extension during the X-server startup is described in Section 4.4.

1.3 Conventions

This manual will follow certain conventions throughout.

Whenever a variable name, command name, directory, or filename

is used in a paragraph they 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 similar to one the reader might see 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

2-1

Chapter 2

HARDWARE INSTALLATION

2.1 Hardware Configurations Supported

The software has been tested on and currently supports IBM

RS/6000 systems (with PCI slots), running in single and multi-

screen configurations. The RS/6000 systems currently tested on

Raptor cards are:

• 43P

• 44P

• IntelliStation Power 275

This chapter discusses the installation of Raptor cards in one of

these machines. Please contact Tech Source if you have

installation issues on a different machine.

2.2 Installation Instructions

The Raptor card installation is simple and consists of a few easy

steps. These installation instructions presume that you are familiar

with the AIX operating system.

Raptor DL-Lite X11R6.1 for AIX Installation Manual

2-2

NOTE: Remember which cables go to which connectors. You may

want to label the cables and connectors before disconnecting them.

Step 1: Shutdown the system and turn the power OFF.

Remove the system’s cover, find an available PCI

Local Bus slot, and remove the bracket and screw.

Ground yourself by touching the metal part on the

case.

Step 2: Install the Raptor card firmly into the PCI Local

Bus slot. Take care to press it evenly and snugly

into the slot. Once you are certain the card is

installed properly in the slot, secure it with the

bracket screw.

Step 3: Secure the system’s cover, attach any previously

removed cables.

Step 4: Connect the Dual Link DVI cable from the Apple

HD panel to the Raptor DL-Lite card.

The Raptor card is now installed and the system is ready for

software installation. Refer to Chapter 3 for installing the Raptor

DL-Lite X11R6.1 for AIX software.

3-1

Chapter 3

SOFTWARE INSTALLATION

3.1 Requirements

The following are prerequisites for installing Raptor DL-Lite

X11R6.1 for AIX Software:

• The system is running AIX 4.3.3, AIX 5.1, AIX 5.2

• Any previous version of TSI software has already been

uninstalled. (Please refer to the manual that accompanied that

software for the appropriate uninstall procedure).

• 41MB of disk space is available in /usr.

One or more of the cards listed in Section 1.1 is presently installed

in the workstation.

3.2 CD-ROM Installation

Installation of Raptor software can be done through SMIT. The

following are the step-by-step instructions for installing Raptor DL-

Lite X11R6.1 for AIX software from CD-ROM:

1. Install a Raptor card in the computer as described in

Chapter 2.

2. Login as root on the target install machine.

3. Uninstall any previous version of TSI software in

accordance with the instructions supplied with that

software.

The installation may fail if previous TSI software already

exists on the system.

Raptor DL-Lite X11R6.1 for AIX Installation Manual

3-2

4. Insert the CD-ROM labeled “Raptor DL-Lite X11R6.1 for

AIX" into the CD-ROM drive.

5. Mount the CD-ROM drive. To do this using SMIT, perform

the following steps:

• Select System Storage Management | File

Systems | Mount a File System

• In the File System Name box, select /dev/cd0

(or the location of your CD-ROM device)

• In the Directory to Mount box, select /cdrom

• In the Type of File System box, select cdrfs

• In the Mount as READ-ONLY file system box,

select yes.

6. Install the software. To do this using SMIT, perform the

following steps:

• Select Software Installation and Maintenance |

Install and Update Software

• Install Software

• In the Input Device/Directory for Software box,

select the appropriate directory below based on

the type of the system you use:

For 43P and 44P machines:

• /cdrom/power3

For IntelliStation Power 275:

• /cdrom/power4

• In the Software to Install box, make sure it says

“_all_latest”.

Chapter 3 – Software Installation

3-3

After installing the drivers, reboot the machine. Turn on the

machine and the AIX should now recognize the Raptor correctly.

You can verify this by entering the following command:

prompt% lsdisp

If a Raptor DL-Lite card is present in the system, this command

should return an entry like:

Note: The Raptor cards are identified by the operating system as

follows:

Raptor DL-Lite rapdlt#

Where # is an instance number assigned by the operating system.

3.3 Configuring the Raptor as LFT Display

In order to use the Raptor card as the LFT display, use the chdisp

command to change the current display device to the Raptor

device.

For Raptor DL-Lite, type the following:

prompt% chdisp [-d|-p] rapdlt0

DEV_NAME SLOT BUS ADPT_NAME DESCRIPTION

======== ==== === ========= ===========

rapdlt0 02 pci Raptor DL-Lite

Graphics

Adapter

Raptor DL-Lite X11R6.1 for AIX Installation Manual

3-4

Note: Use “-d” for temporary change of display until the next

reboot, or “-p” to make a permanent change of display

If the Raptor card is the only graphics device in the system, it will

automatically be configured as the default LFT (console) device.

3.4 Supported Resolutions

The resolution for Raptor DL-Lite is fixed at 2560x1600, for the

Apple LCD panel.

4-1

Chapter 4

INVOKING X11R6.1

4.1 Overview

There are several ways to invoke X11R6.1 on your system:

• xinit

• xdm

• Common desktop Environment (CDE)

• All of the above with MOX extension enabled

Important: For all these methods, there are some environment

variables that must be set. These can be set in your .cshrc file.

prompt% setenv X11R6HOME /usr/X11R6.1

prompt% setenv LD_LIBRARY_PATH \

$X11R6HOME/lib

prompt% set path=($X11R6HOME/bin $path)

The Xtsi server is provided in the $X11R6HOME/bin directory.

The examples used in this chapter refer to the device rapdlt0.

Your actual device name will vary according to the Raptor card type

and the instance number.

4.2 xinit

The xinit program can be directly used to start the X Window

System server. The xinit format is as follows:

xinit [[client] options] [ -- [server]

[display] options ]

Raptor DL-Lite X11R6.1 for AIX Installation Manual

4-2

If no specific client program is given on the command line, xinit

will look for a file in the user's home directory called .xinitrc to

run as a shell script to start up client programs. If no such file

exists, xinit will use the following as a default:

xterm -geometry +1+1 -n login -display :0

If no specific server program is given on the command line, xinit

will look for a file in the user's home directory called .xserverrc

to run as a shell script to start up the server. If no such file exists,

xinit will use the following as a default:

X :0

Note that this assumes that there is a program named X in the

current search path. The X11R6.1 server in this software is called

Xtsi and is in the directory $X11R6HOME/bin. A symbolic link

has been made from X to Xtsi.

To startup the server using xinit, type:

prompt% xinit -- $X11R6HOME/bin/Xtsi -P11 rapdlt0

You may add any other command line arguments to the end of the

line. For additional information on xinit, refer to the xinit man

page.

The X server can run in multi-screen mode. The example below

shows how to start on two Raptor DL-Lite cards:

prompt% xinit -- $X11R6HOME/bin/Xtsi –P11 rapdlt0

–P12 rapdlt1

Chapter 4 - Invoking X11R6.1

4-3

4.3 Setting Bit-Depth and Resolution

4.3.1 Setting Bit-Depth

Raptor cards support various bit-depths and overlay configurations.

This section describes the required settings for these

configurations. The default bit-depth for all Raptor cards is 8-bit.

The bit-depth of the Raptor DL-Lite can be set to 8-bit only, 8+24-

bit, 24-bit, mox16, mox24 or mox32 (see Table 2.)

Mode/Bit-Depth Description of Mode

8-bit 8-bit PseudoColor visual

8+24 mode One 8-bit visual + One 24-bit visual

(simultaneous)

24-bit 24-bit TrueColor visual only

mox16 mox mode w/16 planes

mox24 mox mode w/24 planes

mox32 mox mode w/32 planes

Table 2

An explanation of different MOX modes can be found in Section

4.4.

There are two ways to set bit-depth on the Raptor DL-Lite:

• By setting the environment variable

STARSMODE

• By editing the config file /etc/X11/TSIScreenConfig

Raptor DL-Lite X11R6.1 for AIX Installation Manual

4-4

4.3.1.1 STARSMODE Variable

The bit-depth of the Raptor DL-Lite card can be set using the

STARSMODE environment variable. This variable should be set

before starting up the X server.

For example, set the bit-depth of the Raptor DL-Lite card to 8+24

prompt% setenv STARSMODE +8+24

To set the bit-depth of the Raptor DL-Lite card to mox16

prompt% setenv STARSMODE +mox16

Other bit-depths can be selected in a similar manner.

NOTE: In the case when both methods to set bit-depth are used,

the STARSMODE variable takes precedence over the settings in the

TSIScreenConfig file.

4.3.1.2 Config File

The depth of the Raptor DL-Lite card can be set using the

/usr/X11R6.1/etc/TSIScreenConfig file. Each row in the

file corresponds to a specific Raptor DL-Lite card that is identified

by its device name. The fields in each row are separated by

spaces. In the sample config file shown below the bit-depth of the

Raptor DL-Lite (rapdlt0) card is set to 8+24. The cached pixmap

field is used for debugging purposes only and should always be set

to 1. The other fields are discussed in 4.3.2.

# device Depth Resolution Sync Cached Resfile

pixmap

rapdlt0 8+24 DEFAULT 1 1 trzresinfo

The default visual in 8+24-bit mode is PseudoColor. In order to set

the default visual in the 8+24-bit mode to TrueColor, the X Server

should be started with command line option cc set to 4. The

example below shows how to set the default visual to TrueColor for

the card rapdlt0.

Chapter 4 - Invoking X11R6.1

4-5

#xinit -- $X11R6HOME/bin/Xtsi –Pll rapdlt0 –cc 4

NOTE: This method of setting the default visual has an effect only

in the 8+24-bit mode.

4.3.2 Setting the Resolution

The resolution of the Raptor DL-Lite cards is fixed at 2560x1600.

4.4 Enabling MOX Extension During

X11R6.1 Server Startup

By default, the X11R6.1 server starts in an 8-bit mode. However,

on Raptor DL-Lite cards you may start the X11R6.1 server with

MOX extension enabled. (Details of the MOX Extension to X

Server are in separate technical white paper documentation.)

These MOX modes are available on Raptor DL-Lite cards:

mox16 MOX, 8-bit Normal, 13-bit Group, 5-bit Absolute

mox24 MOX, 8-bit Normal, 21-bit Group, 13-bit Absolute

mox32 MOX, 8-bit Normal, 29-bit Group, 21-bit Absolute

To enable MOX on a Raptor card, set the bit-depth to one of the

MOX modes. Please refer to Section 4.3.1 for details.

4.5 xdm

The X Display Manager (xdm) program is used for running multiple

users on the same host machine. xdm provides services similar to

those provided by init, getty and login on character terminals

prompting for login name and password, authenticating the user,

and running a session. It provides a login window for each user or

selected users.

Several files that are required to start xdm are provided in the

Raptor DL-Lite X11R6.1 for AIX Installation Manual

4-6

directory $X11R6HOME/lib/X11/xdm. The configuration file

xdm-config contains references to the other files and is used to

specify other configuration parameters of xdm. The Xservers file

specifies the users (displays) that must get a login window.

The Xservers file will have individual lines to represent the X-

server startup on each of the display device on which an xdm login

screen is desired. Each startup line in Xservers file should be

modified to look like the following to enable the Raptor device

based xdm login screen:

:0 Local local-uid@console root \

/usr/X11R6.1/bin/Xtsi :0 –P11 rapdlt0

You may also add any other command line arguments to the end of

the line. For more information on xdm refer to the xdm man pages.

4.5.1 MOX Mode Using xdm

In order to enable MOX under xdm you must make use of the

StartWin script installed in /usr/X11R6.1/etc. The

Xservers file should be modified as follows:

:0 local /usr/X11R6.1/bin/StartWin:0

Additional command line options can be appended at the end of

this line. The following example StartWin script will start up the

X Server in mox24 mode.

#!/bin/sh

STARSMODE=+mox24

export STARSMODE

pass=“/usr/X11R6.1/bin/Xtsi”$*

exec $pass

NOTE: By default, the StartWin script starts up the X Server in

mox24 mode. It can be edited in order to support other MOX

modes.

Page is loading ...

Eizo DL-Lite Owner's manual

Eizo DL-Lite Owner's manual

Related papers

Other documents