CAPLfunctionLINSendHeaderError

Open topic with navigation

CAPL Functions » LIN » linSendHeaderError

linSendHeaderError

Valid for: CANoe DE

Function Syntax

dword linSendHeaderError(byte syncByte, byte idWithParity, byte StopAfterError);

Description

This function sends a header with the current sync break, sync delimiter and interbyte space settings and the specified sync byte and id byte.

Note: If the LIN hardware is not in Master mode calling this function will have no effect.

Parameters

• syncByte: Data value to be sent in the Synch Byte field.

  • Correct value is 0x55
  • Value range: 0..0xFF

• idWithParity: Data value to be sent in the Protected Identifier field. The lower 6 bits specify the identifier to be used. The upper 2 bits specify the identifier parity to be used. The correct value can be calculated using the linGetProtectedID function.

  • Value range: 0..0xFF

• StopAfterError: Specifies whether the transmission should be stopped after an error. If an incorrect synch byte is set by this function and StopAfterError is 1, the identifier will not be sent.

  • A simulated message response (has to be activated independently) will generally not be sent if there is an error in the header.
  • Value range: 0..1

Return Values

On success, a value unequal to zero, otherwise zero.

Example

// Force an error in header of LIN frame with ID=0x33 by setting wrong protected ID
on key 'h'
{
    byte linID, protectedID, corParity, errParity, errPID;
    // calculate protected ID with wrong parity bits
    linID = 0x33; // use frame ID=0x33
    protectedID = linGetProtectedID(linID); // get protected ID
    corParity = (protectedID & 0xC0) >> 6; // extract parity (0xC=0=11000000)
    errParity = (corParity ^ 0x2) & 0x3; // calculate wrong parity using XOR
    errPID = linID | (errParity << 6); // calculate PID with wrong parity
    linSendHeaderError(0x55, errPID, 0);
}
// or
// Force an error in header of LIN frame with ID=0x33 by setting wrong Synch byte
linSendHeaderError(0x50, linGetProtectedID(0x33), 0);