Difference between revisions of "Extensions.DiagCom.SetComParameter"
Jump to navigation
Jump to search
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:OTX '''SetComParameter'''}}[[Category:DiagCom]] | {{DISPLAYTITLE:OTX '''SetComParameter'''}}[[Category:DiagCom]] | ||
== Classification == | == Classification == | ||
| − | {{ClassificationActivity | SetComParameter | | + | {{ClassificationActivity | SetComParameter | Changes the value of a communication parameter | [[Action]] | [[Extensions.DiagCom|OTX DiagCom extension]] | [[Extensions.DiagCom#Actions|ComParameter related actions]] | [[Extensions.DiagCom.UnknownTargetException|UnknownTargetException]] <br/> [[Core.DataTypes.ComplexDataType.TypeMismatchException|TypeMismatchException]] | - }} |
== OTL Syntax == | == OTL Syntax == | ||
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;"> | <syntaxhighlight lang="java" enclose="div" style="font-size: medium;"> | ||
| − | DiagCom.SetComParameter( | + | DiagCom.SetComParameter(ComChannelValue, StringTerm, Term); |
</syntaxhighlight> | </syntaxhighlight> | ||
== Description == | == Description == | ||
| − | OTX '''SetComParameter''' activity is used to change the communication parameter, | + | OTX '''SetComParameter''' activity is used to change the value of a communication parameter used by the communication backend. For example, bus timeouts or baud rates can be set using the '''SetComParameter''' node. |
| − | {{Note|In an ODX/MVCI | + | {{Note| In case an ODX/MVCI system is used for vehicle communication, the communication parameter names and data types that can be set are defined by the "D-PDU API/ODX communication parameter" specification.}} |
| + | {{Note|In case an ODX/MVCI system is used for vehicle communication, this action should implicitly control the LogicalLink State. The state should be adjusted for setting of COM Parameters. This requires state eONLINE.}} | ||
== Properties == | == Properties == | ||
{| {{TableHeader}} | {| {{TableHeader}} | ||
{{TableRowPropertiesHeader}} | {{TableRowPropertiesHeader}} | ||
| − | {{TableRowPropertie1| ComChannel | [[Extensions.DiagCom.ComChannel|ComChannel]] | [[ | + | {{TableRowPropertie1| ComChannel | [[Extensions.DiagCom.ComChannel|ComChannel]] | [[Value]] | - | [1] | This element comprises the communication channel where the communication parameter shall be modified.}} |
| − | {{TableRowPropertie2| Name | [[Core.DataTypes.SimpleDataType.String|String]] | [[Term]] | - | [ | + | {{TableRowPropertie2| Name | [[Core.DataTypes.SimpleDataType.String|String]] | [[Term]] | - | [1] | This element specifies the name of the communication parameter which shall be changed.}} |
| − | {{TableRowPropertie1| Value | - | [[ | + | {{TableRowPropertie1| Value | - | [[Term]] | - | [1] | This element specifies the new communication parameter value that shall be set.}} |
|} | |} | ||
== OTL Examples == | == OTL Examples == | ||
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;"> | <syntaxhighlight lang="java" enclose="div" style="font-size: medium;"> | ||
| − | DiagCom.ComChannel | + | DiagCom.ComChannel ComChannel1; |
| − | + | /// Flow | |
| − | DiagCom.SetComParameter( | + | |
| + | ComChannel1 = DiagCom.GetComChannel("LL_CentrElectUDS", "EV_BCMCONTI_009", false); | ||
| + | DiagCom.SetComParameter(ComChannel1, "CP_TesterPresentMessage", &012345); | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Revision as of 09:51, 10 October 2018
Classification
| Name | SetComParameter |
| Short Description | Changes the value of a communication parameter |
| Class | Action |
| Extension | OTX DiagCom extension |
| Group | ComParameter related actions |
| Exceptions | UnknownTargetException TypeMismatchException |
| Checker Rules | - |
| Standard Compliant | Yes |
OTL Syntax
DiagCom.SetComParameter(ComChannelValue, StringTerm, Term);Description
OTX SetComParameter activity is used to change the value of a communication parameter used by the communication backend. For example, bus timeouts or baud rates can be set using the SetComParameter node.
In case an ODX/MVCI system is used for vehicle communication, the communication parameter names and data types that can be set are defined by the "D-PDU API/ODX communication parameter" specification.
In case an ODX/MVCI system is used for vehicle communication, this action should implicitly control the LogicalLink State. The state should be adjusted for setting of COM Parameters. This requires state eONLINE.
Properties
| Name | Data Type | Class | Default | Cardinality | Description |
| ComChannel | ComChannel | Value | - | [1] | This element comprises the communication channel where the communication parameter shall be modified. |
| Name | String | Term | - | [1] | This element specifies the name of the communication parameter which shall be changed. |
| Value | - | Term | - | [1] | This element specifies the new communication parameter value that shall be set. |
OTL Examples
DiagCom.ComChannel ComChannel1;
/// Flow
ComChannel1 = DiagCom.GetComChannel("LL_CentrElectUDS", "EV_BCMCONTI_009", false);
DiagCom.SetComParameter(ComChannel1, "CP_TesterPresentMessage", &012345);