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 21 2.7 Telemetry Monitoring 22 2.8 Startup 22 2.8.1 Startup verification 22 2.9 Shutdown 23 2.9.1 Powering Down the FIERA SPARC 23 2.9.2 Rebooting the FIERA SPARC 23 2.10 Include files 23 2.11 Command Interface 23 2.12 C libraries 24 2.13 Graphical User Interface CCD classes 24 2.14 Data 26 2.14.1 Data Interface Dictionary 26 2.14.2 Setup parameters and files 26 2.14.3 Image data 29 2.14.4 Public part of the FIERA CCD database 32 2.15 Alarm System 34 2.16 Configuration and operational logs 34 2.17 Example of usage of CCD cameras 35 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 46 4.2.1 Command Definition Table for program fcdconCI 46 4.3 Scripts 47 4.3.1 fcdInstall.sh 48 4.3.2 fcdDcsStart.sh 49 4.3.3 fcdDcsWarmStart.sh 51 4.3.4 fcdDcsStop.sh 53 4.3.5 fcdDcsDbSave.sh 55 4.3.6 fcdDcsScan.sh 56 4.3.7 fcdosScan.sh 58 4.3.8 fcdDcsWcs.sh 60 4.3.9 fcdDcsSetLogMask.sh 61 4.3.10 fcdDcsSlcuHalt.sh 62 4.3.11 fcdDcsSlcuReboot.sh 63 4.4 GUI classes 63 4.4.1 fcdExpStatus_uifClass 65 4.4.2 fcdIpStatus_uifClass 66 4.4.3 fcdExpSetup_uifClass 67 4.4.4 fcdReadoutSetup_uifClass 68 4.5 Include files 68 4.6 Database 69 4.6.1 Example for DATABASE.db file 69 4.6.2 Example for USER.db file 70 4.7 Setup files 71 4.7.1 Example for complete FIERA CCD DCS setup file 71 4.8 Image files 73 4.8.1 Example of FITS standard keywords 74 4.8.2 Example of FITS hierarchical keywords 74 4.8.3 Example of FITS standard keywords (Image Extension per Port) 76 4.8.4 Example of FITS hierarchical keywords (Image Extension per Port) 78 4.9 Log files 79 4.9.1 Example of FITS log from a Scientific CCD 79 4.10 Error messages files 80 5 INSTALLATION GUIDE 81 5.1 General 81 5.1.1 Copyright 81 5.2 Supported configuration 81 5.2.1 Hardware 81 5.2.2 Software 81 5.3 Contents 82 5.4 Problem Reporting/Change Request 82 5.5 FIERASW Installation 82 5.6 Configuration of the Instrument workstation 83 5.6.1 Environment variables. 83 5.6.2 Users to be defined 84 5.6.3 WS Environment 85 5.6.4 Real Time Display 86 5.6.5 Setting source mask for FITS logs 86 5.6.6 Files needed for CCD operations 87 5.6.7 Scan System configuration 88 5.7 Configuring the FIERA SLCU 88 5.7.1 Changing Basic TCP /IP Configuration 88 5.7.2 Environment Variables 90 5.7.3 Configuring the "fcdrun" user 91 5.7.4 Adding the "Instrument User" 91 5.7.5 SLCU Environment 92 5.7.6 SLCU Logging System Configuration 93 5.7.7 Rebooting and Halting the SLCU 93 5.8 CCD Camera Installation Verification 94 5.8.1 Checking the Connectivity between the SLCU and the DSP board 94 5.8.2 Checking the Connectivity between the WS and the SLCU manually 94 5.9 CCD Software Operation Verification 96 5.10 Using the FIERA CCD Software 96 6 REFERENCE FOR CHECKING OF THE FIERA CONFIGURATION 97 6.1 fcdAddUser 97 7 ERROR DEFINITIONS 99 8 STANDALONE OPERATIONS 101 8.1 Configuration 101 8.2 Control panel 104 8.3 Engineering Interface 104 8.4 Getting started 106 8.4.1 Simple Demo session 107 8.4.2 SLCU simulated session 108 8.5 Exposure definitions 110 8.5.1 Exposure types 110 8.6 Operational modes and simulation 110 8.7 Operational states 110 8.8 Running the system 111 8.8.1 Starting the control panel 111 8.8.2 Checking CCD camera configuration 111 8.8.3 Setting the operational mode 111 8.8.4 Starting the control software 112 8.8.5 Defining the exposure setups 112 8.8.6 Controlling the exposures 112 8.8.7 Failure reporting 113 8.8.8 Analysing the images 113 8.8.9 Monitoring the telemetry and the temperature values 113 8.8.10 Shutdown of the control software 114 8.8.11 Shutdown of the environment 114 9 \ STANDALONE OPERATIONS: REFERENCE 115 9.1 Panels 115 9.1.1 fcdCtrl 116 9.1.2 fcdTelemetry 119 9.1.3 fcdOpMode 120 9.1.4 fcdConfig 121 9.1.5 fcdConfigTel 123 9.1.6 fcdConfigMode 125 9.1.7 fcdei 127 9.2 Scripts 128 9.2.1 fcdDemo.sh 129 9.2.2 fcdStart.sh 130
