CAPLfunctionCoTfsMonitorIncludeNodeId

coTfsMonitorIncludeNodeId (Level 2)

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

Function Syntax

long coTfsMonitorIncludeNodeId( dword nodeId );

Description

This function includes a single node-ID for monitoring. To include a range of node-IDs use the function coTfsMonitorIncludeNodeIdRange.

You can start the monitoring with coTfsMonitorActivate and stop it with coTfsMonitorDeactivate.

To exclude node-IDs or ranges of node-IDs from monitoring you can use the functions coTfsMonitorExcludeNodeId and coTfsMonitorExcludeNodeIdRange. With coTfsMonitorSetNmtTimeout and coTfsMonitorSetSdoTimeout you can set NMT and SDO timeouts.

Parameters

• nodeID: Node-ID to be monitored.

Return Values

Error code

Example

// configure node-IDs for monitoring: monitor nodes 1..14, 21..24, 26..64 and 127
coTfsMonitorIncludeNodeIdRange( 1, 64);
coTfsMonitorExcludeNodeIdRange( 15, 20);
coTfsMonitorExcludeNodeId   ( 25);
coTfsMonitorIncludeNodeId  (127);

coTfsMonitorSetSdoTimeout( 100 ); // set SDO timeout to 100 ms
coTfsMonitorSetNmtTimeout( 2000 ); // set NMT timeout for boot-up message to 2 s

coTfsMonitorActivate();      // activate monitoring
TestWaitForTimeout(30000);     // monitor CANopen traffic for 60 seconds ...
if (coTfsMonitorDeactivate() != 1) { // deactivate monitoring and add results to report, check for errors
  TestStepFail("Monitoring", "At least one monitored response was not received in time");
}
else {
  TestStepPass("Monitoring", "All monitored responses were received in time");
}