Difference between revisions of "Extensions.DiagCom.ResultState"

From emotive
Jump to navigation Jump to search
 
(28 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
{{DISPLAYTITLE:Data Type '''ResultState'''}}
+
{{DISPLAYTITLE:Data Type '''ResultState'''}}[[Category:DataType]][[Category:DiagCom]]
 
== Classification ==
 
== Classification ==
−
{{ClassificationDataType | ResultState | State of [[Result]] | [[Simple Data Type]] | - | ResultStateLiteral }}
+
{{ClassificationDataType | ResultState | State of [[Extensions.DiagCom.Result|Result]] | [[Core.DataTypes.SimpleDataType|Simple Data Type]] | [[Core.DataTypes.SimpleDataType.SimpleType|SimpleType]] | DefaultValue=ALL_FAILED | Literal=Yes }}
  
 
== Description ==
 
== Description ==
−
'''ResultState''' is an enumeration type describing the state of a [[Result]].  
+
'''ResultState''' is an enumeration type describing the state of a [[Extensions.DiagCom.Result|Result]].  
  
 
The list of allowed enumeration values is defined as follows:
 
The list of allowed enumeration values is defined as follows:
−
* '''ALL_FAILED'''
 
−
* '''ALL_INVALID'''
 
−
* '''ALL_NEGATIVE'''
 
−
* '''ALL_POSITIVE'''
 
−
* '''FAILED'''
 
−
* '''INVALID'''
 
−
* '''NEGATIVE'''
 
−
* '''POSITIVE'''
 
  
−
'''ResultState''' have the following semantic:
+
{| {{TableHeader}}
−
* '''<init> : ResultStateLiteral [0..1]''' <br/> This optional element stands for the hard-coded initialisation value of the identifier at declaration time.
+
|- {{TableHeaderRow}}
−
** '''value : ResultStates={ALL_FAILED|ALL_INVALID|ALL_NEGATIVE|ALL_POSITIVE|FAILED|INVALID|NEGATIVE|POSITIVE} [1]''' <br/> This attribute contain one of the values defined in the '''ResultStates''' enumeration.
+
| '''Value''' || '''[[Literals|<span style="color:white;">Literal</span>]]''' || '''Description'''
 +
|- {{TableRow1}}
 +
| '''ALL_FAILED''' || @ResultState:ALL_FAILED || All ECUs in a functional group (listening to the same functional address) failed to answer, in case of physical addressing: the one requested ECU failed to answer.
 +
|- {{TableRow2}}
 +
| '''ALL_INVALID''' || @ResultState:ALL_INVALID || All ECUs in a functional group (listening to the same functional address) returned an invalid answer, in case of physical addressing: the one requested ECU returned an invalid response.
 +
|- {{TableRow1}}
 +
| '''ALL_NEGATIVE''' || @ResultState:ALL_NEGATIVE || All ECUs in a functional group (listening to the same functional address) returned a negative response, in case of physical addressing: the one requested ECU returned a negative response.
 +
|- {{TableRow2}}
 +
| '''ALL_POSITIVE''' || @ResultState:ALL_POSITIVE || All ECUs in a functional group (listening to the same functional address) returned a positive response, in case of physical addressing: the one requested ECU returned a positive response.
 +
|- {{TableRow1}}
 +
| '''FAILED''' || @ResultState:FAILED || Some of the ECUs in a functional group (listening to the same functional address) failed to answer.
 +
|- {{TableRow2}}
 +
| '''INVALID''' || @ResultState:INVALID || Some of the ECUs in a functional group (listening to the same functional address) returned an invalid response.
 +
|- {{TableRow1}}
 +
| '''NEGATIVE''' || @ResultState:NEGATIVE || Some of the ECUs in a functional group (listening to the same functional address) returned a negative response.
 +
|- {{TableRow2}}
 +
| '''POSITIVE''' || @ResultState:POSITIVE || Some of the ECUs in a functional group (listening to the same functional address) returned a positive response.
 +
|}
 +
 
 +
==Order Relation==
 +
ResultState values may occur as operands of comparisons. For this case, the following order relation is defined. Started with the lowest value ALL_FAILED = 0:
 +
 
 +
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
 +
ALL_FAILED < ALL_INVALID < ALL_NEGATIVE < ALL_POSITIVE < FAILED < INVALID < NEGATIVE < POSITIVE
 +
</syntaxhighlight>
 +
 
 +
==Literal==
 +
The syntax for [[Literals| Literals for complex data types]] will be used, where the '''member value''' is one of the values in the list.
 +
 
 +
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
 +
@ResultState:ALL_FAILED|ALL_INVALID|ALL_NEGATIVE|ALL_POSITIVE| FAILED|INVALID|NEGATIVE|POSITIVE
 +
</syntaxhighlight>
 +
 
 +
{{ConversionTable |
 +
Integer=Returns the index of the value in the ResultStates enumeration (smallest index is 0) | IntegerSample=<tt>Integer val = ToInteger(@ResultState:ALL_FAILED); // Returns 0</tt> |
 +
String=Returns the name of the enumeration value | StringSample=<tt>String s = ToString(@ResultState:ALL_FAILED); // Returns "ALL_FAILED"</tt>
 +
}}
 +
 
 +
==Sample==
 +
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
 +
DiagCom.ResultState ResultStateVariable = @ResultState:ALL_FAILED;
 +
</syntaxhighlight>

Latest revision as of 09:57, 12 September 2019

Classification

Name ResultState
Short Description State of Result
Class Simple Data Type
Base Data Type SimpleType
Default Value ALL_FAILED
Provide a Literal Yes
SpecifiedBy ISO 13209-3
Standard Compliant Yes

Description

ResultState is an enumeration type describing the state of a Result.

The list of allowed enumeration values is defined as follows:

Value Literal Description
ALL_FAILED @ResultState:ALL_FAILED All ECUs in a functional group (listening to the same functional address) failed to answer, in case of physical addressing: the one requested ECU failed to answer.
ALL_INVALID @ResultState:ALL_INVALID All ECUs in a functional group (listening to the same functional address) returned an invalid answer, in case of physical addressing: the one requested ECU returned an invalid response.
ALL_NEGATIVE @ResultState:ALL_NEGATIVE All ECUs in a functional group (listening to the same functional address) returned a negative response, in case of physical addressing: the one requested ECU returned a negative response.
ALL_POSITIVE @ResultState:ALL_POSITIVE All ECUs in a functional group (listening to the same functional address) returned a positive response, in case of physical addressing: the one requested ECU returned a positive response.
FAILED @ResultState:FAILED Some of the ECUs in a functional group (listening to the same functional address) failed to answer.
INVALID @ResultState:INVALID Some of the ECUs in a functional group (listening to the same functional address) returned an invalid response.
NEGATIVE @ResultState:NEGATIVE Some of the ECUs in a functional group (listening to the same functional address) returned a negative response.
POSITIVE @ResultState:POSITIVE Some of the ECUs in a functional group (listening to the same functional address) returned a positive response.

Order Relation

ResultState values may occur as operands of comparisons. For this case, the following order relation is defined. Started with the lowest value ALL_FAILED = 0: 

ALL_FAILED < ALL_INVALID < ALL_NEGATIVE < ALL_POSITIVE < FAILED < INVALID < NEGATIVE < POSITIVE

Literal

The syntax for Literals for complex data types will be used, where the member value is one of the values in the list. 

@ResultState:ALL_FAILED|ALL_INVALID|ALL_NEGATIVE|ALL_POSITIVE| FAILED|INVALID|NEGATIVE|POSITIVE

Core Conversion

The following table shows the rules for conversion to another data type:

Conversion Result Sample
ToBoolean Undefined (should not be used)
ToInteger Returns the index of the value in the ResultStates enumeration (smallest index is 0) Integer val = ToInteger(@ResultState:ALL_FAILED); // Returns 0
ToFloat Undefined (should not be used)
ToString Returns the name of the enumeration value String s = ToString(@ResultState:ALL_FAILED); // Returns "ALL_FAILED"
ToByteField Undefined (should not be used)

Sample

DiagCom.ResultState ResultStateVariable = @ResultState:ALL_FAILED;
Retrieved from "http://emotive.de/wiki/index.php?title=Extensions.DiagCom.ResultState&oldid=9655"