Документ взят из кэша поисковой машины. Адрес оригинального документа : http://www.astro.louisville.edu/software/sbig/archive/xmccd-4.1/xmccd-4.1e/libapogee/src/ApnCamera.i Дата изменения: Thu Apr 8 22:41:00 2010 Дата индексирования: Thu Feb 27 22:37:36 2014 Кодировка: Поисковые слова: annular solar eclipse

/////////////////////////////////////////////////////////////
//
// ApnCamera.h: Interface file for the CApnCamera class.
//
// Copyright (c) 2003-2006 Apogee Instruments, Inc.
//
/////////////////////////////////////////////////////////////

#if !defined(AFX_APNCAMERA_H__CF513996_359F_4103_BBA6_2C730AE2C301__INCLUDED_)
#define AFX_APNCAMERA_H__CF513996_359F_4103_BBA6_2C730AE2C301__INCLUDED_

#if _MSC_VER > 1000
#pragma once
#endif // _MSC_VER > 1000

#include "Apogee.h"

#include "Apn.h"
#include "FpgaRegs/FpgaRegs.h"
#include "ApnCamData.h"
#include "ApnCamData_models.h"


#define MAX_INTEL_HEX_RECORD_LENGTH 16

typedef struct _INTEL_HEX_RECORD
{
unsigned char Length;
unsigned short Address;
unsigned char Type;
unsigned char Data[MAX_INTEL_HEX_RECORD_LENGTH];
} INTEL_HEX_RECORD, *PINTEL_HEX_RECORD;




#define CAPNCAMERA_SUCCESS 0
#define CAPNCAMERA_ERR_CONNECT 1
#define CAPNCAMERA_ERR_READ 2
#define CAPNCAMERA_ERR_WRITE 3
#define CAPNCAMERA_ERR_IMAGE 4
#define CAPNCAMERA_ERR_LINE 5
#define CAPNCAMERA_ERR_START_EXP 6
#define CAPNCAMERA_ERR_STOP_EXP 7
#define CAPNCAMERA_ERR_QUERY 8
#define CAPNCAMERA_ERR_SN 9


typedef struct _FEATURE_SUPPORT_LIST {
bool bSequenceBulkDownload;
} FEATURE_SUPPORT_LIST;


class CApnCamera
{
public:
CApnCamera();
~CApnCamera();

bool GetDeviceHandle( void *hCamera, char *CameraInfo );

bool InitDriver( unsigned long CamIdA,
unsigned short CamIdB,
unsigned long Option );

bool SimpleInitDriver( unsigned long CamIdA,
unsigned short CamIdB,
unsigned long Option );

Apn_Interface GetCameraInterface();

long GetCameraSerialNumber( char *CameraSerialNumber, long *BufferLength );

long GetSystemDriverVersion( char *SystemDriverVersion, long *BufferLength );

long GetUsb8051FirmwareRev( char *FirmwareRev, long *BufferLength );

long GetUsbProductId( unsigned short *pProductId );
long GetUsbDeviceId( unsigned short *pDeviceId );

bool CloseDriver();
long PreStartExpose( unsigned short BitsPerPixel );
long PostStopExposure( bool DigitizeData );

long GetImageData( unsigned short *pImageData,
unsigned short &Width,
unsigned short &Height,
unsigned long &Count );

long GetLineData( unsigned short *pLineBuffer,
unsigned short &Size );

long Read( unsigned short reg, unsigned short& val );
long Write( unsigned short reg, unsigned short val );

long WriteMultiSRMD( unsigned short reg,
unsigned short val[],
unsigned short count );

long WriteMultiMRMD( unsigned short reg[],
unsigned short val[],
unsigned short count );

long QueryStatusRegs( unsigned short& StatusReg,
unsigned short& HeatsinkTempReg,
unsigned short& CcdTempReg,
unsigned short& CoolerDriveReg,
unsigned short& VoltageReg,
unsigned short& TdiCounter,
unsigned short& SequenceCounter,
unsigned short& MostRecentFrame,
unsigned short& ReadyFrame,
unsigned short& CurrentFrame );

void SetNetworkTransferMode( Apn_NetworkMode TransferMode );
long SetCameraSerialNumber( char *CameraSerialNumber, long *BufferLength );
bool DownloadFirmware( PINTEL_HEX_RECORD Firmware );

///////////////////////////////////////////////////////////////////////
// Generic Public calls for handling key camera activities
///////////////////////////////////////////////////////////////////////
long InitDefaults();

bool Expose( double Duration, bool Light );
bool GetImage( unsigned short *pBuffer );
#ifndef ALTA_STANDALONE
bool BufferImage(char *bufferName );
bool BufferDriftScan(char *bufferName, int delay, int rowCount, int nblock , int npipe);
#endif

bool StopExposure( bool DigitizeData );

bool PowerDown();
bool Resume();

bool ResetSystem();
bool ResetSystemNoFlush();
bool PauseTimer( bool PauseState );

bool GuideAbort();
bool GuideRAPlus();
bool GuideRAMinus();
bool GuideDecPlus();
bool GuideDecMinus();
bool ConvertBayerImageToRGB( unsigned short *pBayerBuffer,
unsigned short *pRgbBuffer,
unsigned short ImageWidth,
unsigned short ImageHeight );

///////////////////////////////////////////////////////////////////////
// Public helper functions
///////////////////////////////////////////////////////////////////////
bool ImageReady();
bool ImageInProgress();
void SignalImagingDone();

unsigned short GetExposurePixelsH();
unsigned short GetExposurePixelsV();

///////////////////////////////////////////////////////////////////////
// Public calls for internal state control
///////////////////////////////////////////////////////////////////////
bool read_Present();
unsigned short read_FirmwareVersion();

void read_CameraModel(char *CameraModel, long *BufferLength );
bool read_ShutterState();
bool read_DisableShutter();
void write_DisableShutter( bool DisableShutter );
bool read_ForceShutterOpen();
void write_ForceShutterOpen( bool ForceShutterOpen );
bool read_ShutterAmpControl();
void write_ShutterAmpControl( bool ShutterAmpControl );

bool read_DisableFlushCommands();
void write_DisableFlushCommands( bool DisableFlushCommands );
bool read_DisablePostExposeFlushing();
void write_DisablePostExposeFlushing( bool DisablePostExposeFlushing );

bool read_ExternalIoReadout();
void write_ExternalIoReadout( bool ExternalIoReadout );
bool read_ExternalShutter();
void write_ExternalShutter( bool ExternalShutter );
bool read_FastSequence();
void write_FastSequence( bool FastSequence );

Apn_CameraMode read_CameraMode();
void write_CameraMode( Apn_CameraMode CameraMode );

Apn_Resolution read_DataBits();
void write_DataBits( Apn_Resolution BitResolution );

Apn_Status read_ImagingStatus();

Apn_LedMode read_LedMode();
void write_LedMode( Apn_LedMode LedMode );
Apn_LedState read_LedState( unsigned short LedId );
void write_LedState( unsigned short LedId, Apn_LedState LedState );

bool read_CoolerEnable();
void write_CoolerEnable( bool CoolerEnable );
Apn_CoolerStatus read_CoolerStatus();
double read_CoolerSetPoint();
void write_CoolerSetPoint( double SetPoint );
double read_CoolerBackoffPoint();
void write_CoolerBackoffPoint( double BackoffPoint );
double read_CoolerDrive();
double read_TempCCD();
double read_TempHeatsink();
Apn_FanMode read_FanMode();
void write_FanMode( Apn_FanMode FanMode );

void write_FlushBinningV( unsigned short FlushBinningV );
unsigned short read_FlushBinningV();

unsigned short read_MaxBinningH();
unsigned short read_MaxBinningV();

void write_RoiBinningH( unsigned short RoiBinningH );
unsigned short read_RoiBinningH();
void write_RoiBinningV( unsigned short RoiBinningV );
unsigned short read_RoiBinningV();

unsigned short read_RoiPixelsH();
void write_RoiPixelsH( unsigned short RoiPixelsH );
unsigned short read_RoiPixelsV();
void write_RoiPixelsV( unsigned short RoiPixelsV );

unsigned short read_RoiStartX();
void write_RoiStartX( unsigned short RoiStartX );
unsigned short read_RoiStartY();
void write_RoiStartY( unsigned short RoiStartY );

bool read_DigitizeOverscan();
void write_DigitizeOverscan( bool DigitizeOverscan );
unsigned short read_OverscanColumns();

double read_ShutterStrobePosition();
void write_ShutterStrobePosition( double Position );
double read_ShutterStrobePeriod();
void write_ShutterStrobePeriod( double Period );
double read_ShutterCloseDelay();
void write_ShutterCloseDelay( double ShutterCloseDelay );

bool read_SequenceBulkDownload();
void write_SequenceBulkDownload( bool SequenceBulkDownload );
double read_SequenceDelay();
void write_SequenceDelay( double Delay );
bool read_VariableSequenceDelay();
void write_VariableSequenceDelay( bool VariableSequenceDelay );
unsigned short read_ImageCount();
void write_ImageCount( unsigned short Count );


unsigned short read_SequenceCounter();
unsigned short read_ExposureImageCount();
bool read_ExposureBulkDownload();


bool read_ContinuousImaging();
void write_ContinuousImaging( bool ContinuousImaging );

unsigned short read_TDICounter();
unsigned short read_TDIRows();
void write_TDIRows( unsigned short TdiRows );
double read_TDIRate();
void write_TDIRate( double TdiRate );
unsigned short read_TDIBinningV();
void write_TDIBinningV( unsigned short TdiBinningV );

unsigned short read_KineticsSections();
void write_KineticsSections( unsigned short KineticsSections );
double read_KineticsShiftInterval();
void write_KineticsShiftInterval( double KineticsShiftInterval );
unsigned short read_KineticsSectionHeight();
void write_KineticsSectionHeight( unsigned short KineticsSectionHeight );

bool read_TriggerNormalEach();
void write_TriggerNormalEach( bool TriggerNormalEach );
bool read_TriggerNormalGroup();
void write_TriggerNormalGroup( bool TriggerNormalGroup );
bool read_TriggerTdiKineticsEach();
void write_TriggerTdiKineticsEach( bool TriggerTdiKineticsEach );
bool read_TriggerTdiKineticsGroup();
void write_TriggerTdiKineticsGroup( bool TriggerTdiKineticsGroup );

bool read_ExposureTriggerEach();
bool read_ExposureTriggerGroup();

bool read_ExposureExternalShutter();

bool read_PreFlashEnable();
void write_PreFlashEnable( bool PreFlashEnable );


unsigned short read_IoPortAssignment();
void write_IoPortAssignment( unsigned short IoPortAssignment );
unsigned short read_IoPortBlankingBits();
void write_IoPortBlankingBits( unsigned short IoPortBlankingBits );
unsigned short read_IoPortDirection();
void write_IoPortDirection( unsigned short IoPortDirection );
unsigned short read_IoPortData();
void write_IoPortData( unsigned short IoPortData );

unsigned short read_TwelveBitGain();
void write_TwelveBitGain( unsigned short TwelveBitGain );

unsigned short read_TwelveBitOffset();
void write_TwelveBitOffset( unsigned short TwelveBitOffset );


double read_InputVoltage();
long read_AvailableMemory();

double read_MaxExposureTime();

Apn_NetworkMode read_NetworkTransferMode();
void write_NetworkTransferMode( Apn_NetworkMode TransferMode );

double read_TestLedBrightness();
void write_TestLedBrightness( double TestLedBrightness );


Apn_Platform read_PlatformType();

unsigned short read_AscentADGainSixteenLeft();
unsigned short read_AscentADGainSixteenRight();
void write_AscentADGainSixteen( unsigned short GainValue );

unsigned short read_AscentADOffsetSixteenLeft();
unsigned short read_AscentADOffsetSixteenRight();
void write_AscentADOffsetSixteen( unsigned short OffsetValue );

unsigned short read_DigitizationSpeed();
void write_DigitizationSpeed( unsigned short DigitizationSpeed );

/*
bool FilterInit( Apn_Filter FilterType );
bool FilterClose();

unsigned short read_FilterPosition();
void write_FilterPosition( unsigned short FilterPosition );

bool read_FilterReady();
unsigned short read_FilterMaxPositions();
Apn_Filter read_FilterWheelType();
void read_FilterModel( char *FilterModel, long *BufferLength );
*/

bool read_DataAveraging();
void write_DataAveraging( bool DataAveraging );

bool read_DualReadout();
void write_DualReadout( bool DualReadout );

bool read_ConnectionTest();

bool read_GuideActive();
// void write_GuideActive( bool GuideActive );

double read_GuideRAPlusDuration();
void write_GuideRAPlusDuration( double GuideRAPlusDuration );

double read_GuideRAMinusDuration();
void write_GuideRAMinusDuration( double GuideRAMinusDuration );

double read_GuideDecPlusDuration();
void write_GuideDecPlusDuration( double GuideDecPlusDuration );

double read_GuideDecMinusDuration();
void write_GuideDecMinusDuration( double GuideDecMinusDuration );

Apn_BayerShift read_BayerStartPosition();
void write_BayerStartPosition( Apn_BayerShift BayerStartPosition );

///////////////////////////////////////////////////////////////////////
// Public Variable
///////////////////////////////////////////////////////////////////////
CApnCamData *m_ApnSensorInfo;


/* was private: */

// General helper functions
long LoadVerticalPattern();
long LoadClampPattern( bool UseOppositePatterns );
long LoadSkipPattern( bool UseOppositePatterns );
long LoadRoiPattern( bool UseOppositePatterns, unsigned short Binning );

long WriteHorizontalPattern( APN_HPATTERN_FILE *Pattern,
unsigned short reg,
unsigned short binning );

long InitTwelveBitAD();

long InitAscentSixteenBitAD();

void UpdateGeneralStatus();

long LookupAltaCameraId( unsigned short CameraId );
long LookupAscentCameraId( unsigned short CameraId );

double CheckGuiderRelayDuration( double GuideDuration );
unsigned short CalculateGuiderRelayTimeCounts( double GuideDuration );

void IssueExposeCommand( bool Light );
bool TakeNoDataDarkExposure( double Duration );
void PostExposureRestoreParams();

// Internal private variables
Apn_Platform m_pvtPlatformType;
bool m_pvtResetVerticalArrays;
FEATURE_SUPPORT_LIST m_pvtNewFeatureSupport;

// Camera imaging params
unsigned short m_pvtRoiBinningH;
unsigned short m_pvtRoiBinningV;
unsigned short m_pvtRoiPixelsH;
unsigned short m_pvtRoiPixelsV;
unsigned short m_pvtRoiStartX;
unsigned short m_pvtRoiStartY;

// Camera state variables
Apn_CameraMode m_pvtCameraMode;
bool m_pvtExternalShutter;

bool m_pvtCameraPoweredDown;
bool m_pvtPowerDownCoolerEnable;
Apn_FanMode m_pvtPowerDownFanMode;

Apn_Resolution m_pvtDataBits;

Apn_NetworkMode m_pvtNetworkTransferMode;

Apn_BayerShift m_pvtBayerShift;

bool m_pvtUseAdvancedStatus;

unsigned short m_pvtCameraID;
unsigned short m_pvtFirmwareVersion;

unsigned short m_pvtImageCount;
unsigned short m_pvtTDIRows;
unsigned short m_pvtTDIBinningV;
double m_pvtTDIRate;
unsigned short m_pvtTDICounter;

unsigned short m_pvtFlushBinningV;

bool m_pvtDigitizeOverscan;

bool m_pvtSequenceBulkDownload;
double m_pvtSequenceDelay;
unsigned short m_pvtSequenceCounter;

bool m_pvtFastSequence;

double m_pvtShutterStrobePosition;
double m_pvtShutterStrobePeriod;
double m_pvtShutterCloseDelay;

unsigned short m_pvtExposureTDIRows;

unsigned short m_pvtExposurePixelsH;
unsigned short m_pvtExposurePixelsV;

bool m_pvtExposureTriggerGroup;
bool m_pvtExposureTriggerEach;

bool m_pvtExposureExternalShutter;

unsigned short m_pvtExposureImageCount;
bool m_pvtExposureBulkDownload;

bool m_pvtPreFlashEnable;


unsigned short m_pvtTwelveBitGain;
unsigned short m_pvtTwelveBitOffset;

unsigned short m_pvtAscentSixteenBitGainLeft;
unsigned short m_pvtAscentSixteenBitOffsetLeft;
unsigned short m_pvtAscentSixteenBitGainRight;
unsigned short m_pvtAscentSixteenBitOffsetRight;

bool m_pvtDualReadout;

Apn_LedMode m_pvtLedMode;
Apn_LedState m_pvtLedStateA;
Apn_LedState m_pvtLedStateB;

double m_pvtTestLedBrightness;

bool m_pvtCoolerEnable;
Apn_FanMode m_pvtFanMode;

double m_pvtCoolerBackoffPoint;

Apn_CoolerStatus m_pvtCoolerStatus;
Apn_Status m_pvtImagingStatus;
Apn_Status m_pvtPrevImagingStatus;

bool m_pvtShutterState;
bool m_pvtImageInProgress;
bool m_pvtImageReady;

bool m_pvtTriggerNormalEach;
bool m_pvtTriggerNormalGroup;
bool m_pvtTriggerTdiKineticsEach;
bool m_pvtTriggerTdiKineticsGroup;

unsigned short m_pvtStatusReg;

double m_pvtCoolerDrive;
double m_pvtCurrentHeatsinkTemp;
double m_pvtCurrentCcdTemp;

double m_pvtInputVoltage;

unsigned short m_pvtIoPortDirection;
unsigned short m_pvtIoPortAssignment;
unsigned short m_pvtIoPortBlankingBits;


long m_pvtQueryStatusRetVal;

unsigned short m_pvtMostRecentFrame;
unsigned short m_pvtReadyFrame;
unsigned short m_pvtCurrentFrame;

double m_pvtGuideRAPlusDuration;
double m_pvtGuideRAMinusDuration;
double m_pvtGuideDecPlusDuration;
double m_pvtGuideDecMinusDuration;

Apn_Filter m_pvtFilterWheelType;
unsigned short m_pvtFilterMaxPositions;

bool m_pvtRestoreTdiRowCount;
bool m_pvtRestoreShutterControl;

//////////////////////////////////////////////////
// Platform Constants
//////////////////////////////////////////////////

void SetPlatformConstants();

unsigned short m_PlatformHBinningMax;
unsigned short m_PlatformVBinningMax;

double m_PlatformTimerResolution;
double m_PlatformPeriodTimerResolution;

long m_PlatformTimerOffsetCount;

double m_PlatformSequenceDelayResolution;
double m_PlatformSequenceDelayMaximum;
double m_PlatformSequenceDelayMinimum;

double m_PlatformExposureTimeMin;
double m_PlatformExposureTimeMax;

double m_PlatformTdiRateResolution;
double m_PlatformTdiRateMin;
double m_PlatformTdiRateMax;
double m_PlatformTdiRateDefault;

double m_PlatformVoltageResolution;

double m_PlatformShutterCloseDiff;

double m_PlatformStrobePositionMin;
double m_PlatformStrobePositionMax;
double m_PlatformStrobePositionDefault;

double m_PlatformStrobePeriodMin;
double m_PlatformStrobePeriodMax;
double m_PlatformStrobePeriodDefault;

long m_PlatformTempCounts;
double m_PlatformTempKelvinScaleOffset;

double m_PlatformTempSetpointMin;
double m_PlatformTempSetpointMax;

double m_PlatformTempHeatsinkMin;
double m_PlatformTempHeatsinkMax;

long m_PlatformTempSetpointZeroPoint;
long m_PlatformTempHeatsinkZeroPoint;

double m_PlatformTempDegreesPerBit;

unsigned short m_PlatformFanSpeedOff;
unsigned short m_PlatformFanSpeedLow;
unsigned short m_PlatformFanSpeedMedium;
unsigned short m_PlatformFanSpeedHigh;

double m_PlatformGuiderRelayResolution;
double m_PlatformGuiderRelayMin;
double m_PlatformGuiderRelayMax;
double m_PlatformGuiderRelayOpenTime;
double m_PlatformGuiderRelayCloseTime;

double m_PlatformPreflashDuration;

////////////////////////////////////////////////////////////////////////
// Cached variables for the Expose() method
// double m_pvtCacheDuration;
// unsigned short m_pvtCacheDataBits;
// unsigned short m_pvtCacheRoiPixelsH, m_pvtCacheRoiPixelsV;
// unsigned short m_pvtCacheRoiStartX, m_pvtCacheRoiStartY;
// unsigned short m_pvtCacheRoiBinningH, m_pvtCacheRoiBinningV;

/* added USB/NET specifics */
int m_pvtConnectionOpen;
char m_SysDeviceName[80];
int m_CamIdA;
int m_CamIdB;
int m_Option;
int m_SysImgSizeBytes;
unsigned short m_pvtVendorId;
unsigned short m_pvtProductId;
unsigned short m_pvtDeviceId;
double m_SysDriverVersion;
unsigned short m_pvtSequenceImagesDownloaded ;
unsigned short m_pvtNumImages;
unsigned short m_pvtTdiLinesDownloaded;
char m_HostAddr[80];
unsigned int m_ImageSizeBytes;
bool m_ImageInProgress;
bool m_FastDownload;
unsigned short m_pvtExposeWidth;
unsigned short m_pvtExposeHeight;
bool m_pvtExposeExternalShutter;
unsigned short m_pvtExposeCameraMode;
bool m_pvtExposeSequenceBulkDownload;
bool m_pvtExposeCI;
int m_pvtExposeHBinning;
unsigned short m_pvtExposeBitsPerPixel;
unsigned short m_pvtBitsPerPixel;
bool m_pvtExposeDualReadout;

unsigned int m_cameraNumber;


/* added sensor data mirrors */
bool sensorInfo();
char m_Sensor[20];
char m_CameraModel[20];
unsigned short m_CameraId;
bool m_InterlineCCD;
bool m_SupportsSerialA;
bool m_SupportsSerialB;
bool m_SensorTypeCCD;
unsigned short m_TotalColumns;
unsigned short m_ImagingColumns;
unsigned short m_ClampColumns;
unsigned short m_PreRoiSkipColumns;
unsigned short m_PostRoiSkipColumns;
unsigned short m_OverscanColumns;
unsigned short m_TotalRows;
unsigned short m_ImagingRows;
unsigned short m_UnderscanRows;
unsigned short m_OverscanRows;
unsigned short m_VFlushBinning;
bool m_HFlushDisable;
unsigned short m_ShutterCloseDelay;
double m_PixelSizeX;
double m_PixelSizeY;
bool m_Color;
double m_MinSuggestedExpTime;
// unsigned short m_TempRegRate;
unsigned short m_TempRampRateOne;
unsigned short m_TempRampRateTwo;
double m_PlatformTempSetpointSlope;
double m_PlatformTempSetpointIntercept;
double m_PlatformTempBackoffMin;
double m_PlatformTempBackoffMax;

};

#endif // !defined(AFX_APNCAMERA_H__CF513996_359F_4103_BBA6_2C730AE2C301__INCLUDED_)