Skip to main content
Open topic with navigation CAPL Functions » ISO11783 » ISO11783 Interaction Layer » Iso11783IL_DeactivateDTC

Iso11783IL_DeactivateDTC

Valid for: CANoe DE • CANoe4SW DE

Function Syntax

  • long Iso11783IL_DeactivateDTC(dword spn, byte fmi, dword options); // form 1
  • long Iso11783IL_DeactivateDTC(dword spn, dword options); // form 2
  • long Iso11783IL_DeactivateDTC(dbNode node, dword spn, byte fmi, dword options); // form 3
  • long Iso11783IL_DeactivateDTC(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 ISO11783 Diagnostics is enabled by function Iso11783IL_ActivateDiagnosticsSupport.

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