Mbed OS Reference
|
CRC object provides CRC generation through hardware or software. More...
#include <MbedCRC.h>
Public Member Functions | |
constexpr | MbedCRC (uint32_t initial_xor, uint32_t final_xor, bool reflect_data, bool reflect_remainder) |
Lifetime of CRC object. More... | |
int32_t | compute (const void *buffer, crc_data_size_t size, uint32_t *crc) |
Compute CRC for the data input Compute CRC performs the initialization, computation and collection of final CRC. More... | |
int32_t | compute_partial (const void *buffer, crc_data_size_t size, uint32_t *crc) |
Compute partial CRC for the data input. More... | |
int32_t | compute_partial_start (uint32_t *crc) |
Compute partial start, indicate start of partial computation. More... | |
int32_t | compute_partial_stop (uint32_t *crc) |
Get the final CRC value of partial computation. More... | |
Static Public Member Functions | |
static constexpr uint32_t | get_polynomial () |
Get the current CRC polynomial. More... | |
static constexpr uint8_t | get_width () |
Get the current CRC width. More... | |
CRC object provides CRC generation through hardware or software.
CRC sums can be generated using three different methods: hardware, software ROM tables and bitwise computation. The mode used is normally selected automatically based on required polynomial and hardware capabilities. Any polynomial in standard form (x^3 + x + 1
) can be used for computation, but custom ones can affect the performance.
First choice is the hardware mode. The supported polynomials are hardware specific, and you need to consult your MCU manual to discover them. Next, ROM polynomial tables are tried (you can find list of supported polynomials here crc_polynomial). If the selected configuration is supported, it will accelerate the software computations. If ROM tables are not available for the selected polynomial, then CRC is computed at run time bit by bit for all data input.
If desired, the mode can be manually limited for a given instance by specifying the mode_limit template parameter. This might be appropriate to ensure a table is not pulled in for a non-speed-critical CRC, or to avoid the hardware set-up overhead if you know you will be calling compute
with very small data sizes.
polynomial | CRC polynomial value in hex |
width | CRC polynomial width |
mode_limit | Maximum amount of acceleration to use |
Example: Compute CRC data
Example: Compute CRC with data available in parts
|
constexpr |
Lifetime of CRC object.
initial_xor | Initial value/seed to Xor |
final_xor | Final Xor value |
reflect_data | |
reflect_remainder |
int32_t compute | ( | const void * | buffer, |
crc_data_size_t | size, | ||
uint32_t * | crc | ||
) |
int32_t compute_partial | ( | const void * | buffer, |
crc_data_size_t | size, | ||
uint32_t * | crc | ||
) |
Compute partial CRC for the data input.
CRC data if not available fully, CRC can be computed in parts with available data.
In case of hardware, intermediate values and states are saved by hardware. Mutex locking is used to serialize access to hardware CRC.
In case of software CRC, previous CRC output should be passed as argument to the current compute_partial call. Please note the intermediate CRC value is maintained by application and not the driver.
compute_partial_start
to start the partial CRC calculation. compute_partial_stop
to get the final CRC value.buffer | Data bytes |
size | Size of data |
crc | CRC value is intermediate CRC value filled by API. |
compute_partial_stop
to get final correct CRC value. int32_t compute_partial_start | ( | uint32_t * | crc | ) |
Compute partial start, indicate start of partial computation.
This API should be called before performing any partial computation with compute_partial API.
crc | Initial CRC value set by the API |
compute_partial_stop
without any modifications in application. int32_t compute_partial_stop | ( | uint32_t * | crc | ) |
Get the final CRC value of partial computation.
CRC value available in partial computation is not correct CRC, as some algorithms require remainder to be reflected and final value to be XORed This API is used to perform final computation to get correct CRC value.
crc | CRC result |
|
staticconstexpr |