#include <dm.hpp>

Collaboration diagram for MagAOX::app::dev::dm< derivedT, realT >:

Public Member Functions
int	setupConfig (mx::app::appConfigurator &config)
	Setup the configuration system.

int	loadConfig (mx::app::appConfigurator &config)
	load the configuration system results

int	appStartup ()
	Startup function.

int	appLogic ()
	DM application logic.

int	appShutdown ()
	DM shutdown.

int	onPowerOff ()
	DM Poweroff.

int	whilePowerOff ()
	DM Poweroff Updates.

int	findDMChannels ()
	Find the DM comb channels.

int	allocate (const dev::shmimT &sp)
	Called after shmimMonitor connects to the dmXXdisp stream. Checks for proper size.

int	processImage (void *curr_src, const dev::shmimT &sp)
	Called by shmimMonitor when a new DM command is available. This is just a pass-through to derivedT::commandDM(char*).

int	releaseDM ()
	Calls derived()->releaseDM() and then 0s all channels and the sat map.

int	checkFlats ()
	Check the flats directory and update the list of flats if anything changes.

int	loadFlat (const std::string &target)
	Load a flat file.

int	setFlat (bool update=false)
	Send the current flat command to the DM.

int	zeroFlat ()
	Zero the flat command on the DM.

int	checkTests ()
	Check the tests directory and update the list of tests if anything changes.

int	loadTest (const std::string &target)
	Load a test file.

int	setTest ()
	Send the current test command to the DM.

int	zeroTest ()
	Zero the test command on the DM.

int	zeroAll (bool nosem=false)
	Zero all channels.

Protected Member Functions
int	clearSat ()
	Clear the saturation maps and zero the shared membory.

Protected Attributes
std::string	m_calibRelDir
	The directory relative to the calibPath. Set this before calling dm<derivedT,realT>::loadConfig().

int	m_channels {0}
	The number of dmcomb channels found as part of allocation.

std::map< std::string, std::string >	m_flatCommands
	Map of flat file name to full path.

std::string	m_flatCurrent
	The name of the current flat command.

mx::improc::eigenImage< realT >	m_flatCommand
	Data storage for the flat command.

bool	m_flatLoaded {false}
	Flag indicating whether a flat is loaded in memory.

IMAGE	m_flatImageStream
	The ImageStreamIO shared memory buffer for the flat.

bool	m_flatSet {false}
	Flag indicating whether the flat command has been set.

std::map< std::string, std::string >	m_testCommands
	Map of test file name to full path.

std::string	m_testCurrent

mx::improc::eigenImage< realT >	m_testCommand
	Data storage for the test command.

bool	m_testLoaded {false}
	Flag indicating whether a test command is loaded in memory.

IMAGE	m_testImageStream
	The ImageStreamIO shared memory buffer for the test.

bool	m_testSet {false}
	Flag indicating whether the test command has been set.

int	m_overSatAct {0}

int	m_intervalSatExceeds {0}

bool	m_intervalSatTrip {0}

mx::improc::eigenImage< uint8_t >	m_instSatMap
	The instantaneous saturation map, 0/1, set by the commandDM() function of the derived class.

mx::improc::eigenImage< uint16_t >	m_accumSatMap
	The accumulated saturation map, which acccumulates for m_satAvgInt then is publised as a 0/1 image.

mx::improc::eigenImage< float >	m_satPercMap
	Map of the percentage of time each actator was saturated during the avg. interval.

IMAGE	m_satImageStream
	The ImageStreamIO shared memory buffer for the sat map.

IMAGE	m_satPercImageStream
	The ImageStreamIO shared memory buffer for the sat percentage map.

Private Types
typedef mx::verbose::vvv	verboseT

Private Member Functions
derivedT &	derived ()

Configurable Parameters
std::string	m_calibPath
	The path to this DM's calibration files.

std::string	m_flatPath
	The path to this DM's flat files (usually the same as calibPath)

std::string	m_testPath
	The path to this DM's test files (default is calibPath/tests;.

std::string	m_flatDefault
	The file name of the this DM's default flat command. Path and extension will be ignored and can be omitted.

std::string	m_testDefault
	The file name of the this DM's default test command. Path and extension will be ignored and can be omitted.

std::string	m_shmimFlat
	The name of the shmim stream to write the flat to.

std::string	m_shmimTest
	The name of the shmim stream to write the test to.

std::string	m_shmimSat
	The name of the shmim stream to write the saturation map to.

std::string	m_shmimSatPerc
	The name of the shmim stream to write the saturation percentage map to.

int	m_satAvgInt {100}
	The time in milliseconds to accumulate saturation over.

int	m_satThreadPrio {0}
	Priority of the saturation thread, should normally be > 0.

uint32_t	m_dmWidth {0}
	The width of the images in the stream.

uint32_t	m_dmHeight {0}
	The height of the images in the stream.

float	m_percThreshold {0.98}

float	m_intervalSatThreshold {0.50}

int	m_intervalSatCountThreshold {10}

std::vector< std::string >	m_satTriggerDevice

std::vector< std::string >	m_satTriggerProperty

static constexpr uint8_t	m_dmDataType = ImageStreamTypeCode<realT>()
	The ImageStreamIO type code.

Saturation Thread
This thread processes the saturation maps
sem_t	m_satSemaphore
	Semaphore used to tell the saturation thread to run.

bool	m_satThreadInit {true}
	Synchronizer for thread startup, to allow priority setting to finish.

pid_t	m_satThreadID {0}
	The ID of the saturation thread.

pcf::IndiProperty	m_satThreadProp
	The property to hold the saturation thread details.

std::thread	m_satThread
	A separate thread for the actual saturation processing.

void	satThreadExec ()
	Execute saturation processing.

void	intervalSatTrip ()

static void	satThreadStart (dm *d)
	Thread starter, called by MagAOXApp::threadStart on thread construction. Calls satThreadExec.

INDI
pcf::IndiProperty	m_indiP_flat
	Property used to set and report the current flat.

pcf::IndiProperty	m_indiP_init

pcf::IndiProperty	m_indiP_zero

pcf::IndiProperty	m_indiP_release

pcf::IndiProperty	m_indiP_flats
	INDI Selection switch containing the flat files.

pcf::IndiProperty	m_indiP_flatShmim
	Publish the shmim being used for the flat.

pcf::IndiProperty	m_indiP_setFlat
	INDI toggle switch to set the current flat.

pcf::IndiProperty	m_indiP_tests
	INDI Selection switch containing the test pattern files.

pcf::IndiProperty	m_indiP_testShmim
	Publish the shmim being used for the test command.

pcf::IndiProperty	m_indiP_setTest
	INDI toggle switch to set the current test pattern.

pcf::IndiProperty	m_indiP_zeroAll

int	newCallBack_init (const pcf::IndiProperty &ipRecv)
	The callback called by the static version, to actually process the new request.

int	newCallBack_zero (const pcf::IndiProperty &ipRecv)
	The callback called by the static version, to actually process the new request.

int	newCallBack_release (const pcf::IndiProperty &ipRecv)
	The callback called by the static version, to actually process the new request.

int	newCallBack_flats (const pcf::IndiProperty &ipRecv)
	The callback called by the static version, to actually process the new request.

int	newCallBack_setFlat (const pcf::IndiProperty &ipRecv)
	The callback called by the static version, to actually process the new request.

int	newCallBack_tests (const pcf::IndiProperty &ipRecv)
	The callback called by the static version, to actually process the new request.

int	newCallBack_setTest (const pcf::IndiProperty &ipRecv)
	The callback called by the static version, to actually process the new request.

int	newCallBack_zeroAll (const pcf::IndiProperty &ipRecv)
	The callback for the zeroAll toggle switch, called by the static version.

int	updateINDI ()
	Update the INDI properties for this device controller.

static int	st_newCallBack_init (void *app, const pcf::IndiProperty &ipRecv)
	The static callback function to be registered for initializing the DM.

static int	st_newCallBack_zero (void *app, const pcf::IndiProperty &ipRecv)
	The static callback function to be registered for initializing the DM.

static int	st_newCallBack_release (void *app, const pcf::IndiProperty &ipRecv)
	The static callback function to be registered for initializing the DM.

static int	st_newCallBack_flats (void *app, const pcf::IndiProperty &ipRecv)
	The static callback function to be registered for selecting the flat file.

static int	st_newCallBack_setFlat (void *app, const pcf::IndiProperty &ipRecv)
	The static callback function to be registered for setting the flat.

static int	st_newCallBack_tests (void *app, const pcf::IndiProperty &ipRecv)
	The static callback function to be registered for selecting the test file.

static int	st_newCallBack_setTest (void *app, const pcf::IndiProperty &ipRecv)
	The static callback function to be registered for setting the test shape.

static int	st_newCallBack_zeroAll (void *app, const pcf::IndiProperty &ipRecv)
	The static callback function to be registered for zeroing all channels.

Detailed Description

template<class derivedT, typename realT>
class MagAOX::app::dev::dm< derivedT, realT >

MagAO-X generic deformable mirror controller

The derived class derivedT must expose the following interface

Each of the above functions should return 0 on success, and -1 on an error.

This class should be declared a friend in the derived class, like so:

friend class dev::dm<derivedT,realT>;

MagAOX::app::dev::dm

Definition dm.hpp:73

Calls to this class's setupConfig, loadConfig, appStartup, appLogic, appShutdown, and udpdateINDI functions must be placed in the derived class's functions of the same name.

Definition at line 72 of file dm.hpp.

Member Typedef Documentation

◆ verboseT

template<class derivedT , typename realT >

typedef mx::verbose::vvv MagAOX::app::dev::dm< derivedT, realT >::verboseT

private

Definition at line 75 of file dm.hpp.

Member Function Documentation

◆ allocate()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::allocate ( const dev::shmimT & sp )

Called after shmimMonitor connects to the dmXXdisp stream. Checks for proper size.

Returns: 0 on success; -1 if incorrect size or data type in stream.

Definition at line 960 of file dm.hpp.

◆ appLogic()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::appLogic ( )

DM application logic.

This should be called in derivedT::appLogic as

dm<derivedT,realT>::appLogic();

MagAOX::app::dev::dm::appLogic

int appLogic()

DM application logic.

Definition dm.hpp:829

with appropriate error checking.

Returns: 0 on success; -1 on error, which is logged.

Definition at line 829 of file dm.hpp.

Referenced by MagAOX::app::alpaoCtrl::appLogic(), MagAOX::app::bmcCtrl::appLogic(), and MagAOX::app::irisaoCtrl::appLogic().

◆ appShutdown()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::appShutdown ( )

DM shutdown.

This should be called in derivedT::appShutdown as

dm<derivedT,realT>::appShutdown();

MagAOX::app::dev::dm::appShutdown

int appShutdown()

DM shutdown.

Definition dm.hpp:886

with appropriate error checking.

Returns: 0 on success; -1 on error, which is logged.

Definition at line 886 of file dm.hpp.

Referenced by MagAOX::app::alpaoCtrl::appShutdown(), MagAOX::app::bmcCtrl::appShutdown(), and MagAOX::app::irisaoCtrl::appShutdown().

◆ appStartup()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::appStartup ( )

Startup function.

This should be called in derivedT::appStartup as

dm<derivedT,realT>::appStartup();

MagAOX::app::dev::dm::appStartup

int appStartup()

Startup function.

Definition dm.hpp:695

with appropriate error checking.

Returns: 0 on success; -1 on error, which is logged.

Definition at line 695 of file dm.hpp.

Referenced by MagAOX::app::alpaoCtrl::appStartup(), MagAOX::app::bmcCtrl::appStartup(), and MagAOX::app::irisaoCtrl::appStartup().

◆ checkFlats()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::checkFlats ( )

Check the flats directory and update the list of flats if anything changes.

This is called once per appLogic and whilePowerOff loops.

Returns: 0 on success; -1 on error

Definition at line 1085 of file dm.hpp.

References MagAOX::app::it.

◆ checkTests()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::checkTests ( )

Check the tests directory and update the list of tests if anything changes.

This is called once per appLogic and whilePowerOff loops.

Returns: 0 on success; -1 on error

Definition at line 1444 of file dm.hpp.

References MagAOX::app::it.

◆ clearSat()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::clearSat ( )

protected

Clear the saturation maps and zero the shared membory.

Returns: 0 on success; -1 on error

Definition at line 1836 of file dm.hpp.

References INDI_IDLE.

◆ derived()

template<class derivedT , typename realT >

derivedT & MagAOX::app::dev::dm< derivedT, realT >::derived ( )

inlineprivate

Definition at line 573 of file dm.hpp.

Referenced by MagAOX::app::dev::dm< derivedT, realT >::intervalSatTrip().

◆ findDMChannels()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::findDMChannels ( )

Find the DM comb channels.

Introspectively finds all dmXXdispYY channels, zeroes them, and raises the semapahore on the last to cause dmcomb to update.

Definition at line 921 of file dm.hpp.

◆ intervalSatTrip()

template<class derivedT , typename realT >

void MagAOX::app::dev::dm< derivedT, realT >::intervalSatTrip ( )

inlineprotected

Definition at line 354 of file dm.hpp.

References MagAOX::app::dev::dm< derivedT, realT >::derived(), MagAOX::app::dev::dm< derivedT, realT >::m_satTriggerDevice, and MagAOX::app::dev::dm< derivedT, realT >::m_satTriggerProperty.

◆ loadConfig()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::loadConfig ( mx::app::appConfigurator & config )

load the configuration system results

This should be called in derivedT::loadConfig as

dm<derivedT,realT>::loadConfig(config);

MagAOX::app::dev::dm::loadConfig

int loadConfig(mx::app::appConfigurator &config)

load the configuration system results

Definition dm.hpp:622

with appropriate error checking.

Parameters

[in] config the derived classes configurator

Definition at line 622 of file dm.hpp.

Referenced by MagAOX::app::alpaoCtrl::loadConfigImpl(), MagAOX::app::bmcCtrl::loadConfigImpl(), and MagAOX::app::irisaoCtrl::loadConfigImpl().

◆ loadFlat()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::loadFlat ( const std::string & target )

Load a flat file.

Uses the target argument for lookup in m_flatCommands to find the path and loads the command in the local memory. Calls setFlat if the flat is currently set.

Returns: 0 on success; -1 on error

Parameters

[in] target the name of the flat to load

Definition at line 1216 of file dm.hpp.

◆ loadTest()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::loadTest ( const std::string & target )

Load a test file.

Uses the target argument for lookup in m_testCommands to find the path and loads the command in the local memory. Calls setTest if the test is currently set.

Definition at line 1538 of file dm.hpp.

◆ newCallBack_flats()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::newCallBack_flats ( const pcf::IndiProperty & ipRecv )

The callback called by the static version, to actually process the new request.

Returns: 0 on success.; -1 on error.

Parameters

[in] ipRecv the INDI property sent with the the new property request.

Definition at line 2166 of file dm.hpp.

References MagAOX::app::ipRecv.

◆ newCallBack_init()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::newCallBack_init ( const pcf::IndiProperty & ipRecv )

The callback called by the static version, to actually process the new request.

Returns: 0 on success.; -1 on error.

Parameters

[in] ipRecv the INDI property sent with the the new property request.

Definition at line 2091 of file dm.hpp.

References MagAOX::app::ipRecv.

◆ newCallBack_release()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::newCallBack_release ( const pcf::IndiProperty & ipRecv )

The callback called by the static version, to actually process the new request.

Returns: 0 on success.; -1 on error.

Parameters

[in] ipRecv the INDI property sent with the the new property request.

Definition at line 2141 of file dm.hpp.

References MagAOX::app::ipRecv.

◆ newCallBack_setFlat()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::newCallBack_setFlat ( const pcf::IndiProperty & ipRecv )

The callback called by the static version, to actually process the new request.

Returns: 0 on success.; -1 on error.

Parameters

[in] ipRecv the INDI property sent with the the new property request.

Definition at line 2216 of file dm.hpp.

References MagAOX::app::ipRecv.

◆ newCallBack_setTest()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::newCallBack_setTest ( const pcf::IndiProperty & ipRecv )

The callback called by the static version, to actually process the new request.

Returns: 0 on success.; -1 on error.

Parameters

[in] ipRecv the INDI property sent with the the new property request.

Definition at line 2294 of file dm.hpp.

References MagAOX::app::ipRecv.

◆ newCallBack_tests()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::newCallBack_tests ( const pcf::IndiProperty & ipRecv )

The callback called by the static version, to actually process the new request.

Returns: 0 on success.; -1 on error.

Parameters

[in] ipRecv the INDI property sent with the the new property request.

Definition at line 2244 of file dm.hpp.

References MagAOX::app::ipRecv.

◆ newCallBack_zero()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::newCallBack_zero ( const pcf::IndiProperty & ipRecv )

The callback called by the static version, to actually process the new request.

Returns: 0 on success.; -1 on error.

Parameters

[in] ipRecv the INDI property sent with the the new property request.

Definition at line 2116 of file dm.hpp.

References MagAOX::app::ipRecv.

◆ newCallBack_zeroAll()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::newCallBack_zeroAll ( const pcf::IndiProperty & ipRecv )

The callback for the zeroAll toggle switch, called by the static version.

Returns: 0 on success.; -1 on error.

Parameters

[in] ipRecv the INDI property sent with the the new property request.

Definition at line 2322 of file dm.hpp.

References INDI_BUSY, MagAOX::app::ipRecv, and MagAOX::app::indi::updateSwitchIfChanged().

◆ onPowerOff()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::onPowerOff ( )

DM Poweroff.

This should be called in derivedT::onPowerOff as

dm<derivedT,realT>::onPowerOff();

MagAOX::app::dev::dm::onPowerOff

int onPowerOff()

DM Poweroff.

Definition dm.hpp:904

with appropriate error checking.

Returns: 0 on success; -1 on error, which is logged.

Definition at line 904 of file dm.hpp.

◆ processImage()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::processImage	(	void *	curr_src,
		const dev::shmimT &	sp
	)

Called by shmimMonitor when a new DM command is available. This is just a pass-through to derivedT::commandDM(char*).

Definition at line 1015 of file dm.hpp.

◆ releaseDM()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::releaseDM ( )

Calls derived()->releaseDM() and then 0s all channels and the sat map.

This is called by the relevant INDI callback

Returns: 0 on success; -1 on error

Definition at line 1066 of file dm.hpp.

◆ satThreadExec()

template<class derivedT , typename realT >

void MagAOX::app::dev::dm< derivedT, realT >::satThreadExec ( )

protected

Execute saturation processing.

Definition at line 1900 of file dm.hpp.

References IMAGESTRUCT_FLOAT, and IMAGESTRUCT_UINT8.

Referenced by MagAOX::app::dev::dm< derivedT, realT >::satThreadStart().

◆ satThreadStart()

template<class derivedT , typename realT >

void MagAOX::app::dev::dm< derivedT, realT >::satThreadStart ( dm< derivedT, realT > * d )

staticprotected

Thread starter, called by MagAOXApp::threadStart on thread construction. Calls satThreadExec.

Parameters

[in] d a pointer to a dm instance (normally this)

Definition at line 1894 of file dm.hpp.

References MagAOX::app::dev::dm< derivedT, realT >::satThreadExec().

◆ setFlat()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::setFlat ( bool update = false )

Send the current flat command to the DM.

Writes the command to the designated shmim.

Returns: 0 on success; -1 on error

Todo:: we are assuming that dmXXcomYY is not a cube. This might be true, but we should add cnt1 handling here anyway. With bounds checks b/c not everyone handles cnt1 properly.

Parameters

[in] update If true, this is an update rather than a new set

Definition at line 1300 of file dm.hpp.

◆ setTest()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::setTest ( )

Send the current test command to the DM.

Writes the command to the designated shmim.

Returns: 0 on success; -1 on error

Todo:: we are assuming that dmXXcomYY is not a cube. This might be true, but we should add cnt1 handling here anyway. With bounds checks b/c not everyone handles cnt1 properly.

Definition at line 1615 of file dm.hpp.

◆ setupConfig()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::setupConfig ( mx::app::appConfigurator & config )

Setup the configuration system.

This should be called in derivedT::setupConfig as

dm<derivedT,realT>::setupConfig(config);

MagAOX::app::dev::dm::setupConfig

int setupConfig(mx::app::appConfigurator &config)

Setup the configuration system.

Definition dm.hpp:580

with appropriate error checking.

Todo:: we shmimMonitor now has configSection so this isn't necessary.

Parameters

[out] config the derived classes configurator

Definition at line 580 of file dm.hpp.

Referenced by MagAOX::app::alpaoCtrl::setupConfig(), MagAOX::app::bmcCtrl::setupConfig(), and MagAOX::app::irisaoCtrl::setupConfig().

◆ st_newCallBack_flats()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::st_newCallBack_flats	(	void *	app,
		const pcf::IndiProperty &	ipRecv
	)

static

The static callback function to be registered for selecting the flat file.

Returns: 0 on success.; -1 on error.

Parameters

[in]	app	a pointer to this, will be static_cast-ed to derivedT.
[in]	ipRecv	the INDI property sent with the the new property request.

Definition at line 2159 of file dm.hpp.

References MagAOX::app::ipRecv.

◆ st_newCallBack_init()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::st_newCallBack_init	(	void *	app,
		const pcf::IndiProperty &	ipRecv
	)

static

The static callback function to be registered for initializing the DM.

Returns: 0 on success.; -1 on error.

Parameters

[in]	app	a pointer to this, will be static_cast-ed to derivedT.
[in]	ipRecv	the INDI property sent with the the new property request.

Definition at line 2084 of file dm.hpp.

References MagAOX::app::ipRecv.

◆ st_newCallBack_release()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::st_newCallBack_release	(	void *	app,
		const pcf::IndiProperty &	ipRecv
	)

static

The static callback function to be registered for initializing the DM.

Returns: 0 on success.; -1 on error.

Parameters

[in]	app	a pointer to this, will be static_cast-ed to derivedT.
[in]	ipRecv	the INDI property sent with the the new property request.

Definition at line 2134 of file dm.hpp.

References MagAOX::app::ipRecv.

◆ st_newCallBack_setFlat()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::st_newCallBack_setFlat	(	void *	app,
		const pcf::IndiProperty &	ipRecv
	)

static

The static callback function to be registered for setting the flat.

Returns: 0 on success.; -1 on error.

Parameters

[in]	app	a pointer to this, will be static_cast-ed to derivedT.
[in]	ipRecv	the INDI property sent with the the new property request.

Definition at line 2209 of file dm.hpp.

References MagAOX::app::ipRecv.

◆ st_newCallBack_setTest()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::st_newCallBack_setTest	(	void *	app,
		const pcf::IndiProperty &	ipRecv
	)

static

The static callback function to be registered for setting the test shape.

Returns: 0 on success.; -1 on error.

Parameters

[in]	app	a pointer to this, will be static_cast-ed to derivedT.
[in]	ipRecv	the INDI property sent with the the new property request.

Definition at line 2287 of file dm.hpp.

References MagAOX::app::ipRecv.

◆ st_newCallBack_tests()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::st_newCallBack_tests	(	void *	app,
		const pcf::IndiProperty &	ipRecv
	)

static

The static callback function to be registered for selecting the test file.

Returns: 0 on success.; -1 on error.

Parameters

[in]	app	a pointer to this, will be static_cast-ed to derivedT.
[in]	ipRecv	the INDI property sent with the the new property request.

Definition at line 2237 of file dm.hpp.

References MagAOX::app::ipRecv.

◆ st_newCallBack_zero()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::st_newCallBack_zero	(	void *	app,
		const pcf::IndiProperty &	ipRecv
	)

static

The static callback function to be registered for initializing the DM.

Returns: 0 on success.; -1 on error.

Parameters

[in]	app	a pointer to this, will be static_cast-ed to derivedT.
[in]	ipRecv	the INDI property sent with the the new property request.

Definition at line 2109 of file dm.hpp.

References MagAOX::app::ipRecv.

◆ st_newCallBack_zeroAll()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::st_newCallBack_zeroAll	(	void *	app,
		const pcf::IndiProperty &	ipRecv
	)

static

The static callback function to be registered for zeroing all channels.

Returns: 0 on success.; -1 on error.

Parameters

[in]	app	a pointer to this, will be static_cast-ed to derivedT.
[in]	ipRecv	the INDI property sent with the the new property request.

Definition at line 2315 of file dm.hpp.

References MagAOX::app::ipRecv.

◆ updateINDI()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::updateINDI ( )

Update the INDI properties for this device controller.

You should call this once per main loop. It is not called automatically.

Returns: 0 on success.; -1 on error.

Definition at line 2075 of file dm.hpp.

◆ whilePowerOff()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::whilePowerOff ( )

DM Poweroff Updates.

This should be called in derivedT::whilePowerOff as

dm<derivedT,realT>::whilePowerOff();

MagAOX::app::dev::dm::whilePowerOff

int whilePowerOff()

DM Poweroff Updates.

Definition dm.hpp:912

with appropriate error checking.

Returns: 0 on success; -1 on error, which is logged.

Definition at line 912 of file dm.hpp.

◆ zeroAll()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::zeroAll ( bool nosem = false )

Zero all channels.

Returns: 0 on sucess; <0 on an error

Parameters

[in] nosem [optional] if true then the semaphore is not raised after zeroing all channels

Definition at line 1758 of file dm.hpp.

References INDI_IDLE.

◆ zeroFlat()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::zeroFlat ( )

Zero the flat command on the DM.

Writes a 0 array the designated shmim.

Returns: 0 on success; -1 on error

Todo:: we are assuming that dmXXcomYY is not a cube. This might be true, but we should add cnt1 handling here anyway. With bounds checks b/c not everyone handles cnt1 properly.

Definition at line 1390 of file dm.hpp.

◆ zeroTest()

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::zeroTest ( )

Zero the test command on the DM.

Writes a 0 array the designated shmim.

Returns: 0 on success; -1 on error

Todo:: we are assuming that dmXXcomYY is not a cube. This might be true, but we should add cnt1 handling here anyway. With bounds checks b/c not everyone handles cnt1 properly.

Definition at line 1703 of file dm.hpp.

Member Data Documentation

◆ m_accumSatMap

template<class derivedT , typename realT >

mx::improc::eigenImage<uint16_t> MagAOX::app::dev::dm< derivedT, realT >::m_accumSatMap

protected

The accumulated saturation map, which acccumulates for m_satAvgInt then is publised as a 0/1 image.

Definition at line 320 of file dm.hpp.

◆ m_calibPath

template<class derivedT , typename realT >

std::string MagAOX::app::dev::dm< derivedT, realT >::m_calibPath

protected

The path to this DM's calibration files.

Definition at line 82 of file dm.hpp.

◆ m_calibRelDir

template<class derivedT , typename realT >

std::string MagAOX::app::dev::dm< derivedT, realT >::m_calibRelDir

protected

The directory relative to the calibPath. Set this before calling dm<derivedT,realT>::loadConfig().

Definition at line 113 of file dm.hpp.

◆ m_channels

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::m_channels {0}

protected

The number of dmcomb channels found as part of allocation.

Definition at line 115 of file dm.hpp.

◆ m_dmDataType

template<class derivedT , typename realT >

constexpr uint8_t MagAOX::app::dev::dm< derivedT, realT >::m_dmDataType = ImageStreamTypeCode<realT>()

staticconstexprprotected

The ImageStreamIO type code.

Definition at line 102 of file dm.hpp.

◆ m_dmHeight

template<class derivedT , typename realT >

uint32_t MagAOX::app::dev::dm< derivedT, realT >::m_dmHeight {0}

protected

The height of the images in the stream.

Definition at line 100 of file dm.hpp.

◆ m_dmWidth

template<class derivedT , typename realT >

uint32_t MagAOX::app::dev::dm< derivedT, realT >::m_dmWidth {0}

protected

The width of the images in the stream.

Definition at line 99 of file dm.hpp.

◆ m_flatCommand

template<class derivedT , typename realT >

mx::improc::eigenImage<realT> MagAOX::app::dev::dm< derivedT, realT >::m_flatCommand

protected

Data storage for the flat command.

Definition at line 120 of file dm.hpp.

◆ m_flatCommands

template<class derivedT , typename realT >

std::map<std::string, std::string> MagAOX::app::dev::dm< derivedT, realT >::m_flatCommands

protected

Map of flat file name to full path.

Definition at line 117 of file dm.hpp.

◆ m_flatCurrent

template<class derivedT , typename realT >

std::string MagAOX::app::dev::dm< derivedT, realT >::m_flatCurrent

protected

The name of the current flat command.

Definition at line 118 of file dm.hpp.

◆ m_flatDefault

template<class derivedT , typename realT >

std::string MagAOX::app::dev::dm< derivedT, realT >::m_flatDefault

protected

The file name of the this DM's default flat command. Path and extension will be ignored and can be omitted.

Definition at line 86 of file dm.hpp.

◆ m_flatImageStream

template<class derivedT , typename realT >

IMAGE MagAOX::app::dev::dm< derivedT, realT >::m_flatImageStream

protected

The ImageStreamIO shared memory buffer for the flat.

Definition at line 123 of file dm.hpp.

◆ m_flatLoaded

template<class derivedT , typename realT >

bool MagAOX::app::dev::dm< derivedT, realT >::m_flatLoaded {false}

protected

Flag indicating whether a flat is loaded in memory.

Definition at line 121 of file dm.hpp.

◆ m_flatPath

template<class derivedT , typename realT >

std::string MagAOX::app::dev::dm< derivedT, realT >::m_flatPath

protected

The path to this DM's flat files (usually the same as calibPath)

Definition at line 83 of file dm.hpp.

◆ m_flatSet

template<class derivedT , typename realT >

bool MagAOX::app::dev::dm< derivedT, realT >::m_flatSet {false}

protected

Flag indicating whether the flat command has been set.

Definition at line 124 of file dm.hpp.

◆ m_indiP_flat

template<class derivedT , typename realT >

pcf::IndiProperty MagAOX::app::dev::dm< derivedT, realT >::m_indiP_flat

protected

Property used to set and report the current flat.

Definition at line 390 of file dm.hpp.

◆ m_indiP_flats

template<class derivedT , typename realT >

pcf::IndiProperty MagAOX::app::dev::dm< derivedT, realT >::m_indiP_flats

protected

INDI Selection switch containing the flat files.

Definition at line 396 of file dm.hpp.

◆ m_indiP_flatShmim

template<class derivedT , typename realT >

pcf::IndiProperty MagAOX::app::dev::dm< derivedT, realT >::m_indiP_flatShmim

protected

Publish the shmim being used for the flat.

Definition at line 397 of file dm.hpp.

◆ m_indiP_init

template<class derivedT , typename realT >

pcf::IndiProperty MagAOX::app::dev::dm< derivedT, realT >::m_indiP_init

protected

Definition at line 392 of file dm.hpp.

◆ m_indiP_release

template<class derivedT , typename realT >

pcf::IndiProperty MagAOX::app::dev::dm< derivedT, realT >::m_indiP_release

protected

Definition at line 394 of file dm.hpp.

◆ m_indiP_setFlat

template<class derivedT , typename realT >

pcf::IndiProperty MagAOX::app::dev::dm< derivedT, realT >::m_indiP_setFlat

protected

INDI toggle switch to set the current flat.

Definition at line 398 of file dm.hpp.

◆ m_indiP_setTest

template<class derivedT , typename realT >

pcf::IndiProperty MagAOX::app::dev::dm< derivedT, realT >::m_indiP_setTest

protected

INDI toggle switch to set the current test pattern.

Definition at line 402 of file dm.hpp.

◆ m_indiP_tests

template<class derivedT , typename realT >

pcf::IndiProperty MagAOX::app::dev::dm< derivedT, realT >::m_indiP_tests

protected

INDI Selection switch containing the test pattern files.

Definition at line 400 of file dm.hpp.

◆ m_indiP_testShmim

template<class derivedT , typename realT >

pcf::IndiProperty MagAOX::app::dev::dm< derivedT, realT >::m_indiP_testShmim

protected

Publish the shmim being used for the test command.

Definition at line 401 of file dm.hpp.

◆ m_indiP_zero

template<class derivedT , typename realT >

pcf::IndiProperty MagAOX::app::dev::dm< derivedT, realT >::m_indiP_zero

protected

Definition at line 393 of file dm.hpp.

◆ m_indiP_zeroAll

template<class derivedT , typename realT >

pcf::IndiProperty MagAOX::app::dev::dm< derivedT, realT >::m_indiP_zeroAll

protected

Definition at line 404 of file dm.hpp.

◆ m_instSatMap

template<class derivedT , typename realT >

mx::improc::eigenImage<uint8_t> MagAOX::app::dev::dm< derivedT, realT >::m_instSatMap

protected

The instantaneous saturation map, 0/1, set by the commandDM() function of the derived class.

Definition at line 319 of file dm.hpp.

◆ m_intervalSatCountThreshold

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::m_intervalSatCountThreshold {10}

protected

Definition at line 106 of file dm.hpp.

◆ m_intervalSatExceeds

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::m_intervalSatExceeds {0}

protected

Definition at line 136 of file dm.hpp.

◆ m_intervalSatThreshold

template<class derivedT , typename realT >

float MagAOX::app::dev::dm< derivedT, realT >::m_intervalSatThreshold {0.50}

protected

Definition at line 105 of file dm.hpp.

◆ m_intervalSatTrip

template<class derivedT , typename realT >

bool MagAOX::app::dev::dm< derivedT, realT >::m_intervalSatTrip {0}

protected

Definition at line 137 of file dm.hpp.

◆ m_overSatAct

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::m_overSatAct {0}

protected

Definition at line 135 of file dm.hpp.

◆ m_percThreshold

template<class derivedT , typename realT >

float MagAOX::app::dev::dm< derivedT, realT >::m_percThreshold {0.98}

protected

Definition at line 104 of file dm.hpp.

◆ m_satAvgInt

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::m_satAvgInt {100}

protected

The time in milliseconds to accumulate saturation over.

Definition at line 94 of file dm.hpp.

◆ m_satImageStream

template<class derivedT , typename realT >

IMAGE MagAOX::app::dev::dm< derivedT, realT >::m_satImageStream

protected

The ImageStreamIO shared memory buffer for the sat map.

Definition at line 323 of file dm.hpp.

◆ m_satPercImageStream

template<class derivedT , typename realT >

IMAGE MagAOX::app::dev::dm< derivedT, realT >::m_satPercImageStream

protected

The ImageStreamIO shared memory buffer for the sat percentage map.

Definition at line 324 of file dm.hpp.

◆ m_satPercMap

template<class derivedT , typename realT >

mx::improc::eigenImage<float> MagAOX::app::dev::dm< derivedT, realT >::m_satPercMap

protected

Map of the percentage of time each actator was saturated during the avg. interval.

Definition at line 321 of file dm.hpp.

◆ m_satSemaphore

template<class derivedT , typename realT >

sem_t MagAOX::app::dev::dm< derivedT, realT >::m_satSemaphore

protected

Semaphore used to tell the saturation thread to run.

Definition at line 338 of file dm.hpp.

◆ m_satThread

template<class derivedT , typename realT >

std::thread MagAOX::app::dev::dm< derivedT, realT >::m_satThread

protected

A separate thread for the actual saturation processing.

Definition at line 346 of file dm.hpp.

◆ m_satThreadID

template<class derivedT , typename realT >

pid_t MagAOX::app::dev::dm< derivedT, realT >::m_satThreadID {0}

protected

The ID of the saturation thread.

Definition at line 342 of file dm.hpp.

◆ m_satThreadInit

template<class derivedT , typename realT >

bool MagAOX::app::dev::dm< derivedT, realT >::m_satThreadInit {true}

protected

Synchronizer for thread startup, to allow priority setting to finish.

Definition at line 340 of file dm.hpp.

◆ m_satThreadPrio

template<class derivedT , typename realT >

int MagAOX::app::dev::dm< derivedT, realT >::m_satThreadPrio {0}

protected

Priority of the saturation thread, should normally be > 0.

Todo:: satThreadPrio configuration is not actually implemented.

Definition at line 97 of file dm.hpp.

◆ m_satThreadProp

template<class derivedT , typename realT >

pcf::IndiProperty MagAOX::app::dev::dm< derivedT, realT >::m_satThreadProp

protected

The property to hold the saturation thread details.

Definition at line 344 of file dm.hpp.

◆ m_satTriggerDevice

template<class derivedT , typename realT >

std::vector<std::string> MagAOX::app::dev::dm< derivedT, realT >::m_satTriggerDevice

protected

Definition at line 108 of file dm.hpp.

Referenced by MagAOX::app::dev::dm< derivedT, realT >::intervalSatTrip().

◆ m_satTriggerProperty

template<class derivedT , typename realT >

std::vector<std::string> MagAOX::app::dev::dm< derivedT, realT >::m_satTriggerProperty

protected

Definition at line 109 of file dm.hpp.

Referenced by MagAOX::app::dev::dm< derivedT, realT >::intervalSatTrip().

◆ m_shmimFlat

template<class derivedT , typename realT >

std::string MagAOX::app::dev::dm< derivedT, realT >::m_shmimFlat

protected

The name of the shmim stream to write the flat to.

Definition at line 89 of file dm.hpp.

◆ m_shmimSat

template<class derivedT , typename realT >

std::string MagAOX::app::dev::dm< derivedT, realT >::m_shmimSat

protected

The name of the shmim stream to write the saturation map to.

Definition at line 91 of file dm.hpp.

◆ m_shmimSatPerc

template<class derivedT , typename realT >

std::string MagAOX::app::dev::dm< derivedT, realT >::m_shmimSatPerc

protected

The name of the shmim stream to write the saturation percentage map to.

Definition at line 92 of file dm.hpp.

◆ m_shmimTest

template<class derivedT , typename realT >

std::string MagAOX::app::dev::dm< derivedT, realT >::m_shmimTest

protected

The name of the shmim stream to write the test to.

Definition at line 90 of file dm.hpp.

◆ m_testCommand

template<class derivedT , typename realT >

mx::improc::eigenImage<realT> MagAOX::app::dev::dm< derivedT, realT >::m_testCommand

protected

Data storage for the test command.

Definition at line 129 of file dm.hpp.

◆ m_testCommands

template<class derivedT , typename realT >

std::map<std::string, std::string> MagAOX::app::dev::dm< derivedT, realT >::m_testCommands

protected

Map of test file name to full path.

Definition at line 126 of file dm.hpp.

◆ m_testCurrent

template<class derivedT , typename realT >

std::string MagAOX::app::dev::dm< derivedT, realT >::m_testCurrent

protected

Definition at line 127 of file dm.hpp.

◆ m_testDefault

template<class derivedT , typename realT >

std::string MagAOX::app::dev::dm< derivedT, realT >::m_testDefault

protected

The file name of the this DM's default test command. Path and extension will be ignored and can be omitted.

Definition at line 87 of file dm.hpp.

◆ m_testImageStream

template<class derivedT , typename realT >

IMAGE MagAOX::app::dev::dm< derivedT, realT >::m_testImageStream

protected

The ImageStreamIO shared memory buffer for the test.

Definition at line 132 of file dm.hpp.

◆ m_testLoaded

template<class derivedT , typename realT >

bool MagAOX::app::dev::dm< derivedT, realT >::m_testLoaded {false}

protected

Flag indicating whether a test command is loaded in memory.

Definition at line 130 of file dm.hpp.

◆ m_testPath

template<class derivedT , typename realT >

std::string MagAOX::app::dev::dm< derivedT, realT >::m_testPath

protected

The path to this DM's test files (default is calibPath/tests;.

Definition at line 84 of file dm.hpp.

◆ m_testSet

template<class derivedT , typename realT >

bool MagAOX::app::dev::dm< derivedT, realT >::m_testSet {false}

protected

Flag indicating whether the test command has been set.

Definition at line 133 of file dm.hpp.

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

libMagAOX/app/dev/dm.hpp

Public Member Functions

Protected Member Functions

Protected Attributes

Private Types

Private Member Functions

Configurable Parameters

Saturation Thread

INDI

Detailed Description

Member Typedef Documentation

◆ verboseT

Member Function Documentation

◆ allocate()

◆ appLogic()

◆ appShutdown()

◆ appStartup()

◆ checkFlats()

◆ checkTests()

◆ clearSat()

◆ derived()

◆ findDMChannels()

◆ intervalSatTrip()

◆ loadConfig()

◆ loadFlat()

◆ loadTest()

◆ newCallBack_flats()

◆ newCallBack_init()

◆ newCallBack_release()

◆ newCallBack_setFlat()

◆ newCallBack_setTest()

◆ newCallBack_tests()

◆ newCallBack_zero()

◆ newCallBack_zeroAll()

◆ onPowerOff()

◆ processImage()

◆ releaseDM()

◆ satThreadExec()

◆ satThreadStart()

◆ setFlat()

◆ setTest()

◆ setupConfig()

◆ st_newCallBack_flats()

◆ st_newCallBack_init()

◆ st_newCallBack_release()

◆ st_newCallBack_setFlat()

◆ st_newCallBack_setTest()

◆ st_newCallBack_tests()

◆ st_newCallBack_zero()

◆ st_newCallBack_zeroAll()

◆ updateINDI()

◆ whilePowerOff()

◆ zeroAll()

◆ zeroFlat()

◆ zeroTest()

Member Data Documentation

◆ m_accumSatMap

◆ m_calibPath

◆ m_calibRelDir

◆ m_channels

◆ m_dmDataType

◆ m_dmHeight

◆ m_dmWidth

◆ m_flatCommand

◆ m_flatCommands

◆ m_flatCurrent

◆ m_flatDefault

◆ m_flatImageStream

◆ m_flatLoaded

◆ m_flatPath

◆ m_flatSet

◆ m_indiP_flat

◆ m_indiP_flats

◆ m_indiP_flatShmim

◆ m_indiP_init

◆ m_indiP_release

◆ m_indiP_setFlat

◆ m_indiP_setTest

◆ m_indiP_tests

◆ m_indiP_testShmim

◆ m_indiP_zero