CAPLfunctionOnMOSTMsgFragment

Open topic with navigation

OnMostMsgFragment

CAPL Functions » MOST » OnMostMsgFragment

Valid for: CANoe DE

Function Syntax

OnMostMsgFragment();

Description

The event procedure OnMostMsgFragment is called when the spy detects an incomplete transmission on the Control channel.

The following functions are available for evaluating the event:

• long mostEventChannel()

  • Returns the channel of the packet event.

• long mostEventTime()

  • Returns the time stamp of the event (Units: 10 µs).

• float mostEventTimeNs()

  • Returns the time stamp of the event (Units: 1 ns).

• long mostEventOrigTime()

  • Returns the hardware generated time stamp of the event (Units: 10 µs).

• long mostMsgFragmentDlc()

  • Number of transported data bytes.

• long mostMsgFragmentGetData(byte[] buffer, long cnt)

  • Tries to copy cnt data bytes to a provided buffer. Returns the actual number of copied bytes.

Note: Due to performance reasons only the first transmitted data bytes are stored in the fragment event.

All following functions return -1 if the corresponding data field is invalid (i.e. event was too short to contain the information).

• long mostMsgFragmentSrcAdr(), long mostMsgFragmentDestAdr()

  • Returns the source or destination address.

• long mostMsgFragmentAck()

  • Returns the acknowledge code.

• long mostMsgFragmentPAck()

  • Returns the preemptive acknowledge from the potential packet receiver(s) to the packet transmitter.

• long mostMsgFragmentPriority()

  • Returns the message priority.

• long mostMsgFragmentPIndex()

  • Returns the packet index. The packet index increments by one per message from a node.

• dword mostMsgFragmentCRC()

  • Returns the CRC value.

• long mostMsgFragmentCAck()

  • Returns the CRC acknowledge code.

• long mostMsgFragmentAnnouncedDlc()

  • Returns the announced data length at start of transmission. In general, the announced length is not equal to the actual number of transmitted data bytes for fragments.

In nodal sequences (Measurement Setup) a fragment can be passed to the next node by the outputMostMsgFragmentThis command.

Parameters

—

Return Values

—

Example

—