mcProgramStart

Purpose

Indicates the start of a programming sequence.

Format

Input

ECURefNum

ECURefNum is the task reference which links to the selected ECU. This reference is originally returned from mcECUSelectEx.

Output

Return Value

The return value indicates the status of the function call 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 mcStatusToString function of the ECU M&C API to obtain a descriptive string for the return value.

Description

If you are using the XCP protocol, mcProgramStart implements the XCP command PROGRAM_START. This optional command the beginning of a programming sequence into a non-volatile memory area. If the slave device is not in a state which permits programming, an error is returned. The memory programming commands The end of a non-volatile memory programming sequence is indicated by using the mcProgramReset function.

For further information on how to use program ECU memory and to use the mcProgramStart command refer to the ASAM XCP Part 2 Protocol Layer Specification.