embedded-crc-macros

Crates.ioembedded-crc-macros
lib.rsembedded-crc-macros
version1.0.0
sourcesrc
created_at2020-08-09 08:19:37.897207
updated_at2021-05-13 07:12:00.65805
descriptionMacros implementing portable CRC calculation algorithms for use in no_std.
homepagehttps://github.com/eldruin/embedded-crc-macros-rs
repositoryhttps://github.com/eldruin/embedded-crc-macros-rs
max_upload_size
id274576
size62,580
Diego Barrios Romero (eldruin)

documentation

https://docs.rs/embedded-crc-macros

README

Rust Portable CRC Calculation Macros

crates.io Docs Build Status Coverage Status

This crate provides macros that define portable CRC-8 algorithm implementations with the parameters directly provided at compile time and without any dependencies. Intended for use in no_std.

How this crate compares to others

There is a number of crates implementing CRC algorithms but their intention is to be configurable, generic, use acceleration via SIMD instructions, etc.

This crate provides macros that define portable and non-configurable CRC-8 algorithm implementations with the parameters provided at compile time (optionally using a pre-calculated lookup table) and without any dependencies.

This should allow the compiler to make good optimizations and allows for use of the algorithm in any target architecture with minimal code bloat.

Furthermore, this crate provides macros to generate the lookup tables on build time.

This makes this crate specially well suited for use in no_std environments.

Usage

use embedded_crc_macros::crc8;

crc8!(fn pec, 7 /* x^8+x^2+x+1 */, 0, "SMBus Packet Error Code");

const ADDRESS: u8 = 0x5A;
const REGISTER: u8 = 0x06;

fn main() {
    let crc = pec(&[ADDRESS << 1, REGISTER, 0xAB, 0xCD]);
    println!("PEC: {}", crc); // prints 95
}

Support

For questions, issues, feature requests, other changes, or just feedback, please file an issue in the github project.

License

Licensed under either of

at your option.

Contributing

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Commit count: 24

cargo fmt