Derived class for the Aspen (aka g series) series cameras. More...

#include <Aspen.h>

Inheritance diagram for Aspen:

Collaboration diagram for Aspen:

Public Member Functions
	Aspen ()

virtual	~Aspen ()

void	OpenConnection (const std::string &ioType, const std::string &DeviceAddr, const uint16_t FirmwareRev, const uint16_t Id)

void	CloseConnection ()

void	StartExposure (double Duration, bool IsLight)

int32_t	GetNumAdChannels ()

std::string	GetMacAddress ()

void	Init ()

Apg::FanMode	GetFanMode ()

void	SetFanMode (Apg::FanMode mode, bool PreCondCheck=true)

bool	IsDualReadoutSupported ()

void	SetDualReadout (bool TurnOn)

bool	GetDualReadout ()

Public Member Functions inherited from CamGen2Base
virtual	~CamGen2Base ()

CameraStatusRegs	GetStatus ()

Apg::Status	GetImagingStatus ()

void	GetImage (std::vector< uint16_t > &out)

void	StopExposure (bool Digitize)

uint32_t	GetAvailableMemory ()

int32_t	GetNumAds ()

double	GetCoolerDrive ()

double	GetTempHeatsink ()

Public Member Functions inherited from ApogeeCam
virtual	~ApogeeCam ()

void	Reset ()

uint16_t	ReadReg (uint16_t reg)

void	WriteReg (uint16_t reg, uint16_t value)

void	SetRoiNumRows (uint16_t rows)

void	SetRoiNumCols (uint16_t cols)

uint16_t	GetRoiNumRows ()

uint16_t	GetRoiNumCols ()

void	SetRoiStartRow (uint16_t row)

void	SetRoiStartCol (uint16_t col)

uint16_t	GetRoiStartRow ()

uint16_t	GetRoiStartCol ()

void	SetRoiBinRow (uint16_t bin)

uint16_t	GetRoiBinRow ()

void	SetRoiBinCol (uint16_t bin)

uint16_t	GetRoiBinCol ()

uint16_t	GetFirmwareRev ()

void	SetImageCount (uint16_t count)

uint16_t	GetImageCount ()

uint16_t	GetImgSequenceCount ()

void	SetSequenceDelay (double delay)

double	GetSequenceDelay ()

void	SetVariableSequenceDelay (bool variable)

bool	GetVariableSequenceDelay ()

void	SetTdiRate (double TdiRate)

double	GetTdiRate ()

void	SetTdiRows (uint16_t TdiRows)

uint16_t	GetTdiRows ()

uint16_t	GetTdiCounter ()

void	SetTdiBinningRows (uint16_t bin)

uint16_t	GetTdiBinningRows ()

void	SetKineticsSectionHeight (uint16_t height)

uint16_t	GetKineticsSectionHeight ()

void	SetKineticsSections (uint16_t sections)

uint16_t	GetKineticsSections ()

void	SetKineticsShiftInterval (double interval)

double	GetKineticsShiftInterval ()

void	SetShutterStrobePosition (double position)

double	GetShutterStrobePosition ()

void	SetShutterStrobePeriod (double period)

double	GetShutterStrobePeriod ()

void	SetShutterCloseDelay (double delay)

double	GetShutterCloseDelay ()

void	SetCoolerBackoffPoint (double point)

double	GetCoolerBackoffPoint ()

void	SetCoolerSetPoint (double point)

double	GetCoolerSetPoint ()

Apg::CameraMode	GetCameraMode ()

void	SetCameraMode (Apg::CameraMode mode)

void	SetFastSequence (bool TurnOn)

bool	IsFastSequenceOn ()

void	SetBulkDownload (bool TurnOn)

bool	IsBulkDownloadOn ()

void	SetPipelineDownload (bool TurnOn)

bool	IsPipelineDownloadOn ()

void	SetIoPortAssignment (uint16_t assignment)

uint16_t	GetIoPortAssignment ()

void	SetIoPortBlankingBits (uint16_t blankingBits)

uint16_t	GetIoPortBlankingBits ()

void	SetIoPortDirection (uint16_t direction)

uint16_t	GetIoPortDirection ()

void	SetIoPortData (uint16_t data)

uint16_t	GetIoPortData ()

void	SetPreFlash (bool TurnOn)

bool	GetPreFlash ()

void	SetExternalTrigger (bool TurnOn, Apg::TriggerMode trigMode, Apg::TriggerType trigType)

bool	IsTriggerNormEachOn ()

bool	IsTriggerNormGroupOn ()

bool	IsTriggerTdiKinEachOn ()

bool	IsTriggerTdiKinGroupOn ()

bool	IsTriggerExternalShutterOn ()

bool	IsTriggerExternalReadoutOn ()

void	SetShutterState (Apg::ShutterState state)

Apg::ShutterState	GetShutterState ()

bool	IsShutterForcedOpen ()

bool	IsShutterForcedClosed ()

bool	IsShutterOpen ()

void	SetShutterAmpCtrl (bool TurnOn)

bool	IsShutterAmpCtrlOn ()

void	SetCooler (bool TurnOn)

Apg::CoolerStatus	GetCoolerStatus ()

bool	IsCoolerOn ()

double	GetTempCcd ()

void	SetCcdAdcResolution (Apg::Resolution res)

Apg::Resolution	GetCcdAdcResolution ()

void	SetCcdAdcSpeed (Apg::AdcSpeed speed)

Apg::AdcSpeed	GetCcdAdcSpeed ()

uint16_t	GetMaxBinCols ()

uint16_t	GetMaxBinRows ()

uint16_t	GetMaxImgCols ()

uint16_t	GetMaxImgRows ()

uint16_t	GetTotalRows ()

uint16_t	GetTotalCols ()

uint16_t	GetNumOverscanCols ()

bool	IsInterline ()

CamModel::PlatformType	GetPlatformType ()

void	SetLedAState (Apg::LedState state)

Apg::LedState	GetLedAState ()

void	SetLedBState (Apg::LedState state)

Apg::LedState	GetLedBState ()

void	SetLedMode (Apg::LedMode mode)

Apg::LedMode	GetLedMode ()

std::string	GetInfo ()

std::string	GetModel ()

std::string	GetSensor ()

void	SetFlushCommands (bool Disable)

bool	AreFlushCmdsDisabled ()

void	SetPostExposeFlushing (bool Disable)

bool	IsPostExposeFlushingDisabled ()

double	GetPixelWidth ()

double	GetPixelHeight ()

double	GetMinExposureTime ()

double	GetMaxExposureTime ()

bool	IsColor ()

bool	IsCoolingSupported ()

bool	IsCoolingRegulated ()

double	GetInputVoltage ()

CamModel::InterfaceType	GetInterfaceType ()

void	GetUsbVendorInfo (uint16_t &VendorId, uint16_t &ProductId, uint16_t &DeviceId)

bool	IsCCD ()

void	PauseTimer (bool TurnOn)

bool	IsSerialASupported ()

bool	IsSerialBSupported ()

void	SetFlushBinningRows (uint16_t bin)

uint16_t	GetFlushBinningRows ()

bool	IsOverscanDigitized ()

void	SetDigitizeOverscan (const bool TurnOn)

void	SetAdcGain (uint16_t gain, int32_t ad, int32_t channel)

uint16_t	GetAdcGain (int32_t ad, int32_t channel)

void	SetAdcOffset (uint16_t offset, int32_t ad, int32_t channel)

uint16_t	GetAdcOffset (int32_t ad, int32_t channel)

bool	IsInitialized ()

bool	IsConnected ()

void	SetAdSimMode (bool TurnOn)

bool	IsAdSimModeOn ()

void	SetLedBrightness (double PercentIntensity)

double	GetLedBrightness ()

std::string	GetDriverVersion ()

std::string	GetUsbFirmwareVersion ()

std::string	GetSerialNumber ()

CamInfo::StrDb	ReadStrDatabase ()

void	WriteStrDatabase (CamInfo::StrDb &info)

void	UpdateAlta (const std::string FilenameCamCon, const std::string FilenameBufCon, const std::string FilenameFx2, const std::string FilenameGpifCamCon, const std::string FilenameGpifBufCon, const std::string FilenameGpifFifo)

void	UpdateAscentOrAltaF (const std::string FilenameFpga, const std::string FilenameFx2, const std::string FilenameDescriptor)

void	UpdateAspen (const std::string FilenameFpga, const std::string FilenameFx2, const std::string FilenameDescriptor, const std::string FilenameWebPage, const std::string FilenameWebServer, const std::string FilenameWebCfg)

Protected Member Functions
	Aspen (const std::string &ioType, const std::string &DeviceAddr)

void	FixImgFromCamera (const std::vector< uint16_t > &data, std::vector< uint16_t > &out, int32_t rows, int32_t cols)

void	CreateCamIo (const std::string &ioType, const std::string &DeviceAddr)

bool	AreColsCentered ()

void	ExposureAndGetImgRC (uint16_t &r, uint16_t &c)

void	VerifyCamId ()

void	CfgCamFromId (uint16_t CameraId)

void	WriteId2CamReg ()

void	SetIsInterlineBit ()

Protected Member Functions inherited from CamGen2Base
	CamGen2Base (const uint16_t FirmwareRev, const uint16_t Id, CamModel::PlatformType platform)

	CamGen2Base (CamModel::PlatformType platform)

uint16_t	ExposureZ ()

uint16_t	GetImageZ ()

uint16_t	GetIlluminationMask ()

void	DefaultStartExposure (double Duration, bool IsLight, bool IssueReset=true)

Protected Member Functions inherited from ApogeeCam
	ApogeeCam (CamModel::PlatformType platform)

void	VerifyFrmwrRev ()

void	LogConnectAndDisconnect (bool Connect)

void	ExectuePreFlash ()

void	SetExpsoureTime (double Duration)

void	IssueExposeCmd (bool IsLight)

void	IsThereAStatusError (uint16_t statusReg)

bool	IsImgDone (const CameraStatusRegs &statusObj)

Apg::Status	LogAndReturnStatus (Apg::Status status, const CameraStatusRegs &statusObj)

void	SupsendCooler (bool &resume)

void	ResumeCooler ()

void	WaitForCoolerSuspendBit (const uint16_t mask, const bool IsHigh)

void	InitShutterCloseDelay ()

void	StopExposureModeNorm (bool Digitize)

void	Reset (bool Flush)

void	HardStopExposure (const std::string &msg)

void	GrabImageAndThrowItAway ()

void	AdcParamCheck (const int32_t ad, const int32_t channel, const std::string &fxName)

void	SetNumAdOutputs (const uint16_t num)

bool	CheckAndWaitForStatus (Apg::Status desired, Apg::Status &acutal)

void	CancelExposureNoThrow ()

double	DefaultGetTempHeatsink ()

void	DefaultInit ()

void	ClearAllRegisters ()

void	DefaultCfgCamFromId (uint16_t CameraId)

void	DefaultSetFanMode (Apg::FanMode mode, bool PreCondCheck)

Apg::FanMode	DefaultGetFanMode ()

void	DefaultCloseConnection ()

Private Member Functions
void	UpdateCfgWithRegisterInfo ()

void	UpdateCfgWithStrDbInfo ()

	Aspen (const Aspen &)

Aspen &	operator= (Aspen &)

Private Attributes
const std::string	m_fileName

Additional Inherited Members
Protected Attributes inherited from ApogeeCam
std::shared_ptr< CameraIo >	m_CamIo

std::shared_ptr< PlatformData >	m_CameraConsts

std::shared_ptr< CApnCamData >	m_CamCfgData

std::shared_ptr< ModeFsm >	m_CamMode

std::shared_ptr< CcdAcqParams >	m_CcdAcqSettings

std::shared_ptr< ApgTimer >	m_ExposureTimer

CamModel::PlatformType	m_PlatformType

const std::string	m_fileName

uint16_t	m_FirmwareVersion

uint16_t	m_Id

uint16_t	m_NumImgsDownloaded

bool	m_ImageInProgress

bool	m_IsPreFlashOn

bool	m_IsInitialized

bool	m_IsConnected

double	m_LastExposureTime

Detailed Description

Derived class for the Aspen (aka g series) series cameras.

Derived class for the alta g series cameras.

This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.

Constructor & Destructor Documentation

◆ Aspen() [1/3]

Aspen::Aspen ( )

◆ ~Aspen()

Aspen::~Aspen ( )

virtual

◆ Aspen() [2/3]

Aspen::Aspen	(	const std::string &	ioType,
		const std::string &	DeviceAddr
	)

protected

◆ Aspen() [3/3]

Aspen::Aspen ( const Aspen & )

private

Member Function Documentation

◆ AreColsCentered()

bool Aspen::AreColsCentered ( )

protected

◆ CfgCamFromId()

void Aspen::CfgCamFromId ( uint16_t CameraId )

protectedvirtual

Implements ApogeeCam.

◆ CloseConnection()

void Aspen::CloseConnection ( )

virtual

Closes the IO connection to the camera. IMPORTANT: If this call is made if camera is in an error condition, then the function will try to reset the interface. Thus it is not guaranteed that the address for the camera will be the same after this function is called.

Exceptions

std::runtime_error

Implements ApogeeCam.

◆ CreateCamIo()

void Aspen::CreateCamIo	(	const std::string &	ioType,
		const std::string &	DeviceAddr
	)

protected

◆ ExposureAndGetImgRC()

void Aspen::ExposureAndGetImgRC	(	uint16_t &	r,
		uint16_t &	c
	)

protectedvirtual

Implements ApogeeCam.

◆ FixImgFromCamera()

void Aspen::FixImgFromCamera	(	const std::vector< uint16_t > &	data,
		std::vector< uint16_t > &	out,
		int32_t	rows,
		int32_t	cols
	)

protectedvirtual

Implements ApogeeCam.

◆ GetDualReadout()

bool Aspen::GetDualReadout ( )

Returns: true if dual readout is on, false if it is off (single readout mode)

◆ GetFanMode()

Apg::FanMode Aspen::GetFanMode ( )

virtual

Retruns current fan mode. Ascents always return Apg::FanMode_Off.

Exceptions

std::runtime_error

Implements ApogeeCam.

◆ GetMacAddress()

std::string Aspen::GetMacAddress ( )

Returns an ethernet's camera MAC address. Will throw an std::runtime_error exception if the call is made on a USB camera.

Exceptions

std::runtime_error

◆ GetNumAdChannels()

int32_t Aspen::GetNumAdChannels ( )

virtual

Returns the number of channels on the camera's AD converters.

Exceptions

std::runtime_error

Implements ApogeeCam.

◆ Init()

void Aspen::Init ( )

virtual

Method for initializing the Apogee camera system. Must be called once before image acquisition.

Exceptions

std::runtime_error

Implements ApogeeCam.

◆ IsDualReadoutSupported()

bool Aspen::IsDualReadoutSupported ( )

Returns true if dual readout is support on this camera model

◆ OpenConnection()

void Aspen::OpenConnection	(	const std::string &	ioType,
		const std::string &	DeviceAddr,
		const uint16_t	FirmwareRev,
		const uint16_t	Id
	)

virtual

Opens a connection from the PC to the camera. The results strings from the FindDeviceUsb::Find() and the FindDeviceEthernet::Find() functions. provide the input into this function.

Parameters

[in]	ioType	specifies camera IO interface 'usb' or 'ethernet'
[in]	DeviceAddr	specifies the address of the camera on the interface
[in]	FirmwareRev	Camera's firmware revision. Used to verify interface connection.
[in]	Id	Camera's ID. Used to verify interface connection and setup camera specfic parameters.

Exceptions

std::runtime_error

Implements ApogeeCam.

◆ operator=()

Aspen& Aspen::operator= ( Aspen & )

private

◆ SetDualReadout()

void Aspen::SetDualReadout ( bool TurnOn )

Toggles dual readout (data digitzation via 2 ADC's) mode for cameras that support this feature. This function will throw an exception if the calling program tries to activiate this feature on a camera that does not support this mode

Parameters

[in] TurnOn true to activate, false to deactivate (single readout mode)

Exceptions

std::runtime_error

◆ SetFanMode()

void Aspen::SetFanMode	(	Apg::FanMode	mode,
		bool	PreCondCheck = `true`
	)

virtual

Sets the current fan speed. The default value of this variable after initialization is Apg::FanMode_Low. Ascent cameras do not support programmable fan speed, thus writes using this property have no effect.

Parameters

[in]	mode	Desired fan mode
[in]	PreCondCheck	Setting PreCondCheck to false results in the pre-condition checking to be skipped. PreCondCheck should ALWAYS be set to true.

Exceptions

std::runtime_error

Implements ApogeeCam.

◆ SetIsInterlineBit()

void Aspen::SetIsInterlineBit ( )

protected

◆ StartExposure()

void Aspen::StartExposure	(	double	Duration,
		bool	IsLight
	)

virtual

This method begins the imaging process. The type of exposure taken is depends on various state variables including the CameraMode and TriggerMode.

Parameters

[in]	Duration	Length of the exposure(s), in seconds. The valid range for this parameter is GetMinExposureTime() to GetMaxExposureTime().
[in]	Determines	whether the exposure is a light or dark/bias frame. A light frame requires this parameter to be set to true, while a dark frame requires this parameter to be false.

Exceptions

std::runtime_error

Implements ApogeeCam.

◆ UpdateCfgWithRegisterInfo()

void Aspen::UpdateCfgWithRegisterInfo ( )

private

◆ UpdateCfgWithStrDbInfo()

void Aspen::UpdateCfgWithStrDbInfo ( )

private

◆ VerifyCamId()

void Aspen::VerifyCamId ( )

protected

◆ WriteId2CamReg()

void Aspen::WriteId2CamReg ( )

protected

Member Data Documentation

◆ m_fileName

const std::string Aspen::m_fileName

private

The documentation for this class was generated from the following files:

ln/3rdparty/src/indilib/indi-1.7.4/3rdparty/libapogee/Aspen.h
ln/3rdparty/src/indilib/indi-1.7.4/3rdparty/libapogee/Aspen.cpp

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Aspen() [1/3]

◆ ~Aspen()

◆ Aspen() [2/3]

◆ Aspen() [3/3]

Member Function Documentation

◆ AreColsCentered()

◆ CfgCamFromId()

◆ CloseConnection()

◆ CreateCamIo()

◆ ExposureAndGetImgRC()

◆ FixImgFromCamera()

◆ GetDualReadout()

◆ GetFanMode()

◆ GetMacAddress()

◆ GetNumAdChannels()

◆ Init()

◆ IsDualReadoutSupported()

◆ OpenConnection()

◆ operator=()

◆ SetDualReadout()

◆ SetFanMode()

◆ SetIsInterlineBit()

◆ StartExposure()

◆ UpdateCfgWithRegisterInfo()

◆ UpdateCfgWithStrDbInfo()

◆ VerifyCamId()

◆ WriteId2CamReg()

Member Data Documentation

◆ m_fileName