Show
Ignore:
Timestamp:
11/13/09 15:37:02 (14 years ago)
Author:
bhilburn
Message:

Added Doxygen documentation to headers in the include/vtcross directory.

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • vtcross/trunk/src/include/vtcross/service_management_layer.h

    r465 r518  
    1515*/ 
    1616 
    17 /* This header exports the declaration for the Service Management Layer 
     17/*! This header exports the declaration for the Service Management Layer 
    1818 * component. 
    1919 */ 
     
    2626 
    2727 
    28 /* Service Management Layer (SML) class declaration.  The functions listed here 
    29  * are required by the VTCROSS API for service-oriented VTCROSS radio 
    30  * architectures. 
     28/*! \brief Service Management Layer (SML) class declaration.   
     29 * 
     30 * The functions listed here are required by the CROSS API for  
     31 * service-oriented CROSS radio architectures.  Note that most public functions 
     32 * are documented in the parent class, Component. 
    3133 */ 
    3234class ServiceManagementLayer : public Component 
    3335{ 
    3436    public: 
     37        /*! \brief Default SML Constructor. */ 
    3538        ServiceManagementLayer(); 
     39 
     40        /*! \brief Default SML Destructor. */ 
    3641        ~ServiceManagementLayer(); 
    3742 
    38         /* Overloaded constructor that creates an SML and connects it to the 
     43        /*! \brief Preferred SML Constructor. 
     44         * 
     45         * Overloaded constructor that creates an SML and connects it to the 
    3946         * shell with the passed hostname and port. 
    4047         */ 
     
    4249                const char* serverPort, int16_t clientPort); 
    4350 
    44         /* Connect and register with the shell component at the passed hostname 
     51        /*! \brief Connect the SML to a remote Shell control component.  
     52         * 
     53         * Connect and register with the shell component at the passed hostname 
    4554         * and port. 
    4655         */ 
    4756        void ConnectToShell(const char* serverName, const char* serverPort); 
     57 
    4858        void SendComponentType(); 
    4959        void MessageHandler(int32_t ID); 
     
    5363        void DeregisterComponent(); 
    5464 
    55         /* Starts the SML Server and watches it for incoming messages 
     65        /*! \brief Starts the SML Server and watches it for incoming messages 
     66         * 
     67         * TODO 
    5668         */ 
    5769        void StartSMLServer(); 
    5870 
    5971    private:  
    60         /* Receive the radio configuration settings from the shell and pass them 
     72        /*! \brief Pass the radio configuration onto another component.  
     73         * 
     74         * Receive the radio configuration settings from the shell and pass them 
    6175         * on to another component. 
    6276         */ 
    6377        void TransferRadioConfiguration(int32_t ID); 
    6478 
    65         /* Receive information regarding a completed 'experience' and pass it on 
     79        /*! \brief Pass a radio experience onto another component.  
     80         * 
     81         * Receive information regarding a completed 'experience' and pass it on 
    6682         * to the appropriate cognitive engine. 
    6783         */ 
    6884        void TransferExperience(int32_t ID); 
    6985         
    70         /* Listen for other components registering their available services with 
     86        /*! Listen for other components registering their available services with 
    7187         * the SML.  
    7288         */ 
     
    7490        void DeregisterServices(int32_t ID); 
    7591 
    76         /* Change the active mission of the radio to a new one and adjust radio 
     92        /*! Change the active mission of the radio to a new one and adjust radio 
    7793         * behavoir appropriately. 
    7894         */ 
    7995        void SetActiveMission(); 
    8096 
    81         /* TODO 
     97        /*! TODO 
    8298         */ 
    8399        void RegisterCognitiveEngine(int32_t ID); 
    84100        void DeregisterCognitiveEngine(int32_t ID); 
    85101 
    86         /* List all services provided to the radio by registered components. 
     102        /*! List all services provided to the radio by registered components. 
    87103         */ 
    88104        void ListServices(); 
    89105 
    90         /* Load/Relead the XML configuration file.  
     106        /*! Load/Relead the XML configuration file.  
    91107         */ 
    92108        void ReloadConfiguration(); 
    93109        void LoadConfiguration(const char *SML_Config, Mission* &mList); 
    94110 
    95         /* Create and initialize the DB to hold the services 
     111        /*! Create and initialize the DB to hold the services 
    96112        */ 
    97113        void CreateServicesDB(); 
    98114        void CreateDataDB(); 
    99115 
    100         /* TODO 
     116        /*! TODO 
    101117         */ 
    102118        void PerformActiveMission(); 
    103119        void TransactData(int32_t sourceID); 
    104120 
    105         /* The socket file descriptor information for the shell which this SML 
     121        /*! The socket file descriptor information for the shell which this SML 
    106122         * is connected to. 
    107123         */ 
    108124        int32_t shellSocketFD; 
    109125 
    110         /* TODO 
     126        /*! TODO 
    111127         */ 
    112128        int16_t CEPort;