Public Types | |
typedef logger::logManager< MagAOXApp< _useINDI >, logFileRaw > | logManagerT |
The log manager type. More... | |
Public Member Functions | |
kcubeCtrl_test (const std::string device) | |
virtual void | setupConfig () |
int | loadConfigImpl (mx::app::appConfigurator &_config) |
Implementation of loadConfig logic, separated for testing. More... | |
virtual void | loadConfig () |
virtual int | appStartup () |
Startup function. More... | |
virtual int | appLogic () |
Implementation of the FSM for kcubeCtrl. More... | |
virtual int | appShutdown () |
Shutdown the app. More... | |
int | axis1Initialize () |
int | axis1Enable () |
int | axis1Disable () |
int | axis1Voltage (float &v) |
int | axis2Initialize () |
int | axis2Enable () |
int | axis2Disable () |
int | axis2Voltage (float &v) |
int | set () |
int | rest () |
int | shutdown () |
Get the value of the shutdown flag. More... | |
virtual void | setDefaults (int argc, char **argv) |
Set the paths for config files. More... | |
virtual void | setupBasicConfig () |
The basic MagAO-X configuration setup method. Should not normally be overridden. More... | |
virtual void | loadBasicConfig () |
The basic MagAO-X configuration processing method. Should not normally be overridden. More... | |
virtual void | checkConfig () |
Check for unused and unrecognized config options and settings. More... | |
virtual int | execute () |
The execute method implementing the standard main loop. Should not normally be overridden. More... | |
K-cube Interface | |
int | modIdentify () |
Threads | |
int | threadStart (std::thread &thrd, bool &thrdInit, pid_t &tpid, pcf::IndiProperty &thProp, int thrdPrio, const std::string &cpuset, const std::string &thrdName, thisPtr *thrdThis, Function &&thrdStart) |
Start a thread, using this class's privileges to set priority, etc. More... | |
Member Accessors | |
std::string | configName () |
Get the config name. More... | |
std::string | configDir () |
Get the config directory. More... | |
std::string | driverInName () |
Get the INDI input FIFO file name. More... | |
std::string | driverOutName () |
Get the INDI output FIFO file name. More... | |
std::string | driverCtrlName () |
Get the INDI control FIFO file name. More... | |
Protected Attributes | |
tmcCon< kcubeCtrl > | m_kAxis1 |
bool | m_axis1Enabled {false} |
tmcCon< kcubeCtrl > | m_kAxis2 |
bool | m_axis2Enabled {false} |
bool | m_isSet {false} |
std::string | MagAOXPath |
The base path of the MagAO-X system. More... | |
std::string | m_configName |
The name of the configuration file (minus .conf). More... | |
std::string | m_configDir |
The path to configuration files for MagAOX. More... | |
std::string | m_configBase |
The name of a base config class for this app (minus .conf). More... | |
std::string | m_calibDir |
The path to calibration files for MagAOX. More... | |
std::string | sysPath |
The path to the system directory, for PID file, etc. More... | |
std::string | secretsPath |
Path to the secrets directory, where passwords, etc, are stored. More... | |
unsigned long | m_loopPause |
int | m_shutdown |
Flag to signal it's time to shutdown. When not 0, the main loop exits. More... | |
cpusets | |
The path to the cpusets mount is configured by the environment varialbe defined by MAGOX_env_cpuset in environment.hpp. This environment varialbe is normally named "CGROUPS1_CPUSET_MOUNTPOINT". If the environment variable is not set, the default defined by MAGAOX_cpusetPath in paths.hpp is used. This is normally "/opt/MagAOX/cpuset/" | |
std::string | m_cpusetPath |
Private Member Functions | |
int | clearFSMAlert () |
Clear the FSM alert state. More... | |
INDI | |
INDI_NEWCALLBACK_DECL (kcubeCtrl, m_indiP_axis1_identify) | |
INDI_NEWCALLBACK_DECL (kcubeCtrl, m_indiP_axis1_enable) | |
INDI_NEWCALLBACK_DECL (kcubeCtrl, m_indiP_axis1_voltage) | |
INDI_NEWCALLBACK_DECL (kcubeCtrl, m_indiP_axis2_identify) | |
INDI_NEWCALLBACK_DECL (kcubeCtrl, m_indiP_axis2_enable) | |
INDI_NEWCALLBACK_DECL (kcubeCtrl, m_indiP_axis2_voltage) | |
INDI_NEWCALLBACK_DECL (kcubeCtrl, m_indiP_set) | |
pcf::IndiProperty | m_indiP_axis1_identify |
pcf::IndiProperty | m_indiP_axis1_enable |
pcf::IndiProperty | m_indiP_axis1_voltage |
pcf::IndiProperty | m_indiP_axis2_identify |
pcf::IndiProperty | m_indiP_axis2_enable |
pcf::IndiProperty | m_indiP_axis2_voltage |
pcf::IndiProperty | m_indiP_set |
Logging | |
void | logMessage (bufferPtrT &b) |
Handle a log message from the logging system. More... | |
static logManagerT | m_log |
static int | log (const typename logT::messageT &msg, logPrioT level=logPrio::LOG_DEFAULT) |
Make a log entry. More... | |
static int | log (logPrioT level=logPrio::LOG_DEFAULT) |
Make a log entry. More... | |
static void | configLog (const std::string &name, const int &code, const std::string &value, const std::string &source) |
Callback for config system logging. More... | |
Application State | |
stateCodes::stateCodeT | state () |
Get the current state code. More... | |
void | state (const stateCodes::stateCodeT &s, bool stateAlert=false) |
Set the current state code. More... | |
int | stateLogged () |
Updates and returns the value of m_stateLogged. Will be 0 on first call after a state change, >0 afterwards. More... | |
stateCodes::stateCodeT | m_state |
bool | m_stateAlert |
bool | m_gitAlert |
int | m_stateLogged |
INDI Interface | |
For reference: "Get" and "New" refer to properties we own. "Set" refers to properties owned by others. So we respond to GetProperties by listing our own properties, and NewProperty is a request to change a property we own. Whereas SetProperty is a notification that someone else has changed a property. | |
int | createStandardIndiText (pcf::IndiProperty &prop, const std::string &propName, const std::string &label="", const std::string &group="") |
Create a standard R/W INDI Text property with target and current elements. More... | |
int | createROIndiText (pcf::IndiProperty &prop, const std::string &propName, const std::string &elName, const std::string &propLabel="", const std::string &propGroup="", const std::string &elLabel="") |
Create a standard ReadOnly INDI Text property, with at least one element. More... | |
int | createStandardIndiNumber (pcf::IndiProperty &prop, const std::string &name, const T &min, const T &max, const T &step, const std::string &format, const std::string &label="", const std::string &group="") |
Create a standard R/W INDI Number property with target and current elements. More... | |
int | createROIndiNumber (pcf::IndiProperty &prop, const std::string &propName, const std::string &propLabel="", const std::string &propGroup="") |
Create a ReadOnly INDI Number property. More... | |
int | createStandardIndiToggleSw (pcf::IndiProperty &prop, const std::string &name, const std::string &label="", const std::string &group="") |
Create a standard R/W INDI switch with a single toggle element. More... | |
int | createStandardIndiRequestSw (pcf::IndiProperty &prop, const std::string &name, const std::string &label="", const std::string &group="") |
Create a standard R/W INDI switch with a single request element. More... | |
int | createStandardIndiSelectionSw (pcf::IndiProperty &prop, const std::string &name, const std::vector< std::string > &elements, const std::vector< std::string > &elementLabels, const std::string &label="", const std::string &group="") |
Create a standard R/W INDI selection (one of many) switch with vector of elements and element labels. More... | |
int | createStandardIndiSelectionSw (pcf::IndiProperty &prop, const std::string &name, const std::vector< std::string > &elements, const std::string &label="", const std::string &group="") |
int | registerIndiPropertyReadOnly (pcf::IndiProperty &prop) |
Register an INDI property which is read only. More... | |
int | registerIndiPropertyReadOnly (pcf::IndiProperty &prop, const std::string &propName, const pcf::IndiProperty::Type &propType, const pcf::IndiProperty::PropertyPermType &propPerm, const pcf::IndiProperty::PropertyStateType &propState) |
Register an INDI property which is read only. More... | |
int | registerIndiPropertyNew (pcf::IndiProperty &prop, int(*)(void *, const pcf::IndiProperty &)) |
Register an INDI property which is exposed for others to request a New Property for. More... | |
int | registerIndiPropertyNew (pcf::IndiProperty &prop, const std::string &propName, const pcf::IndiProperty::Type &propType, const pcf::IndiProperty::PropertyPermType &propPerm, const pcf::IndiProperty::PropertyStateType &propState, int(*)(void *, const pcf::IndiProperty &)) |
Register an INDI property which is exposed for others to request a New Property for. More... | |
int | registerIndiPropertyNew (pcf::IndiProperty &prop, const std::string &propName, const pcf::IndiProperty::Type &propType, const pcf::IndiProperty::PropertyPermType &propPerm, const pcf::IndiProperty::PropertyStateType &propState, const pcf::IndiProperty::SwitchRuleType &propRule, int(*)(void *, const pcf::IndiProperty &)) |
Register an INDI property which is exposed for others to request a New Property for, with a switch rule. More... | |
int | registerIndiPropertySet (pcf::IndiProperty &prop, const std::string &devName, const std::string &propName, int(*)(void *, const pcf::IndiProperty &)) |
Register an INDI property which is monitored for updates from others. More... | |
void | sendGetPropertySetList (bool all=false) |
void | handleDefProperty (const pcf::IndiProperty &ipRecv) |
Handler for the DEF INDI properties notification. More... | |
void | handleGetProperties (const pcf::IndiProperty &ipRecv) |
Handler for the get INDI properties request. More... | |
void | handleNewProperty (const pcf::IndiProperty &ipRecv) |
Handler for the new INDI property request. More... | |
void | handleSetProperty (const pcf::IndiProperty &ipRecv) |
Handler for the set INDI property request. More... | |
std::unordered_map< std::string, indiCallBack > | m_indiNewCallBacks |
Map to hold the NewProperty indiCallBacks for this App, with fast lookup by property name. More... | |
std::unordered_map< std::string, indiCallBack > | m_indiSetCallBacks |
Map to hold the SetProperty indiCallBacks for this App, with fast lookup by property name. More... | |
bool | m_allDefsReceived |
Flag indicating that all registered Set properties have been updated since last Get. More... | |
std::string | m_driverInName |
Full path name of the INDI driver input FIFO. More... | |
std::string | m_driverOutName |
Full path name of the INDI driver output FIFO. More... | |
std::string | m_driverCtrlName |
Full path name of the INDI driver control FIFO. More... | |
pcf::IndiProperty | m_indiP_state |
indi Property to report the application state. More... | |
pcf::IndiProperty | m_indiP_clearFSMAlert |
indi Property to clear an FSM alert. More... | |
indiDriver< MagAOXApp > * | m_indiDriver |
The INDI driver wrapper. Constructed and initialized by execute, which starts and stops communications. More... | |
std::mutex | m_indiMutex |
Mutex for locking INDI communications. More... | |
typedef std::pair< std::string, indiCallBack > | callBackValueType |
Value type of the indiCallBack map. More... | |
typedef std::unordered_map< std::string, indiCallBack >::iterator | callBackIterator |
Iterator type of the indiCallBack map. More... | |
typedef std::pair< callBackIterator, bool > | callBackInsertResult |
Return type of insert on the indiCallBack map. More... | |
constexpr static bool | m_useINDI |
Flag controlling whether INDI is used. If false, then no INDI code executes. More... | |
static int | st_newCallBack_clearFSMAlert (void *app, const pcf::IndiProperty &ipRecv) |
The static callback function to be registered for requesting to clear the FSM alert. More... | |
int | createINDIFIFOS () |
Create the INDI FIFOs. More... | |
int | startINDI () |
Start INDI Communications. More... | |
void | updateIfChanged (pcf::IndiProperty &p, const std::string &el, const T &newVal, pcf::IndiProperty::PropertyStateType ipState=pcf::IndiProperty::Ok) |
Update an INDI property element value if it has changed. More... | |
void | updateIfChanged (pcf::IndiProperty &p, const std::string &el, const char *newVal, pcf::IndiProperty::PropertyStateType ipState=pcf::IndiProperty::Ok) |
Update an INDI property element value if it has changed. More... | |
void | updateIfChanged (pcf::IndiProperty &p, const std::string &el, const std::vector< T > &newVals, pcf::IndiProperty::PropertyStateType ipState=pcf::IndiProperty::Ok) |
Update an INDI property if values have changed. More... | |
void | updateIfChanged (pcf::IndiProperty &p, const std::vector< std::string > &els, const std::vector< T > &newVals, pcf::IndiProperty::PropertyStateType newState=pcf::IndiProperty::Ok) |
Update an INDI property if values have changed. More... | |
void | updateSwitchIfChanged (pcf::IndiProperty &p, const std::string &el, const pcf::IndiElement::SwitchStateType &newVal, pcf::IndiProperty::PropertyStateType ipState=pcf::IndiProperty::Ok) |
Update an INDI switch element value if it has changed. More... | |
int | indiTargetUpdate (pcf::IndiProperty &localProperty, T &localTarget, const pcf::IndiProperty &remoteProperty, bool setBusy=true) |
Get the target element value from an new property. More... | |
int | sendNewProperty (const pcf::IndiProperty &ipSend, const std::string &el, const T &newVal) |
Send a newProperty command to another device (using the INDI Client interface) More... | |
int | sendNewProperty (const pcf::IndiProperty &ipSend) |
Send a newProperty command to another device (using the INDI Client interface) More... | |
int | sendNewStandardIndiToggle (const std::string &device, const std::string &property, bool onoff) |
Send a new property commmand for a standard toggle switch. More... | |
int | newCallBack_clearFSMAlert (const pcf::IndiProperty &ipRecv) |
The callback called by the static version, to actually process the FSM Alert Clear request. More... | |
Power Management | |
For devices which have remote power management (e.g. from one of the PDUs) we implement a standard power state monitoring and management component for the FSM. This needs to be enabled in the derived app constructor. To stay enabled, m_powerDevice and m_powerChannel must be not empty strings after the configuration. These could be set in the derived app defaults. If power management is enabled, then while power is off, appLogic will not be called. Instead a parrallel set of virtual functions is called, onPowerOff (to allow apps to perform cleanup) and whilePowerOff (to allow apps to keep variables updated, etc). Note that these could merely call appLogic if desired. | |
int | powerState () |
Returns the current power state. More... | |
int | powerStateTarget () |
Returns the target power state. More... | |
INDI_SETCALLBACK_DECL (MagAOXApp, m_indiP_powerChannel) | |
bool | m_powerMgtEnabled |
std::string | m_powerDevice |
The INDI device name of the power controller. More... | |
std::string | m_powerChannel |
The INDI property name of the channel controlling this device's power. More... | |
std::string | m_powerElement |
The INDI element name to monitor for this device's power state. More... | |
std::string | m_powerTargetElement |
The INDI element name to monitor for this device's power state. More... | |
unsigned long | m_powerOnWait |
Time in sec to wait for device to boot after power on. More... | |
int | m_powerOnCounter |
int | m_powerState |
Current power state, 1=On, 0=Off, -1=Unk. More... | |
int | m_powerTargetState |
Current target power state, 1=On, 0=Off, -1=Unk. More... | |
pcf::IndiProperty | m_indiP_powerChannel |
INDI property used to communicate power state. More... | |
virtual int | onPowerOff () |
This method is called when the change to poweroff is detected. More... | |
virtual int | whilePowerOff () |
This method is called while the power is off, once per FSM loop. More... | |
bool | powerOnWaitElapsed () |
This method tests whether the power on wait time has elapsed. More... | |
PID Locking | |
Each MagAOXApp has a PID lock file in the system directory. The app will not startup if it detects that the PID is already locked, preventing duplicates. This is based on the configured name, not the invoked name (argv[0]). | |
std::string | pidFileName |
The name of the PID file. More... | |
pid_t | m_pid |
This process's PID. More... | |
int | lockPID () |
int | unlockPID () |
Remove the PID file. More... | |
Signal Handling | |
static MagAOXApp * | m_self |
int | setSigTermHandler () |
Sets the handler for SIGTERM, SIGQUIT, and SIGINT. More... | |
void | handlerSigTerm (int signum, siginfo_t *siginf, void *ucont) |
Handles SIGTERM, SIGQUIT, and SIGINT. Sets m_shutdown to 1 and logs the signal. More... | |
static void | _handlerSigTerm (int signum, siginfo_t *siginf, void *ucont) |
The handler called when SIGTERM, SIGQUIT, or SIGINT is received. Just a wrapper for handlerSigTerm. More... | |
Privilege Management | |
uid_t | m_euidReal |
The real user id of the proces (i.e. the lower privileged id of the user) More... | |
uid_t | m_euidCalled |
uid_t | m_suid |
The save-set user id of the process. More... | |
int | setEuidCalled () |
Set the effective user ID to the called value, i.e. the highest possible. More... | |
int | setEuidReal () |
Set the effective user ID to the real value, i.e. the file owner. More... | |
Definition at line 16 of file kcubeCtrl_test.cpp.
|
inherited |
Return type of insert on the indiCallBack map.
Definition at line 567 of file MagAOXApp.hpp.
|
inherited |
Iterator type of the indiCallBack map.
Definition at line 564 of file MagAOXApp.hpp.
|
inherited |
Value type of the indiCallBack map.
Definition at line 561 of file MagAOXApp.hpp.
|
inherited |
The log manager type.
Definition at line 78 of file MagAOXApp.hpp.
|
inline |
Definition at line 20 of file kcubeCtrl_test.cpp.
|
staticprivateinherited |
The handler called when SIGTERM, SIGQUIT, or SIGINT is received. Just a wrapper for handlerSigTerm.
[in] | signum | specifies the signal. |
[in] | siginf | ignored by MagAOXApp |
[in] | ucont | ignored by MagAOXApp |
Definition at line 296 of file MagAOXApp.hpp.
|
virtualinherited |
Implementation of the FSM for kcubeCtrl.
Implements MagAOX::app::MagAOXApp< true >.
Definition at line 284 of file kcubeCtrl.hpp.
|
virtualinherited |
Shutdown the app.
Implements MagAOX::app::MagAOXApp< true >.
Definition at line 536 of file kcubeCtrl.hpp.
|
virtualinherited |
Startup function.
Implements MagAOX::app::MagAOXApp< true >.
Definition at line 224 of file kcubeCtrl.hpp.
|
inherited |
Definition at line 684 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::rest().
|
inherited |
Definition at line 665 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::set().
|
inherited |
Definition at line 541 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::appLogic().
|
inherited |
Definition at line 704 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::rest(), and MagAOX::app::kcubeCtrl::set().
|
inherited |
Definition at line 875 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::rest().
|
inherited |
Definition at line 856 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::set().
|
inherited |
Definition at line 731 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::appLogic().
|
inherited |
Definition at line 895 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::rest(), and MagAOX::app::kcubeCtrl::set().
|
virtualinherited |
Check for unused and unrecognized config options and settings.
Logs the unused targets as warnings. Unrecognized and unused options are logged as critical, and m_shutdown is set. Any command line argument (not an option) will also be critical and cause shutdown.
Definition at line 170 of file MagAOXApp.hpp.
|
privateinherited |
Clear the FSM alert state.
This can only be done from within this class, and this should only be possible via user action via INDI.
Definition at line 525 of file MagAOXApp.hpp.
|
inherited |
Get the config directory.
Definition at line 1100 of file MagAOXApp.hpp.
|
staticprotectedinherited |
Callback for config system logging.
Called by appConfigurator each time a value is set using the config() operator. You never need to call this directly.
[in] | name | The name of the config value |
[in] | code | numeric code specifying the type |
[in] | value | the value read by the config system |
[in] | source | the source of the value. |
Definition at line 276 of file MagAOXApp.hpp.
|
inherited |
Get the config name.
Definition at line 1094 of file MagAOXApp.hpp.
|
protectedinherited |
Create the INDI FIFOs.
Changes permissions to max available and creates the FIFOs at the configured path.
Definition at line 811 of file MagAOXApp.hpp.
|
inherited |
Create a ReadOnly INDI Number property.
[out] | prop | the property to create and setup |
[in] | propName | the name of the property |
[in] | propLabel | [optional] the GUI label suggestion for this property |
[in] | propGroup | [optional] the group for this property |
Definition at line 649 of file MagAOXApp.hpp.
|
inherited |
Create a standard ReadOnly INDI Text property, with at least one element.
[out] | prop | the property to create and setup |
[in] | propName | the name of the property |
[in] | elName | the name of the element |
[in] | propLabel | [optional] the GUI label suggestion for this property |
[in] | propGroup | [optional] the group for this property |
[in] | elLabel | [optional] the GUI label suggestion for the element |
Definition at line 614 of file MagAOXApp.hpp.
|
inherited |
Create a standard R/W INDI Number property with target and current elements.
[out] | prop | the property to create and setup |
[in] | name | the name of the property |
[in] | min | the minimum value for the elements, applied to both target and current |
[in] | max | the minimum value for the elements, applied to both target and current |
[in] | step | the step size for the elements, applied to both target and current |
[in] | format | the _ value for the elements, applied to both target and current. Set to "" to use the MagAO-X standard for type. |
[in] | label | [optional] the GUI label suggestion for this property |
[in] | group | [optional] the group for this property |
Definition at line 628 of file MagAOXApp.hpp.
|
inherited |
Create a standard R/W INDI switch with a single request element.
This switch is intended to function like a momentary switch.
[out] | prop | the property to create and setup |
[in] | name | the name of the property |
[in] | label | [optional] the GUI label suggestion for this property |
[in] | group | [optional] the group for this property |
Definition at line 675 of file MagAOXApp.hpp.
|
inherited |
Create a standard R/W INDI selection (one of many) switch with vector of elements using the element strings as their own labels This switch is intended to function like drop down menu.
[out] | prop | the property to create and setup |
[in] | name | the name of the property, |
[in] | elements | the element names to give to the switches |
[in] | label | [optional] the GUI label suggestion for this property |
[in] | group | [optional] the group for this property |
Definition at line 706 of file MagAOXApp.hpp.
|
inherited |
Create a standard R/W INDI selection (one of many) switch with vector of elements and element labels.
This switch is intended to function like drop down menu.
[out] | prop | the property to create and setup |
[in] | name | the name of the property, |
[in] | elements | the element names to give to the switches |
[in] | elementLabels | the element labels to give to the switches |
[in] | label | [optional] the GUI label suggestion for this property |
[in] | group | [optional] the group for this property |
Definition at line 688 of file MagAOXApp.hpp.
|
inherited |
Create a standard R/W INDI Text property with target and current elements.
[out] | prop | the property to create and setup |
[in] | propName | the name of the property |
[in] | label | [optional] the GUI label suggestion for this property |
[in] | group | [optional] the group for this property |
Definition at line 601 of file MagAOXApp.hpp.
|
inherited |
Create a standard R/W INDI switch with a single toggle element.
This switch is intended to function like an on/off toggle switch.
[out] | prop | the property to create and setup |
[in] | name | the name of the property |
[in] | label | [optional] the GUI label suggestion for this property |
[in] | group | [optional] the group for this property |
Definition at line 662 of file MagAOXApp.hpp.
|
inherited |
Get the INDI control FIFO file name.
Definition at line 1118 of file MagAOXApp.hpp.
|
inherited |
Get the INDI input FIFO file name.
Definition at line 1106 of file MagAOXApp.hpp.
|
inherited |
Get the INDI output FIFO file name.
Definition at line 1112 of file MagAOXApp.hpp.
|
virtualinherited |
The execute method implementing the standard main loop. Should not normally be overridden.
Performs final startup steps. That is:
Errors in the above steps will cause a process exit.
Then commences the main event loop. Conditions on entry to the main loop:
In the event loop, the power state is checked (if being managed). If power is off, then onPowerOff is called. If power is on, or power is not managed, appLogic is called. These methods are implemented in derived classes, and are called every m_loopPause interval.
If an error is returned by either onPowerOff or appLogic, or a signal is handled, then the shutdown is managed. This includes shutting down INDI, calling appShutdown, and unlocking the PID. The log thread will shutdown.
Definition at line 200 of file MagAOXApp.hpp.
|
inherited |
Handler for the DEF INDI properties notification.
Uses the properties registered in m_indiSetCallBacks to process the notification. This is called by m_indiDriver's indiDriver::handleDefProperties.
[in] | ipRecv | The property being sent. |
Definition at line 827 of file MagAOXApp.hpp.
|
inherited |
Handler for the get INDI properties request.
Uses the properties registered in m_indiCallBacks to respond to the request. This is called by m_indiDriver's indiDriver::handleGetProperties.
[in] | ipRecv | The property being requested. |
Definition at line 833 of file MagAOXApp.hpp.
|
inherited |
Handler for the new INDI property request.
Uses the properties registered in m_indiCallBacks to respond to the request, looking up the callback for this property and calling it.
This is called by m_indiDriver's indiDriver::handleGetProperties.
[in] | ipRecv | The property being changed. |
Definition at line 843 of file MagAOXApp.hpp.
|
privateinherited |
Handles SIGTERM, SIGQUIT, and SIGINT. Sets m_shutdown to 1 and logs the signal.
[in] | signum | specifies the signal. |
[in] | siginf | ignored by MagAOXApp |
[in] | ucont | ignored by MagAOXApp |
Definition at line 302 of file MagAOXApp.hpp.
|
inherited |
Handler for the set INDI property request.
This is called by m_indiDriver's indiDriver::handleSetProperties.
[in] | ipRecv | The property being changed. |
Definition at line 852 of file MagAOXApp.hpp.
|
inherited |
|
inherited |
|
inherited |
|
inherited |
|
inherited |
|
inherited |
|
inherited |
|
inherited |
|
protectedinherited |
Get the target element value from an new property.
[out] | localProperty | The local property to update |
[out] | localTarget | The local value to update |
[in] | remoteProperty | the new property received |
[in] | setBusy | [optional] set property to busy if true |
Definition at line 941 of file MagAOXApp.hpp.
|
virtualinherited |
The basic MagAO-X configuration processing method. Should not normally be overridden.
This method processes the standard MagAO-X key=value pairs.
Though it is virtual, it should not normally be overridden unless you need to depart from the MagAO-X standard.
Processing of app specific config goes in loadConfig() implemented by the derived class.
Definition at line 164 of file MagAOXApp.hpp.
|
virtualinherited |
Definition at line 219 of file kcubeCtrl.hpp.
|
inherited |
Implementation of loadConfig logic, separated for testing.
This is called by loadConfig().
[in] | _config | an application configuration from which to load values |
Definition at line 206 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::loadConfig().
|
protectedinherited |
Attempt to lock the PID by writing it to a file. Fails if a process is already running with the same config name. First checks the PID file for an existing PID. If found, interrogates /proc to determine if that process is running and if so if the command line matches. If a matching process is currently running, then this returns an error.
Will not fail if a PID file exists but the stored PID does not correspond to a running process with the same command line name.
Reference: https://linux.die.net/man/3/getpid
Definition at line 410 of file MagAOXApp.hpp.
|
staticinherited |
Make a log entry.
Wrapper for logManager::log
logT | the log entry type |
retval | the value returned by this method. |
[in] | msg | the message to log |
[in] | level | [optional] the log level. The default is used if not specified. |
Definition at line 247 of file MagAOXApp.hpp.
|
staticinherited |
Make a log entry.
Wrapper for logManager::log
logT | the log entry type |
retval | the value returned by this method. |
[in] | level | [optional] the log level. The default is used if not specified. |
Definition at line 260 of file MagAOXApp.hpp.
|
inherited |
Handle a log message from the logging system.
This is a callback from the logManager, and is called when the log thread is processing log entries.
Decides whether to display to stderr and whether to send via INDI.
Definition at line 269 of file MagAOXApp.hpp.
|
inlineinherited |
Definition at line 141 of file kcubeCtrl.hpp.
|
protectedinherited |
The callback called by the static version, to actually process the FSM Alert Clear request.
[in] | ipRecv | the INDI property sent with the new property request. |
Definition at line 998 of file MagAOXApp.hpp.
|
protectedvirtualinherited |
This method is called when the change to poweroff is detected.
Reimplemented in MagAOX::app::zaberLowLevel, MagAOX::app::irisaoCtrl, MagAOX::app::bmcCtrl, and MagAOX::app::alpaoCtrl.
Definition at line 1043 of file MagAOXApp.hpp.
|
protectedinherited |
This method tests whether the power on wait time has elapsed.
You would call this once per appLogic loop while in state POWERON. While false, you would return 0. Once it becomes true, take post-power-on actions and go on with life.
Definition at line 1059 of file MagAOXApp.hpp.
|
inherited |
Returns the current power state.
If power management is not enabled, this always returns 1=On.
Definition at line 1069 of file MagAOXApp.hpp.
|
inherited |
Returns the target power state.
If power management is not enabled, this always returns 1=On.
Definition at line 1078 of file MagAOXApp.hpp.
|
inherited |
Register an INDI property which is exposed for others to request a New Property for, with a switch rule.
This verison sets up the INDI property according to the arguments.
[out] | prop | the property to register |
[in] | propName | the name of the property |
[in] | propType | the type of the property |
[in] | propPerm | the permissions of the property |
[in] | propState | the state of the property |
[in] | propRule | the switch rule type |
|
inherited |
Register an INDI property which is exposed for others to request a New Property for.
This verison sets up the INDI property according to the arguments.
[out] | prop | the property to register |
[in] | propName | the name of the property |
[in] | propType | the type of the property |
[in] | propPerm | the permissions of the property |
[in] | propState | the state of the property |
|
inherited |
Register an INDI property which is exposed for others to request a New Property for.
In this version the supplied IndiProperty must be fully set up before passing in.
[in] | prop | the property to register, must be fully set up |
|
inherited |
Register an INDI property which is read only.
This version requires the property be fully set up.
[in] | prop | the property to register, must be completely setup |
Definition at line 722 of file MagAOXApp.hpp.
|
inherited |
Register an INDI property which is read only.
This verison sets up the INDI property according to the arguments.
[out] | prop | the property to register, will be configured |
[in] | propName | the name of the property |
[in] | propType | the type of the property |
[in] | propPerm | the permissions of the property |
[in] | propState | the state of the property |
Definition at line 732 of file MagAOXApp.hpp.
|
inherited |
Register an INDI property which is monitored for updates from others.
[out] | prop | the property to register |
[in] | devName | the device which owns this property |
[in] | propName | the name of the property |
Definition at line 799 of file MagAOXApp.hpp.
|
inherited |
Definition at line 966 of file kcubeCtrl.hpp.
|
inherited |
Definition at line 821 of file MagAOXApp.hpp.
|
protectedinherited |
Send a newProperty command to another device (using the INDI Client interface)
[in] | ipSend | The property to send a "new" INDI command for |
Definition at line 964 of file MagAOXApp.hpp.
|
protectedinherited |
Send a newProperty command to another device (using the INDI Client interface)
Copies the input IndiProperty, then updates the element with the new value.
[in] | ipSend | The property to send a "new" INDI command for |
[in] | el | The element of the property to change |
[in] | newVal | The value to request for the element. |
Definition at line 954 of file MagAOXApp.hpp.
|
protectedinherited |
Send a new property commmand for a standard toggle switch.
[in] | device | The device name |
[in] | property | The property name |
[in] | onoff | Switch state to send: true = on, false = off |
Definition at line 971 of file MagAOXApp.hpp.
|
inherited |
Definition at line 921 of file kcubeCtrl.hpp.
|
virtualinherited |
Set the paths for config files.
Replaces the mx::application defaults with the MagAO-X config system.
This function parses the CL for "-n" or "--name".
Do not override this unless you intend to depart from the MagAO-X standard.
[in] | argc | standard command line result specifying number of arguments in argv |
[in] | argv | standard command line result containing the arguments. |
Definition at line 142 of file MagAOXApp.hpp.
|
privateinherited |
Set the effective user ID to the called value, i.e. the highest possible.
If setuid is set on the file, this will be super-user privileges.
Reference: http://pubs.opengroup.org/onlinepubs/009695399/functions/seteuid.html
Definition at line 369 of file MagAOXApp.hpp.
|
privateinherited |
Set the effective user ID to the real value, i.e. the file owner.
Reference: http://pubs.opengroup.org/onlinepubs/009695399/functions/seteuid.html
Definition at line 378 of file MagAOXApp.hpp.
|
privateinherited |
Sets the handler for SIGTERM, SIGQUIT, and SIGINT.
Definition at line 293 of file MagAOXApp.hpp.
|
virtualinherited |
The basic MagAO-X configuration setup method. Should not normally be overridden.
This method sets up the config system with the standard MagAO-X key=value pairs.
Though it is virtual, it should not normally be overridden unless you need to depart from the MagAO-X standard.
Setting up app specific config goes in setupConfig() implemented in the derived class.
Definition at line 154 of file MagAOXApp.hpp.
|
virtualinherited |
Definition at line 200 of file kcubeCtrl.hpp.
|
inherited |
Get the value of the shutdown flag.
Definition at line 132 of file MagAOXApp.hpp.
|
staticprotectedinherited |
The static callback function to be registered for requesting to clear the FSM alert.
[in] | app | a pointer to this, will be static_cast-ed to MagAOXApp. |
[in] | ipRecv | the INDI property sent with the new property request. |
Definition at line 987 of file MagAOXApp.hpp.
|
protectedinherited |
Start INDI Communications.
Definition at line 818 of file MagAOXApp.hpp.
|
inherited |
|
inherited |
Set the current state code.
[in] | s | The new application state |
[in] | stateAlert | [optional] flag to set the alert state of the FSM property. |
Definition at line 495 of file MagAOXApp.hpp.
|
inherited |
Updates and returns the value of m_stateLogged. Will be 0 on first call after a state change, >0 afterwards.
This method exists to facilitate logging the reason for a state change once, but not logging it on subsequent event loops. Returns the current value upon entry, but updates before returning so that the next call returns the incremented value. Example usage:
In this example, the log entry is made the first time the state changes. If there are no changes to a different state in the mean time, then when the event loop gets here again and decides it is not connected, the log entry will not be made.
Definition at line 516 of file MagAOXApp.hpp.
|
inherited |
Start a thread, using this class's privileges to set priority, etc.
The thread initialization synchronizer bool
is set to true at the beginning of this function, then is set to false once all initialization is complete. The thread exec function should wait until this is false before doing anything except setting the pid. This is to avoid privilege escalation bugs.
The interface of the thread start function is:
where impl
is the derived class, and mThreadStart
and myThreadExec
are members of impl
.
[out] | thrd | The thread object to start executing |
thrdInit | [in/out] The thread initilization synchronizer. | |
tpid | [in/out] The thread pid to be filled in by thrdStart immediately upon call | |
thProp | [in/out] The INDI property to publish the thread details | |
[in] | thrdPrio | The r/t priority to set for this thread |
[in] | cpuset | the cpuset to place this thread on. Ignored if "". |
[in] | thrdName | The name of the thread (just for logging) |
[in] | thrdThis | The `this` pointer to pass to the thread starter function |
[in] | thrdStart | The thread starting function, a static function taking a `this` pointer as argument. |
Definition at line 452 of file MagAOXApp.hpp.
|
protectedinherited |
Remove the PID file.
Definition at line 413 of file MagAOXApp.hpp.
|
protectedinherited |
Update an INDI property element value if it has changed.
Will only peform a SetProperty if the new element value has changed compared to the stored value, or if the property state has changed.
This comparison is done in the true type of the value.
This is a specialization for const char *
to std::string
.
For a property with multiple elements, you should use the vector version to minimize network traffic. This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
p | [in/out] The property containing the element to possibly update | |
[in] | el | The element name |
[in] | newVal | the new value |
Definition at line 882 of file MagAOXApp.hpp.
|
protectedinherited |
Update an INDI property if values have changed.
Will only peform a SetProperty if at least one value has changed compared to the stored value, or if the property state has changed.
Constructs the element names for each value as elX where X is the index of the vector.
This comparison is done in the true type of the value.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
p | [in/out] The property containing the element to possibly update | |
[in] | el | Beginning of each element name |
[in] | newVals | the new values |
[in] | ipState | [optional] the new state |
Definition at line 911 of file MagAOXApp.hpp.
|
protectedinherited |
Update an INDI property element value if it has changed.
Will only peform a SetProperty if the new element value has changed compared to the stored value, or if the property state has changed.
This comparison is done in the true type of the value.
For a property with multiple elements, you should use the vector version to minimize network traffic.
p | [in/out] The property containing the element to possibly update | |
[in] | el | The element name |
[in] | newVal | the new value |
Definition at line 865 of file MagAOXApp.hpp.
|
protectedinherited |
Update an INDI property if values have changed.
Will only peform a SetProperty if at least one value has changed compared to the stored value, or if the property state has changed.
This comparison is done in the true type of the value.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
p | [in/out] The property containing the element to possibly update | |
[in] | els | String vector of element names |
[in] | newVals | the new values |
[in] | newState | [optional] The state of the property |
Definition at line 928 of file MagAOXApp.hpp.
|
protectedinherited |
Update an INDI switch element value if it has changed.
Will only peform a SetProperty if the new element switch state has changed, or the propery state has changed.
p | [in/out] The property containing the element to possibly update | |
[in] | el | The element name |
[in] | newVal | the new value |
Definition at line 893 of file MagAOXApp.hpp.
|
protectedvirtualinherited |
This method is called while the power is off, once per FSM loop.
Reimplemented in MagAOX::app::zaberLowLevel, MagAOX::app::irisaoCtrl, MagAOX::app::bmcCtrl, and MagAOX::app::alpaoCtrl.
Definition at line 1050 of file MagAOXApp.hpp.
|
protectedinherited |
Flag indicating that all registered Set properties have been updated since last Get.
Definition at line 582 of file MagAOXApp.hpp.
|
protectedinherited |
Definition at line 92 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::appLogic(), MagAOX::app::kcubeCtrl::axis1Disable(), MagAOX::app::kcubeCtrl::axis1Enable(), and MagAOX::app::kcubeCtrl::axis1Initialize().
|
protectedinherited |
Definition at line 95 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::appLogic(), MagAOX::app::kcubeCtrl::axis2Disable(), MagAOX::app::kcubeCtrl::axis2Enable(), and MagAOX::app::kcubeCtrl::axis2Initialize().
|
protectedinherited |
The path to calibration files for MagAOX.
Definition at line 89 of file MagAOXApp.hpp.
|
protectedinherited |
The name of a base config class for this app (minus .conf).
Definition at line 87 of file MagAOXApp.hpp.
|
protectedinherited |
The path to configuration files for MagAOX.
Definition at line 85 of file MagAOXApp.hpp.
|
protectedinherited |
The name of the configuration file (minus .conf).
Definition at line 83 of file MagAOXApp.hpp.
|
protectedinherited |
Definition at line 424 of file MagAOXApp.hpp.
|
protectedinherited |
Full path name of the INDI driver control FIFO.
This is currently only used to signal restarts.
Definition at line 593 of file MagAOXApp.hpp.
|
protectedinherited |
Full path name of the INDI driver input FIFO.
Definition at line 585 of file MagAOXApp.hpp.
|
protectedinherited |
Full path name of the INDI driver output FIFO.
Definition at line 588 of file MagAOXApp.hpp.
|
privateinherited |
The user id of the process as called (i.e. the higher privileged id of the owner, root if setuid).
Definition at line 314 of file MagAOXApp.hpp.
|
privateinherited |
The real user id of the proces (i.e. the lower privileged id of the user)
Definition at line 313 of file MagAOXApp.hpp.
|
privateinherited |
Definition at line 478 of file MagAOXApp.hpp.
|
inherited |
The INDI driver wrapper. Constructed and initialized by execute, which starts and stops communications.
Definition at line 542 of file MagAOXApp.hpp.
|
inherited |
Mutex for locking INDI communications.
Definition at line 545 of file MagAOXApp.hpp.
|
protectedinherited |
Map to hold the NewProperty indiCallBacks for this App, with fast lookup by property name.
The key for these is the property name.
Definition at line 573 of file MagAOXApp.hpp.
|
inherited |
Definition at line 173 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::appLogic(), and MagAOX::app::kcubeCtrl::appStartup().
|
inherited |
Definition at line 170 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::appLogic(), and MagAOX::app::kcubeCtrl::appStartup().
|
inherited |
Definition at line 176 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::appLogic(), and MagAOX::app::kcubeCtrl::appStartup().
|
inherited |
Definition at line 182 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::appLogic(), and MagAOX::app::kcubeCtrl::appStartup().
|
inherited |
Definition at line 179 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::appLogic(), and MagAOX::app::kcubeCtrl::appStartup().
|
inherited |
Definition at line 185 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::appLogic(), and MagAOX::app::kcubeCtrl::appStartup().
|
protectedinherited |
indi Property to clear an FSM alert.
Definition at line 980 of file MagAOXApp.hpp.
|
protectedinherited |
INDI property used to communicate power state.
Definition at line 1036 of file MagAOXApp.hpp.
|
inherited |
Definition at line 188 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::appLogic(), and MagAOX::app::kcubeCtrl::appStartup().
|
protectedinherited |
indi Property to report the application state.
Definition at line 977 of file MagAOXApp.hpp.
|
protectedinherited |
Map to hold the SetProperty indiCallBacks for this App, with fast lookup by property name.
The key for these is device.name
Definition at line 578 of file MagAOXApp.hpp.
|
protectedinherited |
Definition at line 97 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::appLogic(), MagAOX::app::kcubeCtrl::axis1Disable(), MagAOX::app::kcubeCtrl::axis1Initialize(), MagAOX::app::kcubeCtrl::axis2Disable(), MagAOX::app::kcubeCtrl::axis2Initialize(), MagAOX::app::kcubeCtrl::rest(), and MagAOX::app::kcubeCtrl::set().
|
protectedinherited |
Definition at line 91 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::appLogic(), MagAOX::app::kcubeCtrl::axis1Disable(), MagAOX::app::kcubeCtrl::axis1Enable(), MagAOX::app::kcubeCtrl::axis1Initialize(), MagAOX::app::kcubeCtrl::axis1Voltage(), and MagAOX::app::kcubeCtrl::loadConfigImpl().
|
protectedinherited |
Definition at line 94 of file kcubeCtrl.hpp.
Referenced by MagAOX::app::kcubeCtrl::appLogic(), MagAOX::app::kcubeCtrl::axis2Disable(), MagAOX::app::kcubeCtrl::axis2Enable(), MagAOX::app::kcubeCtrl::axis2Initialize(), MagAOX::app::kcubeCtrl::axis2Voltage(), and MagAOX::app::kcubeCtrl::loadConfigImpl().
|
staticinherited |
Definition at line 237 of file MagAOXApp.hpp.
|
protectedinherited |
The time in nanoseconds to pause the main loop. The appLogic() function of the derived class is called every m_loopPause nanoseconds. Default is 1,000,000,000 ns. Config with loopPause=X.
Definition at line 95 of file MagAOXApp.hpp.
|
protectedinherited |
This process's PID.
Definition at line 394 of file MagAOXApp.hpp.
|
protectedinherited |
The INDI property name of the channel controlling this device's power.
Definition at line 1022 of file MagAOXApp.hpp.
|
protectedinherited |
The INDI device name of the power controller.
Definition at line 1021 of file MagAOXApp.hpp.
|
protectedinherited |
The INDI element name to monitor for this device's power state.
Definition at line 1023 of file MagAOXApp.hpp.
|
protectedinherited |
Flag controls whether power mgt is used. Set this in the constructor of a derived app. If true, then if after loadConfig the powerDevice and powerChannel are empty, then the app will exit with a critical error.
Definition at line 1016 of file MagAOXApp.hpp.
|
protectedinherited |
Counts numer of loops after power on, implements delay for device bootup. If -1, then device was NOT powered off on app startup.
Definition at line 1029 of file MagAOXApp.hpp.
|
protectedinherited |
Time in sec to wait for device to boot after power on.
Definition at line 1026 of file MagAOXApp.hpp.
|
protectedinherited |
Current power state, 1=On, 0=Off, -1=Unk.
Definition at line 1033 of file MagAOXApp.hpp.
|
protectedinherited |
The INDI element name to monitor for this device's power state.
Definition at line 1024 of file MagAOXApp.hpp.
|
protectedinherited |
Current target power state, 1=On, 0=Off, -1=Unk.
Definition at line 1034 of file MagAOXApp.hpp.
|
staticprivateinherited |
Static pointer to this (set in constructor). Used to test whether a a MagAOXApp is already instatiated (a fatal error) and used for getting out of static signal handlers.
Definition at line 289 of file MagAOXApp.hpp.
|
protectedinherited |
Flag to signal it's time to shutdown. When not 0, the main loop exits.
Definition at line 100 of file MagAOXApp.hpp.
|
privateinherited |
The application's state. Never ever set this directly, use state(const stateCodeT & s).
Definition at line 472 of file MagAOXApp.hpp.
|
privateinherited |
Definition at line 475 of file MagAOXApp.hpp.
|
privateinherited |
Counter and flag for use to log errors just once. Never ever access directly, use stateLogged().
Definition at line 480 of file MagAOXApp.hpp.
|
privateinherited |
The save-set user id of the process.
Definition at line 316 of file MagAOXApp.hpp.
|
staticconstexprprotectedinherited |
Flag controlling whether INDI is used. If false, then no INDI code executes.
Definition at line 537 of file MagAOXApp.hpp.
|
protectedinherited |
The base path of the MagAO-X system.
Definition at line 81 of file MagAOXApp.hpp.
|
protectedinherited |
The name of the PID file.
Definition at line 392 of file MagAOXApp.hpp.
|
protectedinherited |
Path to the secrets directory, where passwords, etc, are stored.
Definition at line 93 of file MagAOXApp.hpp.
|
protectedinherited |
The path to the system directory, for PID file, etc.
Definition at line 91 of file MagAOXApp.hpp.