Mistake on this page?
Report an issue in GitHub or email us
Modules | Functions
Hardware CRC

The Hardware CRC HAL API provides a low-level interface to the Hardware CRC module of a target platform. More...

Modules

 crc hal tests
 The crc HAL tests ensure driver conformance to defined behaviour.
 

Functions

bool hal_crc_is_supported (const crc_mbed_config_t *config)
 Determine if the current platform supports hardware CRC for given polynomial. More...
 
void hal_crc_compute_partial_start (const crc_mbed_config_t *config)
 Initialize the hardware CRC module with the given polynomial. More...
 
void hal_crc_compute_partial (const uint8_t *data, const size_t size)
 Writes data to the current CRC module. More...
 

Detailed Description

The Hardware CRC HAL API provides a low-level interface to the Hardware CRC module of a target platform.

Defined behaviour

Undefined behaviour

Non-functional requirements

Potential bugs

Function Documentation

void hal_crc_compute_partial ( const uint8_t *  data,
const size_t  size 
)

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
dataInput data stream to be written into the CRC calculation
sizeSize of the data stream in bytes
void hal_crc_compute_partial_start ( const crc_mbed_config_t config)

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
configContains CRC configuration parameters for initializing the hardware CRC module. For example, polynomial and initial seed values.
bool hal_crc_is_supported ( const crc_mbed_config_t config)

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
configContains 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.
Important Information for this Arm website

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies. If you are not happy with the use of these cookies, please review our Cookie Policy to learn how they can be disabled. By disabling cookies, some features of the site will not work.