Home

Cassegrain Echelle Spectrograph CASPEC

1. es UD we Owe ww UD P M a Sees C So C NAM MOVE RS 810423 Move uords 4 From address B To address N Number of 16 bit words MOVE NOP CALL HOVE A B N Rp SAP VIP GAP Ap ap D p emm c ae aX C SUBROUTINE MYNAM NAME CCD Get programs name pb HED CONVERSION GENERAL SUBROUTINES NAM CONV 7 T 3B AP dE AB AE eH 9E EES HF HE HF HF EEE E 30 14 4 EGE EE 36 30 38 HE 4 96 3 9E 4 9 ee CONVERSION SUBROUTINES dm a M M AP M ne J T o ENTRY POINTS 4 SRORIRGEGEGIIGE GNI GE JE E GR CI1AS INTEGER SIMPLE PRECISION TO ASCII CIZAS INTEGER DOUBLE PRECISION TO ASCII 4 CFIAS FLOATING SIMPLE PRECISION TO ASCII CFZAS FLOATING DOUBLE PRECISION TO ASCII CIZF1 INTEGER DOUBLE PRECISIGN TO FLOATING DFLT gt CF1I2 FLOATI
2. VD OR QU UD wea Re initialise F s MAINTENANCE Status Terminate f Pora 8 fi Observation Displays the Observation menu second level f2 Telescope setting Displays telescope coordinates Should the link with the TCS system not work these ara the last coordinates got Editing is not possihle here but will he possible when an exposure 1 started should the link still fail f3 Display parameters Displays the Display parameters menu second level f4 Help Provides explanatory text for softkeys in a given menu f5 Re initialise F s All or a subset of the functions are initialised Z en CAMAC Worth using if something goes urong with motors instead of terminating CASPEC and restarting it again f Maintenance Activates the Maintenance Menu second level f7 Status Checks all CASPEC motors against the uanted positions and displays Status of calibration lamps and shutter It takes some timo to get the encoder values from CAMAC particularly for those motors which are not initialised as encoder values are then read directly from the encoder NIM module During CCD exposure the Status key in the CCD menu has to be pressed twice to get full status displag so by making sure that there are at least 30 secs before exp end one is sure not to introduce delays in the closure of shutter f8 Terminate Control is passed to program COMBI while CASP is
3. ES MAINTENANCE MANUAL The Software of the Cassegrain Echelle Spectrograph CASPEC 00 011 j j 0 000 rn DUO TED T gum PY Wi 7 Jl i 1 3 ipu T iuf ini j Mui imn ni m 1 MAINTENANCE MANUAL The Software of the CASSEGRAIN ECHELLE SPECTROGRAPH CASPEC G RAFFI July 1984 Page 7 10 12 22 15 17 22 34 26 30 31 33 8 0 0 34 35 36 37 38 39 4 1 1 11 13 13 16 18 23 23 27 30 32 TABLE OF CONTENTS INTRODUCTION 1 CASPEC 1 1 The Data Acquisition System 1 2 The CASPEC user Station 2 OPERATION 3 INSTALLATION 4 CASPEC TESTS 4 1 Installation tests 4 2 Troubleshooting 5 MAINTENANCE PARMG operation 6 CASPEC SOFTWARE STRUCTURE 6 1 Program CASP 6 2 Program CPENG 6 3 Interface with CCD 6 4 Interface with IHAP 6 5 Interface with CRTO5 and COMBI 6 6 Program TCINT 7 TEST PROGRAMS 8 CASPEC and REMOTE CONTROL 9 CASPEC FORMS AND SOURCES 10 COMPUTER READABLE DOCUMENTATION ll REFERENCES FIGURES 1 CASPEC and the data acquisition system 2 CASPEC softkey menus 3 Offset for decker 1 4 Offset for decker 2 5 Scheduling mechanism of CASPEC 6 CASP CCD dialog APPENDICES A CASPEC User Interface
4. O off lzon OsZeeman i quartz 2 neon 3 Hg 4 Fe Ne 5 thorium O no lamp 34 encoder value O 2047 96 encoder value O 2047 ON OF ON OF appropriate function table CASSEGRAIN ECHELLE SPECTRO FUNC Description Valu F 1 Neutral filter 11 3 Colour filter 9 Calih filter n on 11 Photometric filter toiriotols Calib switch OF Pre slit decker 0 Slit vidth 390 micron Decker 1 half width nmn n n n n m o Oo d NM Decker 2 half width 10 Rear slit viewer 12 Calib source 13 Cross disp tilt 7 14 Collimator position 14 19S Hartman mask 1 OF 18 Hartman mask 2 OF nm m mn 0 Must he within limits of F10 CASSEGRAIN ECHELLE SPECTROGRAPH Exposure definition FORM O Rel sequence O Ossingle exp 1 8ssequence Exposure typo RE REsregular FF CCD flat f DKzdark c NO no CCD zNo F s mode Exposure time O O 1 hours O 8 mins O 59 secs 0 59 Tape recording 1 OzQff 1 IHAP format 2 FITS format Sequence number for IHAP 38 Identifier CL 223311 500 INSTRUMENT SETTING Light source 9 O STAR 1 S calibration lamps 1 quartz 2 neon 3 Hg 4 Fe Ne 5 thorium Slit width 300 microns or 2 0 arcseconds Slit length 700 microns or 4 8 arcsoconds Central wavelength Lambda O SOO nm 300 1100 Lollimator focus encoder abs value 1496 0 2047 Neutral filter O 0 5 Colour filter o 9 9 Calibration filte
5. OP LB OP DC prevent multiple copies OP CP current page linking LI 4IOLIB CP 85 LI AFMLIB CP OS LI XMOTOR CP 85 LI ZRCAM 32766 SL following modules use local named common RE ACASP CP 85 49 RE XCPENG CP SE XMDVMS CP 85 SE 4 CP SE 4ZMOTS CP 85 SE XGETAL CP 85 BE XCKSEQ CP 85 follow modules do not use common SE LINKP CP 85 SE SCPRG CP 85 SE amp ASKMT CP BS SE 466 5 SE XEVALS CP 6S SE XNEWPSZ CP 85 SE ACACAM CP BS SE 4TCST CP 85 SE 4CALNA 5 SE XLATST CP 85 SE 102 69 CP 85 SE XPARFG CP 85 SE 1 CP 85 SE XRUPRG CP 85 SE GETSK CP 85 SE XMTHWT CP 85 SE 4CKIOL CP 89 SE XMOTGT CP 85 SE XWTMOT CP 85 SE XPMSG CP 85 SE CEXP CP 85 SE XCMDHS CP 85 SE XDFORM CP 8S SE XPRTST CP 89 following modules use local named common SE AGTFUN CP BS SE XMOVM CP 85 SE 4FILTW CP 85 SE 4CODCK CP 85 SE 4TLCUM CP BS SE 41IPT7 CP 85 SE ACVF 76 CP 85 SE 4UPD13 CP 85 SE 4WKEYS CP 85 SE 4GTGRV CP 85 SE APRTPS CP 85 follow modules do not use common SE 00 CP BS SE MOVE CP 8S SE XASKFN CP 85 SE SHUTT CP 85 c3 85 85 85 65 85 85 85 CP CP CP CP CP CP CP 78 SE LIGHT SE GTMPS SE CKWPS SE KCNARC SE XIHPCM SE XIACTF SE 4TIMCV SE 0614 SL SE END Appendix D
6. Sidereal time 1 TELESCOPE SETTING HH mm ss Right ascension 23 47 45 Airmass 900 13 FORM MTBF Hours gigi luly tables F14 History hours 3 mins date DD 15 15 15 15 13 CASSEGRAIN ECHELLE SPECTROGRAPH 31 485 Total exposure time with CCD Total number of exposures LAMPS of erp s Total exp time Install Hours mins YY MM 83 6 83 6 83 6 83 6 83 6 9 0 0 0 0 0 61 Q9 9 33 CALIBRATION Lamp No 1 quartz e Neon d Hg 4 Fe Ne S thorium ESO suggested for G1 April 27 1983 FITS Keywords list of keywords has been following Appendix G The instruments and detectors INSTRUMENTS Description Keyword Name of instrument Grating blaze angle Grating groove period Camera focal length Color filter number Neutral density filter Slit width Slit length Collimator focus encoder position Central wavelength Hartmann mask position Calibration lamp number DETECTORS Description INSTRUME BLAZANGL GRATFREQ CAMRLEN FLTRNR NDFLTR SLITWDT SLITLEN COLLPOS WAVELENG HARTPOS LAMPNR Keyword Name of detector type Name of detector Type of exposure dark curr flat field Mean temperature of detector Temperature drift during exposure Time of bias light exposure Total dark current time Status of detector and data acquisition DETTYPE DETNAME EXPTYPE DET
7. adapted from B Gustafsson RMES SUBROUTINE MTWT MSBUF IADR ITO IER LU Wait for msg from motor controller GR Note msg takes some 10 20 msec to return so the wait time before first and second attempt should not be bigger than SO msec ITO timeout in seconds SUBROUTINE MTSKP MSBUF IADR IMSGF IER LU Skip any msgs from motor contr GR SUBROUTINE MTPAR MSBUF IADR NMOT ICODE IER LU sk info on motor i GR SUBROUTINE MOTCK IADR NMOT IPOS MCODE IER LU Check motor position GR SUBROUTINE MOTMV IADR NMOT IPOS IER LU Move motor to position GR oO0o00000 oOO00000 aaaaan aaaana agqagaaaanaa aaaan Connect motor first in case it was disconnected SUBROUTINE MBLCM MSBUF IADR IER LU Send block or single cmd to motor GR adapted from B Gustafsson SCOM M8YTS considered only for block parameters write cm A t RD OO UD OS e AED UD s Uum wee UA UD UD a m SUBROUTIN amp MBLRD MSBUF IADR IMSGF IER LU Read single or block msg from motor GR copes with block read SUBROUTINE RDENC IADR NMOT IEABS IER LU Read encoder value OR Reads from hardware registers in two bytes encoder velue 3 bits in upper byte for 11 bit encoder Parameters IADR CAMAC def s NMOT of motor 1 4 IEABS
8. amp 80o0oo0o0o0oo REGUIREMENTS CAMAC USAGE Should be called to check if CAMAC is on line DESCRIPTION Checks the driver status and puts the driver up if it was doun The CAMAC controller status will be checked and if it is off line a warning message will be given without putting doun the driver 1 821025 i 1 0 CCD common suppressed QR l SUBROUTINE GETEG LUSES 168 IER LU Get EQT numb for given session LU QR 830614 C C e c ED OP qe UP VP GP UP GP ee DP c SUBROUTINE CKIOL LUQUT LUIN IER Check I O LU s direct or class I 0 GR 830614 C C Parameters LUOUT Output LU for direct I O is also input LU c LUIN Input LU O for direct I O c for direct I O set to LUOUT on output 2 3 Other subroutines SUBROUTINE TIMCV ZZ IH IM IS IT Convert secs into hh mm ss tens GR B30609 converts real into HH mm ss t hours mins secs tens of sec original version La Silla DH FG oo000 3 Installation Once the relocatable modules are available the library DAGLB GR 75 is created by running the MERGE utility with the DAGLB 75 commands file Command file for MERGE to create DAGLB 75 purge before Program to progra
9. A copy of it is given in Appendix D This file is meant to give temporary information and might vary with version and or installation 5 Follow then the test and troubleshooting procedure given in the next section Complete installation Like partial installation but step 1 must include the loading of the DAQ system and possibly IHAP IHAP loading is generally done with the transfer file LIHAP 100 for the La Silla IHAP The IHAP version should be June 83 or later For more information on IHAP refer to file GIHAP The DAQ system and CCD programs can be loaded via TR 5 Then follow the instructions for partial installation 13 4 CASPEC TESTS 4 1 Installation tests The following description shall be followed systematically in the case of a new CASPEC installation It might of course be of use also for troubleshooting in particular cases Test IHAP installation From instrument console SL 12 logon as IHAP or RU IHAP 12 Using a test image test graphic terminal plotter and Ramtek eg DRES TSTIMG TRAN 41 810 Test graphic terminal PLOT Test plotter CURS Test graphic cursor KDIS 1 Test Ramtek KCOO KTAB GE COLOl COL10 Have a look at colours This is normally enough to test the IHAP peripherals A RAMTEK stand alone test which you can run without IHAP is available on CR 85 CASPEC TRAMT To load it RU LOADR CP 85 XTRAMT 85 It displays a number of gradu
10. B The CASPEC Programs C Loader Command Files CASP CP D CASP account welcome file HICP E Troubleshooting user level F CASPEC tables forms parameters G FITS keywords for instruments detectors ENCLOSED DOCUMENTATION DAQLB library documentation by G Raffi A B MOTOR library documentation by G Raffi IOLIB library documentation by G Raffi C ADDITIONAL DOCUMENTATION not enclosed CCD documentation by P Biereichel CRTO5 interface by P Biereichel COMBI interface by P Biereichel PARMG user guide by B Gustafsson Communication protocol 4 channel motor driver by B Gustafsson Communication between instrument and CCD program by P Biereichel I Available in form of TPE notes collected in the Data Acquisition System Folder from ESO Garching TPE group INTRODUCTION The CASPEC control software is installed on a Helwett Packard 1000 21 MX E computer with an ESO standard configuration 256 Kw of memory 50 Mbyte disc CAMAC crate 1600 bpi magnetic tape unit under the RTE 4B operating system The CASPEC instrument is at present available at the 3 6 m telescope This description refers to features of CASPEC package version 2 0 Oct 83 tapes 831026 Possible following revisions will be notified in the Welcom file displayed when users log on as CASP In June 84 the CASPEC software has been interfaced to the TCINT program at the 3 6 m telescope which copes with the
11. 0 ICLIN class for input via CRTOS ICLOU class for output via CRTOS Moto THIS SUB CAN BE USED ONLY WITH CRTOS NO DIRECT I Q SUBROUTINE PUTPA NSBSET IBUF IFNAM IER ICLOU 1 Put out formiparams no wait GR subroutine used internally by DISPA amp not meant for external usage because CRTOS is not prompted for input and the sequence of actions on CRTOS must be completed outside SUBROUTINE PACHK NSBSET IBUF IFNAM IPTR IER ICLIN ICLOU Read param s to be checked GR Meant to get parameters and then pass then back for check I sthg is wrong an error should be printed INISL 23 ICLOU CA _L PRTTX H Value out of range valid range is 1 1024 ICLOU and then PACHK should be called again with IPTR pointing to invalid field to read again Should the params be correct then PACHK has to be called with IPTR O to exit form mode 6 Q000000000000000 ecOOO0O000000500 eo000 000 The first time PACHK is called with IPTR 1 Displays a form with the parameters contained in IBUF and then reads back the possibly updated param s in same buffer After PACH A INISL line no ICLST should be called again to restore status line initialisation for IOLIB Parameters NSBSET subset number IBUF buffer for params IPTR field where cursor should point to it is assumed that form and params are already on screen 0 16 then exit form mode all OK i
12. abs encoder value read via hardw registers IER err if 0 LU LU FOR error msgs SUBROUTINE MTERR IADR NMOT IERCD LU Print motor commnds errors GR adapted from B Gustaffson PRERR subroutine used by MBLCM to give immediate error messages due to the structure of commands as they are detected by motor controllers SUBROUTINE WTMOT MOTD IPOSS MMSK ITMS IDSCS IER LU ICLST Wait for active motors positions GR PARAMETERS MOTD 16 4 CAMAC definitions for 4 motor controller IPOSS 16 mpositions for 16 motors motors 1 16 corresp to mot contr 1 4 MMSK zmotors mask bits 0 15 lt gt motors 1 16 ITMS 16 timeouts for motors corresp to motors 1 16 says which motors should be waited for IDSCS 165 sflags to leave motors connected or disconn IER merror flag err ifWO negative motor no 1 16 LU output LU for errors aaaaana aoaannan 0 0 e amp 0000005 0005 0 856 0 0000 Oo0000 000000000020 C NOTE Subroutine useful to wait for up to 16 motors to reach position C once they have been initialized or moved in parallel C Used by CASPEC c C C am m i m OO 9 Um wi 4 A Am P m Oe p m woe wow C SUBROUTINE ASKMT LCAMC NMOD NMOT IENP IAXS ISW I ILU IO
13. entries is class number word 1 program name 2 4 time of entry year 5 day seconds 7 8 SUBROUTINE CLRLS ICLASO IER Release a class number PB GAR V1 1 GR Original version by RS 810901 CLRLS does the reverse of CLGET It de allocates the class number and removes its entry from the log file CL NO SY For comments see HP Communicator Vol II issue 6 page 9 SUBROUTINE CLEAN GNUMCL IER Clean class numbers V1 0 GR adapted from CCRLS by P Biereichel used in CCD output parameter NUMCL number of class numbers actually released O for none SUBROUTINE CLRED IILU ICLAS LLBUF IP1 IP2 Start class input from term GR STARTS CLASS READ FROM IILU TERMINAL USING CLASS NUMSER ICLAS IP1 TYPICALLY USED TO MARK ORIGIN OF MESSAGE THIS IS USEFUL WHEN WAITING FOR MESSAGES FORM VARIOUS SOURCES ON A SINGLE CLASS IP1 COULD GIVE CLASS IDENTIFYING SOURCE IP2 TYPICALLY USED TO SAY IF HANDSHAKE IS WANTED CLASS FOR THIS PASSED THEN OR NOT WANTED 0 THEN READ WITH ECHO ON FUNCTION MGET NCLAS IBUF LLBUF IP1 IP2 Class get line GR 0 o00000000 nannan OcOO0000000900000 DOES CLASS GET WITHOUT WAIT ON IILU TERMINAL GETw NUMBER CF CHARACTERS GOT zNEGATIVE NUMBER OF REQUESTS TO CLASS FOR NO MESSAGE SUBROUTINE PUTM NCLAS IBUF LLOUT IP1 IP2 Class put message GR STRTS CLASS 1 0 WRITE READ OF A MESSAGE TO ANOT
14. output LU or class for CRTOS Only valid YE or HO reply acceted else prompt is repeated SUBROUTINE PRTTX IBUF IOLU Print an immediate string QR IBUF THE BUFFER TO PRINT IGLU THE LU TO PRINT ON VEs2NO BUFFER FLUSHING NO OUTPUT NOW SUBROUTINE 18 NCHAR LU Print a string from buffer QR Parameters IBUF buffer with string NCHAR number of char s to print LU output lu or class if negative output is not flushed nou this allous to continue on same line SUBROUTINE PRTTN CIPBUF INUM IRDX IOLU Print text number QR Printing of tert number on same line done with one EXEC call Number printed vith 6 char s including sign Pararmeters IPBUF text buffer no _ but needed for string INUM integer number to print on same line IOLU output LU or class for CRTOS IRDX input radix 8 10 16 if negative no flushing at end this allous to stay on same line SUBROUTINE PRTNM CINUM IRDX LU Print an integer with given radix GR The number of digits chosen for decimal conversion depends on o0000 oOoO00000 0505 000000 aQ00000000 o0O0O000000no0 oco000009000000000500 the value to print sign is printed only for dec negative numb Parameters INUM integer IRDX input radix 8 10 16 LU output LU or class SUBROUTINE PRTEXCIBUF LU Qutput string with prefix GR Otherwise identical to PRTTX Normally used to prefix error messages SUBROUTINE PRTEN CIBUF
15. 85 CASPEC sources not libraries can be listed via TR ELIST 85 38 10 COMPUTER READABLE DOCUMENTATION To list these files use utility PR RU PR Name CR 1 CASPEC user interface Appendix A file CPUSR CASPEC software troubleshooting Appendix E File CPHLP 7 CAMAC documentation and tests Files CAMAC and TCAM CCD file CCD CRTOS file CRTOS COMBI file COMBI DAQLB file DAQLB Motor library file MOTOR IOLIB file IOLIB GIHAP Installation of IHAP IMGOl IHAP manual text 39 11 REFERENCES Cassegrain Echelle Spectrograph ESO User s Manual Cassegrain Echelle Spectrograph ESO Technical Report Part 1 The new Data Acquisition System for ESO instrumentation The Messenger Dec 83 IHAP manual by F Middelburg ESO June 83 Appendix A Al CASPEC USER INTERFACE SSSEIITIIEICIE GEJTIEIIOE 3E 20 28 235 35 3238229 30 The CASP program interfaces with the user via a 2 levels structure of Menus While the screen layout is that foreseen by the Terminal Handler interface the various menus are displayed at the top of the screen and the 8 white fields correspond to the 8 function keys of an HP2645 terminal MAIN MENU OBSERVATION Telescope setting DISPLAY PARAMETERS Help fi am em an am f2 ee a ee eee a me mm ic 22 AD PRD DE 4 cam cm am Qu cub
16. Garching or E Allaert in La Silla 3 Motor test programs The motor test programs TMOST TMINI TMOST can be run in stand alone mode directly from a terminal or in the DAQ environment under CRTOS Furthermore they can be run with run time parameters from console or from another program or interactively uhen no parameters are specified They make use of the libraries 4MOTOR XIOLIB 4DAGLB To load or reload them the transfer file TMOTR 75 should be used but if CASP is installed on your system these programs are already vailable 5 1 Motor status TMOST PROGRAM TMOST Check status of DC motor GR 830309 PARAMETERS PAR 1 sSLU for direct I O Class for output via CRTOS default LOGLU PAR 2 sCAMAC LU default 60 FAR C3 where NMODsCAMAC N for mot controll PARC4 amp zNMOTsnumber of motor in this motor contr 1 4 PARCOS O for direct I O Class for input CRTOS 00000000 IOLIB 83 8 28 15 24 8 TECHNICAL NOTE TPE GR 830826 2 1 GC Raffi ESO Garching PROGRAM TMINI DC motor with abs serial encoder GR 830530 Init works with dc motor 11 bit ser encoder PAR 1 mLU for direct ItO Class for output via CRTOS default LOGLU PARC2 sCAMAC LU default 60 P4R 3 NMOD CAMAC N for motor controller PAR S mO for direct I O Class for input CRTOS PARAMETERS o000000000 5 3 Motor handset control TMHND PROGRAM TMHNO Motor handset control GR 830311 PARC1 mLU for di
17. IN IB LU Output string number with prefix GR Otherwise identical to PRTTN Normally used to prefix error messages m a Uu SO ub ED OO Oe D UD UD D n FUNCTION INP IPBUF 18 ILEN IILU IOLU Prompt for input string GR Parameters IPBUF prompt buffer i input wanted on same line terminate with else with IBUF input buffer ILEN no of chars in input buffer for input actual no of chars read on return IILU input LU or class via CRTOS IOLU output LU or class via CRTOS INP return the actual no of input char s SUBROUTINE REDDG IVAL IRDX TERR IBUF IDGS Read number from ASCII buffer GR IVAL THE RESULTING INPUT VALUE IRDX THE INPUT RADIX IERR 0 for error e g non numeric character read IBUF THE INPUT BUFFER ID3S THE NUMBER OF DIGITS IN input buffer agqaaqaanna aaqaa amp aa OO00000 c amp OoO00909 0000500 0000 o00000000 2 2 Class I O subroutines SUBROUTINE CLGCET ICLAS IER Get a class number V1 0 GR original version RS 810901 CLGET Allocates a class number and logs it to a disc file adapted from HP Communicator Vol II isuue page 3 Up to 31 8 uord entries are stored in file CL NO SY 1 4 after copy of the most recent entry in which the first word is set to the number of entries The format for the other
18. as they were left last time CASP was used unless of course they were modified via PARMG 497 6 2 Program CPENG Control of CASPEC functions lamps and shutter is all done from the CPENG program via CAMAC The CASPEC functions associated with 15 DC motors and 13 encoders Hartmann masks have no encoders are listed in table 8 functions set up see Appendix F The control actions are normally started by a request coming via class I o from CASP but autonomous checks are also performed like in the case of a periodic check on the motor positions every 60 secs during long exposures to verify that they are in position All communication between CPENG and CASPEC is via CAMAC The modules used are 4 ESO motor controllers capable of driving 4 motors each One I o register to drive the shutter One I o register to control calibration lamps and function codes readout The following table summarizes the commands and replies accepted and returned by CPENG via class I o R CASP CPENG PROTOCOL CPENG reply On reply to every command A 3 words buffer is returned 2HOK with IBUF 1 lt or 2HER IBUF 2 IZDON 0 if CAMAC Z was not done and or needed again 1 if Z was done Furthermore a status line message is output on the instrument console with status of motors lamps and shutter except for IN command IBUF 3 contains echelle and cross disperser function codes in upper lower byte Z is done
19. directly from a terminal or be scheduled within the DAG environment The way the subroutines make the distinction betueen direct output end CRTOS output is by looking at the LU received if it is 2255 then class output via CRTOS is wanted Output can also be sent to the status lines of CRTOS by passing the corresponding class number However in this case an additional info is needed by CRTOS namely the line number This is passed by an initialization Subroutine INISL The set of class subroutines are used by the I O package but are available to class I O communicate with programs They are recommended in place of EXEC calls for the degree of extra portability that program has e g changing machine would mean substituting the subroutines rather than changing the whole code A group of subroutines deal with tables forms parameters providing a simple interface to CRTOS which supports these functions In this group the DFORM subroutine is an exception as it provides direct table display The reason for putting it in this library is that it seems general enough to be used by e g Instrument programs to display auxiliary tables on the IHAP graphic terminal when IMAP is not used 1 List of subroutines The IOLIB subroutines are grouped in 4 sections uhere they are listed according to the source files structure with modules ordered from higher to lower level subroutines The list does not include internally used subroutines which are
20. either from CCD CASP or from the user via COMBI A program called IHAP2 can also be installed for test purposes The relevant files for IHAP2 are available on CR 85 It can be run e g from the system console and passes commands to IHAP once this has been scheduled by CASP via COMBI So two users can in principle work on the same database at the same time Note however that while the main IHAP is suspended during CCD data readout from CAMAC as this is timing critical the same does not apply to program IHAP2 So its usage is recommended as 8 debugging tool but not for normal operation Interface with CRTO5 and 7 The protocols with these programs are described both in computer readable documentation and in the additional documentation E and F 6 4 6 5 2733 When COMBI is scheduled at start up time by CASP it does not take control of terminal This happens though when CASP is terminated via the Main Menu Terminate softkey When this is pressed CASP does not terminate yet but simply gives terminal control to COMBI and keeps waiting for commands in class I o COMBI at this point displays its own top menu containing the softkeys CASP CCD IHAP and Terminate If Terminate is pressed then COMBI informs all active programs in the environment that they have to terminate CASP in particular terminates CPENG before exiting as for COMBI there is only one instrument program CASP and it does not know of the existence of CP
21. f having done all this and restarted CASP this still misbehaves e g giving LU errors terminate it and type EX exiting your session Logging in as CASP reassigns all logical units and might fix the problem and LAST E2 Rebooting the computer is the extreme remedy Enter date on system console and wait up to end of bootup procedure before logging on at CASPEC console as CASP However this uill not help fixing problems uith CAMAC or peripherals F1 Aonendix F CASPEC TABLES Filter uheels calibration lamps Slit and deckers Rear slit viewer collimator cross disperser CASPEC LU s and CAMAC stations Cabling and function codes Spectral table History table Instrument status Instrument set up Instrument engineering set up Exposure definition Summary of exposures Telescope set op e INETALLATION TABLES read only for user 3 4 6 11 13 USER DEFINED TABLES set up under CASP F2 CASSEGRAIN ECHELLE SPECTROGRAPH Instrument status FORM CASPEC 3 6 m telescope installation Detector mounted COD RCA Camera SHORT focal lenath 281 mn Gratings cross disperser grooves mm 300 blaze angle 43 echelle grooves mm Q blaze angle 0 INSTRUMENT SETTING Light source 5 O ST amp R 1 9 calibroation lamps 1 quartz 2 neon 3 Hg 4 Fe Ne 5 thorium Slit width 309 microns or 2 0 arcsoconds Slit length 799 microns or 4 9 arcseconds Central wavelength Lambda SOO nm 300 1
22. in upper byte e g LH amp to be prefixed to any following output O binary O deletes prefix for following output SUBROUTINE PRMPT IPCHR Gives a default prompt for ASCII input GR Note to be used with func call INP for following input PARAMETER IPCHR character in upper byte e g 1H amp to be prompted as default for input O binary O deletes prompt for following input SUBROUTINE RDIN CIPBUF INUM IRDX IMIN IMAX I1 ILU IOLU Read with prompt integer in a range GR The text IMIN IMAX is added to the prompt string The prompt is repeated up to when valid input is got The IMIN IMAX text is not added if IMINxIMAX Q The validity check is not performed on input if IMINDSIMAX Printout of min max IPSUF and check are skipped also for non dec input prompt buffer _ to get inp on same line integer value input radix 8 10 16 min value accepted for INUM fax value accepted for INUM input LU or class for CRTOS INUM IRDX IMIN IMAX IILU Parameters oO 000030 00050000000 o00000000 e amp Y00000000on0 oO 00000000000 IOLU output LU or class for 95 SUBROUTINE ASKYN IPBUF IANS I ILU IOLU Ask for Yes No reply GR The text YE NO is added to the prompt string The prompt is repeated up to when a valid input is received Parameters IPBUF prompt buffer no input is from same line IANS x first to letters or reply YE or NO IILU input LU or class for CRTOS IOLU
23. n1 HICP B3 8 29 16 15 8 4 IH DP mhJ a 15C dBWelcom to use the CASPEC spectrograph amp de 4 DP The DAG system works with IHAP June B3 ESO standard 2301 system DP This has to be run from the instrument console Logical unit 12 DP 4 connection to CAMAC helps to get the CASP main menu displaied DP but having got CAMAC you do not need CASPEC to get a feeling of hou DP the program works the computer though will be frustrated DP DP An on line HELP key on every menu level telis you hou CASP works DP DP To try CASPEC without CCD and without IHAP use RU CASP 1 DP To do partial tests try TCAM TMINI TMOST TMHND CPCKS CCTST CCD IKAP DP in order of increasing complexity DP DP For off line LU changes e g initial error on LU s and CASP aborted DP run PARMG on form file FOCP CP 33 but cuidado DP To abort type ZCP from system console and logon again as CASP DP To continue with a normal CASPEC session type TR TR 1 SYTO 13701 TOxO on IHAP graphic terminal SYTO 12 0 TOO on instrument console 75 TR RPCASP 2 RU CASP SYOF TCINT 1 75 TR OFCASP 2 OF IHSPL 5 EX Appendix E E1 CPHLP 83 8 29 16 14 TROUBLESHOOTING PROCEDURE FOR CASPEC A frequent problem is the occurrence of the message Ready LU 17 meaning that the graphic terminal is stuck Hit the RETURN key on the g
24. not via CRTOS no class allowed C C The form is simply left on screen all time 2 4 Other subroutines SUBROUTINE TIME IYR IDY SEC RS G10509 Get year day and seconds IVR lt Year IDY Julian day of year SEC Time of day in seconds floating NAM TIMA 7 RS 810217 Convert time or angle to ASCII TIME lt gt Time or angle in seconds floating BUF 12 char ASCII string like 275 086 89 3 4t TIMA NOP CALL TIMA TIME BUF C n a a A SO ae ar a VP VP um ub UA m FUNCTION NDSEC INIT Gives time difference in secs GR C C Gives integer number of seconds elapsed from C reference time C Parameters C INIT O count delta from nou C pass back in NDSEC elapsed secs C C om ap Qu A a a A ae e A e ee 18 6 ED e e e a e au D WP hp qup VD UAR aD ub Gub eee C NAM DAT 7 RS 810216 Convert year day to ASCII YEAR lt gt year JDAY Julian day BUF 1C character ASCII string like 16 FEB 81 DAT CALL DAT CIYEAR IDAY IBUF 3 m UD S
25. to allow easy portability of detector packages like CCD among various instruments and of instrument packages among different telescopes The main components of the DAQ system as used by CASPEC are visualized in Fig l and are described below 7 The CCD software sets up and monitors the CCD detector via a microprocessor controller It executes exposures on demand and stores acquired data on disc and tape 175 kwords per image The CCD package is now implemented to be completely portable among different instruments and is clearly the kernel of every CCD based instrument 7 The CAMAC NIM motor controller systems capable of controlling 4 motors per module handle the motor encoder loops for the 15 DC motors of CASPEC in a variety of configurations circular and linear movements motors with and without encoders They are an essential component at the border between software and instrumentation electronics a The terminal handler program is instead dealing with the DAQ software at the user end side It implements and controls access to the user screen by several programs supporting function keys and forms at a high level A generalized version of the parameter manager program used by CES to access parameter tables is also part of the DAQ system Communication among programs is via ASCII messages and to this end a number of interfaces have been defined Instrument Detector DAQ system telescope control system DAQ system IHAP Th
26. 0 530 Max aperture Closed 1567 i 2 600 offset 700 full closed Decker No 2 Absolute encoder values Fig 4 A value of 600 for the offset is appropriate as it falls in the forbidden region and allows to have relative values well inside the range 0 2047 However in this case the offset absolute value is higher than the absolute encoder value at max aperture This means only with reference to fig 5 that the start point of the linear movement is now the full closed position In other words the mounting of the decker is such that increasing encoder values lead to movements in the max aperture direction The arrow indicates the direction of the linear movement i e the direction of movement when relative values increase Table 4 refers to functions rear slit viewer collimator cross disperser Hartmann masks and echelle The rear slit viewer although physically a wheel is seen by software as a linear function as there is a forbidden range in the rotation Collimator and cross disperser are linear functions No values have to be filled in for the Hartmann masks as there are no encoders for them and they simply move from one electromechanical limit to the other upper lower limits The echelle position is adjusted manually and not used by CASPEC as there is no computer control of this function For more information on the mechanical structure of functions please refer to the CASPEC Technical Manual Part 1 Compl
27. 00000 00005000000000000 00005050 0 055 00000000 Parameters FPNAM GS 21 3 ASCII file name of param s file FPNAM A msecurity code FPNAM S CR NSBSET subset number according to PARFG IPBUF input buffer of right size IER error return flag err if 0 LU zlu for errors SUBROUTINE PINFO NSBSET NOFRM NOREC LGREC IFNAM IER LU Get info on form GR IFHAM 5 contains form file name sec code 5 file is open once first time PINFO is called agagaanadaanannan aaqaan SUBROUTINE PARFG INAM LGPAR PDIC DATE PNUM 1686 Parameter table configurator BG C CDOC QC 3 E HE Ae EMERGERE EE AE EAE EE AE EAE AE EE EAE EAE E E E AE H AE EAE UE UE EAE AE E EIER E ERE ERE NAME PARFG SUMMARY Returns information about parameter file format BY Birger Gustafsson ESO GAR DATE 11 00 AM WED 4 MAY 1983 KEYWORDS PACKAGE 1 0 and Class I O subroutines REQUIREMENTS disc DESCRIPTION The program returns record number and word count of the parameters for each form in the form file Number of forms are also returned It also returns the record with creation date and last update date O00000000000000000000000000570000 00005 00000755005000000000000000 INPUT INAM File name of forms file Format word 1 3 file name word 4 security code word 3 cartridge number LGBUF Length of parameter dictionary buffer 2 times the number of forms requested OUTPUT 66 Parameter
28. 100 Colliaator focus encoder abs value 1496 0 2047 Neutral filter 9 0 9 Colour filter o 0 9 Calibration filter o 9 9 Photometric filter o 0 9 Rear slit viewer o Qzof f Laon 22Zeeman F3 CASSEGRAIN ECHELLE SPECTROGRAPH Filter wheels calib lights FORM O2 There are equispaced positions where pos O2no filter Offset for posit O is adjustable 0 2047 11 bit ser encoder OFFSET Filter No s Timeout 99 secs Neutral filtor 979 12345 10 Colour filter 396 1 2 3 4 5 10 Calibration filter 2013 12 3 4 5 10 Photometric filter 80 129345 5 Calibration switch wheel Offset for star 1582 Offset for lamp 197 Timeout 5 99 secs 10 Calibration source wheel Offsets for O blind pos 1 quartz 2 neon 3 Hg 4 amp sFe Ne 5 thorium 150 698 1402 1202 417 964 Timeovut S 99 secs 10 FORM O3 6zall over 323 250 947 399 10 width coeff 22 817 micron encod unit F4 CASSEGRAIN ECHELILE SPECTROGRAPH Slit and deckers table PRESLIT DECKER Positions G all out 1 2 3 4 789 616 41 4645 394 Offset 0 2047 0 Timeout 5 99 secs 10 are driven by sane motor Position when closed SLIT hoth sides Max aperture positon 2mm Offset 0 2047 Timeout 5 99 secs Total Seeing coeff 144 micron arcsec DECKERS No 1 up and No 2 down Closed Max aperture Offset Decker no 1 1584 500 90 Decker no 2 1567 330 600 Timeout
29. 5 99 secs 10 Nne decker width coeff 213 34 micron encod unit F5 CASPEC 4 Rear slit vioewer collimator cross disp FORM 04 REAR SLIT VIEWER QN position 1344 0 2047 CFF position 16 0 2047 Zeaman position 1750 0 2047 Offset 1200 0 2047 Timeout 10 5 99 COLI IMATOR Low end position 95 0 2047 Top end position 1907 0 2047 Offset O 0 2047 Timeout 30 5 99 CROSS DISPERSER i Position at blue end 1643 Position at red end 123 0 2047 Offset 0 2047 O Timeout 5 99 9 Coeff A B C TLEA BsLOeC LOs 2 Ti cr disp tfilt LOzcentral wavel with short camera A 1369 87304 B 1 27083 6 Q0000 F10 9 with long camera A 1369 87304 B 1 27083 Q0090 F10 5 HARTMAN MASKS Timeout 30 5 99 ECHELLE Position 550 0 2047 manual adyustement F6 4 CASSEGRAIN ECHELLE SPECTROGRAPH LU S and CAMAC table FORM OS General installation parameters Telescope identifier 3 6 3 6 2 2 Detector mounted 1 1 CCO 2 Photographic plate O none Canera 1 1 short 281mm 2 long 550mm LOGICAL UNITS System LU for CASPEC I O terminal LUSCP O Omany LU ok CR ref number for auxiliary files ICPCR 33 CeMAC LU for CASPEC crate LCAMC 46 LU for link with TCS Osno link LUTCS 26 CAMAC STATIONS 7 Status register station NRSTS 1 Shutter rogister station NSTSH 12 Motor controller 1 station NMOT1 14 Motor controller station NMOT2 15 2 Motor controller 3 station NMQT3 14 4 station N
30. AMAC in read write and DMA TMOH Move Hartmann mask Ti4HND Use handset on motors Appendix C C1 CASP T 200004 IS ON CROOO01 USING 00005 BLKS R 0000 0001 Transfer file to load CASPEC package assumes DAG and CCD loaded COO2 to load DAG CCD use DAGCC 75 0003 OF 0004 OF CPENG O005 RU LNADR CP 85 XCASP 85 0006 PU CASP CP 3 0007 SP CASP CP 3 O008 RU LOADR CP 85 XCPENG 85 ds PU CPENG CP 3 10 SP CPENG CP 3 0011 following is TCINT program for 3 4m TC340 0012 0013 DR TC360 85 0014 PU CINT CP 3 0015 s6 TCINTNCP 0016 RU LOADR PARMG 95 0017 PU PARMG CP 3 0018 SP PARMG CP 3 0019 type TR to re load all of them 002 to tables CR 33 O21 tables to tables oo22 tables are updated else use ST instead of DU cmd O023 DU PACP 85 PACP CP 33 0024 DU FOCP 85 FOCP CP 33 0023 4 DU SKCP 85 SKCP CP 33 0026 OF CPCKS 0027 RU LOADR CP 85 XCPCKS 85 0028 PU CPCKS CP 3 0029 SP CPCKS8 CP 3 0030 OF TMINI 0031 RU LOADR CP BS XTMINI 85 0032 PU TMINI CP 3 0033 SP TMINI CP 3 0034 OF TMOST 0035 RU LOADR CP 85 XTMOST 85 O038 PU TMOST CP 0037 SP TMOST CP 3 0038 OF TMHND 0039 RU LDADR CP BS XTMHND 85 0040 PU TMHND CP 3 0041 SP TMHND CP 3 0042 E 16 18 54 c2 ecP g3 8 29
31. As said before during long exposure a self check on motors position is enabled every 60 secs Motors must be at wanted encoder value 1 in order to be considered in position If an error occurs this is made clear to the user in the compound status line on the instrument console but no active action is taken i e the exposure continues CASP itself does not know of this at this stage CASP is notified of occurred failures only at exposure end and then it will warn the user and ask that functions are re initialized The exposure done is not lost When a user sees in the status line that an error occurred during an exposure he can simply press the status softkey under CCD to know more CCD sends a status request to CASP and this in turn passes it to CPENG Full information on function positions is given on status request Interface with CCD The CCD program is described in the CCD additional documentation D by P Biereichel The interface instrument CCD is fully described in the additional documentation I CASPEC makes use of the protocol defined there to handle commands to and from CCD The CCD program takes control of the instrument terminal and displays its own menu once it receives the start exposure command EX It gives back terminal control at exposure end 6 3 31 Fig 6 shows how the dialog between CASP CCD and IHAP at exposure time CASP CCD DIALOG Book space for CCD image data to disc COMM writ
32. DES D APPEL JSB CF1AS S P 58 CF2AS D P DEF 4 RETURN ADDRESS DEF VALUE FLOATING POINT VALUE DEF BUFAS BUFFER ASCII RIGHT JUSTIFIED DEF FORMT DISPLAY FORMAT BITS O A 7 TOTAL OF CHARACTERS BITS 8 A 15 DECIMAL CHARACTERS 4F HF 4F IEEE HF HF YF HF dt IEEE 3E 4E HF 4E CE 9E 9E E E EE AE E U 4E 30 4E 434043733094 A dE 4E 4E dB de AE HE HE amp X kk k ik ES EU AE IE HF 4 4F E0334 HF 360 3E EHE HE EE 9E EE EIE E EAE 4 HF HE He E 4E AE E IEEE HE E OU F 309 HF EE HF E HF HF 3E N D P INTEGER 4s FLOATING MODES D APPEL JSB CI2F1 INTEGER D P gt FLOATING DEF 3 RETURN ADDRESS DEF INTGR DOUBLE PRECISION INTEGER DEF FLOAT FLOATING POINT JSB CF112 FLOATING gt INTEGER D P DEF 3 RETURN ADDRESS DEF FLOAT FLOATING POINT DEF INTGR DOUBLE PRECISION INTEGER DLD INTGR 4 B NOMBRE DOUBLE PRECISION JSB DFLT A B NOMBRE FORMAT FLOTTANT DLD FLOAT A B NOMBRE FORMAT FLOTTANT JSB DRND A B NOMBRE DOUBLE PRECISION X X X E E ok x ik X X ik ik dt 36 3E 3E 4 4E HE 4 3E 36 4E 00 30 4 E31 4E 4E 9 4E 4E 9E 4 4F 9 1100 HE 4 HF ae 4E 3 4F HF 4 0 9 9E 4E a 4F 4E 4E 4 4 library XIOLIB GR 75 i
33. DFORM Direct display of form params GR 830715 1 4 Other subroutines em em ae OOS UD URP cm Se CAD e ee Gun ee ee UD ee UND AED SUD ee AD ee e ee e o TU ee e e OD e m en ee m TIME TIMA RS 810217 Convert time or angle to ASCII NOSEC Gives time difference in secs GR 830128 DAT RS B10216 Convert year day to ASCII OVE RS 810423 Move words MYMAM CCD Get programs name pb 820401 CONV 2 Subroutine calls 2 1 I O subroutines SUBROUTINE INISL LINST ICLST Set up status line number GR Used to inform the output subroutines of a given status line number associated to the class number for status ICLST 1 ICLSTC255 this has no effect Following calls to PRTTX PRTBF PRTNM PRTTN PRTDG OUT will direct output to the line LINST if the LU they indicate mICLST otheruise output will go to the rolling part of the screen or to LU directly if LU lt C255 Parameters LIMST line number for status line Must be within per locked part of screen ICLST status class number for terminal handler up e e ee GU wees Cup um Uum e UD m AUD OO BOWE SO UU ED OUS emp CONS OOO lt SUBROUTINE PREFXCIPCHR Prefix all cutput with special character GR PARAMETER IPCHR character
34. E Detector and instrument programs 000000000000 000000000070050000 REQUIREMENTS Program COMBI INSTALLATION USAGE Must be the first executable statement in the program DESCRIPTION CRASH FLAG 40 CRASH OCCURED INPUT MAILBOX OF COMBI CRTOS STATUS MAILBOX CRTOS INPUT MAILBOX CRTOS OUTPUT MAILBOX IHAP INPUT MAILBOX STATUS LINE 1 STATUS LINE 2 calling program PARAMS 20 word buffer 1 ICRASH 2 ICLOT 3 ICLSTS 4 ICAPQS 5 ICOSAP 6 ICLIHI 7 18T81 8 ISTS2 IPARM CIPARM C IPARM CIPARM CIPARM IPARM IPARM C IPARM ICLMY Input class for IPRGNR Program for calling program ml if father program ICLFTH Class of father program IPRFTH Program of father program CALL LINKP PARAMS ICLMY IPRGNR ICLFTH IPRFTH INPUT OUTPUT CALLING SEQUENCE SUBROUTINE IHPCM ICMD NB ICLASS ICLIHI ICLQU GR 830827 IHAP The IHAP command contained in ICMD LengthzNB bytes is sent to the mailbox ICLIHI The program waits until it gets a prompt from IHAP via the mailbox ICLASS Send msg to DESCRIPTION AANQANANAAIANANANAIAAANAAAAN aaaqaqaa 2 2 Equipment handling subroutines SUBROUTINE CKCAM LUCAM IER LU Check CAMAC GR 830615 c C NAME CKCAM SUMMARY Check CAMAC driver and CAMAC crate on line c BY Peter Biereichel 8 c DATE gt 11 41 AM THU 3 JUNE 1982 PACKAGE CCD program 0o000000090000 0550 05
35. ENG The Top Menu of CASP allows to use once more IHAP So IHAP can be called from 3 different Menus of 3 different programs CASP CCD and COMBI In all three cases the same IHAP menus are displayed this is the reason to manage the whole interface with IHAP in COMBI If the CASP softkey is pressed CASP takes again terminal control and displays its top Menu The previous initialization is still valid and the user can carry on with CASP operations However the main reason apart from termination to go to the COMBI menu with the Terminate key is probably to use then the CCD softkey This gives terminal control to the CCD program which will display its top menu This is equivalent to use CCD in stand alone mode and makes available to the user all the Menus and softkeys of CCD This way of working might be practical for example to change CCD tables with PARMG under CCD while working with CASPEC This occurs for example when a different binning factor on CCD is wanted Once CASP has given control to COMBI the only commands it expects back is either to terminate IP1 1 or to continue In this last case the same menu which was on the screen when terminal control was given up by CASP is displayed again This situation occurs not only when the Terminate softkey was pressed but every time an exposure ends As explained in the section about CCD interaction CCD receives terminal control when an exposure is started and displays its own P
36. HER PROGRAM LLOUTsNUMBER OF CHARACTERS TO OUTPUT FUNCTION MNAIT ONCLAS IBUF LLBUF IP1 IP2 Class wait for line GR DOES CLASS GET WITH WAIT MWAITSNUMBER OF CHARACTERS GOT SUBROUTINE PTPAR NCLAS 161 IP2 Pass ipl ipa params via class I O GR Passes a dummy buffer and IP1 IP2 params in class 1 0 SUBROUTINE CKCLS ICLAS IER Checks for valid class number GR Useful when a subroutine executes only under CRTOS as preliminary check e g uhen ICLAS O typing error resulting in non initialised variable a neu class number might be allocated and the error would possibly go unnoticed in this section of program Oo0000 o000000 Q00000000 Oo0000000 2 3 Table handling subroutines SUBROUTINE DISPA NSBSET IBUF IFNAM IER ICLIN ICLOU Display form amp params from memory GR Parameters NSBSET subset number IBUF buffer with params IFNAM name of form file TER error flag error if 0 ICLOU class for output via CRTOS Note THIS SUB CAN BE USED ONLY WITH CRTOS NO DIRECT 1 0 It is assumed here that params are already in CASPEC mem tables having been got previously from disc via SUBROUTINE REDPA NSBSET IBUF IFNAM IER ICLIN ICLOU Read updated param s in buffer GR Displays a form with the parameters contained in IBUF and then reads back the possibly updated param s in same buffer Parameters NSBSET subset number IBUF buffer for params TER error flag error if
37. LES CR 33 take following precautions 1 List installation tables on printer via PARMG It is useful to have old values in mind in editing and good to keep a hard copy of previous values in case of troubles later on To get tables listing quicker you can use PARMG on each table or a transfer file like PFORM 85 2 Copy PACP FOCP from CR 33 to temporary files so that you keep a back up copy during testing of the new tables The tables concerned with installation parameters are 2 3 4 5 6 13 Some general points refer to the three installation tables 2 3 and 4 Please note that all the encoder values expected are always the absolute encoder values though internally CASPEC uses relative encoder values for linear functions The valid range is 0 2047 given that 11 bit serial encoders are used The timeout value between 5 and 99 secs must be long enough to allow for the longest possible function movement e g from min to max position but not much longer than needed as positioning errors are given only at the end of the timeout time 19 Once functions reach the wanted encoder value the motor controllers are operated by CASPEC in two different ways depending on function either the motor is left connected or it is disconnected and left disconnected even if position is lost In the first case the function is kept in the wanted position all the time The second solution is instead preferred when one does not
38. LU Ask parameters for motor GR C C Works with direct I Q or CRTOS I Q C isusO for all params C isusi for all params but no encoder and no axis value C iswe2 for all params but no axis value C C Note Refers to subroutines of library XIOLIB C Used in test programs TMINI TMOST TMHND 3 Installation Once the relocatable modules are available the library XMOTOR GR 75 is created by running the MERGE utility with the MOTOR 75 commands file Transfer file for MERGE to create XMOTOR GR 75 purge beforehand AACHST 75 AMBLST 75 MBLIN 75 ZOTZ 75 IMOTIN 79 MOVLM 79 MTCOM 79 XMTRED 75 MTWT 75 MTSKP 75 X MTPAR 75 MOTCK 5 MOTMV 75 MBLCM 75 MSLRD 75 XRDENC 5 0 5 UTMOT 785S ASWMT 79S When XASKMT is used the library IGLIB is needed as well at load time 4 Maintenance To maintain the library by modification of existing modules or addition of new ones follow these steps 1 Compile appropriate modules 2 Modify MOTOR GR 75 for MERGE 3 Build with MERGE new MOTOR 4 Edit all changed sections of this document MOTOR GR 75 5 To list this RU PR MOTOR 78 1 Laportant NOTE Given that existing programs use MOTOR backwards compatibility must be maintained Furthermore MOTOR must be the same on all installations For this reason it is advisable that uhen you have subroutines to contribute you do it in agreement with either G Raffi in
39. MOT4 17 Motor controller F7 CASSEGRAIN ECHELLE SPECTROGRAPH Cabling and F codes table FORM O FUNCTIONS 1 164 0 8 4 7 B 1 16 FUNCTIONS 9 2 1 3 Contr 2 motors 10 12 13 Contr 4 motors 13 15 16 14 15 11 multiple codes CODES 1 31 F 2 Calib switch dth no 2 iewer sources ator nn msk2 31 for F s with F 6 Slit wi F S Decker F 10 Slit v F 12 Calib F 14 Collim F 16 Hartma CABLING vontr 1 motors 1 4 Contr 3 motors 9 12 FUNCTION 1 Neutral filter 3 3 Colour filter 16 7 Decker no 1 7 F F F S Preslit decker F F 9 Calib filter 1 F 11 Not used 25 F 15 Hartmann msk1 24 CODES O no more 1 F 4 Echelle Codes 20 32 qraoves am hlare angle 63 4 22 300 F 13 Cross disp Codes grooves mn blaze angle 4 3 INSTRUMENT SETTING Light source 5 O STAR 1 calibration lamps 1 quartz 2 neon 3 Hg 4 Fe Ne 9 thorium Slit width 300 microns or 2 0 arcseconds Slit length 703 microns or 4 8 arcsoconds Central wavelength Lambda 0 SOO nm 300 1100 Collimator focus encoder abs value 1496 0 2047 Neutral filter 0 Q9 Colour filter o 0 5 Calibration filter o 0 9 Photometric filter o 0 35 Rear slit viewer o Qaof f Laon 2 Zeenan F9 GRAPH Functions set up FORM 8 gt e 0 9 0 9 0 9 0 9 ON OF star Omall out 6smax width sor 2 9 arcseconds 350 k
40. MTEMP DETDTEMP DETBLTIM DETDKTIM DETSTAT DAGLB 8G3 8 28 15 2 TECHNICAL NOTE TPE GR 830827 18 Edited by G Raffi ESO Garching DAGLB library 830827 7 lt lt G Raffi ESO Garching Update history Preliminary collection GR 830827 Library of subroutines in the Data Acquisition System Environment INCEX Introduction l List of subroutines 1 1 Program to program communication 1 2 Equipment handling 1 3 Others 2 Subroutine calls 2 1 Program to program communication 2 2 Equipment handling 2 3 Others 3 Installation 4 Maintenance Introduction This library is intended as an expandable library of subroutines with the aim to help and make faster the development of programs within the ESO Data Acquisition System All programmers are strongly encouraged to contribute their portable subroutines to this library The initials on the header line are not necessarily the ones of the author of the original version stealing and readaptation of subroutines is in fact encouraged with the aim of saving time and making as many subroutines as possible available to the programmers community You are also invited to use some form of standard header describing the subroutine calls as standard programming practice This will also make easier the documentation as you can simply merge the top part of your subroutines into this document i List of subroutines SCPRG Check PRG
41. NG TO INTEGER DOUBLE PRECISION DRND omm M n 4 AUTHOR PH ROSSIGNOL DATE JANUARY 1979 48 4 4e 4 46 4 4 3 3E TELE gt gt OH HF 9 30 4646 46 36 90 4E t 46 4E 96 464 46 4 4 46 46 4648 4 46090 40 46 40 AP 4E dt HE 40 40903096 36 4 AE 3E 3E AE AE AE AE MEAE 3E E ME 9443 4E AE HF de 4 4 4 39 AE AE AE EAE IE a J AE EIE AE AE IE AE EE a HEAR 4E EAE AE AE IE ARE CONVERSION INTEGER mmm ASCII EBSSSSSESSES GCEGLDGE IDIIGECTCISGRGDIEQIGE E GE 7 IS 2 2 2 2 GE SOS GEGEND D 02 GE E NE GS CE GO MODES D APPEL JSB 145 S P gt JSB CI2AS D P DEF 4 RETURN ADDRESS DEF VALUE INTEGER VALUE DEF BUFAS BUFFER ASCII RIGHT JUSTIFIED DEF FORMT DISPLAY FORMAT CHARACTERS ee KEE A Ae EAE 4F 4F IEEE 3 1E HE t lt HF EE EAE A EE 4F EE AE EAE HF EE EAE EAE E EAE EAE 4F 4 de E 3t 3e 3E Je M AE AE AE JE AED IE HF E 6 JF HF E HF A FF 4E 4E IE HE HF HE EE EE JF a a 4F a ae E IEEE EE E 4F dt 4F de dt HF 4 4F C CONVERSION FLOATING 9 ASCII iiO
42. ally changing vertical colour bars according with the last look up table loaded in the RAMTEK RU TRAMT n with n number of consecutive displays wanted It is assumed that IHAP and all its segments have been restored RP by the welcom file at boot up time Test CCD installation RU CCTST This allows to test CAMAC Le Croy modules link with microprocessor and temperature controller Check CCD installation tables RU PARMG answering form file CCDFO PB 75 parameters files CCDPA PB 75 Has Table 1 contains LU s and CAMAC stations used RU CCD CCD used in stand alone mode a run CCTST hardware tests softkey under CCD Should this fail after CCTST has succeeded in stand alone mode the reason might be due to wrong information in the installation table of CCD Enter debugging commands like 22 IN OK 11 DFREO00010 Define exposure of 10 secs OK EX Start exposure DONE During exposure the CCD message with the remaining exp time should appear and at end data should be recorded in IHAP database Have a look at directory etc with IHAP eg DLIST 1 WCOMM l For more information on CCD installation and troubleshooting see enclosed documentation D Test CASPEC installation Check CASPEC installation tables RU PARMG answering form file FOCP CP 33 parameters file PACP CP 33 Files FOCP PACP SKCP should be on CR 33 A copy of them ex
43. ause Exposure Menu At exposure end CCD gives back terminal control to CASP However this passing and receiving terminal control mechanism is handled by COMBI i e CASP tells COMBI to give control to CCD and at exposure end CASP receives by COMBI a command to proceed and d splay again its previous menu The purpose of COMBI should now be clearer it allows and controls terminal access to the instrument and detector programs and handles common data acquisition functions TCINT program TCINT handles the interface with the telescope control system In the present installation of CASPEC at 3 6 m telescope TCINT deals with the 3 6 m telescope control system based on 77 45 via the Suter link CASPEC does not have any active control over the telescope The link is only used to retr eve right ascension declination and sidereal time for every exposure Should CASPEC be installed on a different telescope the TCINT program will have to be the appropriate one for that telescope However CASPEC will not have to be changed at all as the interface instrumentation software TCINT is instrument and telescope independent TCINT has never control of the instrument terminal nor displays any message on it 6 6 7 TEST PROGRAMS The test programs used by CASPEC are stand alone programs which can be run directly e g from system console or under CASP via the Maintenance Menu function keys The maintenance Menu i
44. be gt 4 4 mot per module so that in case of error the motor number is correct e g motor 13 failed Houever internally it is transformed into MMOT motor no between 1 4 modulo 4 SUBROUTINE MOTZ IADR NMOD IER LU _ Initialise motor controller module GR Initializes motor controller CAMAC Z not assumed before as this subr will be repeated for every motor controller module but hopefully not Z ASSUMES THAT 4 Z ON CAMAC HAS BEEN DONE e m ee wwe Ow Cee ewe Uum dip cp 4p eee m ee SUBROUTINE MOTIN IAOR MOTN IENP IGF ISOLO ISOFU IAXS IPAFG IER LU Move motor to initial position GR adapted from B Gustafsson RTCAM MOTN contains a motor number In principle it can be 24 4 mot per e amp 0000000000 onana e 000000000000000000 o000000000 0000 module so that in case of error the motor number is correct e g motor 13 failed However internally it is transformed into NMOTzmotor no between 1 4 modulo 4 SUBROUTINE MOVLMCIADR MOTN INITY ISPED IER LU Move motor no encoder to hardu limit GR adapted from B Gustafsson RTCAM SUBROUTINE MTCOM MSBUF IADR IER LU Send command to motor GR adapted from B Gustafsson SCOM SUBROUTINE MTRED MSBUF IADR IMSGF Read msg from motor controller GR
45. commands to CCD described under CCD operation Switching on and off calibration lamps and shutter operation via CPENG ON OFF follow respectively to the shutter open and shutter close commands from CCD this last is given even for dark exposure After data have been written by CCD into the IHAP database CASP writes instrument parameters into the IHAP header see later under IHAP operation Program PARMG is scheduled by CASP in the Maintenance Menu to allow changes in installation tables The recommended way is however to use PARMG off line to this end CASP is not in control of the instrument console during exposures and IHAP usage During exposures CCD gets terminal input In a sequence of exposures as CCD is not aware that this is a sequence control is passed back to CASP via COMBI at every exposure end However CASP disregards terminal input in this phase and starts immediately the next exposure passing then control again to CCD The only way to abort a sequence is therefore to abort an exposure in a sequence under CCD control The CASPEC logic dealing with CCD IHAP TCINT communication is explained better in the next sections All CASPEC tables are saved at termination in file PACP The original idea was to create different sets of tables where users could save their configuration for next run This was tested but it proved simpler and better to use only one set of tables Next time CASP is started the tables are read from disc
46. corresponds to a no filter position Given that there are 5 other equispaced positions on the filter wheel defined by the sense of rotation one has to fill in the filter number corresponding to each position For the meaning of filter numbers refer to table 11 where neutral and colour filter numbers are defined The calibration switch wheel and the calibration source wheel have instead a number of not predefined positions to go to The blind position of calibration source wheel is basically any position far away from a lamp It is used while doing a star exposure to avoid stray light coming in even if the calibration switch wheel is obviously set to star 0 Table 3 refers to functions Preslit decker slit and deckers These functions are linear for the motor controller software as the encoder can only move within a range of values while mechanical limits prevent it to go into other positions The meaning of offset in this case is rather special and deserves a detailed explanation Offset evaluation for linear function Let us take a decker as an example It is a function with an eccentric drive which allows it to move between a minimum and a maximum position Assuming to work with the handset for the determination of the limits one has to work out the valid range of the function The limits obtained are the physical mechanical limits of the function and are not the values to put into the table In particular for deckers
47. ction l List of subroutines Subroutine calls 2 J Installation 4 Maintenance 5 Motor test programs 1 Motor status TMOST 5 2 Motor initialisation TMINI 5 93 Motor handset control TMHND Introduction This library is a by product of the development of CASPEC So chile on one hand is quite suitable to the softuare Data Acquisition Sytei of ESO and tested under the CASPEC conditions it does not intend to be good for all applications In particular the initialisation subroutines do refer to DC motors with absolute serial binary encoders They can easily be adapted to other cases Initialisation subroutines do exist in two versions normal initialisation MOTIN block initialisation faster MBLIN The subroutine MOVLM moves DC motors without encoders against limits he motor test programs TMOST TMINI TMHNO are used by CASPEC but they are stand alone test programs uhich can be used whenever the motor controllers are used In particular TMOST and TMHND do not refer to any particular type of motor or encoder and so should be completely general 1 List of subroutines MCNST Check motor controller status GR 830614 MBLST Get block status from motor controller GR 830614 MBLIN Move motor to initial position GR 830614 MOTZ Initialise motor controller module GR 830614 MOTIN Move motor to initial position GR 830717 I OVLM Move motor no encoder to hardw limit GR 830308 MTCOM Send conmand to motor GR 830614 MTRED Read msg from moto
48. e CCD info in A IHAP header Write CASPEC info in IHAP header MSAV WFIT write data to tape Fig 6 is implemented Define exposure Start exposure Open shutter Close shutter Done asynchr reply ICOM 32 Interface with IHAP IHAP see references is scheduled by COMBI in the Data Acquisition System environment on CASP request COMBI displays also the IHAP softkey menu All commands to IHAP are via COMBI terminal CRTO5 COMBI IHAP When the user presses the softkey IHAP either under CASP or CCD these programs pass terminal control to COMBI which delivers user commands to IHAP via class I o and displays replies on the rolling part of the instrument terminal IHAP is terminated only when CASP exits not with the TERM command IHAP shares its database with CCD see QSPA command to understand how space is reserved for CCD images The WCOM command is used by CCD to record CCD information in the IHAP comment area The ICOM command is used by CASP to record CASPEC information in the extended directory The directory itself is filled in both by CCD and CASP The format in which the information is recorded is by using a structure of FITS keywords as listed in Appendix G Subroutine WKEYS of CASP implements the dialog with IHAP to store this information The default format for tape recording is IHAP but FITS is available as well In short IHAP receives commands
49. e IHAP data processing system is used for on line data reduction IHAP has now been extended with new commands to handle echelle data June 83 version IHAP runs independently but within the DAQ system and shares its data base with the CCD program so that data are written only once to disc The CASPEC and CCD programs are implemented in such a way to make remote control feasible i e they are split in two parts one with the user interface and logic the second with the CAMAC operations which can be installed on two different computers and can exchange messages via a link CASPEC and the data acquisition system SOFTKEY MENUS OF CASPEC Instrument console Terminal Handler Test Programs Telescope Control Interface SOFTKEY MENUS OF CASPEC OBSERVATION Telescope Setting DISPLAY PARAMETERS Help MAIN MENU Display Change Lamps Test Filter Slit exposure sequence Help parame shutter CAMAC Help Wheel deckers Help ters eee tab tab Previous Move Check Handset Previous sequence Status Menu Motors Motors move Menu OBSERVATION MENU MAINTENANCE MENU DISPLAY PARAMETERS MENU Functions Spectral Previous Menu Note Softkey labels are in capital letters when another menu is called Fig 2 10 1 2 The CASPEC user station It consists of n instrument console HP 2645 for user I O An auxiliary console HP 2648 used either to display CASPEC additional forms
50. ete information on the motor controllers protocol is given in the additional documentation H Table 6 tells instead how the functions are connected e g function 9 connected to Contr 1 motor 1 Controller numbers are in turn associated to CAMAC stations by table 5 ay ae Table 6 contains also a code for each function The code is a switch selectable 5 bits configuration set up on the function side of CASPEC This is used to check on line that functions are connected in the right place For every function CAMAC is read and the value obtained compared with the one given in this table to prevent illegal functions exchange e g by a wrong cable connection Function codes are unique for each function but echelle and cross disperser might have more than one valid code This allows CASPEC to differentiate between echelles and cross dispersers of different characteristics so that the correct function characteristics can be recorded on tape in the data headers The last installation table history table 13 gives statistics on the usage of CASPEC Its purpose is to help to assess when calibration lamps need replacement Note also that as total exposure times are expressed in hours and minutes it might happen that lamps which are exposed for very few seconds never get any minutes reported This is because every time CASPEC is exited the rounded value of minutes is stored and the fraction is lost The relevant information in this case is t
51. f lt O it is assumed that form and params are not yet on screen initialisation call negated value of field to point to IER error flag error if 0 ICLIN sclass for input vie CRTOS ICLOU class for output via CRTOS Note THIS SUB CAN BE USED ONLY WITH CRTOS NO DIRECT 1 0 SUBROUTINE GETPR FPNAM IFNAM NSBSET IPBUF IER LU Get from disc form parameters GR Get parameters associated with subset see PARFG code for a definition of subset REQUIREMENTS Parameters data file corresponding to formss file must have been built with PARMG parameters manager off line program Every form has an associated data record in the parameters file identified by a subset number Subroutine PARFG of PARMG and PINFO allow to retrieve from a subset number the corresponding form no location and size of data record in the perameters file INPUT FPNAM name of params file amp CHARS one word with SC one word with CR IFNAM name of form file NSBSETsnumber of subset according with PARFG IPBUF wbuffer for erpected parameters IPBLL length of parameters buffer must correspond exactly to CASFG info QUTPUT IER Q no error sino subset found m2 mismatch between params buffer length length of CASFG given in IPBLL lt O FMP error IPBLL sactual length read possibly different from input if error detected SUBROUTINE PUTPR FPNAM IFNAM NSBSET IPBUF IER LU Put form parameters into param s file GR O0000000000000o000000 Oo0
52. file dictionary Qutput format word 1 record number for parameters for form number 1 word 2 number of parameter words in form 1 word 3 record number for parameters for form number 2 word 4 number of parameter words in form 2 word 5 record number for parameters for form number 3 word number of parameter uords in form 3 A nonexisting form gives record number 1 and number of words 0 PNUM Number of forms DATE Record number for creation and update date Record format word 1 creation date year word 2 creation date day word 3 creation date hour word 4 creation date min word 35 last update date year word amp last update date day word 7 last update date hour word 8 last update date min IERR Error flag Flag negative file manager error on foms file Flag no error CALLING SEQUENCE CALL PARFG INAM LGPAR PDIC DATE PNUM IERR 0 SUBROUTINE DFORM IFNAM NSBSET 18 IMOD IER LU Direct display of form params GR C C Parameters IFNAM S filename sec code CR C NSBSET sparams subset no C IBUF mbuffer with params c IMOD O normal display cpendclose form file C first display leave form file open C 1 assume form is on screen fill in new params C 2 close form file and clean up c IER zorror flag err if 0 LU direct I O lu
53. h RC have been kept in mind in its implementation This should allow an easier transition to a possible remote controllable version of the instrument software In our case the remote control environment is defined as a connection between two computers one near the user La Serena Garching and one near the instrument in La Silla The CASPEC and the CCD packages have been implemented in a way that makes possible the separation into two parts one near the user and one near the instrumentation in practice near CAMAC CASPEC in fact consists basically of two packages CASP and CPENG The interface between the two programs is simple and very few words are exchanged In a remote control environment the class I o interface will be substituted by a link interface CASP should run together with CRTO5 PARMG etc at the user end CPENG at the instrument end The same applies to CCD where CCD deals with the user interface and DAQ WCHDG deal with the instrument This implementation shall allow Remote Control experiments with lines at a fairly low baud rate At the same time the same high level interface can be offered to the remote user thanks to the fact that Menus and forms handling can be dealt with entirely by the user end computer However further work has to be done both on CASPEC and CCD packages to make them remotely controllable uode 9 CASPEC FORMS and SOURCES CASPEC forms can be listed with command file TR PFORM
54. he total number of oe with that lamp showing how many times it has been switched on and o Once maintenance tables have been created the following is advisable l list new tables on printer 2 save them in a secondary location unknown to user This prevents that he can accidentally alter installation tables using PARMG Only after some time when it is clear that the new tables are correct the copy of PACP and FOCP on CR 85 should be overwritten with tables from CR 33 and kept as a reference set up Tables PACP FOCP are a back up copy referring to the original CASP installation and should never be overwritten We 99 CASPEC SOFTWARE STRUCTURE It is assumed that the reader of this section is familiar with the concepts of the ESO software data acquisition environment The chapter on CASPEC software gives a general overview on the DAQ system components which one Should read before 6 6 1 Program CASP It is the main CASPEC program run by the user when he enters RU CASP Its purpose is to handle the logic concerned with the user interface menus and tables displays It interfaces with the user via the terminal handler program CRTO5 and with CASPEC via the kernel program CPENG CASPEC engine which controls motors lamps and shutter CASP has also links to programs CCD IHAP COMBI and TCINT as explained below Fig 5 gives a global view of the scheduling mechanisms of CASPEC at start time The arr
55. in a suspended state If CASP is re started from COMBI initialisation does not need to be done again MAINTENANCE MENU activated by Maintenance function key Change parameters Lamps shutter Test CAMAC Help f 1 f2 ee F Qe wm mw ee wo we P G a mo m m ao a mo o om ao m o m ae Move motors Check motors Handset move Previous menu F e m a 6 7 f8 fi Change parameters Starts program PARMG to display list or change tables PARMG parameter manager can also be used in stand alone modelon 2649 f2 Lamos shutter Starts 5 program which can control shutter calibration lamps and give a listing of function codes identifiers for funct connectors CPCKS can also be run in stand alone mode f3 Test CAMAC Starts program TCAM which can be run also as a stand alone CAMAC test f Move motors Starts TMINI program to initialise up to 4 motors in a controller Note that after this all other motor controllers will be reset by Z TMINI can also be run as a stand alone motor controller test f Check motors Starts TMOST program which gives encoder readouts and status of all motors connected to a motor controller This program which can also be run in stand alone mode does not affect the posit
56. ions of motors Encoder values are read also if the correspond motor controller is not initialisedsin this case the value is not read from the controller but directly from the NIM encoder module TMOST is a program detached from CASP and does not know whether the encoder values got are the ones wanted or not For a global test on all motors including wanted position check use the Status key f7 Handset ove Allows to use handset on motors and to revert to computer control Really an extreme tool DISPLAY PARAMETERS MENU activated by Display parameters function key Filter wheel tab Slitdeckers tab Collim etc tab Help 1 g 3 4 Motors vs funct s Functions set up Spectral table Previous menu g 6 7 f8 OBSERVATION MENU activated by Observation function key Define exposure Display sequence IHAP Help 1 a P 2 ee 3 mo am 4 on am Start single exp Start sequence Status Previous menu 9 amp yy e f g Note The function
57. ists on CASPEC CR 85 If files are copied from CR 85 to CR 33 CASPEC will use the tables given in TABLES CR 33 under the assumption that this CR is mounted before CR 85 as mounting order CASPEC tables are listed in Appendix F Checks under PARMG l Make sure that header form refers to PACP CP 33 or edit it like this 2 Make sure that LU s and CAMAC modules stations correspond to the description of table 5 In particular the cartridge CR for auxiliary files should be 33 15 Test CASPEC as a whole by logging on as CASP or by running RU CASP on instrument console Possible messages like class deallocated before the Main Menu Display do not indicate a bad installation CASP can be partially tested without IHAP and without CCD by RU CASP 1 A message will appear saying that this is a CASPEC stand alone mode In this case CASP needs only the instrument console If CAMAC is switched off CASP will not proceed after the Main Menu leaving to the user only the possibility to terminate However some limited testing can be done with any CAMAC crate connection without the CASPEC modules This allows a partial installation check on any ESO HP computer with CAMAC As CASP tries first of all to initialize motors it will fail on all of them Then it will ask for the CASPEC functions filter wheels etc to be activated Answering will complete the initialization phase of CASP and will all
58. k to star position after exposure Possibly cal lamp is switched off at shutter closing time 5 Start sequence The same sequence of actions as for single exposure but the calib Switch is moved back to star only at the end of the sequence The current exposure definition is updated on the 2648 screen while the execution of the sequence proceeds A pnendix B Bl CPACK 83 8 29 16 19 b THE CASPEC PROGRAMS THE CASPEC package consists in a set of on line programs which cooperate and form tho so called data acquisition environment DAG They are CASP handles user end and logic of CASPEC CPENS CP engine acts on CAMAC to control motors lamps shutter TCINT Interface program to TCS CCD CCD user end DAG The CCD data acquisition program WCHDG A watch dog program to prevent CCD hang ups COME I A program to connect together instr and detector pack CRTOS Terminal handler to cope with softkeys and forms PARMG Parameter manager to handle CASPEC and CCD tables IHAP Note CCD IMAP PARMG can be used as stand alone programs For PARMG operation remember that the form file name for CASPEC is FOCP CP 33 Off line programs A number of off line programs are also part of the CASPEC package and can also be used in stand alone mode to do various functions They are CCTST Test of CCD CAMAC and link CPCKS Checks lamps shutter function codcs for CASPEC TMINI Motor controller initialization TMOST Motor controller positions TCAM Test C
59. keys Start single exposure and Start sequence give control of the terminal to the CCD program which in turn displays a Menu allowing various options during exposure IHAP STATUS ABORT IHAP also can bo operated by using function keys It is a sequence of menus at same level linked hy the ETC function key The IHAP menus are the same if IHAP is run under CASP or CCD fi Define exposure Definition of either single exposure or sequence of exposures Note When starting CASP the definitions contained in the parameters file are read However the single exposure definition has to be validated before starting exposure by pressing this key Otherwise CASP will not accept to start exposure f2 Display sequence When a sequence of exposures has been defined by the previous softkey and the user has declared that he has no more exposures in the sequence all the existing definitions above the max no A3 of exposures wanted will be cancelled f3 IHAP Calls IHAP already started IHAP cmds can be passed either via rolling screen or using function keys f4 Start single exp Sequence actions Motors are put in position according to definition possibly calibration lamp is switched on Control is passed to CCD program which displays its oun menv Complete info cn CASPEC can be got any time by pressing Status twice Motors are automatically checked against positions every 50 secs for exposures 970 secs Calibration prism is put hac
60. like ST but only OK ER reply wanted MK Motor check on off IBUF 1 ZHMK 2HON IBUF 2 lt 2HOF Enables disables periodic check of motors On all class I 0 commands parameters 1 and 2 IP1 IP2 are used as follows IPl class number for reply to CASP if 9 CPENG terminates without reply IP2 source destination numbers of CASP and CPENG programs in upper lower bytes COMBI conventions i309 In addition to the protocol described one should add that CPENG gets the installation tables of CASPEC by obtaining the parameter file name at IN init time and reading then the tables from disc As a consequence every time installation tables are changed e g by usage of PARMG a new IN command is sent to CPENG This does not apply to user tables changed dynamically under CASP The only relevant part of information for CPENG in this case is the table 8 content saying where to position the CASPEC functions and this is transmitted along with every MOVE command to CPENG Note that motor controllers need a Z on CAMAC for resetting So Z to CAMAC is given by CPENG at INitialization time Messages from CPENG go either to the rolling part of the instrument console or and to the instrument status line CASPEC messages are not tagged to say if they come from CASP or CPENG as this has no meaning for the user A compound status line with status of functions lamps and shutter appears after every CPENG command except IN
61. m communication 6665 LINKP 75 X IHPCM 75 Equipment handling CKCAM 75 GETEG 75 CKIQU 75 Others ATIMCV 75 4 Maintenance To maintain the library by modification of existing modules or addition of neu ones follow these steps t 1 Compile appropriate modules 2 Modify DAGLB GR 79 for MERGE 3 Build with MERGE neu XDAGLB 4 Edit all changed sections of this document DAGLB GR 75 To list this RU PR DAGLB 795 1 Important NOTE Given that existing programs use DAGLB backwards compatibility must be Maintained Furthermore DAGLB must be the same on all installations For this reason it is advisable that when you have subroutines to Contribute you do it in agreement with either G Raffi in Garching or E Allaert in La Silla MOTOR S3 8 28 15 33 TECHNICAL NOTE TPE GR 830827 2o G Raffi ESO Garching i MOTOR library H i motor test programs MOTOR library motor test programs 830827 G Raffi ESO Garching Undate history Original version GR 830827 Library of HP 1000 RTE 4B FTN4X subroutines to interface with the ESO 4 channel motor controllers The motor controllers interfaced by these subroutines are the ones developed by B Gustafsson ESO Carching The protocol HP CAMAC motor controller is described in Communications protocol betueen 4 channel motor driver and H P computer B Gustafsson Technical Note TPE 1 81 Rev 2 May 24 83 INDEX Introdu
62. new telescope control system l THE CASPEC SOFTWARE The CASPEC on line software to control the instrument acquire data from the CCD detector and to do on line data reduction consists of a number of Programs cooperating together It runs under the RTE 4B operating system in an ESO standard HP 1000 configuration 256 Kw of memory 50 Mbytes disc CAMAC crate 1600 bpi magnetic tape unit The CASPEC specific control software consists of a main program CASP which handles the user interface and the instrument logic and sends commands to a kernel program This in turn controls and monitors the 15 CASPEC functions corresponding to 15 DC motors and operates calibration lamps and Shutter It is foreseen that the user can define single exposures or sequences of exposures to be executed on the CCD detector The CASPEC motors are automatically positioned before each exposure The CASPEC logic is based on a set of parameter tables where the instrument configuration and installation values are described These tables can easily be displayed or modified on line The interface with the instrument is via CAMAC and a library of subroutines has been developed to interface with the CAMAC motor controllers 1 1 The data acquisition system The CASPEC specific programs rely on what we call data acquisition system a set of either new or extensively readapted programs and libraries connected by well defined interfaces The main idea behind this is
63. not meant for the user 1 1 1 70 subroutines INISL Set up status line number QR 830617 PREFX Prefix all output with special character GR 830617 PRMPT Gives a default prompt for ASCII input QR 830617 RDIN Read with prompt integer in a range GR 830617 ASKYN Ask for Yes No reply GR 830617 PRTTX Print an immediate string GR 830617 PRTBF Print a string from huffer QR 830617 PRTTN Print text number GR 830617 PRTNM Print an integer with given radix GR 830613 PRTEX Output string with prefix GR 830613 PRTEN Output string number with prefix GR 830613 INP Prompt for input string GR 830614 REDDG Read number from ASCII buffer GR 830614 1 2 Class 1 0 subroutines CLGET Get a class number V1 0 66 830210 CLRLS Release a class number PB GAR V1 1 GR 830210 CLEAN Clean class numbers V1 0 GR 830210 CLRED Start class input from term GR 830214 ET Class get line GR 830214 PUTM Class put message GR 830214 MWAIT Class uait for line GR 830214 PTPAR Pass ipl ip2 params via class GR 830214 CKCLS Checks for valid class number GR 830214 1 3 Tables handling subroutines DISPA Display form amp params from memory GR 8303813 REDPA Read updated param s in buffer GR 630513 PUTPA Put out form amp params no wait GR 830513 PACHK Read param s to be checked GR 830513 GETPR Get from disc form parameters GR 830614 PUTPR Put form parameters into param s file GR 830614 PIMFO Get info on form QR 830614 PARFG Parameter table configurator BG 830519
64. nstalled only the CASPEC specific programs are needed To be sure that you are in this situation check the following 1 Existence of following type 6 files IHAP GROO GR54 at least for IHAP CRTO5 COMBI FORM PARMG for the DAQ system CCD DAQ DAQSO DAQS1 WCHDG CCTST for CCD 2 Make sure that either the DAQ cartridge DAQCC CR 75 is mounted or otherwise that the table files needed by CCD and COMBI CCDSK CCDFO CCDPA CCMSG SWTSK are available check TABLE CR 33 3 Mount CASPEC CR 85 and load CASPEC package by running the transfer file TR CASP 85 On a standard system 2308 type 6 files are already available on CR 85 and so no loading is needed A listing of the loader files CASP and CP is given in Appendix C Note CR reference number needs to be 85 at load time This will load the programs CASPEC CPENG TCINT for 3 6 m and optionally the test programs TMINI TMOST TMHND TCAM CPCKS The reason for this last option is that test programs except CPCKS are general purpose and they might be already available So possibly only CPCKS needs to be loaded 12 4 Make sure that there is an account CASP under which the user can log on If not create one and use HICP CP 2 as welcom file for this account HICP should already be on CR 2 but a copy exists on CR 85 HICP gives introductory information on CASPEC its function and restores RP the DAQ and CASPEC programs
65. on CAMAC to reset motor controllers IBUF 2 should say so on reply IBUF 3 INMSK mask with functions successfully moved IBUF 3 ISTSH Status of shutter IBUF 3 ISTLA bit pattern with lamps status CASP command IN Initialize IBUF 1 2HIN Buffer of 40 words passed to CEPNG with amp CPCOM common Must be first command MO Move IBUF 1 2HMO IBUF 2 INDON If 0 initialization needs to be done From IBUF 5 on the parameters of table 8 are given wanted encoder values SH Shutter IBUF 1 2HSH 2HOP Open IBUF 2 2HCL close LI Calibration lamps IBUF 1 2HLI HON IBUF 2 HOF IBUF 3 lamp no if O all lamps 259 CASP CPENG PROTOCOL CPENG reply IBUF 3 ICKMSK bit pattern with functions in correct position Messages to describe status of motors lamps and shutter are displayed to terminal status line IBUF 3 ICKMSK OK ER reply not given when CK command is internally generated by CPENG selftest mode during long exposures Message to terminal status line No reply given to this command On all class I O replies parameters IPl and IP2 are used as follows IPI 0 IP2 source destination of message CPENG CASP number according to COMBI conventions CASP command ST Status of CASPEC All functions are checked to see if they are at wanted position Shutter and lamp status are checked as well CK Check CASPEC
66. or for on line graphics 2 Ramtek monitors colour and B amp W and an HP plotter for data reduction User input to CASPEC is via function keys 2 levels of menus and via forms filled in with appropriate parameters The user has also access to CCD programs IHAP parameter manager and test programs at the same console Typically during long exposures he would work with IHAP to reduce previous data while the CCD detector and the CASPEC motors are automatically monitored by the corresponding programs 2 OPERATION Fig 2 shows the 2 levels of softkey menus handled by CASP All commands to CASP are via softkeys However the user is also requested to fill in forms and occasionally to answer questions in the rolling part of the instrument console Appendix A gives a description of the softkey logic The same text can be obtained on line for all the softkeys in a given Menu by making use of the Help softkey complete description of CASPEC operation from the user standpoint is given in the CASPEC User s Manual Itu 3 INSTALLATION The CASPEC software runs within the ESO Data Acquisition System DAQ The CASPEC programs are listed in Appendix B Partial Installation Normally the CASPEC programs should be already installed on CR 3 and tables should be on CR 33 Here are instructions to load the programs on a new system If the system contains already IHAP June 83 or later version and the DAQ programs i
67. ow to test various parts of CASP CASP can also be tested without CCD Initialization of CCD will obviously fail but CASP proceeds and even exposures of type NO no CCD can be done CASPEC versions Caspec version V 2 0 Oct 83 tape 831026 described here goes together with DAQ system July 83 CR 75 tape either July 83 or 831026 CASPEC V 2 0 initializes motor controllers in block mode fast mode 5 secs It goes together with motor controller PROMS vers 27 10 83 or later EtG 4 2 Troubleshooting The most common problems which might arise are listed here in the assumption that CASP was properly installed For problems due to bad installation follow the advice given in the previous section on installation tests Appendix E refers to problems which the user himself can fix like getting the IHAP graphic terminal going or restarting CASPEC from scratch if he gets stuck A problem which might occasionally show up is that an encoder value cannot be reached at a first attempt Re initializing CASPEC via the appropriate softkey usually fixes the problem Some encoders locations might be faulty while a location one or two encoder values away is reachable This might be acceptable on some functions In general for motors troubleshooting use the advise given in the following table SYMPTOM POSSIBLE DIAGNOSIS CURE All motors fail Something wrong with CAMAC Check hardware Initializing installation or cable
68. ows indicate the programs scheduled where an arrow passing via COMBI means that CASP schedules programs like IHAP CCD and TCINT by passing a command to COMBI to do it The number near the arrow indicates in which order programs are scheduled by CASP at start time When CASP schedules COMBI it receives back a sequence of class numbers which allows later communication with COMBI and CRTOS Class numbers are always got via COMBI never directly from the system so that COMBI can also release them at CASP termination If run time parameter 3 is 0 CCD and IHAP are not scheduled This is a stand alone mode to run CASP useful for installation tests Should COMBI and CRTOS not exist CASP cannot even start If CPENG scheduling or initialization fails this results in a fatal error and CASP can only be terminated Should instead IHAP or CCD fail at schedule time or should CCD fail initializing these are considered non catastrophic errors and allow to proceed with CASP although clearly no exposures with CCD can be done Should TCINT TCS Telescope Control System Interface fail this only shows that the link with the TCS computer is not OK As this condition does not mean that CASPEC cannot be operated properly full CASPEC operation is possible in any case The only difference in further operation with CASP is that at start exposure time a form will be displayed asking to enter telescope coordinates and sidereal time while these values are sim
69. ply displayed on the rolling screen without pausing CASP operation when the link with TCS is working properly Another important start up operation is the retrieval of the installation tables by CASP SCHEDULING MECHANISM OF CASPEC Fig 5 55 s First of all CASP looks for the LU s installation table 5 on file PACP on the first mounted CR containing PACP it should be the TABLES CR 33 Table 5 contains in turn a CR reference for auxiliary files should be 33 again to be used in further parameter file operations Table 5 is retrieved with subroutine GETPR all other tables with subroutine GETAL third function of the start up section of CASP is to initialize motors to a given last run setting This is a way of checking that all functions are working properly The actual initialization is done via the CPENG program see later Should some of the F s fail re initialization is attempted again but interactively allowing the user to select or exclude certain functions After this whatever the result the main menu is displayed Re initialization can be done over and over from the main menu if needed The menus displayed by CASPEC and the actions corresponding to their softkeys are already described in the Operations chapter and Appendix A This corresponds to the handling of user input However CASP deals also with messages coming from CCD and COMBI and replies to commands sent to IHAP and CPENG The logic cor
70. r controller GR 830319 MIQT Wait for msg from motor controller QR 830614 MTSAP Skip any msgs from motor contr GR 830614 MTPAR Ask info on motor GR 830319 MOTCK Check motor position GR 830319 MOTMV Move motor to position GR 830309 MSLCM Send block or single cmd to motor GR 830614 MGLRD Read single or block msg from motor GR 830614 RDENC Read encoder value GR 830614 MTERR Print motor commnds errors GR 830614 WTMDT Wait for active motors positions GR 830615 ASKMT Ask parameters for motor GR 830103 2 Subroutine calls SUBROUTINE MCNSTCIADR ICSTAT MSTAT LSTAT 18 05 LU 1 Check motor controller status GR Parameters IADR wscoded CAMAC addresses NMOT mmotor number 1 4 any if interested only in cotroller status ICSTAT 2 controller in messy state better to give a Z z if motor did not yet receive a Z O if motor was reset by Z or power dip 1 if motor controller is initialised MCODE status reply for given motor makes sense only for ICSTAT 1 LU LU for error messages SUBROUTINE MBLST IADR MSTAT LSTAT IPOS IER LU Get block status from motor controller GR ene ee MP ee ee ee M ee e queam SUBROUTINE MBLIN IADR MOTN IENP IGF 1500 ISOFU IAXS IPAFG IER LU Move motor to initial position GR adapted from B Gustafsson RTCAM MOTN contains a motor number In principle it can
71. r o 0 3 Photometric filter O 0 5 Rear slit viewer o Omoff Laon 2 Zeemnan of exposures FORM 10 Instrument setting Foc NCLP V 1494 00000 1494 4 0 0 0 0 1496 40000 1494 0 0 0 0 0 000000 000000 000000 000000 H nm sszexpos time MTamag tape Osno F11 CASSEGRAIN ECHELLE SPECTROGRAPH Sumnary IOIOIOIOIOIIIG M Exposure definitions Identifier CL EPS ERI 00 FF EPS ERI 500 FF EPS ERI 00 DK EPS ERI 00 MT Seqt 1 35 1 38 1 37 1 38 o 0 o o 0 0 o 0 1 8 Teetype TP H mm 1 RE 0 QO 2 RE O 3 RE 0 0 4 DK o o 0 o 0 0 o 0 0 0 0 0 Hazrel seq Seq zsoquonco for IHAP Wdtwslit width Hgthsslit height Foc scollim focus Pzphotometric Vaslit viewer Szlight source Neneutral Cscolour Lzscalib Filters F12 CASSEGRAIN ECHELLE SPECTROGRAPH Spectral table FORM 11 Characteristic wavelengths of filters and CASPEC NEUTRAL FILTER Numer 0 1 2 3 4 3 Density free 2 6 1 93 0 90 0 33 0 33 COLOUR FILTERS Number Wavelengths Recommended central uavelength 0 frec 1 from 610 to 999 O nm Q from 0 to 999 o nm 3 from 20 to 639 580 nm 4 from 400 to 540 480 nm 9 from 426 to 502 456 nm OVERALL BANDWIDTH of CASPEC Centre 400 nn yields fron 340 to 442 nm 450 nm 390 S56 nm 09 nm 449 30 nm 950 na 00 600 nm 600 na 550 6S0 nm 650 na 400 695 nm 700 na 650 740 nm I oe ss 42 F13 Declination 6
72. raphic terminal to unlock it Should this not work hit the RESET TERMINAL key consecutively twice on Same terminal and then the RETURN key this will cure the problem This point is relevant because at initialisation time CASP does not proceed if the graphic terminal is not available i CASP or CCD stuck In case of CASP or CCD programs being stuck do the following from system console ZCP 85 This is an abort and restart procedure file that will allow to run then CASP again from CASPEC console Let this procedure file run up to completion before starting CASP again Should it be stuck somewhere apply comments which appear on screen and that to further proceed with a procedure file one has to type HOWEVER it is not always easy to get the system console FMGR prompt in order to enter 26 85 If this is the case then a number o programs have to be aborted by hand and then the prompt will come up again Here are some hints on hou to proceed Hit the RETURN key to get the prompt OF DAG 1 OF CCD 1 OF CPENG 1 OF CASP 1 OF CRTOS 1 t this point either the FMGR prompt comes up on its oun or you can get it up by 0N FMGR Should the system reply vith an INVALID STATUS error message try the following OF FMGR 1 ON FMGR Once you get the FMGR prompt type ZCP 85 as explained before WHAT ELSE Should all the above remedies fail do not despair
73. rect ItO Class for output via CRTOS default LOGLU PAR 2 CAMAC LU default 60 PAR 3 sS NMOD where NMODsSCAMAC N for mot controll PAR 4 NMOTsnumber of motor in this motor contr 1 4 PAR S mO for direct I O Class for input CRTOS PARAMETERS o 0 6 1018 library B30826 G Raffi ESO Garching Library of subroutines for direct class I O and tables handling Update history Original version GR 830826 Introduction 1 List of subroutines 1 1 I O subroutines 1 2 Class I O subroutines 1 9 Tables handling subroutines 1 4 Other subroutines 2 Subroutine calls 2 1 I O subroutines 2 2 Class I O subroutines 2 3 Tables handling subroutines 2 4 Other subroutines 3 Installation 4 Maintenance Introduction The purpose and need of a library of I O subroutines is that programs developed in the ESO Data Acquisition System environment do not talk directly to the terminal but via the Terminal Handler CRTOS While the usage of an I O library instead of formatted I O gives always advantages in terms of maintenability of 1 0 software this has become a necessity with the usage of the Terminal Handler CRTOS package written by P Biereichel An extra advantage of this is device handler independence as the sane calls are used both for direct I O and for class I O to a terminal LU via CRTOS Test programs for example can benefit from this as they can be run either in stand alone mode
74. responding to the exposure definition and to the start exposure softkeys is explained here in greater detail Logic of Exposure Definition Table 9 is filled in with the wanted exposure parameters while table 1 is displayed on the IHAP graphic terminal used as an auxiliary display Screen Table 7 and 1 are then filled in with the appropriate parameters from table 1 where table 1 is used to give a status display on request Parameters are then converted into table 8 values initial set up or engineering set up table This last table is the one actually used to drive CASPEC The reason for this is that table 9 does not contain all functions e g Hartmann mask being a higher level table for the user Table 8 is instead filled in with suitably converted table 9 values taking default values when necessary e g Hartmann masks off and gives a one to one correspondence with the 15 functions driven by CASP The values of table 8 are the ones converted into encoder values and used to control the CASPEC motors If the sequence number defined is greater than the definition of table 9 is also inserted in table 10 in the location corresponding to the sequence number specified 26 Logic of Start exposure and Start sequence Motors are put in position via CPENG checking first if any of the present positions have to be changed on the basis of table 9 values Then one exposure single or in a sequence is started via a sequence of
75. s 3 Installation Once the relocatable modules are avilable the created by running the MERGE utility with the IOLIB 75 commands file Instructions for MERGE to create library XIOLIB 1 0 subroutines HILIO 75 PRTEX 75 KINP 75 APROUT 75 ZBYTE 75 ZBITS 75 Class I O subroutines ZCLCET 75 CLRED 75 Tables handling subroutines ADISPA 75 GETPR 75 PARFG 75 0 75 Other subroutines TIME 75 ZTIMA 73 ANOSEC 75 DAT 75 0 5 ANYNAM 753 ACONV 75 4 Maintenance To maintain the library by modification of existing modules or addition of neu ones follow these steps 1 Compile appropriate modules 2 Modify IOLIB GR 75 for MERGE 3 Build with MERGE new XIOLIB 4 Edit all changed sections of this document IOLIB GR 75 S To list this RU PR IOLIB 75 1 compatibility must be on all installations have subroutines to G Raffi in Garching Important NOTE As existing programs use IOLIB bachwards maintained Furthermore IOLIB must be the same For this reason it is advisable that when you contribute you do it in agreement with either or E Allaert in La Silla
76. s To modify CAMAC stations connected or power switched use PARMG on table 5 and off on CASPEC cable connections 6 for connections Some motors fail Typically encoder problems Use softkey STATUS and test program TMOST to Some cables can be get status of controllers disconnected or badly and encoder values connected Try to re initialize all functions or only those functions which fail ome motors still Motor cables encoder or Use programs TMINI and amplifier problem motor TMHND to know where to go controller problem Be carefull you need to know a lot on the functions you move like valid range type of axis This assumes deep knowledge of CASPEC Zo Tox Remember also that you can test even one single motor with CASP softkey re initialize and this test repeated on different values is normally a more reasonable and easier way to proceed than to use a test program e g under the maintenance menu This is because CASP knows the type valid range and scaling factor for every function However if you want to move a motor with TMINI get first all the relevant information on the motor to exercise like Type of axis linear or circular upper lower limits for encoder and offset in case of linear axis All this is in tables either 2 or 3 or 4 depending on function From table 6 you know to which controller the function is connected and in table 5 you have the controllers slots Having done this you can tr
77. s password protected by password CP In particular programs TMOST TMINI TMHND are general purpose test programs for motors though specifically written for CASPEC They are fully documented in the MOTOR library see enclosed documentation B To get a general description of what they mean and how they work refer to CASPEC User interface Appendix A or use on line the Help softkey in the maintenance menu All these programs can be simply run without parameters in stand alone mode and will work interactively Using them under CASP one has the advantage that some parameters like terminal and CAMAC LU s are directly passed to test programs with the run string and the user has not to know all this TCAM is a CAMAC general purpose test program CPCKS and TMOH are instead tests which are CASPEC specific Note that TMOH used to test Hartmann mask is so rarely used that it is not available under CASP in the Maintenance Menu It is not even loaded normally with CASPEC To load it RU LOADR CP 85 ZTMOH 85 Program TMOST does not interfere with CASP work and can be run in parallel e g from system console while TMHND might interfere and TMINI certainly does as it resets all the motor controllers with Z Be aware of this when running tests from system console while CASPEC is running 36 8 CASPEC AND REMOTE CONTROL Although the CASPEC package is not implemented to be directly remotely controlled RC some concepts dealing wit
78. status and schedule GR 830614 CKPRG Check PRG status GR 830614 LINKP V1 0 Link program to COMBI PB 830216 IH CM Send msg to IHAP GR 830804 1 2 Eqvipment handling CKCAM Check CAMAC GR 830615 GETEQ Get EQT numb for given session LU GR 830614 CKIOL Check I O LU s direct or class lt I 0 GR 830614 1 3 Others TIMCV Convert secs into hh mm ss tens GR 830609 2 Subroutine calls SUBROUTINE SCPRGC CIPNAM IER LU IP1 162 IP3 164 IPS Check PRG status and schedule GR 830614 c C parameters IPNAM 3 s6 chars program name C IER O program OK ready to be scheduled c LU LU or class for messages c like Restoring program C C adapted from CCD subroutine SCRTS by P B c c A A us A WD QD OOOO SO OO UD UD c SUBROUTINE CKPRGCIPNAM IER LU Check PRG status GR 830614 0 C parameters IPNAM 3 6 chars program name c IER O program OK ready to be scheduled C LU LU or class for messages C like Restoring program C C adapted from CCD subroutine SCRTS by P B c SUBROUTINE LINKP PARAMS ICLMY IPRGNR ICLFTH IPRFTH V1 0 Link program to COMBI PB 830216 SUMMARY Link program to COMBI s enviroment BY Peter Biereichel ESO GAR DATE 16 FEB 1983 KEYWORDS PACKAG
79. to reach the fully closed position remember that the complementary decker has to be kept open as deckers are free to push each other around the central position Having found the mechanical limits one can then proceed to find the close position i e the centre position where the two deckers touch each other The range of allowed encoder values is now known The offset is then chosen as an encoder value falling within the forbidden range so that the relative encoder values in the allowed range are well within the range 0 2047 without crossing 2047 In the case of the deckers let us assume that fig 3 contains the results of the handset measurements for decker no l 2047 0 300 full closed postion closed 1584 forbidden region 550 offset 600 Max aperture Decker No 1 Absolute encoder values Fig 3 The continuous line shows the valid range to go from max aperture to closed position 2 deckers touching in the middle to full closed position or vice versa This allows to choose the offset value 550 would be appropriate in this case so that relative values go from 50 to 1797 So one can say that the offset is connected to the sense of rotation of the motor axis In this case increasing encoder values lead to movements in the close position direction 223 x To complete the picture let us consider decker 2 as a further example in Fig 4 where the offset meaning is less self evident 2047
80. want that a function moves backwards forwards even of one bit A disconnected motor can of course drift due to the weight of the function or simply to a motor amplifier offset but this when limited and slow is sometimes preferable to precise active control These effects have been studied at installation and functions are set up as follows Functions 1 3 6 9 11 12 motor disconnected on position Functions 2 7 8 10 13 14 motor left connected on position Hartmann masks 15 16 are disconnected once the limit is reached so that they cannot drift away The connect disconnect alternative is not an installation option as it is independent of the particular mounting of functions Subroutine amp GTFUN contains anyhow the definition of the above values as a parameter for each function Another general point concerns the encoder value limits which cannot be exactly the mechanical limits They must be some encoder values away from them 2 or 3 bits is enough so that these values can always be reached under computer control Now let us look in some detail into the various installation tables Table 2 refers to wheel functions Neutral filter colour filter calibration filter photometric filter calibration switch wheel calibration source wheel They are all circular functions meaning by this that they are rotating and free to move to any position in either direction For the first 4 functions the offset position
81. y to move the motor to various positions Should this fail then you might suspect a bad connection faulty electronics or faulty function Changing function on the same controller using a different controller etc helps then in localizing the problem Should instead TMINI succeed on a faulty CASPEC function then there might be something wrong with the tables or the particular encoder value wanted cannot be reached for some other reason e g encoder problem Use the Status softkey under CASP to get a global view of the functions status 18 5 MAINTENANCE This section deals with routine maintenance operations to do when some instrument components motors encoders controllers functions or simply cables have been changed or exchanged Please note that even the simple dismounting remounting of a CASPEC function e g a filter wheel might affect installation parameters as for example the relative encoder values might be different The CASPEC installation parameters are kept in the installation tables which can be changed with PARMG Parameter Manager To run PARMG RU PARMG answering form file FOCP CP 33 and checking that parameters file is 067 03 The top form of PARMG when run with the above form file contains the list of CASPEC tables as given in Appendix F where the tables layout with the set up parameters at CASPEC installation are also listed Important note Before editing any tables on TAB

Cassegrain Echelle Spectrograph CASPEC

Contents

Download Pdf Manuals

Related Search

Related Contents