T A B L E O F C O N T E N T S

1 INTRODUCTION 9

1.1 PURPOSE 9

1.2 APPLICABLE DOCUMENTS 9

1.3 REFERENCE DOCUMENTS 9

1.4 ABBREVIATIONS AND ACRONYMS 9

1.5 GLOSSARY 10

1.6 STYLISTIC CONVENTIONS 11

2 OVERVIEW 13

2.1 SYSTEM ARCHITECTURE 13

2.2 IRACE SOFTWARE MODULE 14

2.2.1 IRACE COMMAND SERVER PROCESS 14

2.2.2 SOLARIS DMA ACQUISITION PROCESS 14

2.2.3 IRACE INTERFACE LIBRARIES 15

2.2.4 SIMULATION MODE 15

2.3 THE INFRARED DATA ACQUISITION MODULE 15

2.4 HOW TO BUILD YOUR OWN APPLICATION 16

3 THE IRACE CONTROLLER 17

3.1 PHYSICAL INTERFACES 17

3.1.1 BIDIRECTIONAL PARALLEL PORT INTERFACE 17

3.1.2 SERIAL PORT INTERFACE 17

3.2 PROCESSOR NETWORK 18

3.3 IRACE STATUS BUS 18

3.4 SEQUENCER 19

3.4.1 CLOCK PATTERNS 20

3.4.2 SEQUENCER SUBPATTERN DISPATCHER 21

3.4.3 SEQUENCER PROGRAM LOOP 22

3.4.4 SEQUENCER MODES 22

3.4.5 SEQUENCER RUN-CONTROL 22

3.5 CLOCK AND DC-BIAS DRIVER (CLDC) 22

3.6 ADC CONTROL 23

4 THE PRE-PROCESSOR 25

4.1 SOFTWARE ARCHITECTURE 25

4.2 DMA INTERFACE 25

4.3 ACQUISITION PROCESSES 26

4.4 HOW TO DEVELOP AN ACQUISITION PROCESS 27

4.4.1 BASIC SYSTEM INITIALIZATION 27

4.4.2 THE ACQUISITION LOOP 29

4.4.3 DATA FRAMES 30

4.4.4 PARALLEL PROCESSING 35

4.4.5 USER DEFINED COMMANDS 36

4.4.6 DOWNLOADING OF DATA-SETS 37

4.4.7 COUNTER RESET AND EXPOSURE END FLAG 38

4.4.8 REAL-TIME PERFORMANCE 38

4.5 COMMAND INTERFACE 39

4.6 DATA INTERFACE 39

5 IRACE INTERFACE LIBRARIES 43

5.1 TCOM INTERFACE LIBRARY 43

5.1.1 SEQUENCER FUNCTIONS 43

5.1.2 CLDC FUNCTIONS 43

5.1.3 STATUS BUS FUNCTIONS 43

5.1.4 GENERAL STATUS FUNCTIONS 44

5.1.5 SYSTEM SERVICES FUNCTIONS 44

5.1.6 INTERACTIVE MODE FUNCTIONS 44

5.2 SDMA-INTERFACE LIBRARY 44

5.2.1 SDMA ACQUISITION 44

5.2.2 COMMAND INTERFACE 45

5.2.3 DATA INTERFACE 46

6 INFRARED DCS 47

6.1 INFRARED ACQUISITION LIBRARY 47

6.2 CONTROL SERVER BASE CLASS 47

6.3 EVENT HANDLER CLASS 47

6.4 INFRARED ACQUISITION CONTROL SERVER 47

6.4.1 INTEGRATION TIME 49

6.4.2 SETUP COMMAND 49

6.4.3 READ-OUT MODES 50

6.4.4 WINDOW 50

6.4.5 EXPOSURE CONTROL 51

6.4.6 DETECTOR MODES 52

6.4.7 FRAME SELECTION 52

6.4.8 NAMING OF DATA FILES 53

6.4.9 FITS HEADER 54

6.5 DATA TRANSFER BASE CLASS 54

6.6 SERVER EXTENSIONS 54

6.7 IMAGE POST-PROCESSING 56

6.8 BURST MODE 56

6.8.1 RAW DATA MODE 57

6.8.2 INTERNAL BURST MODE 57

6.9 GRAPHICAL USER INTERFACE 58

6.10 START-UP 60

7 CONFIGURATION FILES 63

7.1 SYSTEM CONFIGURATION FILE 64

7.2 DETECTOR CONFIGURATION FILE 65

7.3 DEFAULT SETUP FILE 66

7.4 VOLTAGE SETUP FILE 67

7.5 CLOCK-PATTERN SETUP FILE 68

7.6 IRACE LOOP STRUCTURES 69

7.6.1 IRACE LOOP DEBUGGER 71

8 ENVIRONMENT SETTING AND INSTALLATION 73

8.1 HW AND SW REQUIREMENTS 73

8.2 ENVIRONMENT VARIABLES 73

8.3 IRD PACKAGE INSTALLATION 73

8.4 MANUAL SOFTWARE INSTALLATION 74

8.4.1 SOFTWARE INSTALLATION ON ULTRA-SPARC 74

8.4.2 SOFTWARE INSTALLATION ON IWS 76

9 INTERACTIVE MODE 77

9.1 PRE-PROCESSOR INTERACTIVE MODE 77

9.1.1 PROCESS STARTUP 77

9.1.2 IMPORTANT COMMANDS 77

9.2 TCOM INTERACTIVE MODE 77

9.2.1 PROCESS STARTUP 78

9.2.2 IMPORTANT COMMANDS 78

9.3 MACRO FILES 79

9.4 SEQUENCE FILE 79

9.5 DIRECTORY STRUCTURE 79

10 REFERENCE 81

10.1 COMMAND DEFINITION TABLE (CDT) 81

10.2 iracqEVH CLASS 91

10.3 iracqDTT CLASS 96

10.4 iracqDTT_EVH CLASS 99

10.5 iracqDTT CLASS 101

11 EXAMPLES 103

11.1 CONTROL SERVER EXTENSION 103

11.2 DATA TRANSFER TASK EXTENSION 112

Quadralay Corporation http://www.webworks.com Voice: (512) 719-3399 Fax: (512) 719-3606 sales@webworks.com