This file contains the API and the configuration of the AUTOSAR Basic Software module CRC. More...

#include "Std_Types.h"
#include "Crc.h"

Macros
#define	CRC8_SAEJ1850_POLYNOMIAL 0x1D

#define	FIRSTCALLCRC8 0xFF

#define	CRC8NBITS 8

#define	CRC8MSB 0x80

#define	CRC8H2F_POLYNOMIAL 0x2F

#define	FIRSTCALLCRC8H2F 0xFF

#define	CRC8H2FNBITS 8

#define	CRC8H2NMSB 0x80

#define	CRC16_POLYNOMIAL 0x1021

#define	FIRSTCALLCRC16 0xFFFF

#define	CRC16NBITS 8

#define	CRC16MSB 0x8000

#define	CRC16_8LEFT 8

#define	CRC_16BITARC_POLYNOMIAL_REFLECTED (uint16)0xA001

#define	CRC_16BITARC_LSB 0x00001

#define	CRC_32BIT_POLYNOMIAL_REFLECTED (uint32)0xEDB88320u

#define	CRC_32BIT_XORVALUE 0xFFFFFFFFu

#define	CRC_32BIT_LSB 0x00000001u

#define	CRC_CRC32P4_POLYNOMIAL_REFLECTED (uint32)0xC8DF352Fu

#define	CRC_32BITP4_XORVALUE 0xFFFFFFFFu

#define	CRC_32BITP4_LSB 0x00000001u

#define	CRC_CRC64_POLYNOMIAL_REFLECTED (uint64)0xC96C5795D7870F42UL

#define	CRC_64BIT_XORVALUE 0xFFFFFFFFFFFFFFFFUL

#define	CRC_64BIT_LSB 0x0000000000000001UL

#define	VENDOR_ID 0x0000

#define	MODULE_ID 0x0000

#define	CRC_SW_MAJOR_VERSION 0

#define	CRC_SW_MINOR_VERSION 0

#define	CRC_SW_PATCH_VERSION 0

Functions
uint8	Crc_CalculateCRC8 (const uint8 *Crc_DataPtr, uint32 Crc_Length, uint8 Crc_StartValue8, boolean Crc_IsFirstCall)
	Calculate a CRC of 8 bits

uint8	Crc_CalculateCRC8H2F (const uint8 *Crc_DataPtr, uint32 Crc_Length, uint8 Crc_StartValue8H2F, boolean Crc_IsFirstCall)
	Calculate a CRC of 8 bits with other polynomial 0x2F

uint16	Crc_CalculateCRC16 (const uint8 *Crc_DataPtr, uint32 Crc_Length, uint16 Crc_StartValue16, boolean Crc_IsFirstCall)
	Calculate a CRC of 16 bits and polynomial of 0x1021

uint16	Crc_CalculateCRC16ARC (const uint8 *Crc_DataPtr, uint32 Crc_Length, uint16 Crc_StartValue16, boolean Crc_IsFirstCall)
	Calculate a CRC of 16 bits and polynomial of 0xA001

uint32	Crc_CalculateCRC32 (const uint8 *Crc_DataPtr, uint32 Crc_Length, uint32 Crc_StartValue32, boolean Crc_IsFirstCall)
	Calculate a CRC of 32 bits and polynomial of 0x04C11DB7

uint32	Crc_CalculateCRC32P4 (const uint8 *Crc_DataPtr, uint32 Crc_Length, uint32 Crc_StartValue32, boolean Crc_IsFirstCall)
	Calculate a CRC of 32 bits and polynomial of F4’AC’FB’13h

uint64	Crc_CalculateCRC64 (const uint8 *Crc_DataPtr, uint32 Crc_Length, uint64 Crc_StartValue64, boolean Crc_IsFirstCall)
	Calculate a CRC of 64 bits and polynomial of 42’F0’E1’EB’A9’EA’36’93h

uint8	Crc_GetVersionInfo (Std_VersionInfoType *Versioninfo)
	Fuunction to assign values to VersionInfo structure

Detailed Description

This file contains the API and the configuration of the AUTOSAR Basic Software module CRC.

The Crc library contains the following routines for CRC calculation • CRC8: SAEJ1850 • CRC8H2F: CRC8 0x2F polynomial • CRC16 • CRC32 • CRC32P4: CRC32 0xF4ACFB13 polynomial • CRC64: CRC-64-ECMA

This library was designed like a Runtime calculation: Slower execution, but small code size (no ROM table)

Function Documentation

◆ Crc_CalculateCRC16()

uint16 Crc_CalculateCRC16	(	const uint8 *	Crc_DataPtr,
		uint32	Crc_Length,
		uint16	Crc_StartValue16,
		boolean	Crc_IsFirstCall )

Calculate a CRC of 16 bits and polynomial of 0x1021

The function calculates the a 16 bit CRC according to the standard of AUTOSAR with their respective paramters.

First is necessary to know if is the first time to use the function and it is assigned a value for our CRC calculation. The function calculates the CRC through a for cycle, one of them is to know what of all bytes is in the calculation and the other is to move the bit of the respective byte.

The function uses bit shift to calculate the CRC according with the process.

Parameters

Crc_DataPtr	Pointer to start address of data block to be calculated.
Crc_Length	Length of data block to be calculated in bytes.
Crc_StartValue16	Start value when the algorithm starts.
Crc_IsFirstCall	boolean variable to know if is the first time that we used the function.

Return values

crcValue the value of crc (16 bits) according with parameters and specifications of this function

Requirement: SWS_Crc_00019, SWS_Crc_00015

< Polynomial of CRC16

< Value of CRC if is first call

< Number of shift bits on crc calculation

< Number of bits of a byte

< Most significant bit of 2 bytes

◆ Crc_CalculateCRC16ARC()

uint16 Crc_CalculateCRC16ARC	(	const uint8 *	Crc_DataPtr,
		uint32	Crc_Length,
		uint16	Crc_StartValue16,
		boolean	Crc_IsFirstCall )

Calculate a CRC of 16 bits and polynomial of 0xA001

The function calculates the a 16 bit CRC with data reflected according to the standard of AUTOSAR with their respective paramters.

In this case AUTOSAR specify a 0x8005 polynomial but the function need that the input data are relfected so the reflected data of 0x8005 is 0xA001.

First is necessary to know if is the first time to use the function and it is assigned a value for our CRC calculation. The function calculates the CRC through a for cycle, one of them is to know what of all bytes is in the calculation and the other is to move the bit of the respective byte.

The function uses bit shift to calculate the CRC according with the process.

Parameters

Crc_DataPtr	Pointer to start address of data block to be calculated.
Crc_Length	Length of data block to be calculated in bytes.
Crc_StartValue16	Start value when the algorithm starts.
Crc_IsFirstCall	boolean variable to know if is the first time that we used the function.

Return values

crcValue the value of crc (16 bits) according with parameters and specifications of this function

Requirement: SWS_Crc_00071, SWS_Crc_00069

< Polynomial of CRC16ARC

< Less significant bit

◆ Crc_CalculateCRC32()

uint32 Crc_CalculateCRC32	(	const uint8 *	Crc_DataPtr,
		uint32	Crc_Length,
		uint32	Crc_StartValue32,
		boolean	Crc_IsFirstCall )

Calculate a CRC of 32 bits and polynomial of 0x04C11DB7

The function calculates the a 32 bit CRC with data reflected according to the standard of AUTOSAR with their respective paramters.

In this case AUTOSAR specify a 0x04C11DB7 polynomial but the function need that the input data are relfected so the reflected data of 0x04C11DB7 is 0xEDB88320.

First is necessary to know if is the first time to use the function and it is assigned a value for our CRC calculation. The function calculates the CRC through a for cycle, one of them is to know what of all bytes is in the calculation and the other is to move the bit of the respective byte.

The function uses bit shift to calculate the CRC according with the process.

Parameters

Crc_DataPtr	Pointer to start address of data block to be calculated.
Crc_Length	Length of data block to be calculated in bytes.
Crc_StartValue32	Start value when the algorithm starts.
Crc_IsFirstCall	boolean variable to know if is the first time that we used the function.

Return values

crcValue the value of crc (32 bits) according with parameters and specifications of this function

Requirement: SWS_Crc_00020, SWS_Crc_00016

< Polynomial of CRC32

< Value of CRC if is first call

< Less significant bit

< Value of CRC if is first call

◆ Crc_CalculateCRC32P4()

uint32 Crc_CalculateCRC32P4	(	const uint8 *	Crc_DataPtr,
		uint32	Crc_Length,
		uint32	Crc_StartValue32,
		boolean	Crc_IsFirstCall )

Calculate a CRC of 32 bits and polynomial of F4’AC’FB’13h

The function calculates the a 32 bit CRC with data reflected according to the standard of AUTOSAR with their respective paramters.

In this case AUTOSAR specify a F4’AC’FB’13h polynomial but the function need that the input data are relfected so the reflected and is needed to assign the first CRC value the value of their XOR in this case 0xFFFFFFFF.

First is necessary to know if is the first time to use the function and it is assigned a value for our CRC calculation. The function calculates the CRC through a for cycle, one of them is to know what of all bytes is in the calculation and the other is to move the bit of the respective byte.

The function uses bit shift to calculate the CRC according with the process.

Parameters

Crc_DataPtr	Pointer to start address of data block to be calculated.
Crc_Length	Length of data block to be calculated in bytes.
Crc_StartValue32	Start value when the algorithm starts.
Crc_IsFirstCall	boolean variable to know if is the first time that we used the function.

Return values

crcValue the value of crc (32 bits) according with parameters and specifications of this function

Requirement: SWS_Crc_00058, SWS_Crc_00059

< Value of CRC if is first call

< Less significant bit

< Polynomial of CRC32P4

< Value of CRC if is first call

◆ Crc_CalculateCRC64()

uint64 Crc_CalculateCRC64	(	const uint8 *	Crc_DataPtr,
		uint32	Crc_Length,
		uint64	Crc_StartValue64,
		boolean	Crc_IsFirstCall )

Calculate a CRC of 64 bits and polynomial of 42’F0’E1’EB’A9’EA’36’93h

The function calculates the a 32 bit CRC with data reflected according to the standard of AUTOSAR with their respective paramters.

In this case AUTOSAR specify a 42’F0’E1’EB’A9’EA’36’93h polynomial but the function need that the input data are relfected so the reflected and is needed to assign the first CRC value the value of their XOR in this case 0xFFFFFFFFFFFFFFFF.

First is necessary to know if is the first time to use the function and it is assigned a value for our CRC calculation. The function calculates the CRC through a for cycle, one of them is to know what of all bytes is in the calculation and the other is to move the bit of the respective byte.

The function uses bit shift to calculate the CRC according with the process.

Parameters

Crc_DataPtr	Pointer to start address of data block to be calculated.
Crc_Length	Length of data block to be calculated in bytes.
Crc_StartValue64	Start value when the algorithm starts.
Crc_IsFirstCall	boolean variable to know if is the first time that we used the function.

Return values

crcValue the value of crc (64 bits) according with parameters and specifications of this function

Requirement: SWS_Crc_00061, SWS_Crc_00064

< Value of CRC if is first call

< Less significant bit

< Polynomial of CRC64

< Value of CRC if is first call

◆ Crc_CalculateCRC8()

uint8 Crc_CalculateCRC8	(	const uint8 *	Crc_DataPtr,
		uint32	Crc_Length,
		uint8	Crc_StartValue8,
		boolean	Crc_IsFirstCall )

Calculate a CRC of 8 bits

The function calculates the a 8 bit CRC according to the standard of AUTOSAR with their respective paramters.

First is necessary to know if is the first time to use the function and it is assigned a value for our CRC calculation. The function calculates the CRC through a for cycle, one of them is to know what of all bytes is in the calculation and the other is to move the bit of the respective byte.

The function uses bit shift to calculate the CRC according with the process.

Parameters

Crc_DataPtr	Pointer to start address of data block to be calculated.
Crc_Length	Length of data block to be calculated in bytes.
Crc_StartValue8	Start value when the algorithm starts.
Crc_IsFirstCall	boolean variable to know if is the first time that we used the function.

Return values

crcValue the value of crc (8 bits) according with parameters and specifications of this function

Requirement: SWS_Crc_00031, SWS_Crc_00032

< Polynomial of CRC8_SAEJ1850

< Value of CRC if is first call

< Number of bits of a byte

< Most significant bit of a byte

◆ Crc_CalculateCRC8H2F()

uint8 Crc_CalculateCRC8H2F	(	const uint8 *	Crc_DataPtr,
		uint32	Crc_Length,
		uint8	Crc_StartValue8H2F,
		boolean	Crc_IsFirstCall )

Calculate a CRC of 8 bits with other polynomial 0x2F

The function calculates the a 8 bit CRC according to the standard of AUTOSAR with their respective paramters.

First is necessary to know if is the first time to use the function and it is assigned a value for our CRC calculation. The function calculates the CRC through a for cycle, one of them is to know what of all bytes is in the calculation and the other is to move the bit of the respective byte.

The function uses bit shift to calculate the CRC according with the process.

Parameters

Crc_DataPtr	Pointer to start address of data block to be calculated.
Crc_Length	Length of data block to be calculated in bytes.
Crc_StartValue8H2F	Start value when the algorithm starts.
Crc_IsFirstCall	boolean variable to know if is the first time that we used the function.

Return values

crcValue the value of crc (8 bits) according with parameters and specifications of this function

Requirement: SWS_Crc_00043, SWS_Crc_00044

< Polynomial of CRC8H2F

< Value of CRC if is first call

< Number of bits of a byte

< Most significant bit of a byte

◆ Crc_GetVersionInfo()

uint8 Crc_GetVersionInfo ( Std_VersionInfoType * Versioninfo )

Fuunction to assign values to VersionInfo structure

This service returns the version information of this module.

The function assign values to VersionInfo structure to know the vendorID, moduleID, sw_major_version, sw_minor_version and sw_patch_version.

The function returns a TRUE if the members of structure have a value this part of code is inly for test porpuses.

Parameters

Versioninfo Variable that locates the version information of CRC.

Return values

status

Requirement: SWS_Crc_00021

< CRC Vendor ID VALUE

< CRC MODULE ID VALUE

< CRC_SW_MAJOR_VERSION ID VALUE

< CRC_SW_MINOR_VERSION ID VALUE

< CRC_SW_PATCH_VERSION ID VALUE

Macros

Functions

Detailed Description

Function Documentation

◆ Crc_CalculateCRC16()

◆ Crc_CalculateCRC16ARC()

◆ Crc_CalculateCRC32()

◆ Crc_CalculateCRC32P4()

◆ Crc_CalculateCRC64()

◆ Crc_CalculateCRC8()

◆ Crc_CalculateCRC8H2F()

◆ Crc_GetVersionInfo()