Orocos Real-Time Toolkit  2.9.0
Public Types | Public Member Functions | List of all members
RTT::corba::CDataFlowInterface Interface Reference

An interface to access the dataflow of a CControlTask object. More...

import"rtt/transports/corba/DataFlow.idl";

Inheritance diagram for RTT::corba::CDataFlowInterface:
RTT::corba::CService

Public Types

typedef sequence< string > CPortNames
 
typedef sequence< CPortDescriptionCPortDescriptions
 

Public Member Functions

CPortNames getPorts ()
 Returns the names of the ports of this component. More...
 
CPortDescriptions getPortDescriptions ()
 Returns the names of the ports of this component. More...
 
CPortType getPortType (in string port_name) raises (CNoSuchPortException)
 Returns the type of the given port. More...
 
string getDataType (in string port_name) raises (CNoSuchPortException)
 Returns the data type for the given port. More...
 
boolean isConnected (in string port_name) raises (CNoSuchPortException)
 Check if the given port is already connected to something. More...
 
void disconnectPort (in string port_name) raises (CNoSuchPortException)
 Disconnects this port from all connections it is part of. More...
 
CChannelElement buildChannelOutput (in string input_port, inout CConnPolicy policy) raises (CNoCorbaTransport,CNoSuchPortException,CInvalidArgument)
 Use this to write to an input port with the given policy. More...
 
CChannelElement buildChannelInput (in string output_port, inout CConnPolicy policy) raises (CNoCorbaTransport,CNoSuchPortException,CInvalidArgument)
 Use this to read from an output port with the given policy. More...
 
boolean createConnection (in string local_port, in CDataFlowInterface remote_ports, in string remote_port, inout CConnPolicy policy) raises (CNoSuchPortException)
 Connect the given named port to the given remote port. More...
 
boolean createSharedConnection (in string input_port, inout CConnPolicy policy) raises (CNoSuchPortException,CInvalidArgument)
 Use this to connect a port to an existing connection that can be looked up by the given policy. More...
 
boolean removeConnection (in string local_port, in CDataFlowInterface remote_ports, in string remote_port) raises (CNoSuchPortException)
 Removes the specified connection created with createConnection. More...
 
boolean createStream (in string local_port, inout CConnPolicy policy) raises (CNoSuchPortException)
 Create an out-of-band data stream with a given policy. More...
 
void removeStream (in string local_port, in string stream_name) raises (CNoSuchPortException)
 Removes a stream added with createStream. More...
 

Detailed Description

An interface to access the dataflow of a CControlTask object.

Data ports are exported as assignable expressions (Set/Get). Buffer ports are exported as buffer channels.

Definition at line 150 of file DataFlow.idl.

Member Typedef Documentation

Definition at line 153 of file DataFlow.idl.

Definition at line 152 of file DataFlow.idl.

Member Function Documentation

CChannelElement RTT::corba::CDataFlowInterface::buildChannelInput ( in string  output_port,
inout CConnPolicy  policy 
)
raises (CNoCorbaTransport,
CNoSuchPortException,
CInvalidArgument
)

Use this to read from an output port with the given policy.

Some protocols may adjust the policy, or pass additional information into the policy, such as the name of the newly created connection.

CChannelElement RTT::corba::CDataFlowInterface::buildChannelOutput ( in string  input_port,
inout CConnPolicy  policy 
)
raises (CNoCorbaTransport,
CNoSuchPortException,
CInvalidArgument
)

Use this to write to an input port with the given policy.

Some protocols may adjust the policy, or pass additional information into the policy, such as the name of the newly created connection.

The returned channel element will not be functional until channelReady() has been called for it

boolean RTT::corba::CDataFlowInterface::createConnection ( in string  local_port,
in CDataFlowInterface  remote_ports,
in string  remote_port,
inout CConnPolicy  policy 
)
raises (CNoSuchPortException
)

Connect the given named port to the given remote port.

Use this method to connect two Orocos data flow ports.

The local port needs to be the output, while the remote port is the input. In case you only want to write a port without using this function, use buildChannelOutput. For only reading a port, use buildChannelInput.

This method combines both buildChannelOutput() and buildChannelInput() and is generally better in setting up and checking a data flow connection between two ports than the separate methods.

This method will call the remote_ports interface back to orchestrate the connection building.

See also
removeConnection() to remove this connection again.
boolean RTT::corba::CDataFlowInterface::createSharedConnection ( in string  input_port,
inout CConnPolicy  policy 
)
raises (CNoSuchPortException,
CInvalidArgument
)

Use this to connect a port to an existing connection that can be looked up by the given policy.

boolean RTT::corba::CDataFlowInterface::createStream ( in string  local_port,
inout CConnPolicy  policy 
)
raises (CNoSuchPortException
)

Create an out-of-band data stream with a given policy.

You may specify a name_id in the policy object, or if left empty, a name will be chosen for you.

void RTT::corba::CDataFlowInterface::disconnectPort ( in string  port_name)
raises (CNoSuchPortException
)

Disconnects this port from all connections it is part of.

See also
CChannelElement::disconnect() to disconnect a single Channel.
string RTT::corba::CDataFlowInterface::getDataType ( in string  port_name)
raises (CNoSuchPortException
)

Returns the data type for the given port.

CPortDescriptions RTT::corba::CDataFlowInterface::getPortDescriptions ( )

Returns the names of the ports of this component.

CPortNames RTT::corba::CDataFlowInterface::getPorts ( )

Returns the names of the ports of this component.

CPortType RTT::corba::CDataFlowInterface::getPortType ( in string  port_name)
raises (CNoSuchPortException
)

Returns the type of the given port.

boolean RTT::corba::CDataFlowInterface::isConnected ( in string  port_name)
raises (CNoSuchPortException
)

Check if the given port is already connected to something.

boolean RTT::corba::CDataFlowInterface::removeConnection ( in string  local_port,
in CDataFlowInterface  remote_ports,
in string  remote_port 
)
raises (CNoSuchPortException
)

Removes the specified connection created with createConnection.

void RTT::corba::CDataFlowInterface::removeStream ( in string  local_port,
in string  stream_name 
)
raises (CNoSuchPortException
)

Removes a stream added with createStream.

Parameters
local_portThe port to remove the stream from.
stream_nameThe name_id returned in the CConnPolicy object after the call to createStream.

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