Purpose

Performs a non-volatile memory certification task on the ECU device. Format

mcTypeStatus mcXCPProgramVerify(
mcTypeTaskRef ECURefNum,
u8 Mode,
u16 VerType,
u32 VerValue);

Input

ECURefNum

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

Mode

Mode specifies the verification mode and can be defined as:

00=request to start internal routine

01=transmit a Verification Value

VerType

VerType determines the verification type and is a bit mask described below:

0x0001—calibration area(s) of the flash

0x0002—code area(s) of the flash

0x0004—complete flash content

0x0008...0x0080—reserved

0x0100...0xFF00—user defined

VerValue

VerValue verification value is project specific. 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 function of the ECU M&C API to obtain a descriptive string for the return value.

Description

can be used to verify the success of non-volatile memory reprogramming.

With Mode set to 00 the master can request the slave to start internal test routines to check whether the new flash contents fits to the rest of the flash. Only the result is of interest. With Mode set to 01, the master can tell the slave that he will be sending a Verification value to the slave. The definition of the Verification mode is project-specific. The master receives the Verification Mode from the project-specific programming flow control and passes it to the slave.

implements the optional XCP PROGRAM_VERIFY command defined by the XCP specification. For further information on how to program non-volatile ECU memory refer to the ASAM XCP Part 2 Protocol Layer Specification.