crc-full

Description

The crc-full module is used to calculate any kind of CRC setting parameters such as length, polynomial and others. It's completely written in typescript for node js.

How to use

Use is very simple. Just add the module to project.

Install dependencies:
The only one dependency is typescript compiler

npm install -g typescript

Import in node js

After typescript is installed, simple run:

npm install crc-full

Use in your project

First of all import the module in your project files, then create an instance of the class whith all parameters of the CRC algorithm you need. After the instance is create you can compute the CRC of your data passing an array of byte or simply a buffer object.

For typescript use:

import {CRC} from 'crc-full'
...
let crc =  new CRC("CRC16", 16, 0x8005, 0x0000, 0x0000, false, false);
crc.compute([0x48, 0x65, 0x6c, 0x6c, 0x6f, 0x20, 0x77, 0x6f, 0x72, 0x6c, 0x64, 0x21]);
let computed_crc = crc.compute(Buffer.from("Hello world!","ascii"))

For javascript use:

const CRC = require('crc-full').CRC;
var crc = new CRC("CRC16", 16, 0x8005, 0x0000, 0x0000, false, false);
crc.compute([0x48, 0x65, 0x6c, 0x6c, 0x6f, 0x20, 0x77, 0x6f, 0x72, 0x6c, 0x64, 0x21]);
var computed_crc = crc.compute(Buffer.from("Hello world!", "ascii"))

Where the parameters in the constructor are:

• Length: the Length of CRC in bit (8,16,32)
• Name: friendly name for the configuration
• Polinomial: the polinomial used to compute CRC
• InitialValue: initial value of CRC
• FinalXorValue: final value of CRC
• InputReflected: boolen that indicate if need to reflect input
• OutputReflected: boolen that indicate if need to reflect input

Presets

Invoking the static getter defaults is possible to use the internal preconfigurated CRC algorithms. An array of instantiated object is returned back

The algorithms are:

Is possible to use one of above CRC preset using the method default(name) where parameter name is the name of chosen preset.

Typescript users can use:

import {CRC} from 'crc-full'
let crc = CRC.default("CRC16_CCIT_ZERO");
let computed_crc = crc.compute(Buffer.from("Hello world!","ascii"))

Typescript users can use:

const CRC = require('crc-full').CRC;
var crc = CRC.default("CRC16_CCIT_ZERO");
var computed_crc = crc.compute(Buffer.from("Hello world!","ascii"))

Advanced

The module also support advanced methods to calculate CRC tables and export them as byte arrays:

...
crc.makeCrcTable();
crc.makeCrcTableReversed();
var table = crc.table;
...

Notes

The method compute take a byte array (or Buffer) as input and returns a number.
If you need to convert a string you have to pass it as a byte array.
If you need to read the CRC result in hex format string use .toString(16)