Class CRC

CRC (Cyclic Redundancy Check) class for computing various CRC algorithms.

This class provides a comprehensive implementation of CRC calculation algorithms commonly used in automotive diagnostics, communication protocols, and data integrity verification. It supports 8-bit, 16-bit, and 32-bit CRC calculations with configurable parameters including polynomial, initial value, final XOR value, and reflection settings.

The class includes a comprehensive set of predefined CRC algorithms and allows custom CRC configurations for specific use cases.

Example

// Using predefined CRC algorithms
const crc16Modbus = CRC.default('CRC16_MODBUS')
if (crc16Modbus) {
  const data = Buffer.from([0x01, 0x02, 0x03, 0x04])
  const crcValue = crc16Modbus.compute(data)
  console.log(`CRC16-MODBUS: 0x${crcValue.toString(16).padStart(4, '0')}`)
}

// Creating custom CRC configuration (like in bootloader.ts)
const customCrc = new CRC('self', 16, 0x3d65, 0, 0xffff, true, true)
const fileContent = await fs.readFile('firmware.bin')
const crcResult = customCrc.compute(fileContent)

// Computing CRC for different data types
const crc32 = CRC.default('CRC32')
if (crc32) {
  // From number array
  const arrayData = [0x48, 0x65, 0x6c, 0x6c, 0x6f] // "Hello"
  const crcFromArray = crc32.compute(arrayData)

  // From Buffer
  const bufferData = Buffer.from('Hello', 'utf8')
  const crcFromBuffer = crc32.compute(bufferData)

  // Get CRC as Buffer (useful for network protocols)
  const crcBuffer = crc32.computeBuffer(bufferData)
}

Constructors

constructor

Accessors

finalXor initial inputReflected name polynomial resultReflected table width defaults

Methods

compute computeBuffer buildInCrc default

Constructors

constructor

  • new CRC(
        name: string,
        width: number,
        polynomial: number,
        initial: number,
        finalXor: number,
        inputReflected: boolean,
        resultReflected: boolean,
    ): CRC

  • Creates an instance of the CRC (Cyclic Redundancy Check) class.

    Parameters

    • name: string

      The name of the CRC algorithm.

    • width: number

      The width of the CRC in bits.

    • polynomial: number

      The polynomial used for the CRC calculation.

    • initial: number

      The initial value for the CRC calculation.

    • finalXor: number

      The value to XOR with the final CRC value.

    • inputReflected: boolean

      Whether the input bytes should be reflected.

    • resultReflected: boolean

      Whether the result should be reflected.

    Returns CRC

Accessors

finalXor

  • get finalXor(): number

  • Returns number

  • set finalXor(v: number): void

  • Parameters

    • v: number

    Returns void

initial

  • get initial(): number

  • Returns number

  • set initial(v: number): void

  • Parameters

    • v: number

    Returns void

inputReflected

  • get inputReflected(): boolean

  • Returns boolean

  • set inputReflected(v: boolean): void

  • Parameters

    • v: boolean

    Returns void

name

  • get name(): string

  • Returns string

  • set name(v: string): void

  • Parameters

    • v: string

    Returns void

polynomial

  • get polynomial(): number

  • Returns number

  • set polynomial(v: number): void

  • Parameters

    • v: number

    Returns void

resultReflected

  • get resultReflected(): boolean

  • Returns boolean

  • set resultReflected(v: boolean): void

  • Parameters

    • v: boolean

    Returns void

table

  • get table(): number[]

  • Returns number[]

width

  • get width(): number

  • Returns number

  • set width(v: number): void

  • Parameters

    • v: number

    Returns void

Staticdefaults

  • get defaults(): CRC[]

  • Returns a list of default CRC configurations.

    The list includes various CRC algorithms with their respective parameters:

    • Name: The name of the CRC algorithm.
    • Width: The width of the CRC (number of bits).
    • Polynomial: The polynomial used for the CRC calculation.
    • Initial Value: The initial value for the CRC calculation.
    • Final XOR Value: The value to XOR with the final CRC value.
    • Reflect Input: Whether to reflect the input bytes.
    • Reflect Output: Whether to reflect the output CRC value.

    Returns CRC[]

    An array of CRC configurations.

Methods

compute

  • compute(bytes: number[] | Buffer): number

  • Computes the CRC (Cyclic Redundancy Check) value for the given input bytes.

    Parameters

    • bytes: number[] | Buffer

      The input data as an array of numbers or a Buffer.

    Returns number

    • The computed CRC value.

computeBuffer

  • computeBuffer(bytes: number[] | Buffer): Buffer

  • Parameters

    • bytes: number[] | Buffer

    Returns Buffer

StaticbuildInCrc

  • buildInCrc(name: string): undefined | CRC

  • Get built-in CRC by name

    Available built-in CRCs:

    Name Width Polynomial Initial Final XOR Input Reflected Result Reflected
    CRC8 8 0x07 0x00 0x00 false false
    CRC8_SAE_J1850 8 0x1d 0xff 0xff false false
    CRC8_SAE_J1850_ZERO 8 0x1d 0x00 0x00 false false
    CRC8_8H2F 8 0x2f 0xff 0xff false false
    CRC8_CDMA2000 8 0x9b 0xff 0x00 false false
    CRC8_DARC 8 0x39 0x00 0x00 true true
    CRC8_DVB_S2 8 0xd5 0x00 0x00 false false
    CRC8_EBU 8 0x1d 0xff 0x00 true true
    CRC8_ICODE 8 0x1d 0xfd 0x00 false false
    CRC8_ITU 8 0x07 0x00 0x55 false false
    CRC8_MAXIM 8 0x31 0x00 0x00 true true
    CRC8_ROHC 8 0x07 0xff 0x00 true true
    CRC8_WCDMA 8 0x9b 0x00 0x00 true true
    CRC16_CCIT_ZERO 16 0x1021 0x0000 0x0000 false false
    CRC16_ARC 16 0x8005 0x0000 0x0000 true true
    CRC16_AUG_CCITT 16 0x1021 0x1d0f 0x0000 false false
    CRC16_BUYPASS 16 0x8005 0x0000 0x0000 false false
    CRC16_CCITT_FALSE 16 0x1021 0xffff 0x0000 false false
    CRC16_CDMA2000 16 0xc867 0xffff 0x0000 false false
    CRC16_DDS_110 16 0x8005 0x800d 0x0000 false false
    CRC16_DECT_R 16 0x0589 0x0000 0x0001 false false
    CRC16_DECT_X 16 0x0589 0x0000 0x0000 false false
    CRC16_DNP 16 0x3d65 0x0000 0xffff true true
    CRC16_EN_13757 16 0x3d65 0x0000 0xffff false false
    CRC16_GENIBUS 16 0x1021 0xffff 0xffff false false
    CRC16_MAXIM 16 0x8005 0x0000 0xffff true true
    CRC16_MCRF4XX 16 0x1021 0xffff 0x0000 true true
    CRC16_RIELLO 16 0x1021 0xb2aa 0x0000 true true
    CRC16_T10_DIF 16 0x8bb7 0x0000 0x0000 false false
    CRC16_TELEDISK 16 0xa097 0x0000 0x0000 false false
    CRC32 32 0x04c11db7 0xffffffff 0xffffffff true true
    CRC32_BZIP2 32 0x04c11db7 0xffffffff 0xffffffff false false
    CRC32_C 32 0x1edc6f41 0xffffffff 0xffffffff true true
    CRC32_D 32 0xa833982b 0xffffffff 0xffffffff true true
    CRC32_MPEG2 32 0x04c11db7 0xffffffff 0x00000000 false false
    CRC32_POSIX 32 0x04c11db7 0x00000000 0xffffffff false false
    CRC32_Q 32 0x814141ab 0x00000000 0x00000000 false false
    CRC32_JAMCRC 32 0x04c11db7 0xffffffff 0x00000000 true true
    CRC32_XFER 32 0x000000af 0x00000000 0x00000000 false false

    Parameters

    • name: string

      The name of the CRC algorithm to retrieve

    Returns undefined | CRC

    The CRC instance if found, undefined otherwise

Staticdefault

  • default(name: string): undefined | CRC

  • Retrieves a CRC object from the defaults list by its name.

    Parameters

    • name: string

      The name of the CRC object to find.

    Returns undefined | CRC

    The CRC object with the specified name, or undefined if not found.

Settings

Member Visibility

On This Page

Constructors
Accessors
Methods