CAPLfunctionsJ1939ILOverview

J1939 Interaction Layer

CAPL Functions » J1939 » J1939 Interaction Layer

J1939 Interaction Layer

Valid for: CANoe DE • CANoe4SW DE

J1939

Only available with J1939. To use the CAPL functions the node layer J1939_IL.dll must be included via the module description file J1939_IL.vmodule. You can include the node layer by using the configuration dialog of the node on page Components or via the node attribute NodeLayerModules in the database.

---

ON THIS PAGE:

• Callback Functions
• DTC Support
• Fault Injection for Messages
• Fault Injection for Transport Protocols
• Message Configuration
• Node Control
• Other Functions
• Signal/Message Access

Callback Functions

• J1939ILOnAddressClaimConflict: Is called if an address conflict is detected.
• J1939ILOnAddressViolation: Is called if an address violation is detected.
• J1939ILOnCA: Is called from the IL when a Command Address message is received.
• J1939ILOnChangedState: Is called if the IL has changed its state.
• J1939ILOnError: Is called if an error has occurred.
• J1939ILOnRequest: Is called if a request (0xEA00) is received.
• J1939ILOnRxMessage: Is called if a message was received successfully.
• J1939ILOnTxMessage: Is called if a message was sent successfully.
• J1939ILOnTxPrepare: Is called before a parameter group is sent.

DTC Support

• J1939ILActivateDiagnosticsSupport: Activates or deactivates the support of J1939 diagnostics by the IL.
• J1939ILActivateDTC: Activates a diagnostics trouble code (DTC) and add it to the list of active DTCs.
• J1939ILAddDTC: Adds a diagnostics trouble code (DTC) to a diagnostics message.
• J1939ILClearAllDTCs: Clears the list of active DTCs as well as the list of previously active DTCs.
• J1939ILDeactivateDTC: Deactivates a diagnostics trouble code (DTC) and removes it from the list of active DTCs.
• J1939ILGetDTCStatus: Returns the current occurrence count of a diagnostics trouble code (DTC).
• J1939ILRemoveDTC: Removes a diagnostics trouble code (DTC) from a diagnostics message.
• J1939ILSetLampStatus: Sets the lamp status of a diagnostics message.

Fault Injection for Messages

• J1939ILBlockRxMessage
• J1939ILResetBlockedRxMessage
• J1939ILResetAllBlockedRxMessages: Prevents processing of a received message by the Interaction Layer.
• J1939ILBlockTxMessage
• J1939ILResetBlockedTxMessage
• J1939ILResetAllBlockedTxMessages: Prevents transmitting of a message generated by the interaction layer.
• J1939ILDelayRxMessage
• J1939ILResetDelayedRxMessage
• J1939ILResetAllDelayedRxMessage: Delays processing of a received message by the interaction layer.
• J1939ILManipulateMessage
• J1939ILResetManipulatedMessage
• J1939ILResetAllManipulatedMessages: Modifies the content of a message generated and sent by the interaction layer.

Fault Injection for Transport Protocols

• J1939ILBlockTxTpAbort
• J1939ILResetBlockedTxTpAbort: Prevents transmission of TP.Abort message by the Interaction Layer.
• J1939ILBlockTxTpCts
• J1939ILResetBlockedTxTpCts: Prevents transmission of TP.CTS message by the Interaction Layer.
• J1939ILBlockTxTpDt
• J1939ILResetBlockedTxTpDt: Prevents transmission of TP.DT message by the Interaction Layer.
• J1939ILBlockTxTpEoma
• J1939ILResetBlockedTxTpEoma: Prevents transmission of TP.EoMA message by the Interaction Layer.
• J1939ILDelayTxTpAbort
• J1939ILResetDelayededTxTpAbort: Delays transmission of TP.Abort message by the Interaction Layer.
• J1939ILDelayTxTpCts
• J1939ILResetDelayedTxTpCts: Delays transmission of TP.CTS message by the Interaction Layer.
• J1939ILDelayTxTpDt
• J1939ILResetDelayedTxTpDt: Delays transmission of TP.DT message by the Interaction Layer.
• J1939ILDelayTxTpEoma
• J1939ILResetDelayedTxTpEoma: Delays transmission of TP.EoMA message by the Interaction Layer.
• J1939ILFreezeTp
• J1939ILUnfreezeTp
• J1939ILKillTp: Freezes the current TP connection immediately.

Message Configuration

• J1939ILDisableMsg: Disables the sending of a message.
• J1939ILEnableMsg: Re-enables the sending of a disabled message.
• J1939ILSetMessageProperty: Sets the property of a message.
• J1939ILSetMsgCycleTime: Sets the message cycle time.
• J1939ILSetMsgDA: Sets the message destination address.
• J1939ILSetMsgDelayTime: Sets the message delay time.
• J1939ILSetMsgPriority: Sets the message priority.

Node Control

• J1939ILEnableAddressViolationDetection: Activates detection of address violations by other nodes.
• J1939ILAcceptRxPG: Checks if the received parameter group is addressed to the J1939 IL.
• J1939ILControlInit: Suppress the auto-start function of the IL.
• J1939ILControlResume: Restarts the IL after suspension.
• J1939ILControlStart: Activate node to start Address Claiming.
• J1939ILControlStop: Deactivates the IL and stops sending cyclic messages.
• J1939ILControlWait: Suspends sending messages.
• J1939ILGetAddress: Returns the address that is used by the J1939 IL.
• J1939ILGetState: Returns the current state of the J1939 IL.
• J1939ILSetNodeProperty: Sets the property of a node.
• J1939ILGetDeviceName: Gets the J1939 NAME of the simulated node.

Other Functions

• J1939ILGetLastError: Returns the value of the last called J1939 IL function.
• J1939ILGetLastErrorText: Returns the textual description of the value of the last called J1939 IL function.
• J1939ILSetVerbosity: Sets verbosity for writing in Write Window.

Signal/Message Access

• J1939ILSetMsgEvent: Sends a message immediately.
• J1939ILSetMsgRawData: Sets the data bytes of the message.
• J1939ILSetSignal: Sets the physical value of a signal.
• J1939ILSetSignalRaw: Sets the raw value of a signal.