Difference between revisions of "Extensions.DiagCom"
Jump to navigation
Jump to search
(31 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
+ | {{DISPLAYTITLE:OTX '''DiagCom''' Extension}}[[Category:OTX-Extension]][[Category:DiagCom]] | ||
== Classification == | == Classification == | ||
− | {{ClassificationExtension| | + | {{ClassificationExtension | DiagCom | Diagnostic Vehicle Communication | [[OtxReference#Extensions|OTX Extension]] | - | [[Diagnostic Communication Kernel (MVCI ISO 22900)]]}} |
== Introduction == | == Introduction == | ||
Line 18: | Line 19: | ||
{| {{TableHeader}} | {| {{TableHeader}} | ||
{{TableRowCatagory|ComChannel related actions}} | {{TableRowCatagory|ComChannel related actions}} | ||
− | {{TableRowKeyValueList|[[IdentifyAndSelectVariant]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.IdentifyAndSelectVariant|IdentifyAndSelectVariant]]|}} |
− | {{TableRowKeyValueList|[[CloseComChannel]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.CloseComChannel|CloseComChannel]]|}} |
{{TableRowCatagory|ComParameter related actions}} | {{TableRowCatagory|ComParameter related actions}} | ||
− | {{TableRowKeyValueList|[[SetComParameter]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.SetComParameter|SetComParameter]]|}} |
− | {{TableRowKeyValueList|[[SetComplexComParameter]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.SetComplexComParameter|SetComplexComParameter]]|}} |
{{TableRowCatagory|DiagService related actions}} | {{TableRowCatagory|DiagService related actions}} | ||
− | {{TableRowKeyValueList|[[ExecuteDiagService]]| | + | {{TableRowKeyValueList|[[Extensions.DiagCom.ExecuteDiagService|ExecuteDiagService]]|}} |
− | {{TableRowKeyValueList|[[ExecuteHexDiagService]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.ExecuteHexDiagService|ExecuteHexDiagService]]|}} |
− | {{TableRowKeyValueList|[[StartRepeatedExecution]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.StartRepeatedExecution|StartRepeatedExecution]]|}} |
− | {{TableRowKeyValueList|[[StopRepeatedExecution]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.StopRepeatedExecution|StopRepeatedExecution]]|}} |
− | {{TableRowKeyValueList|[[SetRepetitionTime]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.SetRepetitionTime|SetRepetitionTime]]|}} |
− | {{TableRowKeyValueList|[[GetAllResultsAndClear]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetAllResultsAndClear|GetAllResultsAndClear]]|}} |
− | {{TableRowKeyValueList|[[SetParameterValue]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.SetParameterValue|SetParameterValue]]|}} |
− | {{TableRowKeyValueList|[[SetParameterValueBySemantic]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.SetParameterValueBySemantic|SetParameterValueBySemantic]]|}} |
− | {{TableRowKeyValueList|[[SetPdu]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.SetPdu|SetPdu]]|}} |
|} | |} | ||
Line 41: | Line 42: | ||
{{TableRowCatagory|ComChannel related terms}} | {{TableRowCatagory|ComChannel related terms}} | ||
− | {{TableRowKeyValueList|[[GetComChannel]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetComChannel|GetComChannel]]|}} |
− | {{TableRowKeyValueList|[[GetComChannelIdentifierFromResponse]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetComChannelIdentifierFromResponse|GetComChannelIdentifierFromResponse]]|}} |
− | {{TableRowKeyValueList|[[GetComChannelEcuVariantName]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetComChannelEcuVariantName|GetComChannelEcuVariantName]]|}} |
− | {{TableRowKeyValueList|[[IsVariant]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.IsVariant|IsVariant]]|}} |
{{TableRowCatagory|DiagService related terms}} | {{TableRowCatagory|DiagService related terms}} | ||
− | {{TableRowKeyValueList|[[CreateDiagServiceByName]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.CreateDiagServiceByName|CreateDiagServiceByName]]|}} |
− | {{TableRowKeyValueList|[[CreateDiagServiceBySemantic]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.CreateDiagServiceBySemantic|CreateDiagServiceBySemantic]]|}} |
− | {{TableRowKeyValueList|[[GetDiagServiceListBySemantic]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetDiagServiceListBySemantic|GetDiagServiceListBySemantic]]|}} |
− | {{TableRowKeyValueList|[[GetDiagServiceFromResult]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetDiagServiceFromResult|GetDiagServiceFromResult]]|}} |
− | {{TableRowKeyValueList|[[GetDiagServiceFromException]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetDiagServiceFromException|GetDiagServiceFromException]]|}} |
− | {{TableRowKeyValueList|[[GetDiagServiceName]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetDiagServiceName|GetDiagServiceName]]|}} |
− | {{TableRowKeyValueList|[[GetRepetitionTime]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetRepetitionTime|GetRepetitionTime]]|}} |
{{TableRowCatagory|Request related terms}} | {{TableRowCatagory|Request related terms}} | ||
− | {{TableRowKeyValueList|[[GetRequest]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetRequest|GetRequest]]|}} |
− | {{TableRowKeyValueList|[[GetPdu]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetPdu|GetPdu]]|}} |
{{TableRowCatagory|Result related terms}} | {{TableRowCatagory|Result related terms}} | ||
− | {{TableRowKeyValueList|[[GetFirstResult]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetFirstResult|GetFirstResult]]|}} |
− | {{TableRowKeyValueList|[[GetAllResults]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetAllResults|GetAllResults]]|}} |
− | {{TableRowKeyValueList|[[GetResultState]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetResultState|GetResultState]]|}} |
{{TableRowCatagory|Response related terms}} | {{TableRowCatagory|Response related terms}} | ||
− | {{TableRowKeyValueList|[[GetFirstResponse]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetFirstResponse|GetFirstResponse]]|}} |
− | {{TableRowKeyValueList|[[GetAllResponses]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetAllResponses|GetAllResponses]]|}} |
− | {{TableRowKeyValueList|[[GetResponseName]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetResponseName|GetResponseName]]|}} |
− | {{TableRowKeyValueList|[[GetResponseState]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetResponseState|GetResponseState]]|}} |
− | {{TableRowKeyValueList|[[IsPositive | + | {{TableRowKeyValueList|[[Extensions.DiagCom.IsPositive|IsPositive]]|}} |
− | |||
− | |||
− | |||
− | |||
{{TableRowCatagory|Parameter related terms}} | {{TableRowCatagory|Parameter related terms}} | ||
− | {{TableRowKeyValueList|[[GetParameterBySemantic]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetParameterBySemantic|GetParameterBySemantic]]|}} |
− | {{TableRowKeyValueList|[[GetParameterByPath]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetParameterByPath|GetParameterByPath]]|}} |
− | {{TableRowKeyValueList|[[GetParameterName]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetParameterName|GetParameterName]]|}} |
− | {{TableRowKeyValueList|[[GetParameterSemantic]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetParameterSemantic|GetParameterSemantic]]|}} |
− | {{TableRowKeyValueList|[[GetParameterTextId]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetParameterTextId|GetParameterTextId]]|}} |
− | {{TableRowKeyValueList|[[GetParameterAsList]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetParameterAsList|GetParameterAsList]]|}} |
− | {{TableRowKeyValueList|[[GetParameterValueAsBoolean]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetParameterValueAsBoolean|GetParameterValueAsBoolean]]|}} |
− | {{TableRowKeyValueList|[[GetParameterValueAsString]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetParameterValueAsString|GetParameterValueAsString]]|}} |
− | {{TableRowKeyValueList|[[GetParameterValueAsInteger]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetParameterValueAsInteger|GetParameterValueAsInteger]]|}} |
− | {{TableRowKeyValueList|[[GetParameterValueAsFloat]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetParameterValueAsFloat|GetParameterValueAsFloat]]|}} |
− | {{TableRowKeyValueList|[[GetParameterValueAsByteField]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetParameterValueAsByteField|GetParameterValueAsByteField]]|}} |
− | {{TableRowKeyValueList|[[GetParameterValueAsQuantity]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetParameterValueAsQuantity|GetParameterValueAsQuantity]]|}} |
{{TableRowCatagory|ComParam related terms}} | {{TableRowCatagory|ComParam related terms}} | ||
− | {{TableRowKeyValueList|[[GetDefaultComplexComParameter]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetDefaultComplexComParameter|GetDefaultComplexComParameter]]|}} |
− | {{TableRowKeyValueList|[[GetComplexComParameter]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetComplexComParameter|GetComplexComParameter]]|}} |
− | {{TableRowKeyValueList|[[GetComParameterValueAsBoolean]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetComParameterValueAsBoolean|GetComParameterValueAsBoolean]]|}} |
− | {{TableRowKeyValueList|[[GetComParameterValueAsString]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetComParameterValueAsString|GetComParameterValueAsString]]|}} |
− | {{TableRowKeyValueList|[[GetComParameterValueAsInteger]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetComParameterValueAsInteger|GetComParameterValueAsInteger]]|}} |
− | {{TableRowKeyValueList|[[GetComParameterValueAsFloat]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetComParameterValueAsFloat|GetComParameterValueAsFloat]]|}} |
− | {{TableRowKeyValueList|[[GetComParameterValueAsByteField]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetComParameterValueAsByteField|GetComParameterValueAsByteField]]|}} |
− | {{TableRowKeyValueList|[[GetComParameterValueAsQuantity]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetComParameterValueAsQuantity|GetComParameterValueAsQuantity]]|}} |
− | {{TableRowKeyValueList|[[GetDefaultComParameterValueAsBoolean]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetDefaultComParameterValueAsBoolean|GetDefaultComParameterValueAsBoolean]]|}} |
− | {{TableRowKeyValueList|[[GetDefaultComParameterValueAsString]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetDefaultComParameterValueAsString|GetDefaultComParameterValueAsString]]|}} |
− | {{TableRowKeyValueList|[[GetDefaultComParameterValueAsInteger]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetDefaultComParameterValueAsInteger|GetDefaultComParameterValueAsInteger]]|}} |
− | {{TableRowKeyValueList|[[GetDefaultComParameterValueAsFloat]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetDefaultComParameterValueAsFloat|GetDefaultComParameterValueAsFloat]]|}} |
− | {{TableRowKeyValueList|[[GetDefaultComParameterValueAsByteField]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetDefaultComParameterValueAsByteField|GetDefaultComParameterValueAsByteField]]|}} |
− | {{TableRowKeyValueList|[[GetDefaultComParameterValueAsQuantity]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetDefaultComParameterValueAsQuantity|GetDefaultComParameterValueAsQuantity]]|}} |
{{TableRowCatagory|Event related terms}} | {{TableRowCatagory|Event related terms}} | ||
− | {{TableRowKeyValueList|[[GetDiagServiceFromEvent]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.GetDiagServiceFromEvent|GetDiagServiceFromEvent]]|}} |
− | {{TableRowKeyValueList|[[IsDiagServiceEvent]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.IsDiagServiceEvent|IsDiagServiceEvent]]|}} |
− | + | {{TableRowKeyValueList|[[Extensions.DiagCom.DiagServiceEventSource|DiagServiceEventSource]]|}} | |
|} | |} | ||
Line 114: | Line 111: | ||
{| {{TableHeader}} | {| {{TableHeader}} | ||
− | {{TableRowKeyValueList|[[ComChannel]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.ComChannel|ComChannel]]|}} |
− | {{TableRowKeyValueList|[[DiagService]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.DiagService|DiagService]]|}} |
− | {{TableRowKeyValueList|[[Result]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.Result|Result]]|}} |
− | {{TableRowKeyValueList|[[ParameterContainer]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.ParameterContainer|ParameterContainer]]|}} |
− | {{TableRowKeyValueList|[[Parameter]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.Parameter|Parameter]]|}} |
− | {{TableRowKeyValueList|[[Message]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.Message|Message]]|}} |
− | {{TableRowKeyValueList|[[Response]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.Response|Response]]|}} |
− | {{TableRowKeyValueList|[[Request]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.Request|Request]]|}} |
− | {{TableRowKeyValueList|[[ResultState]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.ResultState|ResultState]]|}} |
− | {{TableRowKeyValueList|[[ResponseState]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.ResponseState|ResponseState]]|}} |
− | |||
|} | |} | ||
Line 130: | Line 126: | ||
{| {{TableHeader}} | {| {{TableHeader}} | ||
− | {{TableRowKeyValueList|[[DiagComException]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.DiagComException|DiagComException]]|}} |
− | {{TableRowKeyValueList|[[AmbiguousSemanticException]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.AmbiguousSemanticException|AmbiguousSemanticException]]|}} |
− | {{TableRowKeyValueList|[[UnknownTargetException]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.UnknownTargetException|UnknownTargetException]]|}} |
− | {{TableRowKeyValueList|[[LossOfComException]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.LossOfComException|LossOfComException]]|}} |
− | {{TableRowKeyValueList|[[UnknownResponseException]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.UnknownResponseException|UnknownResponseException]]|}} |
− | {{TableRowKeyValueList|[[UnknownComChannelException]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.UnknownComChannelException|UnknownComChannelException]]|}} |
− | {{TableRowKeyValueList|[[InvalidStateException]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.InvalidStateException|InvalidStateException]]|}} |
− | {{TableRowKeyValueList|[[IncompleteParameterizationException]]|}} | + | {{TableRowKeyValueList|[[Extensions.DiagCom.IncompleteParameterizationException|IncompleteParameterizationException]]|}} |
|} | |} | ||
Line 144: | Line 140: | ||
{| {{TableHeader}} | {| {{TableHeader}} | ||
− | {{TableRowKeyValueList|[[DiagCom_Chk001]]|No Path in ExecuteDiagService response parameter | + | {{TableRowKeyValueList|[[Extensions.DiagCom.DiagComChk001|DiagCom_Chk001]]|No Path in ExecuteDiagService response parameter arguments}} |
− | {{TableRowKeyValueList|[[DiagCom_Chk100]]|Access path can not be | + | {{TableRowKeyValueList|[[Extensions.DiagCom.DiagComChk002|DiagCom_Chk002]]|Type-safe GetAllResultsAndClear}} |
− | {{TableRowKeyValueList|[[DiagCom_Chk101]]|Access path can not be | + | {{TableRowKeyValueList|[[Extensions.DiagCom.DiagComChk100|DiagCom_Chk100]]|Access path can not be determinded}} |
− | {{TableRowKeyValueList|[[DiagCom_Chk102]]|Targets of the access paths are not the same | + | {{TableRowKeyValueList|[[Extensions.DiagCom.DiagComChk101|DiagCom_Chk101]]|Access path can not be resolved}} |
− | + | {{TableRowKeyValueList|[[Extensions.DiagCom.DiagComChk102|DiagCom_Chk102]]|Targets of the access paths are not the same struct}} | |
+ | {{TableRowKeyValueList|[[Extensions.DiagCom.DiagComChk103|DiagCom_Chk103]]|Incorrect data type in request/response parameter arguments of inline mapping}} | ||
+ | {{TableRowKeyValueList|[[Extensions.DiagCom.DiagComChk200|DiagCom_Chk200]]| The required request parameter in ExecuteDiagService can not be determinded}} | ||
|} | |} |
Latest revision as of 06:22, 12 February 2019
Contents
Classification
Name | DiagCom |
Short Description | Diagnostic Vehicle Communication |
Class | OTX Extension |
Base Extension | - |
Pre-Conditions | Diagnostic Communication Kernel (MVCI ISO 22900) |
Specified by | ISO 13209-3 |
Introduction
The purpose of the OTX DiagCom extension is to provide the necessary OTX elements for performing diagnostic vehicle communication. Specifically, the following diagnostic use cases have been considered:
- Handling of ECU communication channels
- Execution of a diagnostic service
- Setting of service request parameters and evaluation of service response parameters
- Dealing with positive or various negative responses of a diagnostic service
- Handling of communication channel protocol parameters
- Performing variant identification of an ECU
- Functionally addressed diagnostic services: more than one ECU will respond to a request
- Repeated/cyclic execution of diagnostic services: a single request will result in multiple responses from the same ECU
- A potential combination of functional addressing and cyclic service execution: multiple ECUs responding multiple times to one request
- Complex data structures within the requests and responses of diagnostic services: structures of parameters, lists of parameters, lists containing structures of parameters
Actions
ComChannel related actions | |
IdentifyAndSelectVariant | |
CloseComChannel | |
ComParameter related actions | |
SetComParameter | |
SetComplexComParameter | |
DiagService related actions | |
ExecuteDiagService | |
ExecuteHexDiagService | |
StartRepeatedExecution | |
StopRepeatedExecution | |
SetRepetitionTime | |
GetAllResultsAndClear | |
SetParameterValue | |
SetParameterValueBySemantic | |
SetPdu |
Terms
Data Types
ComChannel | |
DiagService | |
Result | |
ParameterContainer | |
Parameter | |
Message | |
Response | |
Request | |
ResultState | |
ResponseState |
Exceptions
DiagComException | |
AmbiguousSemanticException | |
UnknownTargetException | |
LossOfComException | |
UnknownResponseException | |
UnknownComChannelException | |
InvalidStateException | |
IncompleteParameterizationException |
Checker Rules
DiagCom_Chk001 | No Path in ExecuteDiagService response parameter arguments |
DiagCom_Chk002 | Type-safe GetAllResultsAndClear |
DiagCom_Chk100 | Access path can not be determinded |
DiagCom_Chk101 | Access path can not be resolved |
DiagCom_Chk102 | Targets of the access paths are not the same struct |
DiagCom_Chk103 | Incorrect data type in request/response parameter arguments of inline mapping |
DiagCom_Chk200 | The required request parameter in ExecuteDiagService can not be determinded |