Struct Serial 

pub struct Serial {
    _p: (),
}

A serial teletype interface for x86_64 systems.

This struct provides a basic implementation of a serial TTY using the COM1 serial port. It implements the Teletype trait to allow read and write operations over a serial interface.

Fields

_p: ()

Implementations

impl Serial

pub const fn new() -> Self

Creates a new COM1 serial interface instance.

This function initializes a serial TTY for performing character-based I/O operations. The actual hardware interaction is handled via the Teletype trait methods (write and read).

Returns

• A new instance of Serial, representing a COM1 serial interface.

Trait Implementations

impl Default for Serial

fn default() -> Self

Returns the “default value” for a type.

impl Teletype for Serial

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

Writes data to the serial teletype (COM1).

This function attempts to convert the input byte slice into a UTF-8 string. If the conversion is successful, it prints the string to the console. If the data is aligned to a 16-byte boundary, it is printed as a single string; otherwise, it is printed byte by byte.

Arguments

• data: The byte slice to be written.

Returns

• Ok(usize): The number of bytes written.
• Err: If the input data is not valid UTF-8.

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

Reads data from the serial teletype (COM1).

This function retrieves data from the serial interface and stores it in the provided mutable buffer.

Arguments

• data: A mutable byte slice where the read data will be stored.

Returns

• Ok(usize): The number of bytes successfully read.
• Err: If the read operation failed.