<think>我们参考了用户提供的引用[1][2][3][4]，这些引用展示了crcmod库中predefined模块下Crc类的使用示例。 根据这些示例，我们可以总结出Crc类的基本使用方法： 1. 创建Crc对象：可以通过指定预定义的CRC算法名称（如'crc-8-maxim'、'modbus'、'xmodem'等）来创建Crc对象。 2. 更新数据：使用update方法传入需要计算CRC的数据（字节类型）。 3. 获取结果：通过crcValue属性获取整数形式的CRC值，也可以通过hexdigest()方法获取十六进制字符串形式的CRC值。 另外，引用中还展示了使用mkPredefinedCrcFun函数（即通过crcmod.predefined.mkPredefinedCrcFun）来创建CRC计算函数，这种方式可以直接调用函数计算，但用户本次询问的是Crc类的使用。 因此，我们将重点介绍Crc类的使用步骤，并给出一个完整的示例。 注意：用户需要确保已经安装了crcmod库（可以使用pip install crcmod安装）。 下面我们将详细介绍Crc类的使用： </think> ### Python `crcmod.predefined.Crc` 类使用指南 `crcmod.predefined.Crc` 类提供了预定义 CRC 算法的实现，支持多种标准校验算法（如 CRC-8、CRC-16、CRC-32 等）。以下是核心使用方法： #### 1. **基本使用流程** ```python import crcmod.predefined from binascii import unhexlify # 步骤1: 创建Crc对象（指定算法名称） crc_calculator = crcmod.predefined.Crc('crc-16-modbus') # 示例使用Modbus CRC # 步骤2: 更新数据（支持多次调用update） data = b'Hello, CRC!' # 字节类型数据 crc_calculator.update(data) # 步骤3: 获取校验结果 print(crc_calculator.crcValue) # 输出: 整数形式的CRC值 (如 27901) print(crc_calculator.hexdigest()) # 输出: 十六进制字符串 (如 '6cfd') ``` #### 2. **支持算法列表** 通过 `crcmod.predefined._crc_definitions` 查看所有预定义算法： ```python print(crcmod.predefined._crc_definitions.keys()) # 输出示例: ['crc-8', 'crc-16-modbus', 'crc-32', 'xmodem', ...] ``` #### 3. **处理十六进制数据** ```python hex_data = '1A2B3C4D' # 十六进制字符串 → 字节转换 bytes_data = unhexlify(hex_data) crc8 = crcmod.predefined.Crc('crc-8-maxim') crc8.update(bytes_data) print(f"CRC-8-Maxim: {crc8.hexdigest()}") ``` #### 4. **完整示例：Modbus CRC 校验** ```python # 创建Modbus CRC计算器 modbus_crc = crcmod.predefined.Crc('modbus') # 添加数据（可分段） modbus_crc.update(b'\x01\x03') # 功能码 modbus_crc.update(b'\x00\x01\x00\x02') # 数据域 # 获取结果（低字节在前） crc_bytes = modbus_crc.digest() # 字节形式结果 (如 b'\x85\x6B') crc_hex = modbus_crc.hexdigest() # 十六进制 (如 '856B') ``` #### 5. **关键方法说明** | 方法/属性 | 说明 | |------------------|----------------------------------------------------------------------| | `update(data)` | 添加字节数据（可多次调用） | | `crcValue` | 整数形式的CRC结果 (e.g., `34256`) | | `hexdigest()` | 十六进制字符串 (e.g., `'85AB'`) | | `digest()` | 字节形式的CRC结果 (e.g., `b'\x85\xAB'`) | | `new([data])` | 创建相同配置的新对象（可选初始数据）[^3] | #### 6. **注意事项** 1. **输入数据类型**：`update()` 只接受 `bytes` 或 `bytearray`，字符串需编码： ```python text = "Hello" crc_calculator.update(text.encode('utf-8')) ``` 2. **算法名称规范**：使用预定义名称（如 `'crc-32'`, `'xmodem'`），完整列表见[文档](https://crcmod.sourceforge.net/crcmod.predefined.html)[^2][^4]。 3. **重置计算器**：每次计算后需重新创建对象或使用 `new()` > 引用示例：`crcmod.predefined.Crc('modbus')` 可直接用于工业协议校验[^4]。