CAPLfunctionTestJoinLinCsErrorEvent

TestJoinLinCSErrorEvent

Valid for: CANoe DE • CANoe4SW DE

Function Syntax

• long TestJoinLinCSErrorEvent()
• long TestJoinLinCSErrorEvent(dbMsg apDBMsg)
• long TestJoinLinCSErrorEvent(dword aFrameId)

Description

Adds an event of type checksum error to the set of joined events. This is a non-blocking function.

Note: Dependent on the used parameter type the appropriate bus context in a multibus environment has only to be set before the function is called if the corresponding database object will be ambiguous. Further information on site MultiBus Environment.

Parameters

• apDBMsg: Symbolic message
• aFrameId: Frame identifier

Return Values

• -3: Error while adding the specified event to the set of joined events
• -1: General error, e.g. functionality is not available
• > 0: Number of the newly joined event

Example

testcase tcTFS_waitForLINResponse(int frameId)
{
    long eventIndex;

    testJoinMessageEvent(frameId);
    testJoinLinReceiveErrorEvent(frameId);
    testJoinLinCSErrorEvent(frameId);
    testJoinLinTransmErrorEvent(frameId);

    eventIndex = testWaitForAnyJoinedEvent(5000);
    switch (eventIndex)
    {
        case 1: // valid frame
            testStepPass("Validation", "IUT has responded correctly");
            break;

        case 2:  // receive error
            testStepFail("Validation", "IUT has responded with wrong number of data bytes");
            break;

        case 3: // checksum error
            testStepFail("Validation", "IUT has responded with wrong checksum");
            break;

        case 4: // transmission error
            testStepFail("Validation", "IUT has not responded");
            break;

        default:
            testStepFail("Validation", "Internal error! Unexpected event (return code %d) on waiting for response", eventIndex);
    }
}

TestGetWaitLinCSErrorData • TestWaitForLinCSError • TestWaitForAllJoinedEvents • TestWaitForAnyJoinedEvent