Crate dvb_t2mi 

ETSI TS 102 773 v1.4.1 DVB-T2 Modulator Interface (T2-MI) parser + builder.

Entry points:

• Parse / Serialize — the two symmetric contracts every payload type implements.
• packet — T2-MI packet header and type parsing.
• payload — BBFrame, L1, FEF, timestamp, and addressing payload types.
• crc — CRC-32 per Annex A.

RFU policy

Payload parsers REJECT non-zero reserved (rfu) bits with ReservedBitsViolation and serialize them as 0 — with one deliberate exception: individual addressing (0x21) PRESERVES its leading rfu byte verbatim so gateway streams round-trip byte-exact (see payload::individual_addressing).

Quickstart: pump a TS, get typed payloads

pump::T2miPump filters a TS by PID, reassembles + CRC-validates T2-MI packets, and hands back events whose payload dispatches to a typed payload::AnyPayload:

use dvb_t2mi::pump::T2miPump;
use dvb_t2mi::payload::AnyPayload;

let mut pump = T2miPump::new(0x0006); // T2-MI PID from the PMT
for packet in &ts_packets {          // each aligned 188-byte TS packet
    for event in pump.feed_ts(packet) {
        if let Ok(AnyPayload::Bbframe(bb)) = event.payload() {
            println!("BBFrame plp_id={}", bb.plp_id);
        }
    }
}

The full signal chain

T2-MI carries DVB-T2 BBFrames, which carry the inner MPEG-TS, which carries SI. The crates compose end to end — T2-MI here, BBFrame extraction in dvb-bbframe, SI demux in dvb-si:

TS (T2-MI PID) ─▶ T2miPump ─▶ AnyPayload::Bbframe
                                  │ bb.bbframe
                                  ▼
                         dvb_bbframe::Bbheader::parse + up_iter
                                  │ inner TS packets
                                  ▼
                         dvb_si::demux::SiDemux ─▶ AnyTable

A complete, working version of this chain (synthetic fixture, every layer built and asserted) lives in dvb-t2mi/tests/chain.rs.

Features

Feature	Default	Enables
ts	on	pump::T2miPump — PID-filtered TS reassembly + CRC validation. Off → bring your own complete T2-MI packet bytes.
serde	on	Serialize-only — for display/export (JSON via serde_json); parsing FROM JSON is deliberately unsupported, re-parse from wire bytes. Serialize on every packet/payload type.
yoke	off	yoke::Yokeable on the zero-copy payload view types — own a parsed T2-MI payload past the input buffer’s borrow without re-parsing.

Header-only example

use dvb_t2mi::packet::Header;
use dvb_common::Parse;
let buf = [0x00u8, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00];
let hdr = Header::parse(&buf[..]).unwrap();
assert_eq!(hdr.payload_len_bits, 0);

Re-exports

pub use error::Error;

pub use error::Result;

Modules

crc

T2-MI CRC helpers.

error

Error type returned by every parser in this crate.

packet

T2-MI packet header and type parsing.

payload

T2-MI payload types (§5.2.1 - §5.2.12).

pump

T2miPump — owning-Bytes feed-and-iterate T2-MI pump.

traits

T2-MI–specific traits. Parse / Serialize are provided by dvb_common and imported directly at call sites.

ts

TS packet reassembly utilities.