Skip to main content

Documentation Index

Fetch the complete documentation index at: https://notevil.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Open topic with navigation CAPL Functions » ISO11783 » File Server Interaction Layer (FS IL) » FSIL_OnRxMessage

​
FSIL_OnRxMessage (Callback)

Valid for: CANoe DE • CANoe4SW DE

​
Function Syntax

long FSIL_OnRxMessage( pg * rxPG );

​
Description

Is called from the FS IL if the FS IL receives the parameter group, namely before the parameter group is processed by the FS IL. The message data can be manipulated in the callback method or handling of the message by the IL can be suppressed. Usage
  • To ignore some incoming messages;
  • To simulate faulty behavior of the node that communicates with simulated node (by manipulating of incoming messages);

​
Parameters

  • rxPG: Message which is received

​
Return Values

  • 0: Received parameter group will be ignored by the FS IL
  • 1: Received parameter group will be processed by the FS IL

​
Example

The following example blocks the RQST of the pgn = 0x5** (case 5) and replace the RQST of the pgn = 0x3** by the RQST of the pgn = 0x4** (case 3). 
long FSIL_OnRxMessage( pg * rxPG )
{
    if(rxPG.PGN == 0xEA00)
    {
        switch(rxPG.BYTE(1))
        {
            case 3:
                rxPG.BYTE(1) = 4;
                return 1;
            case 5:
                return 0;
            default:
                return 1;
        }
    }
    return 1;
}