Orocos Real-Time Toolkit 2.5.0
A State contains an entry, run, handle and exit program. More...
|virtual void||loaded (ExecutionEngine *ee)|
|virtual const std::string &||getName () const =0|
|Get the name of this state. |
|virtual ProgramInterface *||getEntryProgram () const =0|
|Get the entry program of this State. |
|virtual ProgramInterface *||getRunProgram () const =0|
|Get the run program of this State. |
|virtual ProgramInterface *||getHandleProgram () const =0|
|Get the handle program of this State. |
|virtual ProgramInterface *||getExitProgram () const =0|
|Get the exit program of this State. |
|virtual int||getEntryPoint () const =0|
|Get the beginning definition of this State. |
|virtual StateInterface *||copy (std::map< const base::DataSourceBase *, base::DataSourceBase * > &replacementdss) const =0|
A State contains an entry, run, handle and exit program.
The entry and exit programs will be called when the state is entered of left. The handle program will be called each time the state is requested and no transition is made. The run program will be called before any transition is evaluated.
Thus when we are in state A and want to switch to state B, the following happens :
* in State A : * call A->run(); * if ( transition to B allowed ) * call A->onExit(); * call B->onEntry(); * return true; * else * call A->handle(); * return false; *
Error recovery can be handled inside these programs, if even that fails, the programs return false and the state machine containing this state is considered in error.