Download SBIG Universal Driver/Library

Transcript
Santa Barbara Instrument Group
•
•
•
•
Universal Driver Application Note
The CFW Command is a single API call that supports multiple sub-commands through the
cfwCommand entry in the CFWParams. Each of the sub-commands requires certain settings of
the CFWParams entries and returns varying results in the CFWResults. Each of these
sub-commands is discussed in detail above.
As with all API calls the CFW Command returns an error code. If the error code is
CE_CFW_ERROR, then in addition the cfwError entry in the CFWResults further enumerates
the error.
With the CFW-6A model color filter wheel set the cfwParam1 item to the desired calibrated
pulse width in microseconds for the Goto and Init sub-commands.
With the CFW-1602 use the Goto command to Position 4 to access a special dark position. After
issuing this command you must do a CFW Init command before going to any other positions.
3.4.11 Motor Focus
The Motor Focus Command is a high-level API for controlling SBIG Motor Focus accessories. It
supports the new ST Motor Focus unit and will be expanded as required to support new models in the
future.
Parameters Struct:
struct MFParams{
enum mfModel – (see the MF_MODEL_SELECT enum)
0=Unknown, 1=Auto Select, 2=ST Motor Focuser
enum mfCommand – (see the MF_COMMAND enum)
0=Query, 1=Goto, 2=Init, 3=Get Info, 4=Abort
long mfParam1 - command specific
long mfParam2 - “ “
ushort outLength - “ “
uchar *outPtr
-“ “
ushort inLength - “ “
uchar *inPtr
-“ “
} MFParams;
Results Struct:
typedef struct {
enum mfModel - (see the mfModel above)
long mfPosition – (position of the Motor Focus, 0=Center, signed)
enum mfStatus – (see the MF_STATUS enum)
enum mfError – (see the MF_ERROR enum)
long mfResult1 – command specific
long mfResult2 – “
“
} MFResults;
Motor Focus Command MFC_QUERY
• Use this command to monitor the progress of the Goto sub-command. This command takes no
additional parameters in the MFParams. You would typically do this several times a second after
the issuing the Goto command until it reports MFS_IDLE in the mfStatus entry of the
MFResults. Motor Focus accessories report their current position in the mfPosition entry of the
MFResults struct where the position is a signed long with 0 designating the center of motion or
the home position. Also the Temperature in hundredths of a degree-C is reported in the
mfResult1 entry.
Page 23