dvb-bbframe 4.0.0

ETSI DVB-S2 / S2X / T2 BBFrame parser + builder.
Documentation

dvb_bbframe

ETSI DVB-S2 / S2X / T2 Base-Band Frame (BBFRAME) parser and builder, supporting both Normal Mode (NM) and High Efficiency Mode (HEM).

A BBFRAME is the unit of payload carried in a DVB-S2/S2X/T2 baseband stream: a 10-byte BBHEADER followed by a data field of user packets (a Transport Stream or Generic Stream). This crate parses and rebuilds the header and walks the data field; it does not implement the physical layer (LDPC/BCH coding, modulation).

Coverage

Module Purpose
header Bbheader — the 10-byte BBHEADER (MATYPE-1/2, UPL, DFL, SYNC, SYNCD, CRC-8), parse + serialize. Decodes Mode (NM/HEM), TsGs, and the MATYPE flags (SIS/MIS, CCM/ACM, ISSYI, NPD, ext, ISI).
packet up_iter — user-packet extraction from the data field, honouring SYNCD and the UPL stride.
crc crc8 — CRC-8 per EN 302 307-1 §5.1.4 / EN 302 755 Annex F. The NM/HEM mode is recovered from computed_crc8 ^ stored_byte.
issy ISSY (Input Stream Synchronizer) field parser, EN 302 755 Annex C.

Features

Feature Default Description
serde off Serialize-only — Serialize on Bbheader, Matype, TsGs, Mode, Issy (JSON via serde_json); parsing FROM JSON is deliberately unsupported, re-parse from wire bytes
yoke off yoke::Yokeable on the zero-copy user-packet iterator view types (NmTsIter, HemTsIter) so a parsed view can outlive its input buffer's borrow without a re-parse

no_std is not supported (thiserror requires std).

Principles

  • Spec fidelity — every BBHEADER field is exposed; bit positions match EN 302 307-1 / EN 302 755.
  • Parse and construct — Bbheader round-trips: parse → serialize → parse is identity (CRC included).
  • No magic numbers — every hex literal outside tests is a named constant or enum.

Usage

use dvb_bbframe::header::{Bbheader, Mode};

let hdr = Bbheader::parse(frame)?;
assert_eq!(hdr.mode, Mode::Normal);
println!("UPL={} DFL={} SYNC=0x{:02X}", hdr.upl, hdr.dfl, hdr.sync);

Authoritative references

  • ETSI EN 302 307-1 (DVB-S2) / EN 302 307-2 (DVB-S2X)
  • ETSI EN 302 755 (DVB-T2) — §5.1.7 (HEM), Annex C (ISSY), Annex F (CRC-8)

The structured spec reference is under docs/; the canonical PDFs are vendored in the workspace specs/ directory.

License

Licensed under either of MIT (LICENSE-MIT) or Apache-2.0 (LICENSE-APACHE), at your option.