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

​
TCIL_ControlStop

Valid for: CANoe DE • CANoe4SW DE

​
Function Syntax

  • long TCIL_ControlStop(); // form 1
  • long TCIL_ControlStop(dword option); // form 2
  • long TCIL_ControlStop(dbNode tc); // form 3
  • long TCIL_ControlStop(dbNode tc, dword option); // form 4

​
Description

Deactivates the Task Controller and stops sending cyclic messages. A Cannot Claim Address message is sent, if the NMT is activated and the message is not suppressed with the parameter option set to 1. Removes all device descriptor object pools (DDOPs) too.

​
Parameters

  • tc: TC simulation node to apply the function
  • option: Options
    1: Suppress sending Cannot Claim Address message

​
Return Values

  • 0: Function has been executed successfully
  • < 0: An error has occurred, see IL Error Code

​
Example

Example form 4 
void SetDataMaskSize(dword newSize) {
  // data mask size can only be changed if TC is stopped
  TCIL_ControlStop(TC, 1);
  // wait until Working Sets have detected that TC is offline
  TestWaitForTimeout(3500);
  // change size and restart TC
  TCIL_SetNodeProperty(TC,"dataMaskSize", newSize);
  TCIL_ControlStart(TC);
}