Skip to main content
Open topic with navigation CAPL Functions » ISO11783 » Task Controller Interaction Layer (TC IL) » TCIL_OnRequest

TCIL_OnRequest (Callback)

Valid for: CANoe DE • CANoe4SW DE

Function Syntax

long TCIL_OnRequest( long rqPGN, long sourceAddr );
long TCIL_OnRequest( long rqPGN, long sourceAddr, long destinationAddress );

Description

This callback function is called from the TC IL if a request (0xEA00) is received. The return value defines the node reaction to the request.

Parameters

  • rqPGN: Requested PGN
  • sourceAddr: Source address from which the request was sent
  • destinationAddress: Destination address on which the request was sent

Return Values

  • 0: Do not respond to the request
  • 1: Request with the message from the Tx list of the node
  • 2: Send a negative acknowledgment (NACK)
  • 3: Send a positive acknowledgment (ACK)

Example

long TCIL_OnRequest( long rqPGN, long sourceAddr )
{
  switch( rqPGN ) {
    case 0xFF02:
      return 2; // send NACK
  }
  return 1;
}