CRC8

CRC8 的协作图:

函数
xwer_t	xwlib_crc8_cal (xwu8_t *crc8, xwu8_t xorout, bool refin, bool refout, xwu8_t plynml, const xwu8_t stream[], xwsz_t *size)
	计算数据的CRC8校验值
xwu8_t	xwlib_crc8_calms (const xwu8_t stream[], xwsz_t *size)
	用主流CRC8参数模型计算数据的CRC8校验值

变量
const xwu8_t	xwlib_crc8tbl_0x07 [256]
	CRC8多项式0x7的查询表
const xwu8_t	xwlib_crc8tbl_0x31 [256]
	CRC8多项式0x31的查询表
const xwu8_t	xwlib_crc8tbl_0x9B [256]
	CRC8多项式0x9B的查询表

详细描述

函数说明

xwlib_crc8_cal()

xwer_t xwlib_crc8_cal	(	xwu8_t *	crc8,
		xwu8_t	xorout,
		bool	refin,
		bool	refout,
		xwu8_t	plynml,
		const xwu8_t	stream[],
		xwsz_t *	size
	)

计算数据的CRC8校验值

参数

[in,out]	crc8	指向缓冲区的指针，此缓冲区： (I) 作为输入时，表示初始值 (O) 作为输出时，返回计算结果，当计算失败时，值不会发生改变
[in]	xorout	与结果异或的值
[in]	refin	是否按位镜像翻转输入的每个字节(xwbop_rbit8)
[in]	refout	是否按位镜像翻转输出(xwbop_rbit32)
[in]	plynml	多项式： 0x07 0x31 0X9B
[in]	stream	指向数据的指针
[in,out]	size	指向缓冲区的指针，此缓冲区： (I) 作为输入时，表示数据长度 (O) 作为输出时，返回剩余未计算的数据长度，当返回不为0时， 表示计算未完成，计算结果不会镜像翻转，也不会与xorout异或。

返回

错误码

返回值

XWOK	没有错误，计算结果有效
-EFAULT	空指针
-EOPNOTSUPP	不支持的多项式

<No error

在文件 crc8.c 第 220 行定义.

{
        xwer_t rc;
        xwsz_t total;
        xwsz_t pos;
        xwu8_t res;
 
        XWOS_VALIDATE((crc8), "nullptr", -EFAULT);
        XWOS_VALIDATE((size), "nullptr", -EFAULT);
 
        total = *size;
        res = *crc8;
        pos = 0;
        /* 使用硬件计算部分CRC8校验值 */
        rc = soc_crc8_cal(&res, refin, plynml, &stream[0], size);
        if (*size > 0) {
                /* 使用软件计算剩余部分的CRC8校验值 */
                pos = total - *size;
                rc = xwlib_crc8_swcal(&res, refin, plynml, &stream[pos], size);
                pos = total - *size;
        }
        if (XWOK == rc) {
                if (0 == *size) {
                        if (refout) {
                                res = xwbop_rbit8(res);
                        }
                        res = res ^ xorout;
                }
                *crc8 = res;
        }
        return rc;
}

函数调用图:

这是这个函数的调用关系图:

xwlib_crc8_calms()

xwu8_t xwlib_crc8_calms	(	const xwu8_t	stream[],
		xwsz_t *	size
	)

用主流CRC8参数模型计算数据的CRC8校验值

参数

[in]	stream	指向数据的指针
[in,out]	size	指向缓冲区的指针，此缓冲区： (I) 作为输入时，表示数据长度 (O) 作为输出时，返回剩余未计算的数据长度

返回

CRC8

注解

• 主流CRC8参数模型：
  • 多项式：0x7
  • 初始值：0x0
  • 是否按位镜像翻转输入：否
  • 是否按位镜像翻转输出：否
  • 与结果进行异或计算：0x0

在文件 crc8.c 第 256 行定义.

{
        xwu8_t result;
 
        result = (xwu8_t)0x0;
        // cppcheck-suppress [misra-c2012-17.7]
        xwlib_crc8_cal(&result,
                       (xwu8_t)0x0, false, false, (xwu8_t)0x07,
                       stream, size);
        return result;
}

函数调用图:

变量说明

xwlib_crc8tbl_0x07

const xwu8_t xwlib_crc8tbl_0x07[256]

extern

CRC8多项式0x7的查询表

在文件 crc8.c 第 21 行定义.

xwlib_crc8tbl_0x31

const xwu8_t xwlib_crc8tbl_0x31[256]

extern

CRC8多项式0x31的查询表

在文件 crc8.c 第 61 行定义.

xwlib_crc8tbl_0x9B

const xwu8_t xwlib_crc8tbl_0x9B[256]

extern

CRC8多项式0x9B的查询表

在文件 crc8.c 第 101 行定义.