# null

[Open topic with navigation](../../../../../CANoeDEFamily.htm#Topics/CAPLFunctions/ISO11783/ISOInteractionLayerTC/CAPLfunctionsISOILTCOverview.md)

### ISO11783 Task Controller Interaction Layer

*(Only available with ISO11783!)*

**Valid for**: CANoe DE • CANoe4SW DE

To use the CAPL functions the **ISO11783\_TC\_IL.dll** i.e. [Task Controller Interaction Layer (TC IL)](../../../Shared/ISO11783/ISO11783ILTC.md) must be included.

***

**ON THIS PAGE:**

* [Callback Functions](#Callback)
* [DTC Support](#DiagnosticFunctions)
* [Node Control](#Node)
* [Other Functions](#Other)
* [Signal/Message Access](#Signal/M)
* [TC - Client Control](#TCClientControl)
* [TC - Fault Injection for Messages](#TCFaultInjection)
* [TC - Fault Injection for Transport Protocols](#TCFaultInjectionTP)
* [TC - Other Functions](#TCOtherFunctions)
* [TC - Peer Control](#TCPeerControl)
* [TC - Value Access](#TCValueAccess)

***

#### Callback Functions

| Functions                                                                                   | Short Description                                                                                                           |
| ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| [TCIL\_OnAddressClaimConflict](Functions/CAPLfunctionIso11783TCILOnAddressClaimConflict.md) | Is called if an address conflict is detected.                                                                               |
| [TCIL\_OnAddressViolation](Functions/CAPLfunctionIso11783TCILOnAddressViolation.md)         | Is called if an address violation is detected.                                                                              |
| [TCIL\_OnCA](Functions/CAPLfunctionIso11783TCILOnCA.md)                                     | Is called from the IL when a Command Address message is received.                                                           |
| [TCIL\_OnChangedState](Functions/CAPLfunctionIso11783TCILOnChangedState.md)                 | Is called if the IL has changed its state.                                                                                  |
| [TCIL\_OnError](Functions/CAPLfunctionIso11783TCILOnError.md)                               | Is called if an error has occurred.                                                                                         |
| [TCIL\_OnRequest](Functions/CAPLfunctionIso11783TCILOnRequest.md)                           | Is called if a request (0xEA00) is received.                                                                                |
| [TCIL\_OnRxMessage](Functions/CAPLfunctionIso11783TCILOnRxMessage.md)                       | Is called from the IL if the IL receives the parameter group, namely **before** the parameter group is processed by the IL. |
| [TCIL\_OnTxMessage](Functions/CAPLfunctionIso11783TCILOnTxMessage.md)                       | Is called if a message was sent successfully.                                                                               |
| [TCIL\_OnTxPrepare](Functions/CAPLfunctionIso11783TCILOnTxPrepare.md)                       | Is called before a parameter group is sent.                                                                                 |

#### DTC Support

| Functions                                                                                           | Short Description                                                                         |
| --------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| [TCIL\_ActivateDiagnosticsSupport](Functions/CAPLfunctionIso11783TCILActivateDiagnosticsSupport.md) | Activates or deactivates the support of ISO11783 diagnostics by the IL.                   |
| [TCIL\_ActivateDTC](Functions/CAPLfunctionIso11783TCILActivateDTC.md)                               | Activates a diagnostics trouble code (DTC) and add it to the list of active DTCs.         |
| [TCIL\_ClearAllDTCs](Functions/CAPLfunctionIso11783TCILClearAllDTCs.md)                             | Clears the list of active DTCs as well as the list of previously active DTCs.             |
| [TCIL\_DeactivateDTC](Functions/CAPLfunctionIso11783TCILDeactivateDTC.md)                           | Deactivates a diagnostics trouble code (DTC) and removes it from the list of active DTCs. |
| [TCIL\_GetDTCStatus](Functions/CAPLfunctionIso11783TCILGetDTCStatus.md)                             | Returns the current occurrence count of a diagnostics trouble code (DTC).                 |

#### Node Control

| Functions                                                                                                     | Short Description                                                 |
| ------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| [TCIL\_AcceptRxPG](Functions/CAPLfunctionIso11783TCILAcceptRxPG.md)                                           | Checks if the received parameter group is addressed to the TC IL. |
| [TCIL\_ControlInit](Functions/CAPLfunctionIso11783TCILControlInit.md)                                         | Suppress the auto-start function of the IL.                       |
| [TCIL\_ControlStart](Functions/CAPLfunctionIso11783TCILControlStart.md)                                       | Activate node to start Address Claiming.                          |
| [TCIL\_ControlStop](Functions/CAPLfunctionIso11783TCILControlStop.md)                                         | Deactivates the IL and stops sending cyclic messages.             |
| [TCIL\_EnableAddressViolationDetection](Functions/CAPLfunctionIso11783TCILEnableAddressViolationDetection.md) | Activates detection of address violations by other nodes.         |
| [TCIL\_EnableNameManagement](Functions/CAPLfunctionIso11783TCILEnableNameManagement.md)                       | This function activates the name management of a node.            |
| [TCIL\_GetAddress](Functions/CAPLfunctionIso11783TCILGetAddress.md)                                           | Returns the address that is used by the TC IL.                    |
| [TCIL\_GetState](Functions/CAPLfunctionIso11783TCILGetState.md)                                               | Returns the current state of the TC IL.                           |
| [TCIL\_SetNodeProperty](Functions/CAPLfunctionIso11783TCILSetNodeProperty.md)                                 | Changes an internal property of the node.                         |
| [TCIL\_GetDeviceName](Functions/CAPLfunctionIso11783TCILGetDeviceName.md)                                     | Gets the NAME as reported on the bus.                             |

#### Other Functions

| Functions                                                                       | Short Description                                                               |
| ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| [TCIL\_GetLastError](Functions/CAPLfunctionIso11783TCILGetLastError.md)         | Returns the value of the last called TC IL function.                            |
| [TCIL\_GetLastErrorText](Functions/CAPLfunctionIso11783TCILGetLastErrorText.md) | Returns the textual description of the value of the last called TC IL function. |
| [TCIL\_SetVerbosity](Functions/CAPLfunctionIso11783TCILSetVerbosity.md)         | Set verbosity for writing in Write Window.                                      |

#### Signal/Message Access

| Functions                                                                 | Short Description                    |
| ------------------------------------------------------------------------- | ------------------------------------ |
| [TCIL\_SetMsgEvent](Functions/CAPLfunctionIso11783TCILSetMsgEvent.md)     | Sends a message immediately.         |
| [TCIL\_SetMsgRawData](Functions/CAPLfunctionIso11783TCILSetMsgRawData.md) | Sets the data bytes of the message.  |
| [TCIL\_SetSignal](Functions/CAPLfunctionIso11783TCILSetSignal.md)         | Sets the physical value of a signal. |
| [TCIL\_SetSignalRaw](Functions/CAPLfunctionIso11783TCILSetSignalRaw.md)   | Sets the raw value of a signal.      |

#### TC – Client Control

| Functions                                                                                              | Short Description                                                                                                                        |
| ------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
| [TCIL\_MeasurementCommandRaw](Functions/CAPLfunctionIso11783TCILMeasurementCommandRawPhysical.md)      | Sends a trigger definition to the client (using the raw value).                                                                          |
| [TCIL\_MeasurementCommandPhysical](Functions/CAPLfunctionIso11783TCILMeasurementCommandRawPhysical.md) | Sends a trigger definition to the client (using the physical value).                                                                     |
| [TCIL\_RequestValueCommand](Functions/CAPLfunctionIso11783TCILRequestValueCommand.md)                  | Sends the **Request Value** command to the client.                                                                                       |
| [TCIL\_RequestVersion](Functions/CAPLfunctionIso11783TCILRequestVersion.md)                            | Requests the **Version** message from the client.                                                                                        |
| [TCIL\_StartTask](Functions/CAPLfunctionIso11783TCILStartTask.md)                                      | Starts a task.                                                                                                                           |
| [TCIL\_StopTask](Functions/CAPLfunctionIso11783TCILStopTask.md)                                        | Stops a task.                                                                                                                            |
| [TCIL\_ValueAndAckCommand](Functions/CAPLfunctionIso11783TCILValueAndAckCommandRawPhysical.md)         | Sends the current value of a data entity to the client with **Set Value and Acknowledge command**.                                       |
| [TCIL\_ValueAndAckCommandRaw](Functions/CAPLfunctionIso11783TCILValueAndAckCommandRawPhysical.md)      | Sets the value of a data entity (using the raw value) and sends the value to the client with **Set Value and Acknowledge command**.      |
| [TCIL\_ValueAndAckCommandPhysical](Functions/CAPLfunctionIso11783TCILValueAndAckCommandRawPhysical.md) | Sets the value of a data entity (using the physical value) and sends the value to the client with **Set Value and Acknowledge command**. |
| [TCIL\_ValueCommand](Functions/CAPLfunctionIso11783TCILValueCommandRawPhysical.md)                     | Sends the current value of a data entity to the client with **Value command**.                                                           |
| [TCIL\_ValueCommandRaw](Functions/CAPLfunctionIso11783TCILValueCommandRawPhysical.md)                  | Sets the value of a data entity (using the raw value) and sends the value to the client with **Value command**.                          |
| [TCIL\_ValueCommandPhysical](Functions/CAPLfunctionIso11783TCILValueCommandRawPhysical.md)             | Sets the value of a data entity (using the physical value) and sends the value to the client with **Value command**.                     |

#### TC – Fault Injection for Messages

| Functions                                                                                             | Short Description                                                              |
| ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| [TCIL\_BlockRxMessage](Functions/CAPLfunctionIso11783TCILBlockRxMessage.md)                           | Prevents processing of a received message by the Interaction Layer.            |
| [TCIL\_ResetBlockedRxMessage](Functions/CAPLfunctionIso11783TCILResetBlockedRxMessage.md)             |                                                                                |
| [TCIL\_ResetAllBlockedRxMessages](Functions/CAPLfunctionIso11783TCILResetAllBlockedRxMessages.md)     |                                                                                |
| [TCIL\_BlockTxMessage](Functions/CAPLfunctionIso11783TCILBlockRxMessage.md)                           | Prevents transmitting of a message generated by the interaction layer.         |
| [TCIL\_ResetBlockedTxMessage](Functions/CAPLfunctionIso11783TCILResetBlockedTxMessage.md)             |                                                                                |
| [TCIL\_ResetAllBlockedTxMessages](Functions/CAPLfunctionIso11783TCILResetAllBlockedTxMessages.md)     |                                                                                |
| [TCIL\_DelayRxMessage](Functions/CAPLfunctionIso11783TCILDelayRxMessage.md)                           | Delays processing of a received message by the interaction layer.              |
| [TCIL\_ResetDelayedRxMessage](Functions/CAPLfunctionIso11783TCILResetDelayedRxMessage.md)             |                                                                                |
| [TCIL\_ResetAllDelayedRxMessage](Functions/CAPLfunctionIso11783TCILResetAllDelayedRxMessage.md)       |                                                                                |
| [TCIL\_ManipulateMessage](Functions/CAPLfunctionIso11783TCILManipulateMessage.md)                     | Modifies the content of a message generated and sent by the interaction layer. |
| [TCIL\_ResetManipulatedMessage](Functions/CAPLfunctionIso11783TCILResetManipulatedMessage.md)         |                                                                                |
| [TCIL\_ResetAllManipulatedMessages](Functions/CAPLfunctionIso11783TCILResetAllManipulatedMessages.md) |                                                                                |
| [TCIL\_SetResponseContent](Functions/CAPLfunctionIso11783TCILSetResponseContent.md)                   | Changes the content of the next TC response.                                   |
| [TCIL\_ResetResponseContent](Functions/CAPLfunctionIso11783TCILResetResponseContent.md)               |                                                                                |
| [TCIL\_SetTCStatus](Functions/CAPLfunctionIso11783TCILSetTCStatus.md)                                 | Changes the content and cycle time of the TC Status message.                   |
| [TCIL\_ResetTCStatus](Functions/CAPLfunctionIso11783TCILResetTCStatus.md)                             |                                                                                |

#### TC – Fault Injection for Transport Protocols

| Functions                                                                                     | Short Description                                                                       |
| --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| [TCIL\_BlockTxTpAbort](Functions/CAPLfunctionIso11783TCILBlockTxTpAbort.md)                   | Prevents transmission of (E)TP.Abort message by the Interaction Layer.                  |
| [TCIL\_ResetBlockedTxTpAbort](Functions/CAPLfunctionIso11783TCILResetBlockedTxTpAbort.md)     |                                                                                         |
| [TCIL\_BlockTxTpCts](Functions/CAPLfunctionIso11783TCILBlockTxTpCts.md)                       | Prevents transmission of (E)TP.CTS message by the Interaction Layer.                    |
| [TCIL\_ResetBlockedTxTpCts](Functions/CAPLfunctionIso11783TCILResetBlockedTxTpCts.md)         |                                                                                         |
| [TCIL\_BlockTxTpDpo](Functions/CAPLfunctionIso11783TCILBlockTxTpDpo.md)                       | Prevents transmitting of a ETP.DPO message generated and sent by the interaction layer. |
| [TCIL\_ResetBlockedTxTpDpo](Functions/CAPLfunctionIso11783TCILResetBlockedTxTpDpo.md)         |                                                                                         |
| [TCIL\_BlockTxTpDt](Functions/CAPLfunctionIso11783TCILBlockTxTpDt.md)                         | Prevents transmission of (E)TP.DT message by the Interaction Layer.                     |
| [TCIL\_ResetBlockedTxTpDt](Functions/CAPLfunctionIso11783TCILResetBlockedTxTpDt.md)           |                                                                                         |
| [TCIL\_BlockTxTpEoma](Functions/CAPLfunctionIso11783TCILBlockTxTpEoma.md)                     | Prevents transmission of (E)TP.EoMA message by the Interaction Layer.                   |
| [TCIL\_ResetBlockedTxTpEoma](Functions/CAPLfunctionIso11783TCILResetBlockedTxTpEoma.md)       |                                                                                         |
| [TCIL\_DelayTxTpAbort](Functions/CAPLfunctionIso11783TCILDelayTxTpAbort.md)                   | Delays transmission of (E)TP.Abort message by the Interaction Layer.                    |
| [TCIL\_ResetDelayededTxTpAbort](Functions/CAPLfunctionIso11783TCILResetDelayededTxTpAbort.md) |                                                                                         |
| [TCIL\_DelayTxTpCts](Functions/CAPLfunctionIso11783TCILDelayTxTpCts.md)                       | Delays transmission of (E)TP.CTS message by the Interaction Layer.                      |
| [TCIL\_ResetDelayedTxTpCts](Functions/CAPLfunctionIso11783TCILResetDelayedTxTpCts.md)         |                                                                                         |
| [TCIL\_DelayTxTpDpo](Functions/CAPLfunctionIso11783TCILDelayTxTpDpo.md)                       | Delays transmitting of a ETP.DPO message generated and sent by the interaction layer.   |
| [TCIL\_ResetDelayedTxTpDpo](Functions/CAPLfunctionIso11783TCILResetDelayedTxTpDpo.md)         |                                                                                         |
| [TCIL\_DelayTxTpDt](Functions/CAPLfunctionIso11783TCILDelayTxTpDt.md)                         | Delays transmission of (E)TP.DT message by the Interaction Layer.                       |
| [TCIL\_ResetDelayedTxTpDt](Functions/CAPLfunctionIso11783TCILResetDelayedTxTpDt.md)           |                                                                                         |
| [TCIL\_DelayTxTpEoma](Functions/CAPLfunctionIso11783TCILDelayTxTpEoma.md)                     | Delays transmission of (E)TP.EoMA message by the Interaction Layer.                     |
| [TCIL\_ResetDelayedTxTpEoma](Functions/CAPLfunctionIso11783TCILResetDelayedTxTpEoma.md)       |                                                                                         |
| [TCIL\_FreezeTp](Functions/CAPLfunctionIso11783TCILFreezeTp.md)                               | Freezes the current (E)TP connection immediately.                                       |
| [TCIL\_UnfreezeTp](Functions/CAPLfunctionIso11783TCILUnfreezeTp.md)                           |                                                                                         |
| [TCIL\_KillTp](Functions/CAPLfunctionIso11783TCILKillTp.md)                                   |                                                                                         |

#### TC – Other Functions

| Functions                                                                                             | Short Description                                                                                                      |
| ----------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| [TCIL\_ConnectSysVarWithDataEntity](Functions/CAPLfunctionIso11783TCILConnectSysVarWithDataEntity.md) | Connects a data entity to a system variable.                                                                           |
| [TCIL\_ConnectSysVarWithSection](Functions/CAPLfunctionIso11783TCILConnectSysVarWithSection.md)       | Connects a single section state to a system variable.                                                                  |
| [TCIL\_ExportAllDdops](Functions/CAPLfunctionIso11783TCILExportAllDdops.md)                           | Exports the device descriptor object pools of all Task Controller clients into a file.                                 |
| [TCIL\_ExportDdop](Functions/CAPLfunctionIso11783TCILExportDdop.md)                                   | Exports the device descriptor object pool into a file.                                                                 |
| [TCIL\_GetDesignator](Functions/CAPLfunctionIso11783TCILGetDesignator.md)                             | Returns the designator of DeviceProcessData (DPD) or DeviceProperty (DPT).                                             |
| [TCIL\_GetDeviceParameters](Functions/CAPLfunctionIso11783TCILGetDeviceParameters.md)                 | Returns parameters of the client device which are contained in the Device XML element (DVC) of the device description. |
| [TCIL\_GetElementNumbers](Functions/CAPLfunctionIso11783TCILGetElementNumbers.md)                     | Returns a list of corresponding element numbers for the given DDI.                                                     |
| [TCIL\_GetValuePresentationData](Functions/CAPLfunctionIso11783TCILGetValuePresentationData.md)       | Returns all properties (id, offset, scale, numberDecimals, unitDesignator) of the ValuePresentation object.            |
| [TCIL\_MakeDdopAvailable](Functions/CAPLfunctionIso11783TCILMakeDdopAvailable.md)                     | Enables a device descriptor object pool (DDOP) to be loaded by Object-pool Activate message.                           |
| [TCIL\_RemoveAllDdops](Functions/CAPLfunctionIso11783TCILRemoveAllDdops.md)                           | Removes the device descriptor object pools of all Task Controller clients.                                             |

#### TC – Peer Control

| Functions                                                                                             | Short Description                                                                   |
| ----------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| [TCIL\_AssignReceiver](Functions/CAPLfunctionIso11783TCILAssignReceiver.md)                           | Sends an **Assign Receiver** message to the **setpoint value user** device.         |
| [TCIL\_AssignTransmitter](Functions/CAPLfunctionIso11783TCILAssignTransmitter.md)                     | Sends an **Assign Transmitter** message to the **setpoint value source** device.    |
| [TCIL\_CreatePeerControlAssignment](Functions/CAPLfunctionIso11783TCILCreatePeerControlAssignment.md) | Creates an assignment of a settable process data object to a setpoint value source. |
| [TCIL\_RemovePeerControlAssignment](Functions/CAPLfunctionIso11783TCILRemovePeerControlAssignment.md) | Removes an assignment of a settable process data object to a setpoint value source. |
| [TCIL\_UnassignReceiver](Functions/CAPLfunctionIso11783TCILUnassignReceiver.md)                       | Sends an **Unassign Receiver** message to the **setpoint value user** device.       |
| [TCIL\_UnassignTransmitter](Functions/CAPLfunctionIso11783TCILUnassignTransmitter.md)                 | Sends an **Unassign Transmitter** message to the **setpoint value source** device.  |

#### TC – Value Access

| Functions                                                                          | Short Description                                                                       |
| ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| [TCIL\_GetSectionState](Functions/CAPLfunctionIso11783TCILGetSectionState.md)      | Returns the current state of a single section.                                          |
| [TCIL\_GetValueRaw](Functions/CAPLfunctionIso11783TCILGetValueRawPhysical.md)      | Returns the current raw value of a data entity.                                         |
| [TCIL\_GetValuePhysical](Functions/CAPLfunctionIso11783TCILGetValueRawPhysical.md) | Returns the current physical value of a data entity.                                    |
| [TCIL\_SetSectionState](Functions/CAPLfunctionIso11783TCILSetSectionState.md)      | Sets the state of a single section without sending any command.                         |
| [TCIL\_SetValueRaw](Functions/CAPLfunctionIso11783TCILSetValueRawPhysical.md)      | Sets the value of a data entity without sending any command (using the raw value).      |
| [TCIL\_SetValuePhysical](Functions/CAPLfunctionIso11783TCILSetValueRawPhysical.md) | Sets the value of a data entity without sending any command (using the physical value). |

[IL Error Codes](../../CAPLfunctionsISOj1939ErrorCodes.md) • [TC IL Functional Properties](CAPLfunctionsISOILTCProperties.md) • [TC IL Network Properties](CAPLfunctionsISOILTCNetworkProperties.md)
