Struct PcComponent

pub struct PcComponent<'a, I: InterruptService + 'a> { /* private fields */ }

Component helper for constructing a Pc chip instance.

During the call to finalize(), this helper will perform low-level initialization of the PC hardware to ensure a consistent CPU state. This includes initializing memory segmentation and interrupt handling. See x86::init for further details.

Implementations

impl<'a, I: InterruptService + 'a> PcComponent<'a, I>

pub unsafe fn new(pd: &'a mut PD, pt: &'a mut PT, int_svc: &'a I) -> Self

Creates a new PcComponent instance.

Safety

It is unsafe to construct more than a single PcComponent during the entire lifetime of the kernel.

Before calling, memory must be identity-mapped. Otherwise, introduction of flat segmentation will cause the kernel’s code/data to move unexpectedly.

See x86::init for further details.

Trait Implementations

impl<I: InterruptService + 'static> Component for PcComponent<'static, I>

type StaticInput = (<SerialPortComponent as Component>::StaticInput, <SerialPortComponent as Component>::StaticInput, <SerialPortComponent as Component>::StaticInput, <SerialPortComponent as Component>::StaticInput, &'static mut MaybeUninit<Pc<'static, I>>)

An optional type to specify the chip or board specific static memory that a component needs to setup the output object(s). This is the memory that crate::static_buf!() would normally setup, but generic components cannot setup static buffers for types which are chip-dependent, so those buffers have to be passed in manually, and the Component::StaticInput type makes this possible.

type Output = &'static Pc<'static, I>

The type (e.g., capsule, peripheral) that this implementation of Component produces via Component::finalize(). This is typically a static reference (&'static).

fn finalize(self, s: Self::StaticInput) -> Self::Output

A factory method that returns an instance of the Output type of this Component implementation. This is used in the boot sequence to instantiate and initialize part of the Tock kernel. This factory method may only be called once per Component instance.