Zephyr API Documentation  3.6.99
A Scalable Open Source RTOS
Loading...
Searching...
No Matches
crc.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2018 Workaround GmbH.
3 * Copyright (c) 2017 Intel Corporation.
4 * Copyright (c) 2017 Nordic Semiconductor ASA
5 * Copyright (c) 2015 Runtime Inc
6 * Copyright (c) 2018 Google LLC.
7 * Copyright (c) 2022 Meta
8 *
9 * SPDX-License-Identifier: Apache-2.0
10 */
15#ifndef ZEPHYR_INCLUDE_SYS_CRC_H_
16#define ZEPHYR_INCLUDE_SYS_CRC_H_
17
18#include <zephyr/types.h>
19#include <stdbool.h>
20#include <stddef.h>
21
22#include <zephyr/sys/__assert.h>
23
24#ifdef __cplusplus
25extern "C" {
26#endif
27
28/* Initial value expected to be used at the beginning of the crc8_ccitt
29 * computation.
30 */
31#define CRC8_CCITT_INITIAL_VALUE 0xFF
32
61};
62
82uint16_t crc16(uint16_t poly, uint16_t seed, const uint8_t *src, size_t len);
83
112uint16_t crc16_reflect(uint16_t poly, uint16_t seed, const uint8_t *src, size_t len);
128uint8_t crc8(const uint8_t *src, size_t len, uint8_t polynomial, uint8_t initial_value,
129 bool reversed);
130
162uint16_t crc16_ccitt(uint16_t seed, const uint8_t *src, size_t len);
163
199uint16_t crc16_itu_t(uint16_t seed, const uint8_t *src, size_t len);
200
212static inline uint16_t crc16_ansi(const uint8_t *src, size_t len)
213{
214 return crc16_reflect(0xA001, 0xffff, src, len);
215}
216
226uint32_t crc32_ieee(const uint8_t *data, size_t len);
227
238uint32_t crc32_ieee_update(uint32_t crc, const uint8_t *data, size_t len);
239
253 size_t len, bool first_pkt, bool last_pkt);
254
266uint8_t crc8_ccitt(uint8_t initial_value, const void *buf, size_t len);
267
281uint8_t crc7_be(uint8_t seed, const uint8_t *src, size_t len);
282
296uint8_t crc4_ti(uint8_t seed, const uint8_t *src, size_t len);
297
315uint8_t crc4(const uint8_t *src, size_t len, uint8_t polynomial, uint8_t initial_value,
316 bool reversed);
317
340static inline uint32_t crc_by_type(enum crc_type type, const uint8_t *src, size_t len,
341 uint32_t seed, uint32_t poly, bool reflect, bool first,
342 bool last)
343{
344 switch (type) {
345 case CRC4:
346 return crc4(src, len, poly, seed, reflect);
347 case CRC4_TI:
348 return crc4_ti(seed, src, len);
349 case CRC7_BE:
350 return crc7_be(seed, src, len);
351 case CRC8:
352 return crc8(src, len, poly, seed, reflect);
353 case CRC8_CCITT:
354 return crc8_ccitt(seed, src, len);
355 case CRC16:
356 if (reflect) {
357 return crc16_reflect(poly, seed, src, len);
358 } else {
359 return crc16(poly, seed, src, len);
360 }
361 case CRC16_ANSI:
362 return crc16_ansi(src, len);
363 case CRC16_CCITT:
364 return crc16_ccitt(seed, src, len);
365 case CRC16_ITU_T:
366 return crc16_itu_t(seed, src, len);
367 case CRC32_C:
368 return crc32_c(seed, src, len, first, last);
369 case CRC32_IEEE:
370 return crc32_ieee_update(seed, src, len);
371 default:
372 break;
373 }
374
375 __ASSERT_NO_MSG(false);
376 return -1;
377}
378
383#ifdef __cplusplus
384}
385#endif
386
387#endif
uint8_t crc7_be(uint8_t seed, const uint8_t *src, size_t len)
Compute the CRC-7 checksum of a buffer.
uint32_t crc32_ieee_update(uint32_t crc, const uint8_t *data, size_t len)
Update an IEEE conforming CRC32 checksum.
uint16_t crc16(uint16_t poly, uint16_t seed, const uint8_t *src, size_t len)
Generic function for computing a CRC-16 without input or output reflection.
uint8_t crc4_ti(uint8_t seed, const uint8_t *src, size_t len)
Compute the CRC-4 checksum of a buffer.
uint8_t crc4(const uint8_t *src, size_t len, uint8_t polynomial, uint8_t initial_value, bool reversed)
Generic function for computing CRC 4.
uint16_t crc16_itu_t(uint16_t seed, const uint8_t *src, size_t len)
Compute the checksum of a buffer with polynomial 0x1021, no reflection of input or output.
static uint32_t crc_by_type(enum crc_type type, const uint8_t *src, size_t len, uint32_t seed, uint32_t poly, bool reflect, bool first, bool last)
Compute a CRC checksum, in a generic way.
Definition: crc.h:340
uint16_t crc16_ccitt(uint16_t seed, const uint8_t *src, size_t len)
Compute the checksum of a buffer with polynomial 0x1021, reflecting input and output.
uint32_t crc32_c(uint32_t crc, const uint8_t *data, size_t len, bool first_pkt, bool last_pkt)
Calculate CRC32C (Castagnoli) checksum.
uint8_t crc8_ccitt(uint8_t initial_value, const void *buf, size_t len)
Compute CCITT variant of CRC 8.
uint8_t crc8(const uint8_t *src, size_t len, uint8_t polynomial, uint8_t initial_value, bool reversed)
Generic function for computing CRC 8.
static uint16_t crc16_ansi(const uint8_t *src, size_t len)
Compute the ANSI (or Modbus) variant of CRC-16.
Definition: crc.h:212
crc_type
CRC algorithm enumeration.
Definition: crc.h:49
uint16_t crc16_reflect(uint16_t poly, uint16_t seed, const uint8_t *src, size_t len)
Generic function for computing a CRC-16 with input and output reflection.
uint32_t crc32_ieee(const uint8_t *data, size_t len)
Generate IEEE conform CRC32 checksum.
@ CRC7_BE
Use crc7_be.
Definition: crc.h:52
@ CRC16
Use crc16.
Definition: crc.h:55
@ CRC4_TI
Use crc4_ti.
Definition: crc.h:51
@ CRC16_ITU_T
Use crc16_itu_t.
Definition: crc.h:58
@ CRC32_C
Use crc32_c.
Definition: crc.h:59
@ CRC16_ANSI
Use crc16_ansi.
Definition: crc.h:56
@ CRC8
Use crc8.
Definition: crc.h:53
@ CRC16_CCITT
Use crc16_ccitt.
Definition: crc.h:57
@ CRC8_CCITT
Use crc8_ccitt.
Definition: crc.h:54
@ CRC32_IEEE
Use crc32_ieee.
Definition: crc.h:60
@ CRC4
Use crc4.
Definition: crc.h:50
__UINT32_TYPE__ uint32_t
Definition: stdint.h:90
__UINT8_TYPE__ uint8_t
Definition: stdint.h:88
__UINT16_TYPE__ uint16_t
Definition: stdint.h:89