Struct devices::irqchip::pic::Pic

pub struct Pic {
    interrupt_request: bool,
    resample_events: Vec<Vec<Event>>,
    pics: [PicState; 2],
}

Fields

interrupt_request: bool

resample_events: Vec<Vec<Event>>

pics: [PicState; 2]

Implementations

impl Pic

pub fn new() -> Pic

pub fn get_pic_state(&self, select: PicSelect) -> PicState

Get the current state of the primary or secondary PIC

pub fn set_pic_state(&mut self, select: PicSelect, state: &PicState)

Set the current state of the primary or secondary PIC

pub fn register_resample_events(&mut self, resample_events: Vec<Vec<Event>>)

pub fn service_irq(&mut self, irq: u8, level: bool) -> bool

pub fn masked(&self) -> bool

Determines whether the (primary) PIC is completely masked.

pub fn has_interrupt(&self) -> bool

Determines whether the PIC has an interrupt ready.

pub fn interrupt_requested(&self) -> bool

Determines whether the PIC has fired an interrupt to LAPIC.

pub fn get_external_interrupt(&mut self) -> Option<u8>

Determines the external interrupt number that the PIC is prepared to inject, if any.

fn pic_read_command(&mut self, pic_type: PicSelect) -> u8

fn pic_read_data(&mut self, pic_type: PicSelect) -> u8

fn pic_read_elcr(&mut self, pic_type: PicSelect) -> u8

fn pic_write_command(&mut self, pic_type: PicSelect, value: u8)

fn pic_write_data(&mut self, pic_type: PicSelect, value: u8)

fn pic_write_elcr(&mut self, pic_type: PicSelect, value: u8)

fn reset_pic(&mut self, pic_type: PicSelect)

fn poll_read(&mut self, pic_type: PicSelect) -> (u8, bool)

Determine the priority and whether an update_irq call is needed.

fn get_irq(&self, pic_type: PicSelect) -> Option<u8>

fn clear_isr(&mut self, pic_type: PicSelect, irq: u8)

fn update_irq(&mut self) -> bool

fn set_irq_internal(pic: &mut PicState, irq: u8, level: bool)

Set Irq level. If edge is detected, then IRR is set to 1.

fn get_priority(pic: &PicState, irq_bitmap: u8) -> Option<u8>

fn interrupt_ack(&mut self, pic_type: PicSelect, irq: u8)

Move interrupt from IRR to ISR to indicate that the interrupt is injected. If auto EOI is set, then ISR is immediately cleared (since the purpose of EOI is to clear ISR bit).

fn init_command_word_1(&mut self, pic_type: PicSelect, value: u8)

fn operation_command_word_2(&mut self, pic_type: PicSelect, value: u8)

fn operation_command_word_3(pic: &mut PicState, value: u8)

Trait Implementations

impl BusDevice for Pic

fn device_id(&self) -> DeviceId

Returns a unique id per device type suitable for metrics gathering.

fn debug_label(&self) -> String

Returns a label suitable for debug output.

fn write(&mut self, info: BusAccessInfo, data: &[u8])

Writes at offset into this device

fn read(&mut self, info: BusAccessInfo, data: &mut [u8])

Reads at offset from this device

fn config_register_write( &mut self, reg_idx: usize, offset: u64, data: &[u8] ) -> ConfigWriteResult

Sets a register in the configuration space. Only used by PCI.

fn config_register_read(&self, reg_idx: usize) -> u32

Gets a register from the configuration space. Only used by PCI.

fn init_pci_config_mapping( &mut self, shmem: &SharedMemory, base: usize, len: usize ) -> bool

Provides a memory region to back MMIO access to the configuration space. If the device can keep the memory region up to date, then it should return true, after which no more calls to config_register_read will be made. Otherwise the device should return false.

fn virtual_config_register_write(&mut self, reg_idx: usize, value: u32)

Sets a register in the virtual config space. Only used by PCI.

fn virtual_config_register_read(&self, reg_idx: usize) -> u32

Gets a register from the virtual config space. Only used by PCI.

fn on_sandboxed(&mut self)

Invoked when the device is sandboxed.

fn get_ranges(&self) -> Vec<(BusRange, BusType)>

Gets a list of all ranges registered by this BusDevice.

fn destroy_device(&mut self)

Invoked when the device is destroyed

fn is_bridge(&self) -> Option<u8>

Returns the secondary bus number if this bus device is pci bridge

impl Default for Pic

fn default() -> Self

Returns the “default value” for a type.

impl Suspendable for Pic

The PIC is only used in very early boot on x86_64, and snapshots are not generally taken during that time, so we can safely skip the PIC for now.

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

Stop all threads related to the device. Sleep should be idempotent.

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

Create/Resume all threads related to the device. Wake should be idempotent.

fn snapshot(&mut self) -> Result<Value>

Save the device state in an image that can be restored.

fn restore(&mut self, _data: Value) -> Result<()>

Load a saved snapshot of an image.