Struct TtyDevice 

pub struct TtyDevice {

    name: &'static str,
    uart_device_id: usize,
    input_buffer: Arc<Mutex<VecDeque<u8>>>,
    input_waker: Waker,
    canonical_mode: AtomicBool,
    echo_enabled: AtomicBool,
    read_min_ready_bytes: AtomicU16,
    read_timeout_ms: AtomicU16,
    winsize_cols: Mutex<u16>,
    winsize_rows: Mutex<u16>,
    debug_enabled: AtomicBool,
    kb_mode: AtomicU8,
    esc_state: Mutex<u8>,
    nonblocking: AtomicBool,
}

TTY device implementation.

This device provides terminal functionality including line discipline, echo, and basic terminal I/O operations.

Fields

name: &'static str

uart_device_id: usize

input_buffer: Arc<Mutex<VecDeque<u8>>>

input_waker: Waker

canonical_mode: AtomicBool

echo_enabled: AtomicBool

read_min_ready_bytes: AtomicU16

read_timeout_ms: AtomicU16

winsize_cols: Mutex<u16>

winsize_rows: Mutex<u16>

debug_enabled: AtomicBool

kb_mode: AtomicU8

esc_state: Mutex<u8>

nonblocking: AtomicBool

Implementations

impl TtyDevice

pub fn new(name: &'static str, uart_device_id: usize) -> Self

pub fn wait_until_readable(&self, trapframe: &mut Trapframe)

Block until the TTY input buffer becomes non-empty. Used by polling syscalls (e.g. pselect6) to implement blocking semantics.

pub fn wake_input(&self)

Wake all tasks waiting for TTY input readiness. This is used by timeout handlers to preempt a blocking wait.

pub fn wait_until_readable_with_timeout_ticks( &self, trapframe: &mut Trapframe, ticks: u64, ) -> bool

Wait until readable with a timeout (in ticks). Returns true if timed out, false if input became available.

pub fn input_len(&self) -> usize

Current buffered input length (for diagnostics / readiness debugging)

pub fn is_read_ready_for_select(&self) -> bool

Read readiness for select/poll semantics.

• Canonical mode: ready only when a full line (ending with ‘\n’) exists.
• Non-canonical: honor read_min_ready_bytes; in RAW mode head 0xE0 requires a pair.

fn handle_input_byte(&self, byte: u8)

Handle input byte from UART device.

This method processes incoming bytes and applies line discipline.

fn echo_char(&self, byte: u8)

Echo character back to output.

fn echo_backspace(&self)

Echo backspace sequence.

Trait Implementations

impl CharDevice for TtyDevice

fn read(&self, buffer: &mut [u8]) -> usize

Read multiple bytes from the device

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

Read a single byte from the device

fn write_byte(&self, byte: u8) -> Result<(), &'static str>

Write a single byte to the device

fn can_read(&self) -> bool

Check if the device is ready for reading

fn can_write(&self) -> bool

Check if the device is ready for writing

fn write(&self, buffer: &[u8]) -> Result<usize, &'static str>

Write multiple bytes to the device

fn read_at( &self, _position: u64, buffer: &mut [u8], ) -> Result<usize, &'static str>

Read data from a specific position in the device

fn write_at(&self, _position: u64, buffer: &[u8]) -> Result<usize, &'static str>

Write data to a specific position in the device

fn can_seek(&self) -> bool

Check if this device supports seek operations

impl ControlOps for TtyDevice

fn control(&self, command: u32, arg: usize) -> Result<i32, &'static str>

Perform a control operation

fn supported_control_commands(&self) -> Vec<(u32, &'static str)>

Get a list of supported control commands

impl Device for TtyDevice

fn device_type(&self) -> DeviceType

fn name(&self) -> &'static str

fn as_any(&self) -> &dyn Any

fn as_any_mut(&mut self) -> &mut dyn Any

fn as_char_device(&self) -> Option<&dyn CharDevice>

Cast to CharDevice if this device is a character device

fn capabilities(&self) -> &'static [DeviceCapability]

Optional capabilities exposed by this device (default: none)

fn as_event_capable(&self) -> Option<&dyn EventCapableDevice>

Cast to EventCapableDevice if this device can emit events

fn as_block_device(&self) -> Option<&dyn BlockDevice>

Cast to BlockDevice if this device is a block device

fn as_graphics_device(&self) -> Option<&dyn GraphicsDevice>

Cast to GraphicsDevice if this device is a graphics device

fn as_network_device(&self) -> Option<&dyn NetworkDevice>

Cast to NetworkDevice if this device is a network device

fn into_block_device(self: Arc<Self>) -> Option<Arc<dyn BlockDevice>>

Cast Arc to Arc if this device is a block device This allows direct ownership of the block device for efficient I/O operations

fn into_char_device(self: Arc<Self>) -> Option<Arc<dyn CharDevice>>

Cast Arc to Arc if this device is a character device This allows direct ownership of the char device for efficient I/O operations

fn into_graphics_device(self: Arc<Self>) -> Option<Arc<dyn GraphicsDevice>>

Cast Arc to Arc if this device is a graphics device This allows direct ownership of the graphics device for efficient operations

fn into_network_device(self: Arc<Self>) -> Option<Arc<dyn NetworkDevice>>

Cast Arc to Arc if this device is a network device This allows direct ownership of the network device for efficient operations

impl DeviceEventListener for TtyDevice

fn on_device_event(&self, event: &dyn DeviceEvent)

fn interested_in(&self, event_type: &str) -> bool

impl MemoryMappingOps for TtyDevice

fn get_mapping_info( &self, _offset: usize, _length: usize, ) -> Result<(usize, usize, bool), &'static str>

Get mapping information for a region of the object

fn on_mapped( &self, _vaddr: usize, _paddr: usize, _length: usize, _offset: usize, )

Notification that a mapping has been created

fn on_unmapped(&self, _vaddr: usize, _length: usize)

Notification that a mapping has been removed

fn supports_mmap(&self) -> bool

Check if memory mapping is supported

fn get_mapping_info_with( &self, offset: usize, length: usize, _is_shared: bool, ) -> Result<(usize, usize, bool), &'static str>

Get mapping information with sharing intent.

fn mmap_owner_name(&self) -> String

Diagnostic helper: return a short owner name for logging

fn resolve_fault( &self, access: &AccessKind, map: &VirtualMemoryMap, ) -> Result<ResolveFaultResult, ResolveFaultError>

impl Selectable for TtyDevice

fn current_ready(&self, interest: ReadyInterest) -> ReadySet

Return current readiness for the given interest set.

fn wait_until_ready( &self, interest: ReadyInterest, trapframe: &mut Trapframe, timeout_ticks: Option<u64>, ) -> SelectWaitOutcome

Block the current task using the provided trapframe until the interest becomes ready or the optional timeout (in ticks) expires.

fn set_nonblocking(&self, enabled: bool)

Enable or disable non-blocking I/O semantics on this object.

fn is_nonblocking(&self) -> bool

Query whether non-blocking I/O semantics are enabled on this object.

impl TtyControl for TtyDevice

fn set_echo(&self, enabled: bool)

Enable or disable local echo.

fn is_echo_enabled(&self) -> bool

Returns whether local echo is enabled.

fn set_canonical(&self, enabled: bool)

Enable or disable canonical (line) mode.

fn is_canonical(&self) -> bool

Returns whether canonical (line) mode is enabled.

fn set_winsize(&self, cols: u16, rows: u16)

Set terminal window size in character cells.

fn get_winsize(&self) -> (u16, u16)

Get terminal window size in character cells.