0.0 Reference Documents

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

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

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

[2] VLT Software Programming Standards
VLT-PRO-ESO-10000-0228, Issue 1.0

[3] VMIVME-3111
48 Analog-to-Digital Inputs 2-Channel Digital-to-Analog Output Board
Instruction Manual
Document No. 500-003111-000

[4] CCS-LCU Analog I/O Driver Specification
VLT-SPE-ESO-17210-0355, Issue 1.0

[5] VLT SW Common Software - Overview
VLT-MAN-ESO-17200-0888, Issue 1.0

[6] VLTCommon Software - Installation Manual
VLT-MAN-ESO-17200-0642, Issue 1.10

[7] VLT Software Problem Report Change Request User Manual
VLT-MAN-ESO-17210-0375

[8] CCS-LCU Driver Development Guide and User Manual
VLT-SPE-ESO-17210-0375, Issue 2.2

0.1 Abbreviations And Acronyms

The following abbreviations and acronyms are used in this document:

AIO Analog I/O Interface Module

CCS Central Control Software

CDT Command Descriptor Table

DCT Driver Channel Table

EOC End of analog-to-digital conversion

HW Hardware

I/O Input/Output

ISR Interrupt Service Routine

LAN Local Area Network

LCC LCU Common Software

LCU Local Control Unit

N/A Not Applicable

OS Operating System

SW Software

TBD To Be Defined

VLT Very Large Telescope

WS Workstation

0.0 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.

Items which are subject to change in future versions are marked in this way (AuthorRemark).

7 Very important items are marked in this way (Warning).

Changes to the previous issue of this document are marked with Change-Bars.

0.0 Naming Conventions

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

0.2 Problem Reporting/Change Request

See [7] for instructions.

1 INTRODUCTION

1.1 Purpose

This document¹ provides the User Manual of the VMIVME-3111 Analog I/O Board Driver software module.

It is intended to provide all the necessary information to use the aio Driver from the LCU Common Software or higher level applications.

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

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

· Users's Guide: describes the tasks that can be done by the driver, including examples.

· Reference: a list of the functions available.

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

At the end, the Error Messages and Recovery section provides a complete list of errors and diagnostic messages and possible recovery actions.

1.2 Scope

This manual describes the software module aio in its version 1.19.

The aio Driver is developed for the VMIVME-3111 Analog I/O Board to set analog output signals and to read analog input signals.

This implementation includes the following C library:

· aio - library of routines to access aio module

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

· a standard 6U VMEbus chassis with bus backplane and power supply

· at least one VMIVME-3111 Analog I/O board, any version

· at least one Motorola MVME167 or MVME2604 CPU board, any version

· VxWorks 5.2 or 5.3.1 operating system

· lcudrv for common driver functions, version 1.26

· lculog for internal logging, version 1.11

¹

The document is prepared according to the IEEE 1063-1987 (Standard for SW User Documentation) as recommended in sect. 4.2.14 page 34 of the SW Management Plan - Issue 2.0, 21/05/92.

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