Hardware CRC
[Hal]

Writes data to the current CRC module.

Writes input data buffer bytes to the CRC data register. The CRC module must interpret the data as an array of bytes.

The final transformations are not applied to the data; the CRC module must retain the intermediate result so that additional calls to this function can be made, appending the additional data to the calculation.

To obtain the final result of the CRC calculation, hal_crc_get_result() is called to apply the final transformations to the data.

If the function is passed an undefined pointer, or the size of the buffer is specified to be 0, this function does nothing and returns.

This function can be called multiple times in succession. This can be used to calculate the CRC result of streamed data.

This function is not thread safe. There is only one instance of the CRC module active at a time. Calling this function from multiple contexts appends different data to the same, single instance of the module, which causes an erroneous value to be calculated.

Parameters:

data	Input data stream to be written into the CRC calculation
size	Size of the data stream in bytes

Initialize the hardware CRC module with the given polynomial.

After calling this function, the CRC HAL module is ready to receive data using the hal_crc_compute_partial() function. The CRC module on the board is configured internally with the specified configuration and is ready to receive data.

The platform configures itself based on the default configuration parameters of the input polynomial.

This function must be called before calling hal_crc_compute_partial().

This function must be called with a valid polynomial supported by the platform. The polynomial must be checked for support using the hal_crc_is_supported() function.

Calling hal_crc_compute_partial_start() multiple times without finalizing the CRC calculation with hal_crc_get_result() overrides the current configuration and state, and the intermediate result of the computation is lost.

This function is not thread safe. A CRC calculation must not be started from two different threads or contexts at the same time; calling this function from two different contexts may lead to configurations being overwritten and results being lost.

Parameters:

config

Contains CRC configuration parameters for initializing the hardware CRC module. For example, polynomial and initial seed values.

Determine if the current platform supports hardware CRC for given polynomial.

The purpose of this function is to inform the CRC Platform API whether the current platform has a hardware CRC module and that it can support the requested polynomial.

Supported polynomials are restricted to the named polynomials that can be constructed in the MbedCRC class, POLY_8BIT_CCITT, POLY_7BIT_SD, POLY_16BIT_CCITT, POLY_16BIT_IBM and POLY_32BIT_ANSI.

The current platform must support the given polynomials default parameters in order to return a true response. These include: reflect in, reflect out, initial xor and final xor. For example, POLY_32BIT_ANSI requires an initial and final xor of 0xFFFFFFFF, and reflection of both input and output. If any of these settings cannot be configured, the polynomial is not supported.

This function is thread safe; it safe to call from multiple contexts if required.

Parameters:

config

Contains CRC configuration parameters for initializing the hardware CRC module. For example, polynomial and initial seed values.

Returns:

True if running if the polynomial is supported, false if not.