stateCodes.hpp

Go to the documentation of this file.

/** \file stateCodes.hpp 
  * \brief MagAO-X Application States
  * \author Jared R. Males (jaredmales@gmail.com)
  *
  * History:
  * - 2018-01-20 created by JRM
  */ 

#ifndef app_stateCodes_hpp
#define app_stateCodes_hpp


namespace MagAOX 
{
namespace app
{

/// Scoping struct for application state codes.
/** We do not use the enum class feature since it does not have automatic integer conversion.
  * \ingroup magaoxapp
  */
struct stateCodes 
{

   /// The type of the state code.
   /**
     */
   typedef int16_t stateCodeT;


   /// The numeric codes descrbing an application's state
   /** \ingroup magaoxapp
     */   
   enum : stateCodeT { FAILURE=-20,       ///< The application has failed, should be used when m_shutdown is set for an error.
                       ERROR=-10,         ///< The application has encountered an error, from which it is recovering (with or without intervention)
                       UNINITIALIZED = 0, ///< The application is unitialized, the default
                       INITIALIZED = 1,   ///< The application has been initialized, set just before calling appStartup().
                       NODEVICE = 2,      ///< No device exists for the application to control.
                       POWEROFF = 4,      ///< The device power is off.
                       POWERON = 6,       ///< The device power is on.
                       NOTCONNECTED = 8,  ///< The application is not connected to the device or service.
                       CONNECTED = 10,     ///< The application has connected to the device or service.
                       LOGGEDIN = 15,      ///< The application has logged into the device or service
                       CONFIGURING = 20,   ///< The application is configuring the device.
                       HOMING = 25,       ///< The device is homing.
                       OPERATING = 30,    ///< The device is operating, other than homing.
                       READY = 35,        ///< The device is ready for operation, but is not operating.
                       SHUTDOWN = 10000   ///< The application has shutdown, set just after calling appShutdown().
                  };
                  

   /// Get an ASCII string corresponding to an application stateCode.
   /**
     * \returns a string with the text name of the stateCode
     * 
     */ 
   static std::string codeText( stateCodeT stateCode /**<[in] the stateCode for which the name is desired*/);

}; //struct stateCodes           


std::string stateCodes::codeText( stateCodeT stateCode )
{
   switch(stateCode)
   {
      case stateCodes::FAILURE:
         return "FAILURE";
      case stateCodes::ERROR:
         return "ERROR";
      case stateCodes::UNINITIALIZED:
         return "UNINITIALIZED";
      case stateCodes::INITIALIZED:
         return "INITIALIZED";
      case stateCodes::NODEVICE:
         return "NODEVICE";
      case stateCodes::POWEROFF:
         return "POWEROFF";
      case stateCodes::POWERON:
         return "POWERON";
      case stateCodes::NOTCONNECTED:
         return "NOTCONNECTED";
      case stateCodes::CONNECTED:
         return "CONNECTED";
      case stateCodes::LOGGEDIN:
         return "LOGGEDIN";
      case stateCodes::CONFIGURING:
         return "CONFIGURING";
      case stateCodes::HOMING:
         return "HOMING";
      case stateCodes::OPERATING:
         return "OPERATING";
      case stateCodes::READY:
         return "READY";
      case stateCodes::SHUTDOWN:
         return "SHUTDOWN";
      default:
         return "UNKNOWN";
   }

   return "UNKNOWN";
}

} //namespace app 
} //namespace MagAOX

#endif //app_stateCodes_hpp