Skip to main content

MockCaDevice

Struct MockCaDevice 

Source
pub struct MockCaDevice {
    pub inbound: VecDeque<Vec<u8>>,
    pub ops: Vec<DeviceOp>,
    pub slot: SlotInfo,
}
Expand description

In-memory CaDevice for tests and the differential harness.

  • inbound is a scripted queue of frames the “module” (mock CAM) sends up; each read pops one.
  • every host-side operation is appended to ops so a test (or a differential comparison against an external reference) can assert the exact emitted write/ioctl sequence.

Fields§

§inbound: VecDeque<Vec<u8>>

Scripted frames the module sends to the host (FIFO).

§ops: Vec<DeviceOp>

Recorded host-side operations, in order.

§slot: SlotInfo

Slot status returned by slot_info.

Implementations§

Source§

impl MockCaDevice

Source

pub fn new(inbound: impl IntoIterator<Item = Vec<u8>>) -> Self

New mock with a ready module in slot 0 and the given inbound script.

Examples found in repository?
examples/mock_cam_session.rs (line 17)
15fn main() -> std::io::Result<()> {
16    // Script a module that accepts the transport connection (C_T_C_Reply).
17    let dev = MockCaDevice::new([vec![tags::C_T_C_REPLY, 0x01, 0x01]]);
18    let mut driver = Driver::new(dev);
19
20    // Bring the interface up: reset + open the transport connection.
21    driver.init()?;
22    println!("init: sent {} device op(s)", driver.device().ops.len());
23
24    // Pump the device. When readable it reads a frame and feeds the stack;
25    // otherwise it advances the EN 50221 poll cadence by the timeout.
26    for step in 0..5 {
27        let read = driver.pump(Duration::from_millis(100))?;
28        println!("pump {step}: processed_frame={read}");
29    }
30
31    // Anything the host application needs to act on surfaces as a Notification.
32    for note in driver.take_notifications() {
33        match note {
34            Notification::CamReady => println!("note: CAM ready — safe to send ca_pmt"),
35            Notification::ApplicationInfo { menu, .. } => {
36                println!("note: application_information menu={menu:?}")
37            }
38            Notification::CaInfo { ca_system_ids } => {
39                println!("note: ca_info system_ids={ca_system_ids:?}")
40            }
41            other => println!("note: {other:?}"),
42        }
43    }
44
45    // The mock records every device op (writes/ioctls) — handy for assertions.
46    println!("total recorded device ops: {}", driver.device().ops.len());
47    Ok(())
48}
Source

pub fn written(&self) -> Vec<u8>

The bytes written by the host so far, concatenated (convenience for byte-exact differential comparison against the C reference).

Trait Implementations§

Source§

impl CaDevice for MockCaDevice

Source§

fn read(&mut self, buf: &mut [u8]) -> Result<usize>

Read one link-layer TPDU frame into buf; returns the byte count. Ok(0) means no data available (non-blocking).
Source§

fn write(&mut self, buf: &[u8]) -> Result<()>

Write one link-layer TPDU frame.
Source§

fn reset(&mut self) -> Result<()>

Reset the interface / slot (ioctl CA_RESET).
Source§

fn slot_info(&mut self) -> Result<SlotInfo>

Query slot status (ioctl CA_GET_SLOT_INFO).
Source§

fn poll(&mut self, _timeout: Duration) -> Result<bool>

Wait up to timeout for the device to become readable; Ok(true) if readable. The runtime’s poll loop calls this between reads.
Source§

impl Debug for MockCaDevice

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for MockCaDevice

Source§

fn default() -> MockCaDevice

Returns the “default value” for a type. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> DescriptorObject for T
where T: Debug + Any + Send + Sync,

Source§

fn as_any(&self) -> &(dyn Any + 'static)

Borrow as &dyn Any so the caller can downcast to the concrete type.
Source§

impl<T> ExtensionObject for T
where T: Debug + Any + Send + Sync,

Source§

fn as_any(&self) -> &(dyn Any + 'static)

Borrow as &dyn Any so the caller can downcast to the concrete type.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> TableObject for T
where T: Debug + Any + Send + Sync,

Source§

fn as_any(&self) -> &(dyn Any + 'static)

Borrow as &dyn Any so the caller can downcast to the concrete type.
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.