Return value, Description – National Instruments CAN 372139B-01 User Manual

Page 231

Advertising
background image

Chapter 6

Automotive Diagnostic Command Set API for C

© National Instruments Corporation

6-67

Automotive Diagnostic Command Set User Manual

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 starts a routine in the ECU memory. The ECU routine starts after the positive
response message is sent. The routine stops until the

ndStopRoutineByLocalIdentifier

function and corresponding service are issued. The routines could be either tests that run
instead of normal operating code or routines enabled and executed with the normal operating
code running. In the first case, you may need to switch the ECU to a specific diagnostic mode
using

ndOpenDiagnostic

or unlock the ECU using the SecurityAccess service prior to

using

ndStartRoutineByLocalIdentifier

.

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

Advertising