Struct DeviceManager

pub struct DeviceManager {
    pub basic: BasicDeviceManager,
    devices: Mutex<Vec<Arc<DeviceHandle>>>,
    drivers: Mutex<Vec<Box<dyn DeviceDriver>>>,
}

DeviceManager

This struct is the main device management system. It handles all devices and drivers, including basic I/O devices. It provides methods to register devices, populate devices from the FDT, and manage device drivers.

Fields

• basic: An instance of BasicDeviceManager for managing basic I/O devices.
• devices: A mutex-protected vector of all registered devices.
• drivers: A mutex-protected vector of all registered device drivers.

Fields

basic: BasicDeviceManager

devices: Mutex<Vec<Arc<DeviceHandle>>>

drivers: Mutex<Vec<Box<dyn DeviceDriver>>>

Implementations

impl DeviceManager

const fn new() -> Self

pub fn get_manager() -> &'static DeviceManager

pub fn get_mut_manager() -> &'static mut DeviceManager

pub fn register_device(&self, device: Box<dyn Device>) -> usize

Register a device with the manager

Arguments

• device: The device to register.

Returns

• The id of the registered device.

Example

let device = Box::new(MyDevice::new());
let id = DeviceManager::get_mut_manager().register_device(device);

pub fn borrow_device( &self, id: usize, ) -> Result<BorrowedDeviceGuard, &'static str>

Borrow a device by type and index

Arguments

• id: The id of the device to borrow.

Returns

A result containing a reference to the borrowed device, or an error if the device type is not found or the index is out of bounds.

pub fn borrow_exclusive_device( &self, id: usize, ) -> Result<BorrowedDeviceGuard, &'static str>

Borrow an exclusive device by type and index

Arguments

• id: The id of the device to borrow.

Returns

A result containing a reference to the borrowed device, or an error if the device type is not found or the index is out of bounds.

pub fn get_devices_count(&self) -> usize

Get the number of devices of a specific type

Returns

The number of devices of the specified type.

pub fn borrow_drivers(&self) -> &Mutex<Vec<Box<dyn DeviceDriver>>>

pub fn populate_devices(&mut self)

Populates devices from the FDT (Flattened Device Tree).

This function searches for the /soc node in the FDT and iterates through its children. For each child node, it checks if there is a compatible driver registered. If a matching driver is found, it probes the device using the driver’s probe method. If the probe is successful, the device is registered with the driver.

pub fn register_driver(&mut self, driver: Box<dyn DeviceDriver>)

Registers a device driver with the device manager.

This function takes a boxed device driver and adds it to the list of registered drivers. It is used to register drivers that can be used to probe and manage devices.

Arguments

• driver - A boxed device driver that implements the DeviceDriver trait.

Example

let driver = Box::new(MyDeviceDriver::new());
DeviceManager::get_mut_manager().register_driver(driver);