dvb-ci 0.1.0

DVB Common Interface (EN 50221) — APDU/resource objects, session/transport PDUs, and a CA_PMT builder from a dvb-si PMT.
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

//! DVB Common Interface (EN 50221) — the host↔CICAM wire protocol.
//!
//! Parses + builds the EN 50221 protocol objects: resource APDUs (Resource
//! Manager, Application Information, CA support incl. `ca_pmt`/`ca_pmt_reply`,
//! Date-Time, MMI close), the session-layer SPDUs and transport-layer TPDUs,
//! plus a `CA_PMT` builder that turns a `dvb-si` PMT into the object handed to a
//! CICAM.
//!
//! Every wire structure implements [`dvb_common::Parse`] / [`dvb_common::Serialize`]
//! symmetrically (parse → serialize is byte-identical), with all length fields
//! computed from content. Spec citations live in each module doc; the
//! render-verified transcription is in `docs/en_50221/`.
//!
//! Scope: the wire/protocol layer only. The physical PC-Card transport and CI+
//! crypto (the CC resource) are out of scope. `#![no_std]` (+ `alloc`).
//!
//! # Layers
//!
//! - [`tag`] / [`length`] — the 3-byte `apdu_tag` and the ASN.1-style
//!   `length_field` shared by all PDUs.
//! - [`resource`] — the 4-octet `resource_identifier()`.
//! - [`objects`] — application-layer APDU objects, dispatched by [`AnyApdu`].
//! - [`spdu`] — session-layer SPDUs (open/create/close session, session number).
//! - [`tpdu`] — transport-layer framing (C_TPDU/R_TPDU + connection mgmt).
//! - [`builder`] — the `CA_PMT` projection from a `dvb-si` PMT.
//!
//! # Deferred to a follow-up
//!
//! The MMI **high-level** objects (text/enq/answ/menu/list, Tables 46-51), the
//! MMI low-level/display objects, the **Host Control** (tune/replace) and
//! **Low-Speed Communications** resources are not yet typed. Their `apdu_tag`s
//! are listed in `docs/en_50221/apdu-tag-values.md`; until implemented they are
//! produced by [`AnyApdu::parse`] as [`AnyApdu::Unknown`] (lossless round-trip).
#![no_std]
#![cfg_attr(docsrs, feature(doc_cfg))]
#![warn(missing_docs)]
// Runnable examples, embedded so they render on docs.rs and stay in sync with
// the actual `examples/*.rs` files (shown, not compiled).
#![doc = "\n# Examples\n"]
#![doc = "Two runnable examples ship with this crate (`cargo run -p dvb-ci --example <name>`).\n"]
#![doc = "\n## `build_ca_pmt`\n\n```rust,ignore"]
#![doc = include_str!("../examples/build_ca_pmt.rs")]
#![doc = "```\n\n## `parse_apdu`\n\n```rust,ignore"]
#![doc = include_str!("../examples/parse_apdu.rs")]
#![doc = "```"]

extern crate alloc;

pub mod any;
pub mod builder;
pub mod error;
pub mod length;
pub mod objects;
pub mod resource;
pub mod spdu;
pub mod tag;
pub mod tpdu;
pub mod traits;

pub use any::AnyApdu;
pub use error::{Error, Result};
pub use resource::ResourceId;
pub use tag::ApduTag;
pub use traits::ApduDef;