CRC Driver

---

变更记录

时间	版本	变更记录
2024-08-08	0.1	初 版

---

目录

• ChipOn Microcontroller Abstract Layer Users Manual - CRC Driver
  • 变更记录
  • 目录
• 第1章 引言
  • 1.1 范围
  • 1.2 缩写
  • 1.3 参考
• 第2章 CRC Driver概述
  • 2.1 CRC
• 第3章 文件结构
• 第4章 配置文档
  • 无
• 第5章 发布的参数
  • 5.1 VendorId
  • 5.2 ModuleId
  • 5.3 InstanceId
  • 5.4 SwMajorVersion
  • 5.5 SwMinorVersion
  • 5.6 SwPatchVersion
• 第6章 API文档
  • 6.1 API类型定义
  • 6.2 API函数
    • 6.2.1 Crc_CalculateCRC8
    • 6.2.2 Crc_CalculateCRC8H2F
    • 6.2.3 Crc_CalculateCRC16
    • 6.2.4 Crc_CalculateCRC16ARC
    • 6.2.5 Crc_CalculateCRC32
    • 6.2.6 Crc_CalculateCRC32P4
    • 6.2.7 Crc_GetVersionInfo
  • 6.3 中断处理
  • 6.4 专有区域（EA）信息
    • 6.4.1 专有区域信息
• 第7章 数据描述
  • 7.1 全局数据描述
    • 表80 全局数据描述
• 第8章 错误分类
  • 8.1 错误代码和描述
    • 表81 错误分类
• 第9章 示例用法
  • 9.1 系统时钟配置注意事项
  • 9.2 宏配置
  • 9.3 接口使用示例
    • 9.3.1 Crc_CalculateCRC8 分步计算
    • 9.3.2 Crc_CalculateCRC8 一步计算
    • 9.3.3 Crc_CalculateCRC8H2F 分步计算
    • 9.3.4 Crc_CalculateCRC8H2F 一步计算
    • 9.3.5 Crc_CalculateCRC16 分步计算
    • 9.3.6 Crc_CalculateCRC16 一步计算
    • 9.3.7 Crc_CalculateCRC16ARC 分步计算
    • 9.3.8 Crc_CalculateCRC16ARC 一步计算
    • 9.3.9 Crc_CalculateCRC32 分步计算
    • 9.3.10 Crc_CalculateCRC32 一步计算
    • 9.3.11 Crc_CalculateCRC32P4 分步计算
    • 9.3.12 Crc_CalculateCRC32P4 一步计算
  • 9.4 配置示例
• 第10章 限制和假设
  • 10.1 假设和与软件规格的偏差
    • 表82 假设
    • 偏差
    • 考虑的Bugzilla
  • 10.2 限制
    • 10.2.1

---

第1章 引言

本用户手册提供了AUTOSAR CP R22-11的CRC驱动程序的功能和API实现的相关信息。本用户手册旨在帮助用户熟悉CRC驱动程序的实现KF32A11K1X8硬件平台。它是描述如何使用CRC驱动程序的文档。

1.1 范围

本文档介绍CRC驱动程序实现的以下特性：

• KF32A1X8实现硬件外设的驱动程序
• CRC Driver的文件结构
• 由CRC Driver发布的参数
• API规范
• 说明常见用例的代码段
• 限制和假设

本文档适用于CRC Driver

1.2 缩写

缩写	解释
AUTOSAR	汽车汽车开放系统架构
API	应用程序接口
CRC	循环冗余码校验
ALU	算术逻辑单元
DEM	诊断事件管理器
DET	开发错误跟踪器
BSW	基础软件
HW	硬件
ID	标识符
MCAL	微控制器抽象层
MCU	微控制器

1.3 参考

本节列出了与本用户手册相关的所有文档：

• [1] Specification of CRCDriver, AUTOSAR_SWS_CRCLibrary.pdf Release R22-11
• [2] KF32158用户手册.pdf Release V0.71
• [3] KF32158用户手册.pdf Release V0.8

---

第2章 CRC Driver概述

KF32微控制器提供CRC操作方式。

2.1 CRC

CRC使用的硬件单元计算。

---

第3章 文件结构

本节提供了有关CRC Driver文件和其他相关文件的详细信息。

Name	Description
Crc.c	此文件包含获取版本号函数
Crc.h	此头文件输出CRC驱动程序的宏、类型定义和函数原型
Crc_Im.c	模块芯片适配层接口实现文件
Crc_Im.h	模块芯片适配层接口文件
Crc8.c	Crc_CalculateCRC8算法实现
Crc8H2F.c	Crc_CalculateCRC8H2F算法实现
Crc16.c	Crc_CalculateCRC16算法实现
Crc16ARC.c	Crc_CalculateCRC16ARC算法实现
Crc32.c	Crc_CalculateCRC32算法实现
Crc32P4.c	Crc_CalculateCRC32P4算法实现
Crc_Cfg.h	本文在这里声明了CRC驱动程序的配置数据。

---

第4章 配置文档

无

第5章 发布的参数

5.1 VendorId

• 语法: CRC_VENDOR_ID
• 类型: 宏定义 (#define)
• 文件: Crc.h
• 值: 76
• 描述:

5.2 ModuleId

• 语法: CRC_MODULE_ID
• 类型: 宏定义 (#define)
• 文件: Crc.h
• 值: 123
• 描述: 这个宏给出了CRC驱动模块ID，如AUTOSAR所述

5.3 InstanceId

• 语法: CRC_INSTANCE_ID
• 类型: 宏定义 (#define)
• 文件: Crc.h
• 值: 0
• 描述: 这个宏给出了CRC驱动实例ID，如AUTOSAR所述

5.4 SwMajorVersion

• 语法: CRC_SW_MAJOR_VERSION
• 类型: 宏定义 (#define)
• 文件: Crc.h
• 值: 取决于交付
• 描述: 供应商特定实现的主要版本号。如果驱动程序不再向下兼容（例如，现有API已更改），则增加MAJOR_VERSION

5.5 SwMinorVersion

• 语法: CRC_SW_MINOR_VERSION
• 类型: 宏定义 (#define)
• 文件: Crc.h
• 值: 取决于交付
• 描述: 供应商特定实现的次要版本号。如果驱动程序仍然向下兼容（例如，添加了新功能），则增加MINOR_VERSION

5.6 SwPatchVersion

• 语法: CRC_SW_PATCH_VERSION
• 类型: 宏定义 (#define)
• 文件: Crc.h
• 值: 取决于交付
• 描述: 供应商特定实现的补丁级别版本号。如果驱动程序仍然向上和向下兼容（例如，已修复的错误），则增加PATCH_VERSION

---

第6章 API文档

6.1 API类型定义

无

---

6.2 API函数

6.2.1 Crc_CalculateCRC8

• 服务名称: Crc_CalculateCRC8
• 语法: uint8 Crc_CalculateCRC8(const uint8 *Crc_DataPtr, uint32 Crc_Length, uint8 Crc_StartValue8, boolean Crc_IsFirstCall)
• 来源: 此API由AUTOSAR定义。
• 服务ID: 0x01
• 同步/异步: 同步
• 可重入: 不可重入
• 参数(输入): Crc_DataPtr - 计算数据指针
• 参数(输入): Crc_Length - 计算数据长度
• 参数(输入): Crc_StartValue8 - 输入参数
• 参数(输入): Crc_IsFirstCall - 是否第一次调用，true时，参数Crc_StartValue8无效；false时，参数Crc_StartValue8使用
• 参数(输出): 无
• 返回值: 校验值
• 描述: 8位SAE-J1850，CRC计算
• 注意事项: 无

6.2.2 Crc_CalculateCRC8H2F

• 服务名称: Crc_CalculateCRC8H2F
• 语法: uint8 Crc_CalculateCRC8H2F(const uint8 *Crc_DataPtr, uint32 Crc_Length, uint8 Crc_StartValue8, boolean Crc_IsFirstCall)
• 来源: 此API由AUTOSAR定义。
• 服务ID: 0x05
• 同步/异步: 同步
• 可重入: 不可重入
• 参数(输入): Crc_DataPtr - 计算数据指针
• 参数(输入): Crc_Length - 计算数据长度
• 参数(输入): Crc_StartValue8 - 输入参数
• 参数(输入): Crc_IsFirstCall - 是否第一次调用，true时，参数Crc_StartValue8无效；false时，参数Crc_StartValue8使用
• 参数(输出): 无
• 返回值: 校验值
• 描述: 8位0x2F多项式，CRC计算
• 注意事项: 无

6.2.3 Crc_CalculateCRC16

• 服务名称: Crc_CalculateCRC16
• 语法: uint16 Crc_CalculateCRC16(const uint8 *Crc_DataPtr, uint32 Crc_Length, uint16 Crc_StartValue16, boolean Crc_IsFirstCall)
• 来源: 此API由AUTOSAR定义。
• 服务ID: 0x02
• 同步/异步: 同步
• 可重入: 不可重入
• 参数(输入): Crc_DataPtr - 计算数据指针
• 参数(输入): Crc_Length - 计算数据长度
• 参数(输入): Crc_StartValue16 - 输入参数
• 参数(输入): Crc_IsFirstCall - 是否第一次调用，true时，参数Crc_StartValue8无效；false时，参数Crc_StartValue8使用
• 参数(输出): 无
• 返回值: 校验值
• 描述: 16位CCITT-FALSE，CRC计算
• 注意事项: 无

6.2.4 Crc_CalculateCRC16ARC

• 服务名称: Crc_CalculateCRC16ARC
• 语法: uint16 Crc_CalculateCRC16ARC(const uint8 *Crc_DataPtr, uint32 Crc_Length, uint16 Crc_StartValue16, boolean Crc_IsFirstCall)
• 来源: 此API由AUTOSAR定义。
• 服务ID: 0x08
• 同步/异步: 同步
• 可重入: 不可重入
• 参数(输入): Crc_DataPtr - 计算数据指针
• 参数(输入): Crc_Length - 计算数据长度
• 参数(输入): Crc_StartValue16 - 输入参数
• 参数(输入): Crc_IsFirstCall - 是否第一次调用，true时，参数Crc_StartValue8无效；false时，参数Crc_StartValue8使用
• 参数(输出): 无
• 返回值: 校验值
• 描述: 16位多项式0x8005，CRC计算
• 注意事项: 无

6.2.5 Crc_CalculateCRC32

• 服务名称: Crc_CalculateCRC32
• 语法: uint32 Crc_CalculateCRC32(const uint8 *Crc_DataPtr, uint32 Crc_Length, uint32 Crc_StartValue32, boolean Crc_IsFirstCall)
• 来源: 此API由AUTOSAR定义。
• 服务ID: 0x03
• 同步/异步: 同步
• 可重入: 不可重入
• 参数(输入): Crc_DataPtr - 计算数据指针
• 参数(输入): Crc_Length - 计算数据长度
• 参数(输入): Crc_StartValue32 - 输入参数
• 参数(输入): Crc_IsFirstCall - 是否第一次调用，true时，参数Crc_StartValue8无效；false时，参数Crc_StartValue8使用
• 参数(输出): 无
• 返回值: 校验值
• 描述: 32位以太网，CRC计算
• 注意事项: 无

6.2.6 Crc_CalculateCRC32P4

• 服务名称: Crc_CalculateCRC32P4
• 语法: uint32 Crc_CalculateCRC32P4(const uint8 *Crc_DataPtr, uint32 Crc_Length, uint32 Crc_StartValue32, boolean Crc_IsFirstCall)
• 来源: 此API由AUTOSAR定义。
• 服务ID: 0x03
• 同步/异步: 同步
• 可重入: 不可重入
• 参数(输入): Crc_DataPtr - 计算数据指针
• 参数(输入): Crc_Length - 计算数据长度
• 参数(输入): Crc_StartValue32 - 输入参数
• 参数(输入): Crc_IsFirstCall - 是否第一次调用，true时，参数Crc_StartValue8无效；false时，参数Crc_StartValue8使用
• 参数(输出): 无
• 返回值: 校验值
• 描述: 32位多项式0xF4ACFB13，CRC计算
• 注意事项: 无

6.2.7 Crc_GetVersionInfo

• 服务名称: Crc_GetVersionInfo
• 语法: void Crc_GetVersionInfo (Std_VersionInfoType* VersionInfo)
• 来源: 此API由AUTOSAR定义。
• 服务ID:0x04
• 同步/异步: 同步
• 可重入: 不可重入
• 参数(输入):无
• 参数(输出): VersionInfo-版本信息
• 返回值: 无
• 描述: 获取软件版本号
• 注意事项: 无

---

6.3 中断处理

无

---

6.4 专有区域（EA）信息

6.4.1 专有区域信息

CRC Driver没有提供专有区域。

---

第7章 数据描述

7.1 全局数据描述

以下是CRC Driver中使用的所有全局和静态变量的列表。

表80 全局数据描述

参数	类型/范围	描述
Crc8_ConfigInformation	Crc_ConfigType	Crc_CalculateCRC8多项式信息
Crc8_H2FConfigInformation	Crc_ConfigType	Crc_CalculateCRC8H2F多项式信息
Crc16_ConfigInformation	Crc_ConfigType	Crc_CalculateCRC16多项式信息
Crc16_ConfigInformation	Crc_ConfigType	Crc_CalculateCRC16ARC多项式信息
Crc32_ConfigInformation	Crc_ConfigType	Crc_CalculateCRC32多项式信息
Crc32P4_ConfigInformation	Crc_ConfigType	Crc_CalculateCRC32P4多项式信息

---

第8章 错误分类

8.1 错误代码和描述

无

表81 错误分类

无

---

第9章 示例用法

本章描述了如何在应用程序中使用CRC驱动器提供的不同的API。

9.1 系统时钟配置注意事项

无

9.2 宏配置

#define CRC_VERSION_INFO_API (STD_OFF)

9.3 接口使用示例

9.3.1 Crc_CalculateCRC8 分步计算

static uint8_t Crc_TestData6[4] = {0xFFU, 0xFFU, 0xFFU, 0xFFU};

uint8_t ignored_val = 0x01;
uint8_t resultSAE1;
uint8_t resultSAE2;

resultSAE2 = Crc_CalculateCRC8(&Crc_TestData6[0], 2U, ignored_val, TRUE);
resultSAE2 = Crc_CalculateCRC8(&Crc_TestData6[2], 1U, resultSAE2, FALSE);
resultSAE2 = Crc_CalculateCRC8(&Crc_TestData6[3], 1U, resultSAE2, FALSE);
kf_printf("CRC8 several step result:0x%02x\r\n", resultSAE2);

9.3.2 Crc_CalculateCRC8 一步计算

static uint8_t Crc_TestData6[4] = {0xFFU, 0xFFU, 0xFFU, 0xFFU};

uint8_t ignored_val = 0x01;
uint8_t resultSAE1;
uint8_t resultSAE2;

resultSAE1 = Crc_CalculateCRC8(&Crc_TestData6[0], 4U, ignored_val, TRUE);
kf_printf("CRC8 several step result:0x%02x\r\n", resultSAE2);

9.3.3 Crc_CalculateCRC8H2F 分步计算

static uint8_t Crc_TestData6[4] = {0xFFU, 0xFFU, 0xFFU, 0xFFU};

uint8_t ignored_val = 0x01;
uint8_t resultSAE1;
uint8_t resultSAE2;

resultSAE2 = Crc_CalculateCRC8H2F(&Crc_TestData6[0], 2U, ignored_val, TRUE);
resultSAE2 = Crc_CalculateCRC8H2F(&Crc_TestData6[2], 1U, resultSAE2, FALSE);
resultSAE2 = Crc_CalculateCRC8H2F(&Crc_TestData6[3], 1U, resultSAE2, FALSE);
kf_printf("CRC8 several step result:0x%02x\r\n", resultSAE2);

9.3.4 Crc_CalculateCRC8H2F 一步计算

static uint8_t Crc_TestData6[4] = {0xFFU, 0xFFU, 0xFFU, 0xFFU};

uint8_t ignored_val = 0x01;
uint8_t resultSAE1;
uint8_t resultSAE2;

resultSAE1 = Crc_CalculateCRC8H2F(&Crc_TestData6[0], 4U, ignored_val, TRUE);
kf_printf("CRC8 several step result:0x%02x\r\n", resultSAE2);

9.3.5 Crc_CalculateCRC16 分步计算

static uint8_t Crc_TestData6[4] = {0xFFU, 0xFFU, 0xFFU, 0xFFU};

uint16_t ignored_val = 0x01;
uint16_t resultSAE1;
uint16_t resultSAE2;

resultSAE2 = Crc_CalculateCRC16(&Crc_TestData6[0], 2U, ignored_val, TRUE);
resultSAE2 = Crc_CalculateCRC16(&Crc_TestData6[2], 1U, resultSAE2, FALSE);
resultSAE2 = Crc_CalculateCRC16(&Crc_TestData6[3], 1U, resultSAE2, FALSE);
kf_printf("CRC8 several step result:0x%02x\r\n", resultSAE2);

9.3.6 Crc_CalculateCRC16 一步计算

static uint8_t Crc_TestData6[4] = {0xFFU, 0xFFU, 0xFFU, 0xFFU};

uint16_t ignored_val = 0x01;
uint16_t resultSAE1;
uint16_t resultSAE2;

resultSAE1 = Crc_CalculateCRC16(&Crc_TestData6[0], 4U, ignored_val, TRUE);
kf_printf("CRC8 several step result:0x%02x\r\n", resultSAE2);

9.3.7 Crc_CalculateCRC16ARC 分步计算

static uint8_t Crc_TestData6[4] = {0xFFU, 0xFFU, 0xFFU, 0xFFU};

uint16_t ignored_val = 0x01;
uint16_t resultSAE1;
uint16_t resultSAE2;

resultSAE2 = Crc_CalculateCRC16ARC(&Crc_TestData6[0], 2U, ignored_val, TRUE);
resultSAE2 = Crc_CalculateCRC16ARC(&Crc_TestData6[2], 1U, resultSAE2, FALSE);
resultSAE2 = Crc_CalculateCRC16ARC(&Crc_TestData6[3], 1U, resultSAE2, FALSE);
kf_printf("CRC8 several step result:0x%02x\r\n", resultSAE2);

9.3.8 Crc_CalculateCRC16ARC 一步计算

static uint8_t Crc_TestData6[4] = {0xFFU, 0xFFU, 0xFFU, 0xFFU};

uint16_t ignored_val = 0x01;
uint16_t resultSAE1;
uint16_t resultSAE2;

resultSAE1 = Crc_CalculateCRC16ARC(&Crc_TestData6[0], 4U, ignored_val, TRUE);
kf_printf("CRC8 several step result:0x%02x\r\n", resultSAE2);

9.3.9 Crc_CalculateCRC32 分步计算

static uint8_t Crc_TestData6[4] = {0xFFU, 0xFFU, 0xFFU, 0xFFU};

uint32_t ignored_val = 0x01;
uint32_t resultSAE1;
uint32_t resultSAE2;

resultSAE2 = Crc_CalculateCRC32(&Crc_TestData6[0], 2U, ignored_val, TRUE);
resultSAE2 = Crc_CalculateCRC32(&Crc_TestData6[2], 1U, resultSAE2, FALSE);
resultSAE2 = Crc_CalculateCRC32(&Crc_TestData6[3], 1U, resultSAE2, FALSE);
kf_printf("CRC8 several step result:0x%02x\r\n", resultSAE2);

9.3.10 Crc_CalculateCRC32 一步计算

static uint8_t Crc_TestData6[4] = {0xFFU, 0xFFU, 0xFFU, 0xFFU};

uint32_t ignored_val = 0x01;
uint32_t resultSAE1;
uint32_t resultSAE2;

resultSAE1 = Crc_CalculateCRC32(&Crc_TestData6[0], 4U, ignored_val, TRUE);
kf_printf("CRC8 several step result:0x%02x\r\n", resultSAE2);

9.3.11 Crc_CalculateCRC32P4 分步计算

static uint8_t Crc_TestData6[4] = {0xFFU, 0xFFU, 0xFFU, 0xFFU};

uint32_t ignored_val = 0x01;
uint32_t resultSAE1;
uint32_t resultSAE2;

resultSAE2 = Crc_CalculateCRC32P4(&Crc_TestData6[0], 2U, ignored_val, TRUE);
resultSAE2 = Crc_CalculateCRC32P4(&Crc_TestData6[2], 1U, resultSAE2, FALSE);
resultSAE2 = Crc_CalculateCRC32P4(&Crc_TestData6[3], 1U, resultSAE2, FALSE);
kf_printf("CRC8 several step result:0x%02x\r\n", resultSAE2);

9.3.12 Crc_CalculateCRC32P4 一步计算

static uint8_t Crc_TestData6[4] = {0xFFU, 0xFFU, 0xFFU, 0xFFU};

uint32_t ignored_val = 0x01;
uint32_t resultSAE1;
uint32_t resultSAE2;

resultSAE1 = Crc_CalculateCRC32P4(&Crc_TestData6[0], 4U, ignored_val, TRUE);
kf_printf("CRC8 several step result:0x%02x\r\n", resultSAE2);

9.4 配置示例

无

---

第10章 限制和假设

10.1 假设和与软件规格的偏差

表82 假设

序号	参考	假设
1	通用
2	通用

偏差

考虑的Bugzilla

• Crc_CalculateCRC64函数未实现。

10.2 限制

10.2.1