Enum Notification 

#[non_exhaustive]
pub enum Notification {
    CamReady,
    ApplicationInfo {
        application_type: u8,
        manufacturer: u16,
        code: u16,
        menu: String,
    },
    CaInfo {
        ca_system_ids: Vec<u16>,
    },
    CaPmtReply {
        program_number: u16,
        ca_enable: Option<CaEnable>,
        descrambling_ok: bool,
    },
    Entitlement {
        program_number: u16,
        ca_enable: CaEnable,
        descrambling_ok: bool,
    },
    Mmi(MmiEvent),
    HostControl(HostControlEvent),
    SessionOpened {
        resource: ResourceId,
    },
    SessionClosed {
        session_nb: u16,
    },
    Error {
        detail: String,
    },
    HotPlug(HotPlug),
}

A host-facing event surfaced by the stack (the useful outputs of a CI session — what an application reacts to).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

CamReady

The module is present and the resource-manager handshake completed.

ApplicationInfo

application_information was received.

Fields

application_type: u8

application_type (0x01 = CA).

manufacturer: u16

application_manufacturer.

code: u16

manufacturer_code.

menu: String

The decoded menu string.

CaInfo

ca_info was received — the CA system ids the module supports.

Fields

ca_system_ids: Vec<u16>

CA_system_id values the CAM can descramble.

CaPmtReply

A ca_pmt_reply was received for a prior CA_PMT.

Fields

program_number: u16

program_number the reply pertains to.

ca_enable: Option<CaEnable>

Programme-level CA_enable (EN 50221 §8.4.3.5 Table 26). None iff the programme CA_enable_flag bit was clear (no programme-level status given) — plumbed straight through from the dvb_ci CaPmtReply object’s own Option<CaEnable>, never collapsed to a sentinel.

descrambling_ok: bool

Whether descrambling is (or was) possible, derived from ca_enable. Kept for back-compat with the pre-#763 boolean-only surface.

Entitlement

A per-programme entitlement status transition (#763). Edge-triggered: fires once per program_number only when the programme-level CA_enable status (EN 50221 §8.4.3.5, Table 26) changes versus the last observed ca_pmt_reply for that programme. The transition is detected by the periodic re-query (Driver::set_requery_interval), which re-sends the active ca_pmts with ca_pmt_cmd_id = query so the CAM re-evaluates and replies. Complements the coarse #726 HotPlug module/card layer with the fine-grained per-service layer. (Programme-level status only; the ES-level CA_enable entries are not evaluated for this event.)

Fields

program_number: u16

program_number the status pertains to.

ca_enable: CaEnable

Programme-level CA_enable status.

descrambling_ok: bool

Whether descrambling is possible per the current status.

Mmi(MmiEvent)

An MMI menu/enquiry the host should display.

HostControl(HostControlEvent)

A host_control request the CAM made of the host (EN 50221 §8.5.1). The host acts on it out-of-band (retune / PID replace); the runtime only surfaces the decoded request.

SessionOpened

A session for resource was opened.

Fields

resource: ResourceId

The resource the session serves.

SessionClosed

A session closed.

Fields

session_nb: u16

The session_nb that closed.

Error

A protocol error surfaced by the stack (non-fatal; informational).

Fields

detail: String

Human-readable detail.

HotPlug(HotPlug)

A CAM/card hot-plug transition (#726). See HotPlug.

Implementations

impl Notification

pub fn hotplug(&self) -> Option<HotPlug>

This notification’s HotPlug transition, if it is one — a cheap classifier for poll-mode consumers that only care about hot-plug edges.

Trait Implementations

impl Clone for Notification

fn clone(&self) -> Notification

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Notification

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Notification

impl PartialEq for Notification

fn eq(&self, other: &Notification) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Notification