#[allow(dead_code)] pub(crate) trait Checksum: Send + Sync {
fn width(&self) -> usize;
fn compute(&self, bytes: &[u8]) -> Vec<u8>;
fn validate(&self, bytes: &[u8], received: &[u8]) -> bool {
let computed = self.compute(bytes);
computed == received
}
}
pub(crate) struct XorChecksum;
impl Checksum for XorChecksum {
fn width(&self) -> usize {
1
}
fn compute(&self, bytes: &[u8]) -> Vec<u8> {
let mut acc: u8 = 0;
for &b in bytes {
acc ^= b;
}
vec![acc]
}
}
pub(crate) struct Lrc;
impl Checksum for Lrc {
fn width(&self) -> usize {
1
}
fn compute(&self, bytes: &[u8]) -> Vec<u8> {
let sum: u8 = bytes.iter().fold(0u8, |acc, &b| acc.wrapping_add(b));
let lrc = sum.wrapping_neg();
vec![lrc]
}
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn xor_checksum_empty_returns_zero() {
let cs = XorChecksum.compute(b"");
assert_eq!(cs, vec![0x00]);
}
#[test]
fn xor_checksum_known_nmea_sentence() {
let body = b"GPGLL,3751.65,N,12226.54,W";
let cs = XorChecksum.compute(body);
assert_eq!(cs, vec![0x7E]);
}
#[test]
fn xor_checksum_validate_matches_compute() {
let data = b"GPGLL,3751.65,N,12226.54,W";
let cs = XorChecksum.compute(data);
assert!(XorChecksum.validate(data, &cs));
assert!(!XorChecksum.validate(data, &[0x00]));
}
#[test]
fn xor_checksum_width_is_one() {
assert_eq!(XorChecksum.width(), 1);
}
#[test]
fn lrc_empty_returns_zero() {
let cs = Lrc.compute(b"");
assert_eq!(cs, vec![0x00]);
}
#[test]
fn lrc_known_modbus_request() {
let cs = Lrc.compute(&[0x01, 0x03, 0x00, 0x00, 0x00, 0x01]);
assert_eq!(cs, vec![0xFB]);
}
#[test]
fn lrc_validate_matches_compute() {
let data = b"test";
let cs = Lrc.compute(data);
assert!(Lrc.validate(data, &cs));
assert!(!Lrc.validate(data, &[0x00]));
}
#[test]
fn lrc_width_is_one() {
assert_eq!(Lrc.width(), 1);
}
#[test]
fn lrc_wraps_on_overflow() {
let cs = Lrc.compute(&[0xFF, 0x02]);
assert_eq!(cs, vec![0xFF]);
}
}