|Download Help (Windows Only)|
Calculates a checksum over a defined memory range within the ECU.
ECURefNum is the task reference which links to the selected ECU. This reference is originally returned from mcECUSelectEx.
Configures the target address for the checksum operation in the ECU. mcAddress is a C struct consisting of:
Specifies the address part of the target address.
Extension contains the extension part of the target address.
BlockSize determines the size of the block on which the checksum has to be calculated.
ChecksumType returns the type of the calculated checksum. For CCP, ChecksumType is 0xFF. For XCP, refer to the Description section.
SizeofChecksum returns the size in bytes of the calculated checksum.
Checksum is the calculated checksum.
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.
mcBuildChecksum is used to calculate the checksum of a specified memory block inside the ECU starting at the selected Address.
If you are using the CCP protocol, mcBuildChecksum implements the CCP BUILD_CHKSUM command. The checksum algorithm is not specified by CCP and the checksum algorithm may be different on different devices.
If you are using the XCP protocol, mcBuildChecksum implements the BUILD_CHECKSUM command of the XCP specification. The result of the checksum calculation is returned in Checksum regardless of the checksum type. The following values for ChecksumType are defined in the XCP specification:
|0x01||XCP_ADD_11||Add BYTE into a BYTE checksum, ignore overflows|
|0x02||XCP_ADD_12||Add BYTE into a WORD checksum, ignore overflows|
|0x03||XCP_ADD_14||Add BYTE into a DWORD checksum, ignore overflows|
|0x04||XCP_ADD_22||Add WORD into a WORD checksum, ignore overflows, blocksize must be modulo 2|
|0x05||XCP_ADD_24||Add WORD into a DWORD checksum, ignore overflows, blocksize must be modulo 2|
|0x06||XCP_ADD_44||Add DWORD into DWORD, ignore overflows, blocksize must be modulo 4|
|0x07||XCP_CRC_16||Refer to CRC error detection algorithms|
|0x08||XCP_CRC_16_CITT||Refer to CRC error detection algorithms|
|0x09||XCP_CRC_32||Refer to CRC error detection algorithms|
|0xFF||XCP_USER_DEFINED||User defined algorithm, in externally calculated function|
With ChecksumType XCP_USER_DEFINED, the Slave may indicate that the Master which calculates the checksum must use a user-defined algorithm implemented in an externally calculated function (for instance, Win32 DLL, UNIX shared object file, etc.). The master retrieves the name of the external function file to be used for this slave from the ASAM MCD 2MC description file.
The CRC algorithms are specified by the following parameters:
The name of the algorithm. A string value starting with "XCP_".
The width of the algorithm expressed in bits. This is one less than the width of the Poly.
The polynomial. This is a binary value specified as a hexadecimal number. The top bit of the Poly should be omitted. For example, if the Poly is 0x10110, you should specify 0x06. An important aspect of this parameter is that it represents the unreflected polynomial. The bottom of this parameter is always the least significant bit (LSB) of the divisor during the division, regardless of whether the algorithm is reflected.
This parameter specifies the initial value of the register when the algorithm starts. This is the value to be assigned to the register in the direct table algorithm. In the table algorithm, we may think of the register always commencing with the value zero, and this value being XORed into the register after the nth bit iteration. This parameter should be specified as a hexadecimal number.
A Boolean parameter. If it is FALSE, input bytes are processed with bit 7 being treated as the most significant bit (MSB) and bit 0 being treated as the least significant bit. If this parameter is TRUE, each byte is reflected before being processed.
A Boolean parameter. If it is set to FALSE, the final value in the register is fed into the XORout stage directly. If this parameter is TRUE, the final register value is reflected first.
This is a width-bit value that should be specified as hexadecimal number. It is XORed to the final register value (after the Refout stage) before the value is returned as the official checksum.
For more detailed information about CRC algorithms, refer to: