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 21 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 32 2.16 Configuration and operational logs 33 2.17 Example of usage of CCD cameras 33 3 NOTES FOR ADAPTIVE OPTICS SYSTEMS 35 3.1 Changing a Readout Mode 35 3.1.1 execution of a Readout Mode when the system is not operating 35 3.1.2 change the Readout Mode while an exposure loop is running 36 3.2 Image Cube 36 3.2.1 Setup parameter for Image Cubes 36 3.2.2 How to obtain an Image Cube 36 3.3 Test Mode 37 3.3.1 Example of Test Mode execution 37 4 REFERENCE 39 4.1 Functions 39 4.1.1 fcdCheckSetup 40 4.1.2 fcdGetCIName 42 4.1.3 fcdGetConf 43 4.1.4 fcdGetIndexFromId 44 4.2 Programs 44 4.2.1 Command Definition Table for program fcdconCI 44 4.3 Scripts 45 4.3.1 fcdInstall.sh 46 4.3.2 fcdDcsStart.sh 47 4.3.3 fcdDcsWarmStart.sh 49 4.3.4 fcdDcsStop.sh 51 4.3.5 fcdDcsDbSave.sh 53 4.3.6 fcdDcsScan.sh 54 4.3.7 fcdosScan.sh 56 4.3.8 fcdDcsWcs.sh 58 4.3.9 fcdDcsSetLogMask.sh 59 4.3.10 fcdDcsSlcuHalt.sh 60 4.3.11 fcdDcsSlcuReboot.sh 61 4.4 GUI classes 61 4.4.1 fcdExpStatus_uifClass 63 4.4.2 fcdIpStatus_uifClass 64 4.4.3 fcdExpSetup_uifClass 65 4.4.4 fcdReadoutSetup_uifClass 66 4.5 Include files 66 4.6 Database 67 4.6.1 Example for DATABASE.db file 67 4.6.2 Example for USER.db file 68 4.7 Setup files 69 4.7.1 Example for complete FIERA CCD DCS setup file 69 4.8 Image files 71 4.8.1 Example of FITS primary header 72 4.8.2 Example of FITS secondary header 72 4.9 Log files 73 4.9.1 Example of FITS log from a Scientific CCD 73 4.10 Error messages files 74 5 INSTALLATION GUIDE 75 5.1 General 75 5.1.1 Copyright 75 5.2 Supported configuration 75 5.2.1 Hardware 75 5.2.2 Software 76 5.3 Contents 76 5.4 Problem Reporting/Change Request 76 5.5 FIERASW Installation 76 5.6 Configuration of the Instrument workstation 77 5.6.1 Environment variables. 77 5.6.2 Users to be defined 78 5.6.3 WS Environment 79 5.6.4 Real Time Display 80 5.6.5 Setting source mask for FITS logs 81 5.6.6 Files needed for CCD operations 81 5.6.7 Scan System configuration 82 5.7 Configuring the FIERA SLCU 82 5.7.1 Changing Basic TCP /IP Configuration 82 5.7.2 Environment Variables 84 5.7.3 Configuring the "fcdrun" user 85 5.7.4 Adding the "Instrument User" 85 5.7.5 SLCU Environment 86 5.7.6 SLCU Logging System Configuration 87 5.7.7 Rebooting and Halting the SLCU 87 5.8 CCD Camera Installation Verification 88 5.8.1 Checking the Connectivity between the SLCU and the DSP board 88 5.8.2 Checking the Connectivity between the WS and the SLCU manually 88 5.9 CCD Software Operation Verification 90 5.10 Using the FIERA CCD Software 90 6 REFERENCE FOR CHECKING OF THE FIERA CONFIGURATION 91 6.1 fcdAddUser 91 7 ERROR DEFINITIONS 93 8 STANDALONE OPERATIONS 95 8.1 Configuration 95 8.2 Control panel 98 8.3 Engineering Interface 98 8.4 Getting started 100 8.4.1 Simple Demo session 101 8.4.2 SLCU simulated session 102 8.5 Exposure definitions 104 8.5.1 Exposure types 104 8.6 Operational modes and simulation 104 8.7 Operational states 104 8.8 Running the system 105 8.8.1 Starting the control panel 105 8.8.2 Checking CCD camera configuration 105 8.8.3 Setting the operational mode 105 8.8.4 Starting the control software 106 8.8.5 Defining the exposure setups 106 8.8.6 Controlling the exposures 106 8.8.7 Failure reporting 107 8.8.8 Analysing the images 107 8.8.9 Monitoring the telemetry and the temperature values 107 8.8.10 Shutdown of the control software 108 8.8.11 Shutdown of the environment 108 9 STANDALONE OPERATIONS: REFERENCE 109 9.1 Panels 109 9.1.1 fcdCtrl 110 9.1.2 fcdTelemetry 113 9.1.3 fcdOpMode 114 9.1.4 fcdConfig 115 9.1.5 fcdConfigTel 117 9.1.6 fcdConfigMode 119 9.1.7 fcdei 121 9.2 Scripts 122 9.2.1 fcdDemo.sh 123 9.2.2 fcdStart.sh 124
