Skip to content

JavaScript NPM package for 8 bit, 16bit, 32bit and 64 bit CRC functions as specified by the AUTOSAR standard, written with C++

License

Notifications You must be signed in to change notification settings

richhaar/autosar-crc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AUTOSAR-CRC

A C++ implemented set of 8,16,32,64 bit cyclic redundancy check (CRC) functions conforming to the CRC spec given by AUTOSAR. Written in C++ and compiled as a 'C++ addon' for use in JavaScript. Available on NPM.

Getting Started

These instructions will get you up and running using the autosar-crc node module on your local machine.

Prerequisites

To get going you need the following installed:

  • NodeJS
  • npm
  • c++17 compiler

Installing

Autosar-crc is available on the npm registry, so within your console you can install autosar-crc.

npm install autosar-crc

Different types of CRC

Autosar-crc provides the following:

const autocrc = require('autosar-crc');

console.log(autocrc.crc8('123456789'));
console.log(autocrc.crc8_h2f('123456789'));
console.log(autocrc.crc16('123456789'));
console.log(autocrc.crc32('123456789'));
console.log(autocrc.crc32_p4('123456789'));
console.log(autocrc.crc64('123456789'));
node example.js 

You should get the following result:

75
223
10673
3421780262
379048042
11051210869376104000

The polynomials of the CRC match the spec given in the AUTOSAR standard, see crc_tables.h for specifics on the polynomials.

Each CRC accepts the following types:

  • String
  • TypedArray
  • ArrayBuffer
const autocrc = require('autosar-crc');

const arr = new Uint8Array([0x31,0x32,0x33,0x34,0x35,0x36,0x37,0x38,0x39]);

console.log(autocrc.crc8(arr));
console.log(autocrc.crc8(arr.buffer));
console.log(autocrc.crc8('123456789'))

Should give you the following result (note: 0x31 is hex for 1):

75
75
75

Benchmarks

Running crc32 over the entire works of Shakespeare 100x on a MacBook Air gives the following:

autosar-crc: 2.442s
crc: 3.293s
crc32: 56.973s

Running the tests

The tests are found in the main.test.js file and are run with Jest.

Break down into end to end tests

The test script is defined in package.json so you can run:

npm test

Built With

Authors

  • Richard Haar - Initial work - richhaar

License

This project is licensed under the ISC License - see the LICENSE file for details

Acknowledgments

  • Bastian Molkenthin for the table generation here

About

JavaScript NPM package for 8 bit, 16bit, 32bit and 64 bit CRC functions as specified by the AUTOSAR standard, written with C++

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published