dvb-si

ETSI EN 300 468 DVB Service Information parser and builder, plus the MPEG-2 PSI tables it builds on, the DVB-allocated companion tables, and the DSM-CC data carousel.

Complete coverage: every allocated table_id in EN 300 468 V1.19.1 Table 2 (29 table types; 28 dispatched by AnyTable + the type-keyed MPE datagram view) and every allocated descriptor_tag in Table 12 (0x40–0x7F, 64 descriptors) is implemented, each with a symmetric Parse / Serialize pair and round-trip tests. Layouts are derived from the ETSI specs (vendored in the repo and transcribed into reviewable markdown) and validated against live broadcast captures.

Table coverage

Every table: typed header fields, symmetric parse/serialize, round-trip tested. Per the crate's zero-copy convention, descriptor loops and repeated sub-structures are borrowed &[u8] slices the caller walks with the descriptor parsers — noted below only where a table goes further or stays deliberately raw.

Remaining table_id values are reserved or user-defined in EN 300 468 V1.19.1 Table 2 — there is nothing standardized left to implement.

DSM-CC data carousel

The carousel module types the download-protocol payloads carried inside DSM-CC sections (ISO/IEC 13818-6 §7.2/§7.3 as profiled by DVB — TR 101 202, TS 102 006 SSU, TS 102 809 object carousels):

Validated byte-exact against a live French-TNT (M6 HbbTV) capture in the test suite. BIOP object-carousel payloads above this layer are out of scope.

Descriptors

Every allocated descriptor_tag in EN 300 468 V1.19.1 Table 12 (0x40–0x7F) is implemented — plus the MPEG-2 descriptors that matter in SI context and the de-facto private logical_channel_descriptor. Each parses into a typed struct with a symmetric serializer and round-trip tests; any unallocated/unknown tag passes through as raw bytes (tag + payload preserved). Per the crate's zero-copy convention, free-form byte fields (names, selector tails) stay borrowed &[u8]; notes below only where a sub-structure is deliberately kept raw.

Extension descriptor registry (tag 0x7F)

The first payload byte (descriptor_tag_extension) selects a sub-descriptor (EN 300 468 §6.4). A body is typed only when its syntax table is vendored under docs/; everything else is preserved byte-exact as Raw and round-trips losslessly.

Text decoding

Full EN 300 468 Annex A Table A.3 selector coverage:

Annex A.1 control codes are honored for both the single-byte (0x80–0x9F) and two-byte (U+E080–U+E09F PUA, Table A.2) tables: emphasis markers dropped, CR/LF → space, reserved controls stripped.

Spec grounding

Every layout is cited. The repo vendors the ETSI PDFs and transcribes their syntax tables into reviewable markdown (docs/) — each spec below links both the ETSI deliverable and the in-repo transcription:

The crate has been through five adversarial spec-audit rounds; fixture tests run against real transponder captures.

Demux in 10 lines

Feed 188-byte TS packets to [SiDemux]; it filters by PID, reassembles sections, validates CRCs, follows the PAT to PMT PIDs, and version-gates so a steady carousel emits each table only once. You get a SectionEvent per changed section:

use dvb_si::demux::SiDemux;
use dvb_si::tables::AnyTable;

let mut demux = SiDemux::builder().build();
for packet in ts_packets {                      // each aligned 188-byte packet
    for event in demux.feed(&packet) {          // changed sections only
        if let Ok(AnyTable::Pat(pat)) = event.table() {
            println!("PAT v{} on {}", event.version().unwrap_or(0), event.pid());
            let _ = pat;
        }
    }
}

See examples/si_dump.rs for a complete file-reading CLI (cargo run -p dvb-si --example si_dump -- file.ts [--json]).

Typed dispatch

You rarely match table_ids or descriptor_tags by hand. AnyTable::parse dispatches a complete section to the right typed table; parse_loop walks a descriptor loop yielding AnyDescriptor values (typed where known, Unknown otherwise, never panicking); and DescriptorRegistry lets you plug in private descriptors at runtime. All three are generated from a single declarative list so the dispatcher can never drift from the implemented set.

use dvb_si::descriptors::{parse_loop, AnyDescriptor};

for item in parse_loop(eit_event.descriptors) {
    match item? {
        AnyDescriptor::ShortEvent(se) => println!("{}", se.event_name.decode()),
        AnyDescriptor::Unknown { tag, .. } => eprintln!("unknown 0x{tag:02X}"),
        _ => {}
    }
}

Upgrading from 1.x? Text fields are now DvbText, language codes are LangCode, the JSON shape changed, and the subset Descriptor enum is gone. See MIGRATION-2.0.md for every break with before/after code.

Usage

use dvb_common::Parse;
use dvb_si::tables::sdt::Sdt;

// `section_bytes`: one complete SDT section, e.g. from `SectionReassembler`.
let sdt = Sdt::parse(section_bytes)?;
for service in &sdt.services {
    println!("service_id = {}", service.service_id);
}

Principles

• Spec fidelity. Every field in a section's syntax appears in the parsed struct.
• Parse and construct. Every parser has a symmetric serializer; round-trip is tested.
• Zero-copy where possible. Parsed types borrow from the input via <'a> lifetimes.
• No magic numbers. Every hex literal outside #[cfg(test)] is a named constant or enum.

Features

Default: chrono (MJD+BCD → DateTime<Utc>), ts (TS packet + SectionReassembler), serde.

dvb-si = { version = "2.0", default-features = false }  # tight build

Family

dvb-common — traits + CRC-32
dvb-t2mi — T2-MI, all 12 packet types
dvb-bbframe — S2/S2X/T2 BBFRAME
For GSE see the existing dvb-gse crate.

License

Licensed under either of MIT or Apache-2.0, at your option.