dvb-si 3.1.1

ETSI EN 300 468 DVB Service Information parser + builder. MPEG-2 PSI included.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

//! SI-specific traits. `Parse` / `Serialize` are provided by `dvb_common`
//! and imported directly at call sites.

use dvb_common::{Parse, Serialize};

/// Contract every DVB descriptor implements.
///
/// Descriptors are length-prefixed payloads inside tables. The
/// `TAG` constant ties a struct to its wire identifier.
pub trait Descriptor<'a>: Parse<'a> + Serialize {
    /// Descriptor tag byte — the wire identifier.
    const TAG: u8;

    /// Length of the payload portion (NOT including the 2 header bytes).
    fn descriptor_length(&self) -> u8;
}

/// Implemented by every typed descriptor; drives [`crate::descriptors::AnyDescriptor`]
/// dispatch. `TAG` is the wire descriptor_tag this type parses.
pub trait DescriptorDef<'a>: Parse<'a, Error = crate::error::Error> {
    /// Wire descriptor_tag.
    const TAG: u8;
    /// Diagnostic name. Convention (workspace-wide): SCREAMING_SNAKE,
    /// suffix-free — `SHORT_EVENT`, `EXTENSION`, `NETWORK_NAME`
    /// (no `_descriptor` suffix).
    const NAME: &'static str;
}

/// Implemented by every typed table; drives [`crate::tables::AnyTable`]
/// dispatch. `TABLE_ID_RANGES` lists the inclusive `(lo, hi)` table_id ranges
/// this type accepts.
pub trait TableDef<'a>: dvb_common::Parse<'a, Error = crate::error::Error> {
    /// Inclusive `(lo, hi)` table_id ranges this type parses.
    ///
    /// Single-id types use a single-element slice `&[(id, id)]`.
    /// Multi-range types (e.g. SDT `[(0x42,0x42),(0x46,0x46)]`) list each
    /// contiguous run separately.
    const TABLE_ID_RANGES: &'static [(u8, u8)];
    /// Spec name for diagnostics. SCREAMING_SNAKE, suffix-free:
    /// `PROGRAM_ASSOCIATION`, `EVENT_INFORMATION`, `SERVICE_DESCRIPTION`.
    ///
    /// Deliberate exceptions: `DSM_CC_SECTION` and `MPE_DATAGRAM_SECTION` keep
    /// `_SECTION` because it is part of the spec entity name, not a type suffix.
    const NAME: &'static str;
}

/// Contract every section-carried table implements.
pub trait Table<'a>: Parse<'a> + Serialize {
    /// Expected `table_id` for this table.
    ///
    /// Tables that occupy a range of table_ids (e.g. EIT schedule which covers
    /// 0x50..=0x5F) expose a range helper on the type itself rather than a
    /// single `TABLE_ID` constant.
    const TABLE_ID: u8;

    /// PID on which this table is typically carried.
    ///
    /// Some tables (PMT) use per-programme PIDs signalled by PAT; those
    /// return `0x0000` here and the consumer is expected to know better.
    const PID: u16;
}