OpenRTM-aist IDL  1.2
Public Member Functions | List of all members
RTC::DataFlowComponent Interface Reference

dataFlowComponent More...

import"RTC.idl";

Inheritance diagram for RTC::DataFlowComponent:
Inheritance graph
[legend]
Collaboration diagram for RTC::DataFlowComponent:
Collaboration graph
[legend]

Public Member Functions

ReturnCode_t initialize ()
 initialize More...
 
ReturnCode_t finalize ()
 finalize More...
 
boolean is_alive (in ExecutionContext exec_context)
 is_alive More...
 
ReturnCode_t exit ()
 exit More...
 
ExecutionContextHandle_t attach_context (in ExecutionContext exec_context)
 attach_context More...
 
ReturnCode_t detach_context (in ExecutionContextHandle_t exec_handle)
 detach_context More...
 
ExecutionContext get_context (in ExecutionContextHandle_t exec_handle)
 get_context More...
 
ExecutionContextList get_owned_contexts ()
 get_owned_contexts More...
 
ExecutionContextList get_participating_contexts ()
 
  • get_participating_contexts
More...
 
ExecutionContextHandle_t get_context_handle (in ExecutionContext cxt)
 get_context_handle More...
 
ReturnCode_t on_initialize ()
 on_initialize More...
 
ReturnCode_t on_finalize ()
 on_finalize More...
 
ReturnCode_t on_startup (in ExecutionContextHandle_t exec_handle)
 on_startup More...
 
ReturnCode_t on_shutdown (in ExecutionContextHandle_t exec_handle)
 on_shutdown More...
 
ReturnCode_t on_activated (in ExecutionContextHandle_t exec_handle)
 on_activated More...
 
ReturnCode_t on_deactivated (in ExecutionContextHandle_t exec_handle)
 on_deactivated More...
 
ReturnCode_t on_aborting (in ExecutionContextHandle_t exec_handle)
 on_aborting More...
 
ReturnCode_t on_error (in ExecutionContextHandle_t exec_handle)
 on_error More...
 
ReturnCode_t on_reset (in ExecutionContextHandle_t exec_handle)
 on_reset More...
 
ReturnCode_t on_execute (in ExecutionContextHandle_t exec_handle)
 on_execute More...
 
ReturnCode_t on_state_update (in ExecutionContextHandle_t exec_handle)
 on_state_update More...
 
ReturnCode_t on_rate_changed (in ExecutionContextHandle_t exec_handle)
 on_rate_changed More...
 

Detailed Description

dataFlowComponent

Description

The dataFlowComponent stereotype may be applied to a component type to indicate that its instances should be executed in sorted order by a periodic execution context.

Constraints

Member Function Documentation

ExecutionContextHandle_t RTC::LightweightRTObject::attach_context ( in ExecutionContext  exec_context)
inherited

attach_context

Description

Inform this RTC that it is participating in the given execution context. Return a handle that represents the association of this RTC with the context.

Semantics

This operation is intended to be invoked by ExecutionContextOperations::add_component (see Section 5.2.2.6.6). It is not intended for use by other clients.

ReturnCode_t RTC::LightweightRTObject::detach_context ( in ExecutionContextHandle_t  exec_handle)
inherited

detach_context

Description

Inform this RTC that it is no longer participating in the given execution context.

Semantics

This operation is intended to be invoked by ExecutionContextOperations::remove_component (see Section 5.2.2.6.7). It is not intended for use by other clients.

Constraints

  • This operation may not be invoked if this RTC is not already participating in the execution context. Such a call shall fail with ReturnCode_t::PRECONDITION_NOT_MET.
  • This operation may not be invoked if this RTC is Active in the indicated execution context. Otherwise, it shall fail with ReturnCode_t::PRECONDITION_NOT_MET.
ReturnCode_t RTC::LightweightRTObject::exit ( )
inherited

exit

Description

Stop the RTC’s execution context(s) and finalize it along with its contents.

Semantics

Any execution contexts for which the RTC is the owner shall be stopped. If the RTC participates in any execution contexts belonging to another RTC that contains it, directly or indirectly (i.e., the containing RTC is the owner of the ExecutionContext), it shall be deactivated in those contexts. After the RTC is no longer Active in any Running execution context, it and any RTCs contained transitively within it shall be finalized.

Constraints

An RTC cannot be exited if it has not yet been initialized. Any attempt to exit an RTC that is in the Created state shall fail with ReturnCode_t::PRECONDITION_NOT_MET.

ReturnCode_t RTC::LightweightRTObject::finalize ( )
inherited

finalize

Description

Finalize the RTC that realizes this interface, preparing it for destruction.

Semantics

This invocation of this operation shall result in the invocation of the callback ComponentAction::on_finalize

Constraints

  • An RTC may not be finalized while it is participating in any execution context. It must first be removed with ExecutionContextOperations::remove_component. Otherwise, this operation shall fail with ReturnCode_t::PRECONDITION_NOT_MET. See Figure 5.9.
  • An RTC may not be finalized while it is in the Created state. Any attempt to invoke this operation while in that state shall fail with ReturnCode_t::PRECONDITION_NOT_MET.
  • Application developers are not expected to call this operation directly; it exists for use by the RTC infrastructure.
ExecutionContext RTC::LightweightRTObject::get_context ( in ExecutionContextHandle_t  exec_handle)
inherited

get_context

Description

Obtain a reference to the execution context represented by the given handle.

Semantics

The mapping from handle to context is specific to a particular RTC instance. The given handle must have been obtained by a previous call to attach_context on this RTC.

ExecutionContextHandle_t RTC::LightweightRTObject::get_context_handle ( in ExecutionContext  cxt)
inherited

get_context_handle

Description

This operation returns a handle that is associated with the given execution context.

ExecutionContextList RTC::LightweightRTObject::get_owned_contexts ( )
inherited

get_owned_contexts

Description

This operation returns a list of all execution contexts owned by this RTC.

ExecutionContextList RTC::LightweightRTObject::get_participating_contexts ( )
inherited

  • get_participating_contexts

Description

This operation returns a list of all execution contexts in which this RTC participates.

Semantics

Each call to attach_context causes the provided context to be added to this list. Each call to detach_context causes the provided context to be removed from this list.

ReturnCode_t RTC::LightweightRTObject::initialize ( )
inherited

initialize

Description

Initialize the RTC that realizes this interface.

Semantics

The invocation of this operation shall result in the invocation of the callback ComponentAction::on_initialize.

Constraints

  • An RTC may be initialized only while it is in the Created state. Any attempt to invoke this operation while in another state shall fail with ReturnCode_t::PRECONDITION_NOT_MET.
  • Application developers are not expected to call this operation directly; it exists for use by the RTC infrastructure.
boolean RTC::LightweightRTObject::is_alive ( in ExecutionContext  exec_context)
inherited

is_alive

Description

A component is alive or not regardless of the execution context from which it is observed. However, whether or not it is Active, Inactive, or in Error is dependent on the execution context(s) (see Figure 5.7) in which it is running. That is, it may be Active in one context but Inactive in another. Therefore, this operation shall report whether this RTC is either Active, Inactive, or in Error; which of those states a component is in with respect to a particular context may be queried from the context itself.

ReturnCode_t RTC::ComponentAction::on_aborting ( in ExecutionContextHandle_t  exec_handle)
inherited

on_aborting

Description

The RTC is transitioning from the Active state to the Error state in some execution context.

Semantics

This callback is invoked only a single time for time that the RTC transitions into the Error state from another state. This behavior is in contrast to that of on_error.

ReturnCode_t RTC::ComponentAction::on_activated ( in ExecutionContextHandle_t  exec_handle)
inherited

on_activated

Description

The RTC has been activated in the given execution context.

ReturnCode_t RTC::ComponentAction::on_deactivated ( in ExecutionContextHandle_t  exec_handle)
inherited

on_deactivated

Description

The RTC has been deactivated in the given execution context.

ReturnCode_t RTC::ComponentAction::on_error ( in ExecutionContextHandle_t  exec_handle)
inherited

on_error

Description

The RTC remains in the Error state.

Semantics

If the RTC is in the Error state relative to some execution context when it would otherwise be invoked from that context (according to the context’s ExecutionKind), this callback shall be invoked instead. For example,

ReturnCode_t RTC::DataFlowComponentAction::on_execute ( in ExecutionContextHandle_t  exec_handle)
inherited

on_execute

Description

This operation will be invoked periodically at the rate of the given execution context as long as the following conditions hold:

  • The RTC is Active.
  • The given execution context is Running.

Semantics

This callback occurs during the first execution pass.

Constraints

  • The execution context of the given context shall be PERIODIC.
ReturnCode_t RTC::ComponentAction::on_finalize ( )
inherited

on_finalize

Description

The RTC is being destroyed.

Semantics

Any final RTC-specific tear-down logic should be performed here.

ReturnCode_t RTC::ComponentAction::on_initialize ( )
inherited

on_initialize

Description

The RTC has been initialized and entered the Alive state.

Semantics

Any RTC-specific initialization logic should be performed here.

ReturnCode_t RTC::DataFlowComponentAction::on_rate_changed ( in ExecutionContextHandle_t  exec_handle)
inherited

on_rate_changed

Description

This operation is a notification that the rate of the indicated execution context (see Section 5.2.2.6.4) has changed.

Constraints

  • The execution context of the given context shall be PERIODIC.
ReturnCode_t RTC::ComponentAction::on_reset ( in ExecutionContextHandle_t  exec_handle)
inherited

on_reset

Description

The RTC is in the Error state. An attempt is being made to recover it such that it can return to the Inactive state.

Semantics

If the RTC was successfully recovered and can safely return to the Inactive state, this method shall complete with ReturnCode_t::OK. Any other result shall indicate that the RTC should remain in the Error state.

ReturnCode_t RTC::ComponentAction::on_shutdown ( in ExecutionContextHandle_t  exec_handle)
inherited

on_shutdown

Description

The given execution context, in which the RTC is participating, has transitioned from Running to Stopped.

ReturnCode_t RTC::ComponentAction::on_startup ( in ExecutionContextHandle_t  exec_handle)
inherited

on_startup

Description

The given execution context, in which the RTC is participating, has transitioned from Stopped to Running.

ReturnCode_t RTC::DataFlowComponentAction::on_state_update ( in ExecutionContextHandle_t  exec_handle)
inherited

on_state_update

Description

This operation will be invoked periodically at the rate of the given execution context as long as the following conditions hold:

  • The RTC is Active.
  • The given execution context is Running.

Semantics

This callback occurs during the second execution pass.

Constraints

  • The execution context of the given context shall be PERIODIC.

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