Skip to main content
Open topic with navigation CAPL Functions » ISO11783 » Virtual Terminal Interaction Layer (VT IL) » VTIL_DelayTxTpDt

​
VTIL_DelayTxTpDt

Valid for: CANoe DE • CANoe4SW DE

​
Function Syntax

  • long VTIL_DelayTxTpDt(long firstMsg, long numOfMsg, long timeout); //Form 1
  • long VTIL_DelayTxTpDt(dbNode node, long firstMsg, long numOfMsg, long timeout); //Form 2

​
Description

Delays transmitting of (E)TP.DT messages generated and sent by the interaction layer. The messages to be delayed are identified by their occurrences on the bus, starting at 1 until the given message count is reached. The given range of DT messages are delayed every time until the CAPL function VTIL_ResetDelayedTxTpDt is called. The delay time is added to the value set by VTIL_SetNodeProperty(“TPDTLatency”, …).

​
Parameters

  • firstMsg: Sequence number of the first DT message that shall be blocked [1…n].
  • numOfMsg: Number of DT messages that shall be blocked [1…n].
  • timeout: The delay in milliseconds to continue the transmission with regularly sent DT messages [1…3600000].
  • node: Simulation node to apply the function.

​
Return Values

  • 0: OK
  • -3001: General Error
  • -3002: Parameter firstMsg must be greater than 0
  • -3003: Parameter numOfMsg must be greater than 0

​
Example

on start {
  long res;
  // Delay TP.DT packets 6, 7, 8, 9 by 200 ms each. Continue with packet no. 10 without delay.
  res = VTIL_DelayTxTpDt(6, 4, 200);
  if(res != 0) {
    write("An error occurred: %d", res);
  }
}