Filter Shutter Assembly

See the "Filter Shutter Assembly Generic WIYN Client Software Manual" by John Jercevic for a description of the FSA GWC interface

Streams

Name				Type	Legal values
----				----	------------
fsa.filter.wheel		int	1-3
fsa.filter.engaged		int	1-8
fsa.filter.requested		int	1-8
fsa.filter.high			int	8
fsa.filter.low			int	1
fsa.filter.state		string	(see Note 1)
fsa.filter.detent		string	(see Note 2)

fsa.filter.filtname		string	(see Note 3)

fsa.shutter.current_exp		double	>= 0.1
fsa.shutter.requested_exp	double	>= 0.1
fsa.shutter.low_exp		double	0.1
fsa.shutter.state		string	(see Note 1)
fsa.shutter.mode		string	(see Note 4)

Notes:
(1) Start, Initialize, Reboot, Ready, Busy, Error, Exit
(2) Unknown, Wheel Free, Wheel Locked, Error
(3) This item is produced by the Arcon interface, all other items by the FSA client on 'pearl'
(4) Unknown, Normal, Fast, Frame Transfer

Commands

Command			Action		Type	Legal Values
-------			------		----	------------
fsa.filter.filter	set		int	1-8
fsa.filter.filter	initialize	int	0
fsa.filter.filter	reboot		int	0

fsa.shutter.shutter	initialize	int	0
fsa.shutter.shutter	reboot		int	0
fsa.shutter.exptime	set		double	>= 0.1
fsa.shutter.mode	set		string	normal, fast, xfer


Device Action callbacks for commands:
	REPLY_ACK
	REPLY_BUSY
	REPLY_FAILURE
	REPLY_DONE
	

Jeff Lewis's documentation:

-----------------------------
 FILTER STREAM : fsa.filter.
-----------------------------

wheel           : int   : filter wheel in use (1, 2, 3)
engaged         : int   : current filter position (1-8)
requested       : int   : most recently requested filter position (1-8)
high            : int   : highest allowed filter position request (8)
low             : int   : lowest allowed filter position request (1)
state           : string: state of filter assembly
detent          : string: is the filter wheel locked in place?

--------------------------------------
 FILTER COMMANDS : fsa.filter.filter.
--------------------------------------
  --action--    --send--
set             : int   : request filter in position #1-8
init            : int~  : force filter to find home position
reboot          : int~  : erase SX memory, load sequences & defaults

~ Note: these should be void, but I didn't see an ENG_VOID type in gwc.h.
        Set the passed int value to zero.

-------------------------------
 SHUTTER STREAM : fsa.shutter.
-------------------------------

current_exp     : double: current exposure time (seconds)
requested_exp   : double: requested exposure time (seconds)
low_exp         : double: lowest allowed exposure time (seconds)
state           : string: state of shutter assembly
mode            : string: current operating mode

-----------------------------------------
 SHUTTER COMMANDS : fsa.shutter.shutter.
-----------------------------------------
  --action--    --send--
init            : int~  : force filter to find home position
reboot          : int~  : erase SX memory, load sequences & defaults

~ Note: these should be void, but I didn't see an ENG_VOID type in gwc.h.
        Set the passed int value to zero.

-----------------------------------------
 SHUTTER COMMANDS : fsa.shutter.exptime.
-----------------------------------------
  --action--    --send--
set             : double: set exposure time (seconds)

-------------------------------------
 SHUTTER COMMANDS : fsa.shutter.set.
-------------------------------------
  --action--    --send--
set             : string: force mode change: "normal", "fast", "xfer"

----------------
 DEVICE ACTIONS
----------------

Associated with the commands,

  fsa.filter.cmd,
  fsa.shutter.cmd

REPLY_ACK
REPLY_BUSY
REPLY_DONE
REPLY_FAILURE

--------
 ALARMS
--------

Associated with the streams,

  fsa.filter.state,
  fsa.shutter.state:

AL_OK
AL_FAILURE

------------
 FSA STATES
------------

The streams fsa.*.state will have one of these strings:

  "Start"
  "Initialise"
  "Reboot"
  "Ready"
  "Busy"
  "Error"
  "Exit"

The stream fsa.filter.detent will have one of these strings:

  "Unknown"
  "Wheel Free"
  "Wheel Locked"
  "Error"

Last update: 2001 April 10