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) must be included.ON THIS PAGE:
- Callback Functions
- DTC Support
- Node Control
- Other Functions
- Signal/Message Access
- TC - Client Control
- TC - Fault Injection for Messages
- TC - Fault Injection for Transport Protocols
- TC - Other Functions
- TC - Peer Control
- TC - Value Access
Callback Functions
| Functions | Short Description |
|---|---|
| TCIL_OnAddressClaimConflict | Is called if an address conflict is detected. |
| TCIL_OnAddressViolation | Is called if an address violation is detected. |
| TCIL_OnCA | Is called from the IL when a Command Address message is received. |
| TCIL_OnChangedState | Is called if the IL has changed its state. |
| TCIL_OnError | Is called if an error has occurred. |
| TCIL_OnRequest | Is called if a request (0xEA00) is received. |
| TCIL_OnRxMessage | Is called from the IL if the IL receives the parameter group, namely before the parameter group is processed by the IL. |
| TCIL_OnTxMessage | Is called if a message was sent successfully. |
| TCIL_OnTxPrepare | Is called before a parameter group is sent. |
DTC Support
| Functions | Short Description |
|---|---|
| TCIL_ActivateDiagnosticsSupport | Activates or deactivates the support of ISO11783 diagnostics by the IL. |
| TCIL_ActivateDTC | Activates a diagnostics trouble code (DTC) and add it to the list of active DTCs. |
| TCIL_ClearAllDTCs | Clears the list of active DTCs as well as the list of previously active DTCs. |
| TCIL_DeactivateDTC | Deactivates a diagnostics trouble code (DTC) and removes it from the list of active DTCs. |
| TCIL_GetDTCStatus | Returns the current occurrence count of a diagnostics trouble code (DTC). |
Node Control
| Functions | Short Description |
|---|---|
| TCIL_AcceptRxPG | Checks if the received parameter group is addressed to the TC IL. |
| TCIL_ControlInit | Suppress the auto-start function of the IL. |
| TCIL_ControlStart | Activate node to start Address Claiming. |
| TCIL_ControlStop | Deactivates the IL and stops sending cyclic messages. |
| TCIL_EnableAddressViolationDetection | Activates detection of address violations by other nodes. |
| TCIL_EnableNameManagement | This function activates the name management of a node. |
| TCIL_GetAddress | Returns the address that is used by the TC IL. |
| TCIL_GetState | Returns the current state of the TC IL. |
| TCIL_SetNodeProperty | Changes an internal property of the node. |
| TCIL_GetDeviceName | Gets the NAME as reported on the bus. |
Other Functions
| Functions | Short Description |
|---|---|
| TCIL_GetLastError | Returns the value of the last called TC IL function. |
| TCIL_GetLastErrorText | Returns the textual description of the value of the last called TC IL function. |
| TCIL_SetVerbosity | Set verbosity for writing in Write Window. |
Signal/Message Access
| Functions | Short Description |
|---|---|
| TCIL_SetMsgEvent | Sends a message immediately. |
| TCIL_SetMsgRawData | Sets the data bytes of the message. |
| TCIL_SetSignal | Sets the physical value of a signal. |
| TCIL_SetSignalRaw | Sets the raw value of a signal. |
TC – Client Control
| Functions | Short Description |
|---|---|
| TCIL_MeasurementCommandRaw | Sends a trigger definition to the client (using the raw value). |
| TCIL_MeasurementCommandPhysical | Sends a trigger definition to the client (using the physical value). |
| TCIL_RequestValueCommand | Sends the Request Value command to the client. |
| TCIL_RequestVersion | Requests the Version message from the client. |
| TCIL_StartTask | Starts a task. |
| TCIL_StopTask | Stops a task. |
| TCIL_ValueAndAckCommand | Sends the current value of a data entity to the client with Set Value and Acknowledge command. |
| TCIL_ValueAndAckCommandRaw | 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 | 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 | Sends the current value of a data entity to the client with Value command. |
| TCIL_ValueCommandRaw | Sets the value of a data entity (using the raw value) and sends the value to the client with Value command. |
| TCIL_ValueCommandPhysical | 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 | Prevents processing of a received message by the Interaction Layer. |
| TCIL_ResetBlockedRxMessage | |
| TCIL_ResetAllBlockedRxMessages | |
| TCIL_BlockTxMessage | Prevents transmitting of a message generated by the interaction layer. |
| TCIL_ResetBlockedTxMessage | |
| TCIL_ResetAllBlockedTxMessages | |
| TCIL_DelayRxMessage | Delays processing of a received message by the interaction layer. |
| TCIL_ResetDelayedRxMessage | |
| TCIL_ResetAllDelayedRxMessage | |
| TCIL_ManipulateMessage | Modifies the content of a message generated and sent by the interaction layer. |
| TCIL_ResetManipulatedMessage | |
| TCIL_ResetAllManipulatedMessages | |
| TCIL_SetResponseContent | Changes the content of the next TC response. |
| TCIL_ResetResponseContent | |
| TCIL_SetTCStatus | Changes the content and cycle time of the TC Status message. |
| TCIL_ResetTCStatus |
TC – Fault Injection for Transport Protocols
| Functions | Short Description |
|---|---|
| TCIL_BlockTxTpAbort | Prevents transmission of (E)TP.Abort message by the Interaction Layer. |
| TCIL_ResetBlockedTxTpAbort | |
| TCIL_BlockTxTpCts | Prevents transmission of (E)TP.CTS message by the Interaction Layer. |
| TCIL_ResetBlockedTxTpCts | |
| TCIL_BlockTxTpDpo | Prevents transmitting of a ETP.DPO message generated and sent by the interaction layer. |
| TCIL_ResetBlockedTxTpDpo | |
| TCIL_BlockTxTpDt | Prevents transmission of (E)TP.DT message by the Interaction Layer. |
| TCIL_ResetBlockedTxTpDt | |
| TCIL_BlockTxTpEoma | Prevents transmission of (E)TP.EoMA message by the Interaction Layer. |
| TCIL_ResetBlockedTxTpEoma | |
| TCIL_DelayTxTpAbort | Delays transmission of (E)TP.Abort message by the Interaction Layer. |
| TCIL_ResetDelayededTxTpAbort | |
| TCIL_DelayTxTpCts | Delays transmission of (E)TP.CTS message by the Interaction Layer. |
| TCIL_ResetDelayedTxTpCts | |
| TCIL_DelayTxTpDpo | Delays transmitting of a ETP.DPO message generated and sent by the interaction layer. |
| TCIL_ResetDelayedTxTpDpo | |
| TCIL_DelayTxTpDt | Delays transmission of (E)TP.DT message by the Interaction Layer. |
| TCIL_ResetDelayedTxTpDt | |
| TCIL_DelayTxTpEoma | Delays transmission of (E)TP.EoMA message by the Interaction Layer. |
| TCIL_ResetDelayedTxTpEoma | |
| TCIL_FreezeTp | Freezes the current (E)TP connection immediately. |
| TCIL_UnfreezeTp | |
| TCIL_KillTp |
TC – Other Functions
| Functions | Short Description |
|---|---|
| TCIL_ConnectSysVarWithDataEntity | Connects a data entity to a system variable. |
| TCIL_ConnectSysVarWithSection | Connects a single section state to a system variable. |
| TCIL_ExportAllDdops | Exports the device descriptor object pools of all Task Controller clients into a file. |
| TCIL_ExportDdop | Exports the device descriptor object pool into a file. |
| TCIL_GetDesignator | Returns the designator of DeviceProcessData (DPD) or DeviceProperty (DPT). |
| TCIL_GetDeviceParameters | Returns parameters of the client device which are contained in the Device XML element (DVC) of the device description. |
| TCIL_GetElementNumbers | Returns a list of corresponding element numbers for the given DDI. |
| TCIL_GetValuePresentationData | Returns all properties (id, offset, scale, numberDecimals, unitDesignator) of the ValuePresentation object. |
| TCIL_MakeDdopAvailable | Enables a device descriptor object pool (DDOP) to be loaded by Object-pool Activate message. |
| TCIL_RemoveAllDdops | Removes the device descriptor object pools of all Task Controller clients. |
TC – Peer Control
| Functions | Short Description |
|---|---|
| TCIL_AssignReceiver | Sends an Assign Receiver message to the setpoint value user device. |
| TCIL_AssignTransmitter | Sends an Assign Transmitter message to the setpoint value source device. |
| TCIL_CreatePeerControlAssignment | Creates an assignment of a settable process data object to a setpoint value source. |
| TCIL_RemovePeerControlAssignment | Removes an assignment of a settable process data object to a setpoint value source. |
| TCIL_UnassignReceiver | Sends an Unassign Receiver message to the setpoint value user device. |
| TCIL_UnassignTransmitter | Sends an Unassign Transmitter message to the setpoint value source device. |
TC – Value Access
| Functions | Short Description |
|---|---|
| TCIL_GetSectionState | Returns the current state of a single section. |
| TCIL_GetValueRaw | Returns the current raw value of a data entity. |
| TCIL_GetValuePhysical | Returns the current physical value of a data entity. |
| TCIL_SetSectionState | Sets the state of a single section without sending any command. |
| TCIL_SetValueRaw | Sets the value of a data entity without sending any command (using the raw value). |
| TCIL_SetValuePhysical | Sets the value of a data entity without sending any command (using the physical value). |