Skip to main content

​
coTfsActivateGuardingReqMonitor

Valid for: CANoe DE • CANoe:lite DE • CANoe4SW DE

​
Function Syntax

long coTfsActivateGuardingReqMonitor( dword nodeID, dword guardTime, dword tolerance );

​
Description

When this function is called, it is checked whether the DUT (Device Under Test) makes available the remote frame for the guarding within the defined times. For each correct occurrence, the callback void coTfsOnGuardingRTRMsg(dword nodeId) is called. If the time is not adhered to, then the callback void coTfsOnGuardingRTRFail(dword nodeId, dword cause) is called once. After an error has occurred, the callback system is automatically disabled. The reason for the error is specified in the parameter cause:
  • 1 = Message distance too small
  • 2 = Message distance too large or message is missing
This check can be switched off again with coTfsDeactivateGuardingReqMonitor. Only one DUT can be monitored at a time. The description of coTfsActivateHeartbeatMonitor contains a temporal representation that can be applied sensibly to this function.

​
Parameters

  • nodeID: Node-ID of the DUT.
  • guardTime: Guarding time in us.
  • tolerance: Permitted time deviation of the target device in us. It is recommended that you use an even value. The tolerated time frame within which a message is still accepted is: x - (delta/2) <= x <= x + (delta/2)

​
Return Values

Error code

​
Example

coTfsActivateGuardingReqMonitor( 0x1, 100, 20 );