Content Comparison

ID

Command

Description

SG KPF Notes

1

abort

 abort an exposure in progress (ARC-only)

2

amplifier

 set or get which detector amplifier(s) to use 

Is this how we could choose different amplifier schemes?
(1 amp only, 2 amps only, all 4 etc). Not currently implemented.

3

autodir
NEW in 11 Nov. 2021 version.

automatically create UTC subdirectory for images

NEW 11 Nov. We want this set to ‘NO’, so that UTC subdirectories are not created.

34

basename

 base image name for FITS image files 

KPF can set this in the config file as it will never change (Green: "KPF_Green_", Red: "KPF_Red_")

45

bias

 bias voltage

Steve K: would we ever adjust this or is it set once and for all in the ACF file? (If we're adjusting it we'll want the value for telemetry)

56

buffer

 PCI/e image buffer mapping (ARC-only)

67

cds

 CDS/Deinterlace configuration key (Archon-only) 

I'm not sure what this is, or if it's used by the KPF Archons

78

close

 close the connection to the detector controller 

No doubt needed by KPF software

89

datacube

 data cube state

I'm not sure if this is used to make a our FITS with the amplifiers separate?  (Manual implies it is more for combining images from multiple exposure runs).

910

echo

 test server communication 

No doubt useful to KPF software development

1011

 exitexit

 exit the server 

Likely needed by KPF software

1112

 exposeexpose

 initiate an exposure 

I don't think KPF needs this since we are triggering from TTL?

1213

 exptimeexptime

 exposure time

I don't think KPF needs this since we are triggering from TTL?

1314

 fitsnamingfitsnaming

 FITS filename format 

Here we should be able to use the 'number' setting, since with imnum below we can specify which number to use (i.e. we can give it the current obsID)

1415

 framestatusframestatus

 read the frame status (Archon-only) 

Not implemented yet, but I don't think KPF needs this.

15

Manual notes equivalent Archon-native ‘FRAME’ command

16

geometry

 detector geometry (ARC-only) 

1617

 getpgetp

 get parameter value (Archon-only)

We could used this to get telemetry, one parameter at a time.  However, the native Archon commands STATUS and SYSTEM might be easier/faster as telemetry is returned en mass.

1718

 hdrshifthdrshift

 HDR bit-shift value (Archon-only) 

I'm not sure what this is, or if it's used by the KPF Archons

1819

 heaterheater

 control HeaterX module (Archon-only) 

We will definitely want to query and change the HeaterX values for tuning and engineering/maintenance.

   set/get target

   set/get PID parameters

   set/get ramp and ramp rate

1920

 imdir

 base base image directory for FITS image files 

Since this won't change it can be hard-set in the config file.Does the daily sub-directory saving still happen if fitsnaming is 'number' and not 'date'?

2021

 imnum

 image image number for FITS image files

KPF will want to use this and set it to the obsID for each exposure.  Then images will be named G_obsID.FITS or R_obsID.FITS

2122

 inreg

 write write to VCPU input register (Archon-only)

I'm not sure if our Archons are using this

2223

 interface

 return return the detector interface type 

Perhaps we want this as a record in case it changes?  Keyword?

2324

 keykey

 add FITS keyword to user-defined database

Would be nice to send the obsID ot the header as a keyword as well (records it for posterity since filename obsID will disappear once it is absorbed into the L0 FITS).  This might be the only FITS keyword we send to the Archons.

2425

 loadload

 load firmware into detector controller

We'll want this for engineering only, so that we can upload a new ACF file if needed.  Not sure what manual means by 'power to detector will be off after' (does another command need to follow this?)

2526

 loadtimingloadtiming

 load timing script and parameters (Archon-only) 

Is this needed as part of an ACF upload?

2627

 longexposurelongexposure

 long exposure mode to extend exptime unit (Archon-only)

Changes time unit for exposure from msec (false) to seconds (true).

Since we are using a TTL-driven trigger exposure I don't think we'll need this

2728

 modemode

 camera mode (Archon-only) 

The default KPF mode will be all 4 quadrants being separate.  Is this what we'd use for different readout modes (1, 2, 4 quadrants?)

2829

 openopen

 open a connection to the detector controller 

No doubt needed by KPF software

2930

 sensorsensor

 set or get temperature sensor current (Archon-only)

Steve K:  do the KPF Archons have any of these sensors?

3031

 setpsetp

 set parameter value (Archon-only) 

I don't think we will set any parameters on the Archon?  Not sure what these parameters would be (Steve K?)

3132

 shuttershutter

 set or get the shutter enable state on expose 

I think we would only use this if we were monitoring the shutter out as an idicator the exposure has begun.

3233

 systemfilesystemfile

 generate a system file (Archon-only) 

Not yet implemented, I think not needed by KPF as we'd just use the native Archon commands SYSTEM and STATUS instead

34

trigin
NEW in 11 Nov. 2021 version.

KPF will use ‘trigin untimed’ to prepare the Archon for a tigger pulse that will start an exposure, a well as a ‘trigin readout’ to prepare the Archon for a trigger pulse that will end an exposure.

35

 useframes

 set or get the useframes flag (ARC-only)

3436

 writekeys

 when to write FITS header keywords 

Likely we use "before exposure" setting?  But perhaps also depends on what Archon does for internal telemetry?

3537

 writep

 write parameter value to configuration memory (Archon-only) 

Not yet implemented. I'm also not sure if we need it.