dvb-si 11.1.0

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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227

//! DVB + MPEG-2 descriptors. Each descriptor tag gets its own submodule file.
//!
//! The usual way to consume a descriptor is to walk a table's raw descriptor
//! loop with [`parse_loop`], which yields a typed [`AnyDescriptor`] per entry
//! (or [`AnyDescriptor::Unknown`] for tags with no implementation). To handle a
//! single known tag, call the specific module's `parse` directly (e.g.
//! [`satellite_delivery_system`], [`service`], [`linkage`]).

pub mod aac;
pub mod aac_additional_info;
pub mod ac3;
pub mod adaptation_field_data;
pub mod ait;
pub mod ancillary_data;
pub mod announcement_support;
pub mod any;
pub mod application_signalling;
pub mod association_tag;
pub mod audio_stream;
pub mod auxiliary_video_stream;
pub mod avc_timing_and_hrd;
pub mod avc_video;
pub mod bouquet_name;
pub mod ca;
pub mod ca_identifier;
pub mod cable_delivery_system;
pub mod carousel_identifier;
pub mod cell_frequency_link;
pub mod cell_list;
pub mod component;
pub mod content;
pub mod content_identifier;
pub mod content_labeling;
pub mod content_time_base_indicator;
pub mod copyright;
pub mod country_availability;
pub mod data_broadcast;
pub mod data_broadcast_id;
pub mod data_stream_alignment;
pub mod decoder_config_flags;
pub mod default_authority;
pub mod dsng;
pub mod dts;
pub mod ecm_repetition_rate;
pub mod enhanced_ac3;
pub mod extended_event;
pub mod extension;
pub mod external_es_id;
pub mod flex_mux_timing;
pub mod fmc;
pub mod fmx_buffer_size;
pub mod frequency_list;
pub mod fta_content_management;
pub mod hdr_wcg_idc;
pub mod hevc_video;
pub mod hierarchy;
pub mod ibp;
pub mod iod;
pub mod iso_639_language;
pub mod j2k_video;
mod lang_text;
pub mod linkage;
pub mod local_time_offset;
pub mod logical_channel;
pub mod maximum_bitrate;
pub mod metadata;
pub mod metadata_format;
pub mod metadata_pointer;
pub mod metadata_std;
pub mod mosaic;
pub mod mpeg2_aac_audio;
pub mod mpeg4_audio;
pub mod mpeg4_video;
pub mod mpeg_carriage_flags;
pub mod multilingual_bouquet_name;
pub mod multilingual_component;
pub mod multilingual_network_name;
pub mod multilingual_service_name;
pub mod multiplex_buffer;
pub mod multiplex_buffer_utilization;
pub mod muxcode;
pub mod mvc_extension;
pub mod network_name;
pub mod nordig;
pub mod nvod_reference;
pub mod parental_rating;
pub mod partial_transport_stream;
pub mod pdc;
pub mod private_data_indicator;
pub mod private_data_specifier;
pub mod registration;
pub mod registry;
pub mod related_content;
pub mod s2_satellite_delivery_system;
pub mod satellite_delivery_system;
pub mod scrambling;
pub mod service;
pub mod service_availability;
pub mod service_identifier;
pub mod service_list;
pub mod service_move;
pub mod short_event;
pub mod short_smoothing_buffer;
pub mod sl;
pub mod smoothing_buffer;
pub mod std;
pub mod stream_identifier;
pub mod stuffing;
pub mod subtitling;
pub mod svc_extension;
pub mod system_clock;
pub mod target_background_grid;
pub mod telephone;
pub mod teletext;
pub mod terrestrial_delivery_system;
pub mod time_shifted_event;
pub mod time_shifted_service;
pub mod time_slice_fec_identifier;
pub mod transport_stream;
pub mod tva_id;
pub mod vbi_data;
pub mod vbi_teletext;
pub mod video_stream;
pub mod video_window;
pub mod xait_location;

pub use ca::CaDescriptor;
pub use data_stream_alignment::DataStreamAlignmentDescriptor;
pub use private_data_indicator::PrivateDataIndicatorDescriptor;
pub use registration::RegistrationDescriptor;

/// Write a descriptor's 2-byte header — `tag` then a range-checked 8-bit
/// `descriptor_length` — into `buf[0..2]`.
///
/// `buf` must already be known to hold at least `2 + body_len` bytes (callers
/// check this via `serialized_len()` before calling). Returns
/// [`Error::FieldOverflow`](crate::Error::FieldOverflow) instead of silently
/// narrowing (`as u8`) a `body_len` that does not fit the 8-bit field, which
/// would otherwise emit a misframed descriptor loop (#1129).
pub(crate) fn write_descriptor_header(
    buf: &mut [u8],
    tag: u8,
    body_len: usize,
) -> crate::Result<()> {
    buf[0] = tag;
    buf[1] = broadcast_common::len::fit_u8(body_len, "descriptor_length")?;
    Ok(())
}

pub(crate) fn descriptor_body<'a>(
    bytes: &'a [u8],
    tag: u8,
    what: &'static str,
    reason: &'static str,
) -> crate::Result<&'a [u8]> {
    const HEADER_LEN: usize = 2;
    if bytes.len() < HEADER_LEN {
        return Err(crate::Error::BufferTooShort {
            need: HEADER_LEN,
            have: bytes.len(),
            what,
        });
    }
    if bytes[0] != tag {
        return Err(crate::Error::InvalidDescriptor {
            tag: bytes[0],
            reason,
        });
    }
    let length = bytes[1] as usize;
    let end = HEADER_LEN + length;
    if bytes.len() < end {
        return Err(crate::Error::BufferTooShort {
            need: end,
            have: bytes.len(),
            what,
        });
    }
    Ok(&bytes[HEADER_LEN..end])
}

pub use ait::{AitDescriptorIter, AitDescriptorLoop, AnyAitDescriptor, parse_ait_loop};
pub use any::{AnyDescriptor, DescriptorIter, DescriptorLoop, parse_loop};
pub use extension::registry::{ExtensionObject, ExtensionRegistry, RegisteredExtension};
pub use registry::{
    DescriptorObject, DescriptorRegistry, ExtIterItem, ExtRegistryIter, RegistryIter,
};

pub use private_data_specifier::{PDS_EACEM, PDS_NORDIG};

/// Encode `value` to `nibbles` packed-BCD digits for a `set_*` accessor,
/// mapping overflow to a [`ValueOutOfRange`](crate::Error::ValueOutOfRange)
/// error tagged with the descriptor `field`. Shared by the delivery-system
/// descriptors.
pub(crate) fn encode_bcd_field(value: u64, nibbles: u8, field: &'static str) -> crate::Result<u64> {
    broadcast_common::bcd::decimal_to_bcd(value, nibbles).ok_or(crate::Error::ValueOutOfRange {
        field,
        reason: "value exceeds the BCD field width",
    })
}

#[cfg(test)]
mod header_tests {
    use super::write_descriptor_header;

    /// Boundary: a 255-byte body is the largest an 8-bit `descriptor_length`
    /// can hold, and must still serialize.
    #[test]
    fn write_descriptor_header_accepts_max_body_len() {
        let mut buf = [0u8; 2];
        write_descriptor_header(&mut buf, 0x40, 255).unwrap();
        assert_eq!(buf, [0x40, 255]);
    }

    /// A 256-byte body does not fit the 8-bit field and must return `Err`
    /// rather than wrapping `256 as u8 == 0` into a misframed descriptor
    /// (#1129) — this is the template bug every descriptor serializer had.
    #[test]
    fn write_descriptor_header_rejects_body_len_over_255() {
        let mut buf = [0u8; 2];
        let err = write_descriptor_header(&mut buf, 0x40, 256).unwrap_err();
        assert!(
            matches!(err, crate::Error::FieldOverflow(_)),
            "expected FieldOverflow, got {err:?}"
        );
    }
}