1 INTRODUCTION 9 1.1 Purpose 9 1.2 Scope 10 1.3 Applicable Documents 10 1.4 Reference Documents 10 1.5 Abbreviations and Acronyms 11 1.6 Glossary 12 1.7 Stylistic Conventions 12 1.8 Naming conventions 13 1.9 Problem Reporting/Change Request 13 2 USER'S GUIDE 15 2.1 Overview 15 2.2 Parallelism 15 2.3 Exposure definitions 16 2.3.1 CCD Exposure Id 16 2.3.2 Exposure types 17 2.3.3 Exposure status 18 2.4 Operational modes and simulation 18 2.5 Operational states 19 2.6 Image processing 19 2.7 Telemetry Monitoring 20 2.8 Startup 20 2.8.1 Startup verification 21 2.9 Shutdown 21 2.9.1 Powering Down the FIERA SPARC 21 2.9.2 Rebooting the FIERA SPARC 21 2.10 Include files 22 2.11 Command Interface 22 2.12 C libraries 22 2.13 Graphical User Interface CCD classes 23 2.14 Data 24 2.14.1 Data Interface Dictionary 24 2.14.2 Setup parameters and files 25 2.14.3 Image data 28 2.14.4 Public part of the FIERA CCD database 30 2.15 Alarm System 33 2.16 Configuration and operational logs 33 2.17 Example of usage of CCD cameras 33 3 NOTES FOR ADAPTIVE OPTICS SYSTEMS 37 3.1 Changing a Readout Mode 37 3.1.1 execution of a Readout Mode when the system is not operating 37 3.1.2 change the Readout Mode while an exposure loop is running 38 3.2 Image Cube 38 3.2.1 Setup parameter for Image Cubes 38 3.2.2 How to obtain an Image Cube 38 3.3 Test Mode 39 3.3.1 Example of Test Mode execution 39 4 REFERENCE 41 4.1 Functions 41 4.1.1 fcdCheckSetup 42 4.1.2 fcdGetCIName 44 4.1.3 fcdGetConf 45 4.1.4 fcdGetIndexFromId 46 4.2 Programs 47 4.2.1 Command Definition Table for program fcdconCI 47 4.3 Scripts 48 4.3.1 fcdInstall.sh 49 4.3.2 fcdDcsStart.sh 50 4.3.3 fcdDcsWarmStart.sh 52 4.3.4 fcdDcsStop.sh 54 4.3.5 fcdDcsDbSave.sh 56 4.3.6 fcdDcsScan.sh 57 4.3.7 fcdosScan.sh 59 4.3.8 fcdDcsWcs.sh 61 4.3.9 fcdDcsSetLogMask.sh 62 4.3.10 fcdDcsSlcuHalt.sh 63 4.3.11 fcdDcsSlcuReboot.sh 64 4.4 GUI classes 65 4.4.1 fcdExpStatus_uifClass 66 4.4.2 fcdIpStatus_uifClass 67 4.4.3 fcdExpSetup_uifClass 68 4.4.4 fcdReadoutSetup_uifClass 69 4.5 Include files 70 4.6 Database 71 4.6.1 Example for DATABASE.db file 72 4.6.2 Example for USER.db file 74 4.7 Setup files 76 4.7.1 Example for complete FIERA CCD DCS setup file 77 4.8 Image files 80 4.8.1 Example of FITS standard keywords 81 4.8.2 Example of FITS hierarchical keywords 82 4.8.3 Example of FITS standard keywords (Image Extension per Port) 84 4.8.4 Example of FITS hierarchical keywords (Image Extension per Port) 87 4.9 Log files 88 4.9.1 Example of FITS log from a Scientific CCD 88 4.10 Error messages files 89 5 INSTALLATION GUIDE 91 5.1 General 91 5.1.1 Copyright 91 5.2 Supported configuration 91 5.2.1 Hardware 91 5.2.2 Software 92 5.3 Contents 92 5.4 Problem Reporting/Change Request 92 5.5 FIERASW Installation 92 5.6 Configuration of the Instrument workstation 93 5.6.1 Environment variables. 93 5.6.2 Users to be defined 94 5.6.3 WS Environment 95 5.6.4 Real Time Display 96 5.6.5 Setting source mask for FITS logs 97 5.6.6 Files needed for CCD operations 97 5.6.7 Scan System configuration 98 5.7 Configuring the FIERA SLCU 98 5.7.1 Changing Basic TCP /IP Configuration 98 5.7.2 Environment Variables 100 5.7.3 Configuring the "fcdrun" user 101 5.7.4 Adding the "Instrument User" 101 5.7.5 SLCU Environment 102 5.7.6 SLCU Logging System Configuration 103 5.7.7 Rebooting and Halting the SLCU 103 5.8 CCD Camera Installation Verification 104 5.8.1 Checking the Connectivity between the SLCU and the DSP board 104 5.8.2 Checking the Connectivity between the WS and the SLCU manually 104 5.9 CCD Software Operation Verification 106 5.10 Using the FIERA CCD Software 106 6 REFERENCE FOR CHECKING OF THE FIERA CONFIGURATION 107 6.1 fcdAddUser 108 7 ERROR DEFINITIONS 109 8 STANDALONE OPERATIONS 111 8.1 Configuration 111 8.2 Control panel 114 8.3 Engineering Interface 114 8.4 Getting started 116 8.4.1 Simple Demo session 117 8.4.2 SLCU simulated session 118 8.5 Exposure definitions 120 8.5.1 Exposure types 120 8.6 Operational modes and simulation 120 8.7 Operational states 120 8.8 Running the system 121 8.8.1 Starting the control panel 121 8.8.2 Checking CCD camera configuration 121 8.8.3 Setting the operational mode 121 8.8.4 Starting the control software 122 8.8.5 Defining the exposure setups 122 8.8.6 Controlling the exposures 122 8.8.7 Failure reporting 123 8.8.8 Analysing the images 123 8.8.9 Monitoring the telemetry and the temperature values 124 8.8.10 Shutdown of the control software 124 8.8.11 Shutdown of the environment 125 9 STANDALONE OPERATIONS: REFERENCE 127 9.1 Panels 127 9.1.1 fcdCtrl 128 9.1.2 fcdTelemetry 131 9.1.3 fcdOpMode 132 9.1.4 fcdConfig 133 9.1.5 fcdConfigTel 136 9.1.6 fcdConfigMode 138 9.1.7 fcdei 140 9.2 Scripts 142 9.2.1 fcdDemo.sh 143 9.2.2 fcdStart.sh 144
