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 33 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 standard keywords 72 4.8.2 Example of FITS hierarchical keywords 72 4.8.3 Example of FITS standard keywords (Image Extension per Port) 74 4.8.4 Example of FITS hierarchical keywords (Image Extension per Port) 76 4.9 Log files 77 4.9.1 Example of FITS log from a Scientific CCD 77 4.10 Error messages files 78 5 INSTALLATION GUIDE 79 5.1 General 79 5.1.1 Copyright 79 5.2 Supported configuration 79 5.2.1 Hardware 79 5.2.2 Software 79 5.3 Contents 80 5.4 Problem Reporting/Change Request 80 5.5 FIERASW Installation 80 5.6 Configuration of the Instrument workstation 81 5.6.1 Environment variables. 81 5.6.2 Users to be defined 82 5.6.3 WS Environment 83 5.6.4 Real Time Display 84 5.6.5 Setting source mask for FITS logs 84 5.6.6 Files needed for CCD operations 85 5.6.7 Scan System configuration 86 5.7 Configuring the FIERA SLCU 86 5.7.1 Changing Basic TCP /IP Configuration 86 5.7.2 Environment Variables 88 5.7.3 Configuring the "fcdrun" user 89 5.7.4 Adding the "Instrument User" 89 5.7.5 SLCU Environment 90 5.7.6 SLCU Logging System Configuration 91 5.7.7 Rebooting and Halting the SLCU 91 5.8 CCD Camera Installation Verification 92 5.8.1 Checking the Connectivity between the SLCU and the DSP board 92 5.8.2 Checking the Connectivity between the WS and the SLCU manually 92 5.9 CCD Software Operation Verification 94 5.10 Using the FIERA CCD Software 94 6 REFERENCE FOR CHECKING OF THE FIERA CONFIGURATION 95 6.1 fcdAddUser 95 7 ERROR DEFINITIONS 97 8 STANDALONE OPERATIONS 99 8.1 Configuration 99 8.2 Control panel 102 8.3 Engineering Interface 102 8.4 Getting started 104 8.4.1 Simple Demo session 105 8.4.2 SLCU simulated session 106 8.5 Exposure definitions 108 8.5.1 Exposure types 108 8.6 Operational modes and simulation 108 8.7 Operational states 108 8.8 Running the system 109 8.8.1 Starting the control panel 109 8.8.2 Checking CCD camera configuration 109 8.8.3 Setting the operational mode 109 8.8.4 Starting the control software 110 8.8.5 Defining the exposure setups 110 8.8.6 Controlling the exposures 110 8.8.7 Failure reporting 111 8.8.8 Analysing the images 111 8.8.9 Monitoring the telemetry and the temperature values 111 8.8.10 Shutdown of the control software 112 8.8.11 Shutdown of the environment 112 9 \ STANDALONE OPERATIONS: REFERENCE 113 9.1 Panels 113 9.1.1 fcdCtrl 114 9.1.2 fcdTelemetry 117 9.1.3 fcdOpMode 118 9.1.4 fcdConfig 119 9.1.5 fcdConfigTel 121 9.1.6 fcdConfigMode 123 9.1.7 fcdei 125 9.2 Scripts 126 9.2.1 fcdDemo.sh 127 9.2.2 fcdStart.sh 128
