1 INTRODUCTION

1.1 Purpose

This document is the User Manual of the driver for the VME-ISER8. This VMEbus card is produced by esd electronics system design, Hannover, and has been standardized by ESO.The iser8 driver consists of a module that belongs to the CCS-LCU package. It contains the interface to be used by higher level software to access the VME-ISER8.

The module-name of the driver is iser.

This document should provide all the necessary information for the development of applications using the iser driver.

The manual assumes that the reader has a good knowledge of UNIX, C-language, the VxWorks operating system and is familiar with VxWorks development environment.

In addition to the Introduction section, this manual contains four major sections:

· User's Guide: Consists of the chapters 2, 3 and 3.4. It gives an overview of the driver and describes its functions and ioctl-commands in detail.

· Installation Guide: Describes how to install the driver and make it ready for use.

· Reference: Describes all the driver public functions available as man-pages.

1.2 Scope

This manual describes the software module iser in its version 1.9.

· iser - VME-ISER8 Driver

The following hardware and software environment is required to run the software described:

· a VMEbus chassis with bus backplane and power supply

· at least one VME-ISER8 board

· one Motorola MVME167 or MVME2604 CPU board, any version

· VxWorks version 5.2 or 5.3.1 operating system

1.3 Applicable Documents

The following documents, of the exact issue shown, form a part of this document to the extent specified herein. In the event of conflict between the documents referenced herein and the contents of this document, the contents of this document shall be considered as a superseding requirement.

[1] VLT Local Control Unit Software Specification
VLT-SPE-ESO-17210-0002, Issue 2.0, 30/09/92

1.4 Reference Documents

The following documents contain additional information and are referenced in the text.

[2] VME-ISER8 User Manual, Rev. 2.1 or newer
esd GmbH, Hannover

[3] VxWorks Version 5.2 or 5.3.1 Programmer's Guide
Wind River Systems

[4] VxWorks Version 5.2 or 5.3.1 Reference Manual
Wind River Systems

[5] VLT Software Programming Standards
VLT-PRO-ESO-10000-0228, Issue 1.0, 10/03/93

[6] VLT SW Rel1 - Overview and Installation
VLT-MAN-ESO-17200-0642

[7] CCS-LCU/Driver Development Guide
VLT-MAN-ESO-17210-0375, Issue 2.1, 15.01.1996

[8] VLT Software Problem Report Change Request User Manual
VLT-MAN-ESO-17210-0981, Issue 1.0, 15.01.1996

1.5 Abbreviations And Acronyms

The following abbreviations and acronyms are used in this document:

CCS Central Control Software

CPU Central Processing Unit

FW Firmware

HW Hardware

I/O Input/Output

LCC LCU Common Software

LCU Local Control Unit

N/A Not Applicable

OS Operating System

POST Power On Self Test

RAM Random Access (read/write) Memory

SW Software

TBD To Be Defined

VLT Very Large Telescope

WS Workstation

1.6 Stylistic Conventions

The following styles are used:

bold
in the text, for commands, filenames, prefixes/suffixes as they have to be typed.

italic
in the text, for parts that have to be substituted with the real content before typing.

teletype
for examples.

<name>
in the examples, for parts that have to be substituted with the real content before typing.

bold and italic are also used to highlight words.

1.7 Naming Conventions

This implementation follows the naming conventions as outlined in the VLT Programming Standards [5].

1.8 Problem Reporting/Change Request

The form described in [8] shall be used.

Quadralay Corporation http://www.webworks.com Voice: (512) 719-3399 Fax: (512) 719-3606 sales@webworks.com