1 INTRODUCTION
The software described in this manual is intended to be used in the ESO VLT project by ESO and authorized external contractors only.
While every precaution has been taken in the development of the software and in the preparation of this manual, ESO assumes no responsibility for errors or omissions, or for damage resulting from the use of the software or of the information contained herein.
1.1 PURPOSE
The purpose of this document is to describe the usage of the Startup Tool software package: the manual describes the features supplied by the Startup Tool and how the Instrumentation Software is started and stopped with this tool. The tutorial describes the tool and how the related Template Instrument software modules are used and configured for a specific instrument.
1.2 SCOPE
This document is intended for software developers of instrumentation software for the VLT project.
The related Template Instrument manual [26] describes a template instrument (modules xxins, xxi, etc.) that can be used as a template to build a specific real instrument.
This document does not enter into internal implementation details of the stoo package; this will be found in the Maintenance Manual.
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] GEN-SPE-ESO-19400-0794, 2.0 31/10/97 --- DICB - Data Interface Control Document
[2] VLT-SPE-ESO-10000-0011, 2.0 30/09/92 --- VLT Software Requirements Specification
[3] VLT-PRO-ESO-10000-0228, 1.0 10/03/93 --- VLT Software Programming Standards
[4] VLT-PLA-ESO-10000-0441, 1.0 01/05/95 --- VLT Science Operation Plan
[5] VLT-MAN-ESO-17210-0667, 1.2 08/10/01 --- Guidelines for VLT applications.
[6] VLT-SPE-ESO-17212-0001, 2.0 23/02/95 --- INS Software Specification
[7] VLT-SPE-ESO-17240-0385, 2.1 15/07/96 --- INS Common Software Specification
[8] VLT-ICD-ESO-17240-19400, 2.6 17/11/97 --- ICD between VCS and Archive
[9] VLT-ICD-ESO-17240-19200, 1.3 27/06/00 --- ICD between VCS and OH
1.4 REFERENCE DOCUMENTS
The following documents are referenced in this document.
[10] VLT-MAN-ESO-17200-0888, 1.0 17/08/95 --- VLT Common Software Overview
[11] VLT-MAN-ESO-17200-0642, 4 29/04/04 --- VLT Common Software Installation Manual
[12] VLT-SPE-ESO-17120-1355, 1.2 12/01/99 --- Final Lay-out of VLT Control LANs
[13] VLT-MAN-SBI-17210-0001, 3.7 05/10/01 --- LCU Common Software User Manual
[14] VLT-MAN-ESO-17210-0600, 1.7 02/10/98 --- Motor Control sw User Manual API/ACI
[15] VLT-MAN-ESO-17210-0669, 1.6 02/10/98 --- Motor Engineering Interface User Manual
[16] VLT-MAN-ESO-17210-0619, 2.4 31/03/04 --- Central Control Software User Manual
[17] VLT-MAN-ESO-17210-0707, 1.6 30/09/99 --- On Line Database Loader User Manual
[18] VLT-MAN-ESO-17210-0771, 1.8 06/10/01 --- EVH User Manual
[19] VLT-MAN-ESO-17210-0770, 1.8 30/09/01 --- Extended CCS User Manual
[20] VLT-MAN-ESO-17210-0690, 5 31/03/02 --- Panel Editor User Manual
[21] VLT-MAN-ESO-14100-1878, 1.4 05/12/03 --- IRACE-DCS User Manual
[22] VLT-MAN-ESO-17240-0853, 3 26/03/04 --- INS Common sw - oslx User Manual
[23] VLT-MAN-ESO-17240-2325, 4 31/03/04 --- INS Common sw - Config. Tool User Manual
[24] VLT-MAN-ESO-17240-2265, 4 05/04/04 --- INS Common sw - BOSS User Manual
[25] VLT-MAN-ESO-17240-0934, 5 31/03/04 --- INS Common sw - Base ICS User Manual
[26] VLT-MAN-ESO-17240-1973, 4 31/03/03 --- Template Instrument Software User Manual
[27] VLT-MAN-ESO-17220-0737, 3 28/03/02 --- HOS - Sequencer User Manual
[28] P.Ward, S.Mellor, Yourdon Press, 1985 --- Struct. Development for Real-Time Systems
[29] J. Rumbaugh et. al., Prentice Hall, 1991 --- Object-Oriented Modelling and Design
1.5 ABBREVIATIONS AND ACRONYMS
The following abbreviations and acronyms are used in this document:
CCS Central Control Software
CPU Central Processing Unit
DCS Detector Control Software
ESO European Southern Observatory
FITS Flexible Image Transport Format
GUI Graphical User Interface
ICS Instrument Control Software
INS Instrumentation Software Package
ISAAC Infrared Spectrograph and Array Camera
IWS Instrument Workstation
OMT Object Modelling Technique
OOD Object Oriented Design
OSS Observer Support Software
TCS Telescope Control Software
TIM Time Interface Module
TRS Time Reference System
UIF (Portable) User Interface (Toolkit)
UVES UltraViolet Visual Echelle Spectrograph
VME Versa Module Eurocard
1.6 GLOSSARY
No special definition is introduced in this manual
1.7 STYLISTIC CONVENTIONS
The following styles are used:
bold in the text, for commands, filenames, pre/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 and commands, filenames as they have to be typed.
<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.1 Data Flow and Processor Model Diagrams
Data Flow and processor Model Diagrams are based on De Marco/Yourdon notation for real-time systems [28].
1.7.2 Class Diagrams
Class diagrams are based on OMT notation [29]
In order to simplify drawing of class symbols, a class is represented by a box, divided in two sections:
Lines connecting classes have to be interpreted as follows:
Class hierarchies are also represented as tree diagrams with the base class on the left and derived classes on the right, connected by lines:
1.8 NAMING CONVENTIONS
This implementation follows the naming conventions as outlined in [3].
1.9 PROBLEM REPORTING/CHANGE REQUEST
The form described in [11] shall be used.