Struct AhciPort 

pub struct AhciPort {
    pub port_num: u8,
    pub port_mmio_base: usize,
    pub device_type: AhciDeviceType,
    pub state: PortState,
    pub num_cmd_slots: u8,
    pub ncq_supported: bool,
    pub total_sectors: u64,
    pub sector_size: usize,
}

Represents a single AHCI port with its state and device info.

Fields

port_num: u8

Port number (0-31).

port_mmio_base: usize

Base address for this port’s MMIO registers.

device_type: AhciDeviceType

Device type detected on this port.

state: PortState

Current port state.

num_cmd_slots: u8

Number of command slots supported by the HBA.

ncq_supported: bool

Whether NCQ is supported by the HBA.

total_sectors: u64

Total sectors reported by IDENTIFY DEVICE (0 until identified).

sector_size: usize

Sector size in bytes (default 512).

Implementations

impl AhciPort

pub fn new( port_num: u8, hba_mmio_base: usize, num_cmd_slots: u8, ncq_supported: bool, ) -> Self

Create a new port descriptor.

pub fn detect_device(&mut self)

Detect whether a device is present on this port.

pub fn stop_cmd(&self) -> Result<(), KernelError>

Stop the port command engine (clear ST and FRE, wait for CR and FR to clear).

pub fn start_cmd(&self)

Start the port command engine (set FRE then ST).

pub fn clear_serr(&self)

Clear the port SERR register (write-1-to-clear all bits).

pub fn clear_interrupt_status(&self)

Clear the port interrupt status register.

pub fn wait_ready(&self) -> Result<(), KernelError>

Wait for the port to become not busy (TFD BSY and DRQ clear).

pub fn find_free_slot(&self) -> Result<u8, KernelError>

Find a free command slot.

Returns the slot index (0-based), or an error if all slots are occupied.

pub fn issue_command_and_wait(&self, slot: u8) -> Result<(), KernelError>

Issue a command in the given slot and wait for completion.

Sets the corresponding bit in PORT_CI and polls until it clears or an error is detected in PORT_TFD.

pub fn build_read_dma_ext( &self, lba: u64, sector_count: u16, buffer_phys: u64, ) -> (CommandHeader, CommandTableHeader, PrdtEntry)

Build and issue a READ DMA EXT command.

lba: Starting logical block address. sector_count: Number of sectors to read (1-65535, 0 means 65536). buffer_phys: Physical address of the destination buffer.

This prepares the FIS, command header, PRDT, and issues the command. In a production system, the command list and command tables would be allocated from DMA-capable memory; here we describe the operation structurally.

pub fn build_write_dma_ext( &self, lba: u64, sector_count: u16, buffer_phys: u64, ) -> (CommandHeader, CommandTableHeader, PrdtEntry)

Build and issue a WRITE DMA EXT command.

lba: Starting logical block address. sector_count: Number of sectors to write. buffer_phys: Physical address of the source buffer.

Trait Implementations

impl Clone for AhciPort

fn clone(&self) -> AhciPort

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AhciPort

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

Formats the value using the given formatter.

impl Copy for AhciPort