Skip to main content

​
J1939ILDeactivateDTC

Valid for: CANoe DE • CANoe4SW DE

​
Function Syntax

  • long J1939ILDeactivateDTC(dword spn, byte fmi, dword options); // form 1
  • long J1939ILDeactivateDTC(dword spn, dword options); // form 2
  • long J1939ILDeactivateDTC(dbNode node, dword spn, byte fmi, dword options); // form 3
  • long J1939ILDeactivateDTC(dbNode node, dword spn, dword options); // form 4

​
Description

This function deactivates a diagnostics trouble code (DTC) and removes it from the list of active DTCs. A deactivated DTC is no longer reported in message DM1 (Active Diagnostic Trouble Codes, PGN FECAh) but it is moved to the list of previously active DTCs and is reported in the requestable message DM2 (Previously Active Diagnostic Trouble Codes, PGN FECBh). Note: You can use this function only if support of J1939 Diagnostics is enabled by function J1939ILActivateDiagnosticsSupport.

​
Parameters

  • spn: Suspect Parameter Number of the deactivated DTC, 0..524287.
  • fmi: Failure Mode Indicator of the deactivated DTC, 0..31.
  • options:
    • Bit 0 = 0: Send message DM1 as soon as possible.
    • Bit 0 = 1: Send message DM1 with next cycle.
  • node: Simulation node to apply the function.

​
Return Values

  • 0: success
  • < 0: An error has occurred: IL Error Code
  • -803: Failed to activate DTC because diagnostics support is not activated
  • -804: Failed to activate DTC because DTC not found

​
Example

—