MagAOX::app::dev::telemeter< derivedT > Struct Template Reference

A device base class which saves telemetry. More...

#include <telemeter.hpp>

Collaboration diagram for MagAOX::app::dev::telemeter< derivedT >:

Public Types
typedef XWC_DEFAULT_VERBOSITY	verboseT
typedef logger::logManager< derivedT, logFileRaw< verboseT > >	logManagerT
	The log manager type.

Public Member Functions
	telemeter ()
template<typename telT >
int	telem (const typename telT::messageT &msg)
	Make a telemetry recording.
int	setupConfig (appConfigurator &config)
	Setup an application configurator for the device section.
int	loadConfig (appConfigurator &config)
	Load the device section from an application configurator.
int	appStartup ()
	Starts the telemetry log thread.
int	appLogic ()
	Perform telemeter application logic.
int	appShutdown ()
	Perform telemeter application shutdown.
template<class telT , class... telTs>
int	checkRecordTimes (const telT &tel, telTs... tels)
	Check the time of the last record for each telemetry type and make an entry if needed.
template<class telT , class... telTs>
int	checkRecordTimes (timespec &ts, const telT &tel, telTs... tels)
	Worker function to actually perform the record time checking logic.
int	checkRecordTimes (timespec &ts)
	Empty function called at the end of the template list.

Public Attributes
logManagerT	m_tel
double	m_maxInterval {10.0}
	The maximum interval, in seconds, between telemetry records. Default is 10.0 seconds.

Private Member Functions
derivedT &	derived ()
	Access the derived class.

Detailed Description

template<class derivedT>
struct MagAOX::app::dev::telemeter< derivedT >

A device base class which saves telemetry.

CRTP class derivedT has the following requirements:

• Must be a MagAOXApp
• Must include the following friend declaration:

  friend class dev::telemeter<DERIVEDNAME>; //replace DERIVEDNAME with derivedT class name

• Must include the following typedef:

  typedef dev::telemeter<DERIVEDNAME> telemeterT; //replace DERIVEDNAME with derivedT class name

• Must implement the following interface:

  int checkRecordTimes()
  {
       // Must call this variadic template function with each relevant telemetry type exactly like this
       return telemeterT::checkRecordTimes( telem_type1(), telem_type2(), ..., telem_typeN());
  }

  where there is one constructor-call argument for each telemetry log type recorded by this device. The resultant objects are not used, rather the types are just used for variadic template resolution.
• Must provide one overload of the following function for each telemetry type:

  int recordTelem( const telem_type1 * )
  {
     //DO NOT USE telem_type1
     return m_tel<telem_type1>( { message entered here } );
  }

  You MUST NOT use the pointer argument, it is for type resolution only – you should fill in the telemetry log message using internal values. Note that calls to this function should result in a telemetry log entry every time – it is called when the minimum interval has elapsed since the last entry.
• Must call this class's setupConfig(), loadConfig(), appStartup(), appLogic(), and appShutdown() in the corresponding function of derivedT, with error checking. For convenience the following macros are defined to provide error checking:

  TELEMETER_SETUP_CONFIG( cfig )
  TELEMETER_LOAD_CONFIG( cfig )
  TELEMETER_APP_STARTUP
  TELEMETER_APP_LOGIC
  TELEMETER_APP_SHUTDOWN

Definition at line 74 of file telemeter.hpp.

Member Typedef Documentation

logManagerT

template<class derivedT >

typedef logger::logManager<derivedT, logFileRaw<verboseT> > MagAOX::app::dev::telemeter< derivedT >::logManagerT

The log manager type.

Definition at line 79 of file telemeter.hpp.

verboseT

template<class derivedT >

typedef XWC_DEFAULT_VERBOSITY MagAOX::app::dev::telemeter< derivedT >::verboseT

Definition at line 76 of file telemeter.hpp.

Constructor & Destructor Documentation

telemeter()

template<class derivedT >

MagAOX::app::dev::telemeter< derivedT >::telemeter

(

)

Definition at line 188 of file telemeter.hpp.

Member Function Documentation

appLogic()

template<class derivedT >

int MagAOX::app::dev::telemeter< derivedT >::appLogic

(

)

Perform telemeter application logic.

This calls derivedT::checkRecordTimes(), and should be called from derivedT::appLogic, but only when the FSM is in states where telemetry logging makes sense.

Returns

0 on success

-1 on error

Definition at line 289 of file telemeter.hpp.

References MagAOX::app::dev::telemeter< derivedT >::checkRecordTimes().

Referenced by TEST_CASE().

appShutdown()

template<class derivedT >

int MagAOX::app::dev::telemeter< derivedT >::appShutdown

(

)

Perform telemeter application shutdown.

This currently does nothing.

Returns

0 on success

-1 on error

Definition at line 307 of file telemeter.hpp.

Referenced by MagAOX::app::andorCtrl::appShutdown(), MagAOX::app::dmSpeckle::appShutdown(), MagAOX::app::koolanceCtrl::appShutdown(), MagAOX::app::ocam2KCtrl::appShutdown(), MagAOX::app::qhyCtrl::appShutdown(), MagAOX::app::siglentSDG::appShutdown(), MagAOX::app::sparkleClock::appShutdown(), MagAOX::app::sysMonitor::appShutdown(), and TEST_CASE().

appStartup()

template<class derivedT >

int MagAOX::app::dev::telemeter< derivedT >::appStartup

(

)

Starts the telemetry log thread.

This should be called from derivedT::appStartup

Returns

0 on success

-1 on error

Definition at line 256 of file telemeter.hpp.

Referenced by MagAOX::app::smc100ccCtrl::appStartup(), TEST_CASE(), and TEST_CASE().

checkRecordTimes() [1/3]

template<class derivedT >

template<class telT , class... telTs>

int MagAOX::app::dev::telemeter< derivedT >::checkRecordTimes	(	const telT &	tel,
		telTs...	tels
	)

Check the time of the last record for each telemetry type and make an entry if needed.

This must be called from derivedT::checkRecordTimes(), with one template parameter for ach telemetry log type being recorded.

Returns

0 on succcess

-1 on error

Parameters

[in]	tel	[unused] object of the telemetry type to record
[in]	tels	[unused] objects of the additional telemetry types to record

Definition at line 314 of file telemeter.hpp.

Referenced by MagAOX::app::dev::telemeter< derivedT >::appLogic(), MagAOX::app::filterWheelCtrl::checkRecordTimes(), MagAOX::app::hsfwCtrl::checkRecordTimes(), MagAOX::app::rhusbMon::checkRecordTimes(), and MagAOX::app::usbtempMon::checkRecordTimes().

checkRecordTimes() [2/3]

template<class derivedT >

int MagAOX::app::dev::telemeter< derivedT >::checkRecordTimes

(

timespec &

ts

)

Empty function called at the end of the template list.

Returns

0 on succcess

-1 on error

Parameters

[in]

ts

[unused] the timestamp that records are compared to

Definition at line 336 of file telemeter.hpp.

checkRecordTimes() [3/3]

template<class derivedT >

template<class telT , class... telTs>

int MagAOX::app::dev::telemeter< derivedT >::checkRecordTimes	(	timespec &	ts,
		const telT &	tel,
		telTs...	tels
	)

Worker function to actually perform the record time checking logic.

Recursively calls itself until the variadic template list is exhausted.

Returns

0 on succcess

-1 on error

Parameters

[in]	ts	[unused] the timestamp that records are compared to
[in]	tel	[unused] objects of the telemetry type to record
[in]	tels	[unused] objects of the additional telemetry types to record

Definition at line 324 of file telemeter.hpp.

derived()

template<class derivedT >

derivedT & MagAOX::app::dev::telemeter< derivedT >::derived ( )

inlineprivate

Access the derived class.

Definition at line 181 of file telemeter.hpp.

loadConfig()

template<class derivedT >

int MagAOX::app::dev::telemeter< derivedT >::loadConfig

(

appConfigurator &

config

)

Load the device section from an application configurator.

Returns

0 on success

-1 on error (nothing implemented yet)

Parameters

[in]

config

an application configuration from which to load values

Definition at line 232 of file telemeter.hpp.

References MAGAOX_env_telem, and MAGAOX_telRelPath.

Referenced by MagAOX::app::andorCtrl::loadConfig(), MagAOX::app::filterWheelCtrl::loadConfig(), MagAOX::app::hsfwCtrl::loadConfig(), MagAOX::app::koolanceCtrl::loadConfig(), MagAOX::app::observerCtrl::loadConfig(), MagAOX::app::ocam2KCtrl::loadConfig(), MagAOX::app::picamCtrl::loadConfig(), MagAOX::app::qhyCtrl::loadConfig(), MagAOX::app::siglentSDG::loadConfig(), MagAOX::app::smc100ccCtrl::loadConfig(), MagAOX::app::sysMonitor::loadConfig(), MagAOX::app::zylaCtrl::loadConfig(), MagAOX::app::dmSpeckle::loadConfigImpl(), MagAOX::app::rhusbMon::loadConfigImpl(), MagAOX::app::sparkleClock::loadConfigImpl(), MagAOX::app::tcsInterface::loadConfigImpl(), MagAOX::app::usbtempMon::loadConfigImpl(), MagAOX::app::zaberCtrl::loadConfigImpl(), TEST_CASE(), TEST_CASE(), and TEST_CASE().

setupConfig()

template<class derivedT >

int MagAOX::app::dev::telemeter< derivedT >::setupConfig

(

appConfigurator &

config

)

Setup an application configurator for the device section.

Returns

0 on success.

-1 on error (nothing implemented yet)

Parameters

[in]

config

an application configuration to setup

Definition at line 220 of file telemeter.hpp.

References MagAOX::app::dev::telemeter< derivedT >::setupConfig().

Referenced by MagAOX::app::andorCtrl::setupConfig(), MagAOX::app::filterWheelCtrl::setupConfig(), MagAOX::app::hsfwCtrl::setupConfig(), MagAOX::app::koolanceCtrl::setupConfig(), MagAOX::app::observerCtrl::setupConfig(), MagAOX::app::ocam2KCtrl::setupConfig(), MagAOX::app::picamCtrl::setupConfig(), MagAOX::app::qhyCtrl::setupConfig(), MagAOX::app::rhusbMon::setupConfig(), MagAOX::app::siglentSDG::setupConfig(), MagAOX::app::smc100ccCtrl::setupConfig(), MagAOX::app::sysMonitor::setupConfig(), MagAOX::app::tcsInterface::setupConfig(), MagAOX::app::usbtempMon::setupConfig(), MagAOX::app::zaberCtrl::setupConfig(), MagAOX::app::zylaCtrl::setupConfig(), MagAOX::app::dev::telemeter< derivedT >::setupConfig(), TEST_CASE(), TEST_CASE(), and TEST_CASE().

telem()

template<class derivedT >

template<typename telT >

int MagAOX::app::dev::telemeter< derivedT >::telem

(

const typename telT::messageT &

msg

)

Make a telemetry recording.

Wrapper for logManager::log, which updates telT::lastRecord.

Template Parameters

logT	the log entry type
retval	the value returned by this method.

Parameters

[in]

msg

the data to log

Definition at line 194 of file telemeter.hpp.

References MagAOX::app::msg.

Referenced by visxCtrl.xapp.VisX::emit_telem_stdcam(), visxCtrl.xapp.VisX::handle_exptime(), audibleAlerts.core.AudibleAlerts::handle_reload_request(), and audibleAlerts.core.AudibleAlerts::handle_speech_request().

Member Data Documentation

m_maxInterval

template<class derivedT >

double MagAOX::app::dev::telemeter< derivedT >::m_maxInterval {10.0}

The maximum interval, in seconds, between telemetry records. Default is 10.0 seconds.

Definition at line 83 of file telemeter.hpp.

m_tel

template<class derivedT >

logManagerT MagAOX::app::dev::telemeter< derivedT >::m_tel

Definition at line 81 of file telemeter.hpp.

---

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

• libMagAOX/app/dev/telemeter.hpp