Extensions.DiagCom.GetComChannel
Contents
Classification
| Name | GetComChannel |
| Short Description | Represents a connection to the control unit at runtime |
| Class | Term |
| Extension | OTX DiagCom extension |
| Group | ComChanel related terms |
| Exceptions | UnknownTargetException LossOfComException |
| Checker Rules | - |
| Standard Compliant | Yes |
OTL Syntax
DiagCom.GetComChannel(StringTerm, StringTerm, BooleanTerm);Description
GetComChannel is a term to create a new communication channel via the runtime system diagnosis . The communication channel represents a connection to only one control unit (Logical Link).
To create a connection to the ECU, the following rules are applied:
- The ComChannel is created when this term was called
- If the ComChannel has been already created, it is used and it is carried out, no further action.
It is possible to manually control the lifecycle of a ComChannel by closing a ComChannel handle using the CloseComChannel action. The OTX runtime environment will clean up all opened ComChannel handles at releases all ressources related to this ComChannel.
|
Important: Long-time running procedures should note that the OTX runtime will close open ComChannels (see GetComChannel) solely via the CloseComChannel activity! This has an impact on the long-time stability of the runtime environment. To avoid memory leaks, ComChannels should not be opened implicitly, like
ExecuteDiagService(CreateDiagServiceByName(GetComChannel("LL_AirbaUDS","",false), "DiagnServi_ReadDataByIdentECUIdent"), ...);because the resources cannot be released until the completion of runtime execution. Better use: ComChannel comChannel = GetComChannel("LL_AirbaUDS","",false);
DiagService diagService = CreateDiagServiceByName(comChannel, "DiagnServi_ReadDataByIdentECUIdent"));
ExecuteDiagService(diagService, ...);
...
CloseComChannel(comChannel);For the short-dated execution of procedures, this is of minor importance! |
An GetComChannel#ECU_variant_selection|ECU variant selection can be performed, see below.
Return Value
The Term returns the value, see table below.
In OTX, Terms are categorized according to its return data type!
| Data Type | Description |
| ComChannel | Returns a handle to the ComChannel for a given ECU |
Properties
| Name | Data Type | Class | Default | Cardinality | Description |
| Identifier | String | Term | - | [1] | String that the Communication Channel identified (Logical Link) |
| EcuVariantName | String | Term | "" | [0..1] | Optionally you can select "manual" a special version here. |
| PerformVariantSelection | Boolean | Term | false | [0..1] | Select whether a Variant Identification is to be performed or not. |
ECU variant selection
An ECU variant selection can be performed after opening the channel and returns a handle to the selected ECU-Variant. The variant identification functionality also exists as a separate action called IdentifyAndSelectVariant.
| EcuVariantName | PerformVariantSelection | |
| Empty | False | No ECU variant selection is performed |
| Empty | True | An ECU variant selection is performed for the BaseVariant descriped in Identifier |
| NotEmpty | True | An ECU variant selection is performed. The channel is created to point at the desired ECUVariant and variant selection is performed on the link afterwards. |
OTL Examples
DiagCom.ComChannel myComCannel;
myComCannel = DiagCom.GetComChannel("LL_AllEmissRelatUDSSyste", null, false);See also
GetComChannelIdentifierFromResponse
GetComChannelEcuVariantName
IsVariant
ExecuteDiagService
