swaits
4cccb65124
The wire protocol is re-specified as DongLoRa Protocol v2 (see PROTOCOL.md). Every type_id, tag-correlation rule, and field layout is incompatible with 0.1.0. * Add PROTOCOL.md as the normative spec for the v2 wire format. * Replace framing.rs with a streaming FrameDecoder that emits (type_id, tag, payload) triples on each COBS-delimited, CRC-checked frame. * Split the single-file lib.rs into dedicated modules: frame, commands, events, errors, modulation, info, crc, chip_id. Re-exports preserve convenience imports at the crate root. * Replace RadioConfig / Bandwidth with a Modulation enum covering LoRa, FSK/GFSK, LR-FHSS, and FLRC, each with its own typed parameter struct. * Add TxFlags, RxOrigin, SetConfigResult, OkPayload to model v2 response shapes, and RadioChipId for GET_INFO. * Rewrite fuzz corpus: replace the 4 cobs_* / command_roundtrip targets with decoder_feed, frame_roundtrip, lora_config_roundtrip, and parse_device_message; drop parse_radio_config. * Expand proptest and mutation-killer coverage for the new wire shape. * Rewrite canonical-byte test vectors against the v2 spec.
45 lines
1.2 KiB
Rust
45 lines
1.2 KiB
Rust
//! An arbitrary well-formed `(type_id, tag, payload)` must survive a
|
|
//! frame encode → decode round trip byte-for-byte.
|
|
|
|
#![no_main]
|
|
|
|
use arbitrary::Arbitrary;
|
|
use donglora_protocol::{FrameDecoder, FrameResult, MAX_PAYLOAD_FIELD, MAX_WIRE_FRAME, encode_frame};
|
|
use libfuzzer_sys::fuzz_target;
|
|
|
|
#[derive(Debug, Arbitrary)]
|
|
struct Input<'a> {
|
|
type_id: u8,
|
|
tag: u16,
|
|
payload: &'a [u8],
|
|
}
|
|
|
|
fuzz_target!(|input: Input| {
|
|
if input.payload.len() > MAX_PAYLOAD_FIELD {
|
|
return;
|
|
}
|
|
let mut wire = [0u8; MAX_WIRE_FRAME];
|
|
let Ok(n) = encode_frame(input.type_id, input.tag, input.payload, &mut wire) else {
|
|
return;
|
|
};
|
|
|
|
let mut decoder = FrameDecoder::new();
|
|
let mut matched = false;
|
|
decoder.feed(&wire[..n], |res| {
|
|
if let FrameResult::Ok {
|
|
type_id,
|
|
tag,
|
|
payload,
|
|
} = res
|
|
{
|
|
assert_eq!(type_id, input.type_id);
|
|
assert_eq!(tag, input.tag);
|
|
assert_eq!(payload, input.payload);
|
|
matched = true;
|
|
} else {
|
|
panic!("encode→decode produced a frame error: {:?}", res);
|
|
}
|
|
});
|
|
assert!(matched, "encoded frame did not decode");
|
|
});
|