#![no_std]
#![forbid(unsafe_code)]
#![warn(missing_docs)]
pub mod bits;
pub mod crc;
pub mod error;
pub mod frame;
pub mod message;
pub use error::Rtcm3Error;
pub use frame::Frame;
pub use message::Rtcm3Message;
pub fn decode(buf: &[u8]) -> Result<Rtcm3Message, Rtcm3Error> {
let frame = Frame::parse(buf)?;
Ok(Rtcm3Message::decode(frame.payload())?)
}
pub fn encode(message: &Rtcm3Message, buf: &mut [u8]) -> Result<usize, Rtcm3Error> {
let mut payload = [0u8; 1023];
let payload_len = message.encode(&mut payload)?;
Ok(frame::encode(buf, &payload[..payload_len])?)
}
#[cfg(test)]
mod tests {
use super::*;
fn hex_decode<const N: usize>(hex: &str) -> [u8; N] {
let mut out = [0u8; N];
for (i, chunk) in hex.as_bytes().chunks(2).enumerate() {
let s = core::str::from_utf8(chunk).unwrap();
out[i] = u8::from_str_radix(s, 16).unwrap();
}
out
}
#[test]
fn decodes_a_real_captured_frame() {
let buf: [u8; 25] = hex_decode("d300133ed000038a58d9493c872f34109d07d6af48205ad7f7");
let msg = decode(&buf).unwrap();
let Rtcm3Message::StationArp(m) = msg else {
panic!("expected StationArp");
};
assert_eq!(m.reference_station_id, 0);
assert!((m.x_meters() - 4_444_030.802_8).abs() < 1e-3);
}
#[test]
fn encode_round_trips() {
let original = Rtcm3Message::StationArp(message::StationArp {
reference_station_id: 42,
itrf_realization_year: 19,
gps_indicator: true,
glonass_indicator: true,
galileo_indicator: false,
reference_station_indicator: false,
ecef_x_raw: 44_440_308_028,
single_oscillator_indicator: false,
ecef_y_raw: 30_856_712_349,
quarter_cycle_indicator: 1,
ecef_z_raw: 33_666_582_560,
});
let mut buf = [0u8; frame::MAX_FRAME_LEN];
let n = encode(&original, &mut buf).unwrap();
assert_eq!(decode(&buf[..n]).unwrap(), original);
}
}