Purpose

Executes the UDS ECUReset service. Resets the ECU.

Format

        long ndUDSECUReset(
       TD1 *diagRef,
       unsigned char mode,
       LVBoolean *success);
      

Input

diagRef

Specifies the diagnostic session handle, obtained from ndOpenDiagnosticOnCANFD or ndOpenDiagnosticOnIPStack and passed to subsequent diagnostic functions. Normally, it is not necessary to manually manipulate the elements of this struct.

mode

Indicates the reset mode:

Hex Description
01 hardReset
02 keyOffOnReset
03 softReset
04 enableRapidPowerShutDown
05 disableRapidPowerShutDown

Output

success

Indicates successful receipt of a positive response message for this diagnostic service.

Return Value

The return value indicates the function call status as a signed 32-bit integer. Zero means the function executed successfully. A negative value specifies an error, which means the function did not perform the expected behavior. A positive value specifies a warning, which means the function performed as expected, but a condition arose that may require attention.

Use the ndStatusToString function to obtain a descriptive string for the return value.

Description

This function requests the ECU to perform an ECU reset effectively based on the mode parameter value content. The vehicle manufacturer determines when the positive response message is sent. Depending the value of mode, the corresponding ECU reset event is executed as a hard reset, key off/on reset, soft reset, or other reset.

For further details about this service, refer to the ISO 15765-3 standard.