NEWFIRM INSTRUMENT COMPONENT CONTROLLER (NICC) ---------------------------------------------- GWC Streams and Commands History ------- v1.0.7: - 01-Oct-2004 S. Gott (gott@noao.edu) - Revised the list of temperature sensors in accordance with SDN4102 revision 1. Assigned new variable names that correspond to the sensor numbering scheme described in section 7 of the SDN. v1.0.6: - 17-Sep-2004 P. N. Daly (pnd@noao.edu) - Due to conflict, changed CDS -> CD. v1.0.5: - 11-Aug-2004 S. Gott (gott@noao.edu) - Changed simulation mode states from string {normal|simulate} to integer {0|1}. v1.0.4: - 07-Jul-2004 S. Gott (gott@noao.edu) - Added a simulation mode command and status variable to newfirm.main. - Deleted commands and variables pertaining to temperature regulation by modulation of cold head power. - Added simple on/off commands for cold head power control. - Added setpoint values and regulation on/off commands for temperature control of the detector array and the OSS by the Lakeshore 332. - Added variables to report the detector and OSS temperatures as measured by the Lakeshore 332. - Reduced the number of pressure and vacuum sensors from three to one of each type. - Added a command to set the sampling rate for passive temperature sensors. v1.0.3: - 29-Jan-2004 S. Gott (gott@noao.edu) - fixed various typos v1.0.2: - 27-Jan-2004 S. Gott (gott@noao.edu) - Add "between" value for position reports from filter and ecover - Re-number filter wheel positions as 1-8, define position 0 as "between" - Re-write filter wheel positioning rules to allow for future expansion - Delete "datum" position - Add command attributes to the attribute lists - Move ecover temperature attribute to the "thermal" stream v1.0.1: - 25-Jan-2004 R. E. Marshall (rmarshall@noao.edu) - changed items l[1-8][cefr][fs] -> lens[1-8][cefr][fs] - changed items NFL[1-8][CEFR][FS] -> NFLN[1-8][CEFR][FS] v1.0.0: - 22-Jan-2004 P. N. Daly (pnd@noao.edu) - original version GWC Data Streams ---------------- system stream description ------ ------ ----------- kpno_4m newfirm.main main page kpno_4m newfirm.ecover environmental cover kpno_4m newfirm.filter filter wheel kpno_4m newfirm.thermal thermal environment kpno_4m newfirm.pressure pressure environment kpno_4m newfirm.vacuum vacuum environment ctio_4m newfirm.main main page ctio_4m newfirm.ecover environmental cover ctio_4m newfirm.filter filter wheel ctio_4m newfirm.thermal thermal environment ctio_4m newfirm.pressure pressure environment ctio_4m newfirm.vacuum vacuum environment Data Stream Attributes ---------------------- -->newfirm.main attribute type number keyword units description --------- ------- ------ -------- ------- ----------- ident string 1 NFIDENT None control program id and version auth string 1 NFAUTH None author(s) of the NICC code date string 1 NFDATE None date of last modification sim integer 1 NFSIM None simulation mode {0|1} (1 == simulate) -->newfirm.ecover attribute type number keyword units description --------- ------- ------ -------- ------- ----------- position string 1 NFECPOS None detected position {open|close|between} cmd string 1 NFECCMD None demand position {open|close} -->newfirm.filter attribute type number keyword units description --------- ------- ------ -------- ------- ----------- fw1pos integer 1 NFFW1POS None wheel 1 actual pos {1|2|3|4|5|6|7|8|0} fw1 integer 1 NFFW1CMD None wheel 1 demand pos {1|2|3|4|5|6|7|8} fw2pos integer 1 NFFW2POS None wheel 2 actual pos {1|2|3|4|5|6|7|8|0} fw2 integer 1 NFFW2CMD None wheel 1 demand pos {1|2|3|4|5|6|7|8} name string 1 NFFILTER None actual name {J|H|Ks|CD|Blank|Open|between} pos string 1 NFFILCMD None demand name {J|H|Ks|CD|Blank|Open} -->newfirm.thermal attribute type number keyword units description --------- ------- ------ -------- ------- ----------- detset float 1 NFDETSET Kelvin setpoint for detector array temp control ossset float 1 NFOSSSET Kelvin setpoint for OSS temperature control detreg string 1 NFDETREG none detector array temp regulation {on|off} ossreg string 1 NFOSSREG none OSS temperature regulation {on|off} dettmp float 1 NFDETTMP Kelvin detector array temp measured (loop input) osstmp float 1 NFOSSTMP Kelvin OSS temperature measured (loop input) chpwr1 string 1 NFCHPWR1 none cold head 1 power {on|off} chpwr2 string 1 NFCHPWR2 none cold head 2 power {on|off} chpwr3 string 1 NFCHPWR3 none cold head 3 power {on|off} tsrate integer 1 NFTSRATE seconds temperature sampling rate in s/sample temp1 float 1 NFTEMP1 Kelvin lens 2 rim temp2 float 1 NFTEMP2 Kelvin lens 2 cell spring finger temp3 float 1 NFTEMP3 Kelvin lens 3 rim temp4 float 1 NFTEMP4 Kelvin lens 3 cell spring finger temp5 float 1 NFTEMP5 Kelvin upper housing exterior temp6 float 1 NFTEMP6 Kelvin upper housing exterior temp7 float 1 NFTEMP7 Kelvin upper housing exterior temp8 float 1 NFTEMP8 Kelvin middle housing exterior temp9 float 1 NFTEMP9 Kelvin middle housing exterior temp10 float 1 NFTEMP10 Kelvin lens 4 rim temp11 float 1 NFTEMP11 Kelvin lens 5 rim temp12 float 1 NFTEMP12 Kelvin lens 6 rim temp13 float 1 NFTEMP13 Kelvin lens 4-5-6 cell base temp14 float 1 NFTEMP14 Kelvin middle housing interior temp15 float 1 NFTEMP15 Kelvin fold mirror rear surface temp16 float 1 NFTEMP16 Kelvin lens 7 rim temp17 float 1 NFTEMP17 Kelvin lens 7 cell spring finger temp18 float 1 NFTEMP18 Kelvin fold mirror housing exterior temp19 float 1 NFTEMP19 Kelvin fold mirror housing exterior temp20 float 1 NFTEMP20 Kelvin lens 8 rim temp21 float 1 NFTEMP21 Kelvin lens 8 cell spring finger temp22 float 1 NFTEMP22 Kelvin lower housing exterior temp23 float 1 NFTEMP23 Kelvin lower housing exterior temp24 float 1 NFTEMP24 Kelvin lower housing exterior temp25 float 1 NFTEMP25 Kelvin lens 1 exterior face temp26 float 1 NFTEMP26 Kelvin lens 1 interior (vacuum) face temp27 float 1 NFTEMP27 Kelvin environmental cover interior temp28 float 1 NFTEMP28 Kelvin filter wheel motor, upper wheel temp29 float 1 NFTEMP29 Kelvin filter wheel motor, lower wheel temp30 float 1 NFTEMP30 Kelvin filter wheel housing interior temp31 float 1 NFTEMP31 Kelvin collimator cold baffle tube upper temp32 float 1 NFTEMP32 Kelvin collimator cold baffle tube lower temp33 float 1 NFTEMP33 Kelvin tangent bar #1 close to Dewar wall temp34 float 1 NFTEMP34 Kelvin tangent bar #1 halfway along length temp35 float 1 NFTEMP35 Kelvin tangent bar #1 close to OSS attach temp36 float 1 NFTEMP36 Kelvin tangent bar #2 halfway along length temp37 float 1 NFTEMP37 Kelvin tangent bar #3 halfway along length temp38 float 1 NFTEMP38 Kelvin active radiation shield upper end temp39 float 1 NFTEMP39 Kelvin active radiation shield midpoint temp40 float 1 NFTEMP40 Kelvin active radiation shield midpoint temp41 float 1 NFTEMP41 Kelvin outer passive radiation shield temp42 float 1 NFTEMP42 Kelvin cold head #1, 65 K stage temp43 float 1 NFTEMP43 Kelvin cold head #1, 10 K stage temp44 float 1 NFTEMP44 Kelvin cold head #2, 65 K stage temp45 float 1 NFTEMP45 Kelvin cold head #2, 10 K stage temp46 float 1 NFTEMP46 Kelvin cold head #3, 65 K stage temp47 float 1 NFTEMP47 Kelvin cold head #3, 10 K stage temp48 float 1 NFTEMP48 Kelvin array alignment mount outer plate temp49 float 1 NFTEMP49 Kelvin array mount Invar baseplate temp50 float 1 NFTEMP50 Kelvin array mount thermal mass temp51 float 1 NFTEMP51 Kelvin 2K x 2K array A temp52 float 1 NFTEMP52 Kelvin 2K x 2K array B temp53 float 1 NFTEMP53 Kelvin 2K x 2K array C temp54 float 1 NFTEMP54 Kelvin 2K x 2K array D -->newfirm.pressure attribute type number keyword units description --------- ------- ------ -------- ------- ----------- ps integer 1 NFPS mbar pressure sensor -->newfirm.vacuum attribute type number keyword units description --------- ------- ------ -------- ------- ----------- vs integer 1 NFVS utorr vacuum sensor GWC Commands ------------ attribute argument(s) description --------------------- -------------------------- ---------------------------------- newfirm.main.sim set {0|1} simulation mode control newfirm.ecover.cmd set {open|close} open or close the cover newfirm.filter.fw1 set {slot-number} set wheel 1 to position {n} newfirm.filter.fw2 set {slot-number} set wheel 2 to position {n} newfirm.filter.pos set {J|H|Ks|CD|Blank|Open} set to named filter configuration newfirm.thermal.detset set {float-value>0.0} setpoint for detector temp control newfirm.thermal.ossset set {float-value>0.0} setpoint for OSS temp control newfirm.thermal.detreg set {on|off} enable detector temp regulation newfirm.thermal.ossreg set {on|off} enable OSS temp regulation newfirm.thermal.chpwr1 set {on|off} enable cold head 1 power newfirm.thermal.chpwr2 set {on|off} enable cold head 2 power newfirm.thermal.chpwr3 set {on|off} enable cold head 3 power newfirm.thermal.tsrate set {integer-value>=5} set temp sampling rate in s/sample GWC Actions ----------- ACKNOWLEDGED BUSY DONE Notes ----- At the time of writing the known filter names and positions are J, H, Ks, cold dark slide (CD), blanked off (Blank) and open (Open). Pos FW1 FW2 1 Open Open 2 CD CD 3 Blank Blank 4 Blank Blank 5 Open J 6 Open H 7 Open Ks 8 Blank Blank Given a filter name, NICC will move the appropriate wheel to place the selected filter in the light path, and will move the other wheel to its "Open" position (position 1). The "Blank" position is nominally associated with setting both filter wheels to position 8 so that no light reaches the detector. The "Open" position is nominally associated with setting both filter wheels to position 1 so that all light reaches the detector. The numeric value of a filter wheel that is in transit between positions, and not in any of the 8 defined positions, will be reported as "0". The filter name in this case will be reported as "between".