ax-driver-base 0.3.6

Common interfaces for all kinds of device drivers
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

//! Device driver interfaces used by [ArceOS][1]. It provides common traits and
//! types for implementing a device driver.
//!
//! You have to use this crate with the following crates for corresponding
//! device types:
//!
//! - [`axdriver_block`][2]: Common traits for block storage drivers.
//! - [`axdriver_display`][3]: Common traits and types for graphics display drivers.
//! - [`axdriver_net`][4]: Common traits and types for network (NIC) drivers.
//!
//! [1]: https://github.com/arceos-org/arceos
//! [2]: ../ax-driver-block/index.html
//! [3]: ../ax-driver-display/index.html
//! [4]: ../ax-driver-net/index.html

#![no_std]

extern crate alloc;

use alloc::boxed::Box;

/// All supported device types.
#[derive(Debug, Clone, Copy, Eq, PartialEq)]
pub enum DeviceType {
    /// Block storage device (e.g., disk).
    Block,
    /// Character device (e.g., serial port).
    Char,
    /// Network device (e.g., ethernet card).
    Net,
    /// Graphic display device (e.g., GPU)
    Display,
    /// Input device (e.g., keyboard, mouse).
    Input,
    /// Vsock device (e.g., virtio-vsock).
    Vsock,
}

/// The error type for device operation failures.
#[derive(Debug)]
pub enum DevError {
    /// An entity already exists.
    AlreadyExists,
    /// Try again, for non-blocking APIs.
    Again,
    /// Bad internal state.
    BadState,
    /// Invalid parameter/argument.
    InvalidParam,
    /// Input/output error.
    Io,
    /// Not enough space/cannot allocate memory (DMA).
    NoMemory,
    /// Device or resource is busy.
    ResourceBusy,
    /// This operation is unsupported or unimplemented.
    Unsupported,
}

impl core::fmt::Display for DevError {
    fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
        match self {
            DevError::AlreadyExists => write!(f, "Entity already exists"),
            DevError::Again => write!(f, "Try again"),
            DevError::BadState => write!(f, "Bad state"),
            DevError::InvalidParam => write!(f, "Invalid parameter"),
            DevError::Io => write!(f, "Input/output error"),
            DevError::NoMemory => write!(f, "Not enough memory"),
            DevError::ResourceBusy => write!(f, "Resource is busy"),
            DevError::Unsupported => write!(f, "Unsupported operation"),
        }
    }
}

/// A specialized `Result` type for device operations.
pub type DevResult<T = ()> = Result<T, DevError>;

/// Common operations that require all device drivers to implement.
pub trait BaseDriverOps: Send + Sync {
    /// The name of the device.
    fn device_name(&self) -> &str;

    /// The type of the device.
    fn device_type(&self) -> DeviceType;

    /// The IRQ number of the device, if applicable.
    fn irq_num(&self) -> Option<usize> {
        None
    }
}

impl<T: BaseDriverOps + ?Sized> BaseDriverOps for Box<T> {
    fn device_name(&self) -> &str {
        (**self).device_name()
    }

    fn device_type(&self) -> DeviceType {
        (**self).device_type()
    }

    fn irq_num(&self) -> Option<usize> {
        (**self).irq_num()
    }
}