OpenTestSystem.Otx.Extensions.DiagComPlus.Terms.CreateComChannel Class Reference

Creates a communication channel to an ECU More...

Inheritance diagram for OpenTestSystem.Otx.Extensions.DiagComPlus.Terms.CreateComChannel:

Public Attributes
StringTerm	ecuVariantName
	Cardinality [1] This optional element allows an OTX sequence to explicitly specify a particular ECU variant that the ComChannel shall be associated with. It is provided in addition to the identifier attribute based on the assumption that the ComChannel identifier specifies a connection to a base variant of an ECU. The <ecuVariantName> element can be used to directly create a ComChannel to a specific ECU variant without needing to perform the ECU variant identification step. More...
StringTerm	identifier
	Cardinality [1] This element represents a string identifying the communication channel, which shall be created. More...
Public Attributes inherited from OpenTestSystem.Otx.Core.Terms.Term
MetaData	metaData
	Cardinality [0..1] The MetaData type allows tools to store additional, mainly tool-specific data. More...

Detailed Description

Creates a communication channel to an ECU

The CreateComChannel creates a communication channel to an ECU. The term is needed, because the diag:GetComChannel term does not guarantee, that the communication is not started. For exchangeability the usage of this term is recommended instead of diag:GetComChannel, if the user wants to set communication parameters before starting communication. The detailed runtime behavior is described in DiagManager Runtime Behavior.

Exceptions

DiagCom.Exceptions.UnknownTargetException

If the diag:ComChannel identifier provided by the <identifer> element doesn't exist or is invalid.

Syntax

ComChannelTerm = DiagComPlus.CreateComChannel(StringTerm identifier, StringTerm ecuVariableName = NULL);

Examples

// Local Declarations
Exception Exception1;
DiagCom.ComChannel ComChannel1;
 
// Flow
ComChannel1 = DiagCom.GetComChannel("LL_GatewUDS", "EV_GatewLear_006", false);
try
{
    DiagComPlus.StartCommunication(ComChannel1);
    ComChannel1 = DiagComPlus.CreateComChannel("LL_GatewUDS", "EV_GatewLear_006");
    DiagComPlus.StopCommunication(ComChannel1);
}
catch (DiagCom.LossOfComException Exception1)
{
}

Member Data Documentation

ecuVariantName

StringTerm OpenTestSystem.Otx.Extensions.DiagComPlus.Terms.CreateComChannel.ecuVariantName

Cardinality [1]
This optional element allows an OTX sequence to explicitly specify a particular ECU variant that the ComChannel shall be associated with. It is provided in addition to the identifier attribute based on the assumption that the ComChannel identifier specifies a connection to a base variant of an ECU. The <ecuVariantName> element can be used to directly create a ComChannel to a specific ECU variant without needing to perform the ECU variant identification step.

Note

In case a MVCI/ODX system is used the <ecuVariantName> element specifies the SHORT-NAME of the MCDDbEcuVariant to be associated with the logical link.

identifier

StringTerm OpenTestSystem.Otx.Extensions.DiagComPlus.Terms.CreateComChannel.identifier

Cardinality [1]
This element represents a string identifying the communication channel, which shall be created.

Note

In case a MVCI/ODX system is used the identifier specifies the SHORT-NAME of the MCDLogicalLink to be used for communication.