DragonOS/kernel/src/driver/base/platform/platform_device.rs

use super::{
    super::device::{Device, DeviceState, DeviceType},
    platform_driver::PlatformDriver,
    CompatibleTable,
};
use alloc::sync::Arc;

/// @brief: 实现该trait的设备实例应挂载在platform总线上，
///         同时应该实现Device trait
pub trait PlatformDevice: Device {
    fn get_type(&self) -> DeviceType {
        DeviceType::PlatformDev
    }

    /// @brief: 获取设备匹配表
    /// @parameter: None
    /// @return: 设备匹配表
    fn get_compatible_table(&self) -> CompatibleTable;

    /// @brief: 判断设备是否初始化
    /// @parameter: None
    /// @return: 如果已经初始化，返回true，否则，返回false
    fn is_initialized(&self) -> bool;

    /// @brief: 设置设备状态
    /// @parameter set_state: 设备状态
    /// @return: None
    fn set_state(&self, set_state: DeviceState);

    /// @brief: 设置platform设备驱动
    /// @parameter driver: platform设备驱动
    /// @return: None
    fn set_driver(&self, driver: Option<Arc<dyn PlatformDriver>>);
}