Function Catalog

Release:3.1.0
Date:2016-10-19+02:00
Author:WG DA
Company:MOST Cooperation
Modifications
ChangeReason

FBlock Overview
FBlockIDName
0x03ErrorSpecificationExample

ErrorSpecificationExample (FBlockID = 0x03)

Release:3.1.0
Date:2016-10-19+02:00
Author:unknown
Company:unknown
Modifications
ChangeReason

Function Overview
FktIDNameOccurrence
0x500MethodWithErrorSpecificationMandatory

MethodWithErrorSpecification (0x500)

Occurrence: Mandatory

This method details how errors can be specified in the MOST function catalog.

Format of Function

Function class: Sequence Method

FBlockFunctionOPTypeParameter
ErrorSpecificationExample (0x03)MethodWithErrorSpecification (0x500)StartResultAckSenderHandle, ByteParameter
ErrorAckSenderHandle, ErrorCode, ErrorInfo
ResultAckByteParameter
ErrorErrorCode, ErrorInfo

Parameter

SenderHandle


Unique identifier of the requesting task within the device.

Basis data typeUnitExp.Step
Unsigned Wordnone01

ByteParameter


A parameter of data type Unsigned Byte.

Basis data typeUnitExp.Step
Unsigned Bytenone01

ErrorCode


(Refer to the MOST Specification, section "Structure of MOST Messages: OPType")

Basis data typeCodeNameDescription
Enum
(1 byte)
0x1FBlockIDNotAvailableFBlockID not available
0x2InstIDNotAvailableInstID not available
0x3FktIDNotAvailableFktID not available
0x4OPTypeNotAvailableOPType not available
0x5InvalidLengthInvalid length
0x6ParameterWrongOne or more of the parameters were wrong, i.e., not within the boundaries specified for the function. Example: Function Temp shall be set to 200, although maximum value is 80.
0x7ParameterNotAvailableOne or more of the parameters were within the boundaries specified for the function, but are not available at that time.
0x8...0xAReserved0x08_0x0AReserved range.
0xBDeviceMalfunctionDevice Malfunction
0xCSegmentationErrorErrorInfo contains a value in the range of 0x01…0x07.
0x41NotAvailableFunction is implemented in principle, but is not available at the moment.
0xFF...0xFFReserved0xFFReserved range.

ErrorInfo


Besides the error information provided in the MOST Specification, as an example, additional function specific error info values are specified here.

Basis data typeLengthConditionDescription
StreamErrorCode = 0x1FBlockID not available
ErrorCode = 0x2InstID not available
ErrorCode = 0x3FktID not available
ErrorCode = 0x4Content: UnavailableOPType
OPType not available
ErrorCode = 0x5Invalid length
ErrorCode = 0x6Content: ParameterPosition, ParameterValue
Parameter wrong / out of range
ErrorCode = 0x7Content: ParameterPosition, ParameterValue
Parameter not available
ErrorCode = 0xBDevice Malfunction
ErrorCode = 0xCContent: SegmentationErrorCause
Segmentation Error
ErrorCode = 0x41Not available

ErrorInfo.UnavailableOPType


The value of the OPType for ErrorCode 0x04 (OPType not available). Because this error is only reported from FBlock to controller, the specified range does not include reports (OPType > 8).

Basis data typeCodeNameDescription
Enum
(1 byte)
0x0SetStartSet for properties, Start for methods.
0x1GetAbortGet for properties, Abort for methods.
0x2SetGetStartResultSetGet for properties, StartResult for methods.
0x3IncrementIncrement for properties; no OPType is specified for this code for methods.
0x4DecrementDecrement for properties; no OPType is specified for this code for methods.
0x5NotAllowedNo OPType is specified for this code.
0x6StartResultAckNo OPType is specified for this code for properties; StartResultAck for methods.
0x7AbortAckNo OPType is specified for this code for properties; AbortAck for methods.
0x8StartAckNo OPType is specified for this code for properties; StartAckfor methods.

ErrorInfo.ParameterPosition


Contains the position of the offending parameter, where the value 1 corresponds to the first parameter. If a SenderHandle is present, 1 corresponds to the first parameter following the SenderHandle.

Basis data typeUnitExp.StepRange of valuesRange description
Unsigned Bytenone011...255

ErrorInfo.ParameterValue


Value of the first offending parameter. Since, the data type of the actual parameter is determined at run time, Array Type is used as an envelope so that arbitrary structures can be provided.

Basis data typeElementCount sizeElement typeElement name
Array Type2Unsigned Byte ParameterValueByte

ParameterValueByte


Basis data typeUnitExp.Step
Unsigned Bytenone01

ErrorInfo.SegmentationErrorCause


The cause of the segmentation error.

Basis data typeCodeNameDescription
Enum
(1 byte)
0x1FirstSegmentMissingFirst segment missing, that is, the first telegram of a segmented message was not received.
0x2TooFewBuffersTarget node does not provide enough buffers to handle a message of this size.
0x3UnexpectedSegmentUnexpected segment number.
0x4TooManyMessagesToo many unfinished segmentation messages pending.
0x5TimeoutTimeout while waiting for next segment.
0x6NodeNotCapableNode not capable of handling segmented messages.
0x7MessageCollisionSegmented message has not been finished before the arrival of another message with identical FBlockID, InstID, FktID, and OPType sent by the same node.