Skip to main content

​
diagStartVariantIdentification

Valid for: CANoe DE

​
Function Syntax

  • long diagStartVariantIdentification(); // form 1
  • long diagStartVariantIdentification(char ecuQualifier[]); // form 2

​
Description

Start the automatic variant identification algorithm for the given target, or the currently selected one if none is given. The algorithm will communicate via the built-in diagnostic channel, i.e. the CAPL callback functions are not used for the identification. A tester module may wait for the completion of the algorithm with testWaitForDiagVariantIdentificationCompleted, or query the status of the identification with diagGetIdentifiedVariant.

​
Parameters

  • ecuQualifier: ECU the identification algorithm should run for, not the currently selected one. If given, diagSetTarget does not have to be called.

​
Return Values

  • 0: No error, algorithm was started
  • < 0: Error code, especially:
    • -98: No communication channel could be found for the target
    • -97: Automatic variant identification is not defined in the diagnostic description
    • -91: The variant identification algorithm is already running

​
Example

Unlock ECU after pressing <u>. Example Automatic Variant Identification