|
|
EUROPEAN
SOUTHERN OBSERVATORY
Organisation Européenne pour des Recherches Astronomiques dans l'Hémisphère
Austral
Europäische Organisation für astronomische Forschung in der südlichen
Hemisphäre
VLT PROGRAMME
VERY
LARGE TELESCOPE
VLT
Software
---
Template
Instrument Software
User and
Maintenance Manual
Doc. No.: VLT-MAN-ESO-17240-1973
Issue: 4
Date: 31/03/2003
Name Date Signature
Prepared: A.Longinotti 31/03/2003
Name Date Signature
Approved: K.Wirenstrand
Name Date Signature
Released: K.Wirenstrand
VLT PROGRAMME * TELEPHONE:
(089) 3 20 06-0 * FAX: (089) 3 20 06 514
CHANGE RECORD
|
ISSUE |
DATE |
SECTION/PAGE AFFECTED |
REASON/INITIATION DOCUMENTS/REMARKS |
|
1.0 |
All |
First issue, containing only ICS part |
|
|
2.0 |
|
All |
Second issue, containing the whole instrument, including OS |
|
3 |
|
4.7.2 5.3 10.5 10.10.4 |
MAR2002, Added ICS stand-alone GUI, SPR VLTSW20010501, VLTSW20010502. |
|
4 |
|
3.2 Appendix B |
APR2003 |
|
|
|
|
|
TABLE OF CONTENTS
TABLE
OF CONTENTS 3
1 INTRODUCTION 7
1.1 Purpose 7
1.2 Scope 7
1.3 Applicable Documents 7
1.4 Reference Documents 8
1.5 Abbreviations and Acronyms 9
1.6 Glossary 9
1.7 Stylistic Conventions 9
1.7.1 Data Flow and Processor Model Diagrams 9
1.8 Naming Conventions 10
1.9 Problem Reporting/Change Request 10
2 OVERVIEW 11
2.1 Hardware architecture 11
2.1.1 Devices 11
2.1.2 Computers 11
2.1.3 LANs 11
2.1.4 Special connections 11
2.2 Software Architecture 13
2.2.1 Software Modules 13
2.2.2 Environments 13
2.2.3 Standards 13
3 INSTALLATION GUIDE 15
3.1 Requirements 15
3.1.1 Hardware 15
3.1.2 Software 15
3.2 Installation procedure 15
3.2.1 Preparation 15
3.2.2 Operational hw configuration (all LCUs
available) 16
3.2.3 Development hw configuration (not all LCUs
available) 16
4 OPERATOR’S GUIDE 17
4.1 System Start-up 17
4.1.1 Log-in 17
4.1.2 Telescope availability 17
4.1.3 Midas availability 18
4.1.4 Instrument Software Start-up 18
4.1.5 Begin of operations 19
4.1.6 End of operations 19
4.2 System Shut-down 19
4.3 User Station 20
4.4 Observations with Templates 21
4.5 Alarms 21
4.6 Data files location 21
4.7 Engineering 21
4.7.1 OS Engineering GUI 21
4.7.2 ICS Engineering GUI 21
5 PROGRAMMER'S GUIDE 23
5.1 Instrument Modes 23
5.2 Subsystems Identifiers 23
5.3 ICS Software Devices 23
5.3.1 ICS Special devices 24
5.3.2 ICS Assemblies 24
5.4 Exposures 25
5.4.1 Exposure types 25
5.4.2 Exposure Id 25
5.4.3 Exposure Status 25
5.4.4 Exposure Parallelism 25
5.4.5 Exposure Life Cycle 25
5.4.6 Exposure execution 26
5.5 Operational States 26
5.6 Commands 26
5.6.1 OS Special commands 26
5.6.2 ICS Special commands 26
5.6.3 DCS Special commands 26
5.7 Tcl libraries 26
5.8 Dictionaries 26
5.9 Alias files 27
5.10 Configuration files 27
5.11 Setup files and keywords 27
5.11.1 OCS keywords 27
5.11.2 INS keywords 27
5.11.3 DCS keywords 28
5.12 FITS files 28
5.13 Public on-line database attributes 28
5.14 Operational logs 28
5.15 Templates 28
5.15.1 Acquisition Templates 29
5.15.2 Calibration Templates 29
5.15.3 Observation Templates 29
6 CONFIGURATION 30
6.1 Change Instrument Configuration Parameters 30
7 MAINTENANCE 32
7.1 General 32
7.1.1 Instrument Self-Test 32
7.1.2 Module xxins 32
7.1.3 Module dicXXXX 32
7.2 OS 33
7.2.1 Module xxo 33
7.2.2 Module xxopan 33
7.2.3 Module xxotsf 33
7.2.4 Module xxoseq 34
7.3 ICS 35
7.3.1 ICS Self-Test 35
7.3.2 Module xxi 35
7.3.3 Module xxipan 36
7.3.4 Module xxidev 36
7.4 DCS 36
7.4.1 Engineering 36
7.5 MS 37
7.5.1 Maintenance Templates 37
7.5.2 Module xxmcfg 37
7.5.3 Module xxmseq 37
7.5.4 Module xxmtsf 37
8 FAQ AND TROUBLESHOOTING 38
8.1 Problems at System Start-up 38
8.1.1 Log-in fails 38
8.1.2 Start-up of GUIs fails 38
8.1.3 Start-up of control processes fails 38
8.1.4 xxiControl starts with a wrong simulation
level 38
8.1.5 TCCD starts with a wrong simulation level
and fails to go STANDBY 38
8.1.6 xxoControl tries to access sub-systems
declared as not available 38
8.1.7 Going ONLINE fails 38
8.2 Problems when running exposures 39
8.2.1 Cannot send commands to TCS or access tif 39
8.2.2 Templates cannot access Midas 39
9 ERROR DEFINITIONS 40
10 REFERENCE 41
10.1 Programs 41
10.1.1 Command Definition Table for program
xxoControl 41
10.2 Scripts 42
10.2.1 xxinsStartup 42
10.2.2 xxinsStart 43
10.2.3 xxinsStop 45
10.2.4 xxinsCreateNewInstrument 47
10.3 Include Files 48
10.4 Tcl libraries 49
10.4.1 xxoseqICS 49
10.5 Configuration files 50
10.5.1 xxmcfgCONFIG.cfg 50
10.5.2 xxmcfgINS.cfg 51
10.5.3 xxmcfgSTART.cfg 78
10.6 Setup files 79
10.6.1 Example of
Reference Setup file 79
10.6.2 Example of Instrument Setup File 79
10.7 Templates 80
10.7.1 IR Imaging acquisition template 80
10.7.2 IR Imaging observation template 81
10.7.3 IR Spectroscopy acquisition template 82
10.7.4 IR Spectroscopy observation template 83
10.7.5 Optical Imaging acquisition template 84
10.7.6 Optical Imaging observation template 85
10.7.7 Optical Imaging bias calibration template 86
10.7.8 Optical Imaging flat-field calibration
template 87
10.7.9 Optical Imaging detector linearity
calibration template 88
10.7.10 Optical Imaging focus calibration template 89
10.8 FITS files 90
10.8.1 Example of FITS header 90
10.9 Log files 91
10.9.1 Example of Operational Log (FITS format) 91
10.10 Panels 92
10.10.1 OS Control 92
10.10.2 OS Status 93
10.10.3 OS Engineering 94
10.10.4 ICS stand-alone 96
10.11 Error files 98
10.11.1 xxoErrors.h 98
10.11.2 xxo_ERRORS 99
Appendix A. Create a new Instrument 101
.1 OS sub-classing and method overloading 101
.2 Add special commands to OS 101
.3 Add special handling of set-up keywords in OS 101
.4 Implement a class library for templates 101
.5 Implement an ICS special device on LCU 101
.6 Implement an ICS special device on WS 101
.7 ICS WS sub-classing and method overloading 102
.8 ICS WS Assemblies 102
Appendix B. Installation using different environments