Struct DMSCDeviceControlModule 

pub struct DMSCDeviceControlModule { /* private fields */ }

Main device control module for DMSC.

This module provides comprehensive smart device control functionality, including device discovery, control, and resource scheduling. It manages devices and their resources across distributed environments.

Implementations

impl DMSCDeviceControlModule

pub fn new() -> Self

Creates a new device control module with default configuration.

Returns

A new DMSCDeviceControlModule instance with default configuration

pub fn with_config(self, config: DMSCDeviceControlConfig) -> Self

Configures the device control module with custom settings.

Parameters

• config: The custom configuration to apply

Returns

The updated DMSCDeviceControlModule instance

pub async fn discover_devices(&self) -> DMSCResult<DMSCDiscoveryResult>

Discovers devices in the network/environment.

This method performs a device discovery scan if discovery is enabled, returning information about discovered, updated, and removed devices.

Returns

A DMSCResult<DMSCDiscoveryResult> containing the discovery results

pub async fn allocate_resource( &self, request: DMSCResourceRequest, ) -> DMSCResult<Option<DMSCResourceAllocation>>

Allocates a device resource based on the given request.

This method finds a suitable device based on the requested device type and capabilities, allocates it using the device scheduler, and returns an allocation result if successful.

Parameters

• request: The resource allocation request

Returns

A DMSCResult<Option<DMSCResourceAllocation>> containing the allocation result if successful, or None if allocation failed or auto-scheduling is disabled

pub async fn release_resource(&self, allocation_id: &str) -> DMSCResult<()>

Releases a previously allocated device resource.

This method releases a device resource that was allocated with allocate_resource.

Parameters

• allocation_id: The ID of the allocation to release

Returns

A DMSCResult<()> indicating success or failure

pub async fn get_device_status(&self) -> DMSCResult<Vec<DMSCDevice>>

Gets the current status of all devices.

This method returns a list of all devices currently managed by the device controller.

Returns

A DMSCResult<Vec<DMSCDevice>> containing all managed devices

pub fn get_resource_pool_status( &self, ) -> HashMap<String, DMSCResourcePoolStatus>

Gets the status of all resource pools.

This method returns a map of resource pool names to their current status.

Returns

A HashMap<String, DMSCResourcePoolStatus> containing the status of all resource pools

Trait Implementations

impl DMSCModule for DMSCDeviceControlModule

fn name(&self) -> &str

Returns the name of the device control module.

Returns

The module name as a string

fn is_critical(&self) -> bool

Indicates whether the device control module is critical.

The device control module is non-critical, meaning that if it fails to initialize or operate, it should not break the entire application. This allows the core functionality to continue even if device control features are unavailable.

Returns

false since device control is non-critical

fn init<'life0, 'life1, 'async_trait>( &'life0 mut self, ctx: &'life1 mut DMSCServiceContext, ) -> Pin<Box<dyn Future<Output = DMSCResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Initializes the device control module asynchronously.

This method performs the following steps:

1. Loads configuration from the service context
2. Initializes real device discovery based on system hardware
3. Sets up resource scheduling and management

fn priority(&self) -> i32

Returns the priority of the module.

fn dependencies(&self) -> Vec<&str>

Returns the list of module dependencies.

fn before_start<'life0, 'life1, 'async_trait>( &'life0 mut self, _ctx: &'life1 mut DMSCServiceContext, ) -> Pin<Box<dyn Future<Output = DMSCResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Prepares the module for startup.

fn start<'life0, 'life1, 'async_trait>( &'life0 mut self, _ctx: &'life1 mut DMSCServiceContext, ) -> Pin<Box<dyn Future<Output = DMSCResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Starts the service module.

fn after_start<'life0, 'life1, 'async_trait>( &'life0 mut self, _ctx: &'life1 mut DMSCServiceContext, ) -> Pin<Box<dyn Future<Output = DMSCResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Performs post-startup operations.

fn before_shutdown<'life0, 'life1, 'async_trait>( &'life0 mut self, _ctx: &'life1 mut DMSCServiceContext, ) -> Pin<Box<dyn Future<Output = DMSCResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Prepares the module for shutdown.

fn shutdown<'life0, 'life1, 'async_trait>( &'life0 mut self, _ctx: &'life1 mut DMSCServiceContext, ) -> Pin<Box<dyn Future<Output = DMSCResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Shuts down the service module.

fn after_shutdown<'life0, 'life1, 'async_trait>( &'life0 mut self, _ctx: &'life1 mut DMSCServiceContext, ) -> Pin<Box<dyn Future<Output = DMSCResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Performs post-shutdown cleanup.

impl Default for DMSCDeviceControlModule

fn default() -> Self

Returns the “default value” for a type.

impl<'py> IntoPyObject<'py> for DMSCDeviceControlModule

type Target = DMSCDeviceControlModule

The Python output type

type Output = Bound<'py, <DMSCDeviceControlModule as IntoPyObject<'py>>::Target>

The smart pointer type to use.

type Error = PyErr

The type returned in the event of a conversion error.

fn into_pyobject( self, py: Python<'py>, ) -> Result<<Self as IntoPyObject<'_>>::Output, <Self as IntoPyObject<'_>>::Error>

Performs the conversion.

impl PyClass for DMSCDeviceControlModule

type Frozen = False

Whether the pyclass is frozen.

impl PyClassImpl for DMSCDeviceControlModule

const IS_BASETYPE: bool = false

#[pyclass(subclass)]

const IS_SUBCLASS: bool = false

#[pyclass(extends=…)]

const IS_MAPPING: bool = false

#[pyclass(mapping)]

const IS_SEQUENCE: bool = false

#[pyclass(sequence)]

const IS_IMMUTABLE_TYPE: bool = false

#[pyclass(immutable_type)]

const RAW_DOC: &'static CStr = c"Main device control module for DMSC.\n\nThis module provides comprehensive smart device control functionality, including device discovery,\ncontrol, and resource scheduling. It manages devices and their resources across distributed environments.\x00"

Docstring for the class provided on the struct or enum.

const DOC: &'static CStr

Fully rendered class doc, including the text_signature if a constructor is defined.

type BaseType = PyAny

Base class

type ThreadChecker = SendablePyClass<DMSCDeviceControlModule>

This handles following two situations:

type PyClassMutability = <<PyAny as PyClassBaseType>::PyClassMutability as PyClassMutability>::MutableChild

Immutable or mutable

type Dict = PyClassDummySlot

Specify this class has #[pyclass(dict)] or not.

type WeakRef = PyClassDummySlot

Specify this class has #[pyclass(weakref)] or not.

type BaseNativeType = PyAny

The closest native ancestor. This is PyAny by default, and when you declare #[pyclass(extends=PyDict)], it’s PyDict.

fn items_iter() -> PyClassItemsIter

fn lazy_type_object() -> &'static LazyTypeObject<Self>

fn dict_offset() -> Option<isize>

fn weaklist_offset() -> Option<isize>

impl PyMethods<DMSCDeviceControlModule> for PyClassImplCollector<DMSCDeviceControlModule>

fn py_methods(self) -> &'static PyClassItems

impl PyTypeInfo for DMSCDeviceControlModule

const NAME: &'static str = "DMSCDeviceControlModule"

Class name.

const MODULE: Option<&'static str> = ::core::option::Option::None

Module name, if any.

fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject

Returns the PyTypeObject instance for this type.

fn type_object(py: Python<'_>) -> Bound<'_, PyType>

Returns the safe abstraction over the type object.

fn is_type_of(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type or a subclass of this type.

fn is_exact_type_of(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type.

impl ServiceModule for DMSCDeviceControlModule

fn name(&self) -> &str

Returns the name of the service module.

fn is_critical(&self) -> bool

Indicates if the module is critical to the operation of the system.

fn priority(&self) -> i32

Returns the priority of the module.

fn dependencies(&self) -> Vec<&str>

Returns the list of module dependencies.

fn init(&mut self, _ctx: &mut DMSCServiceContext) -> DMSCResult<()>

Initializes the service module.

fn start(&mut self, _ctx: &mut DMSCServiceContext) -> DMSCResult<()>

Starts the service module.

fn shutdown(&mut self, _ctx: &mut DMSCServiceContext) -> DMSCResult<()>

Shuts down the service module.

fn before_start(&mut self, _ctx: &mut DMSCServiceContext) -> DMSCResult<()>

Prepares the module for startup.

fn after_start(&mut self, _ctx: &mut DMSCServiceContext) -> DMSCResult<()>

Performs post-startup operations.

fn before_shutdown(&mut self, _ctx: &mut DMSCServiceContext) -> DMSCResult<()>

Prepares the module for shutdown.

fn after_shutdown(&mut self, _ctx: &mut DMSCServiceContext) -> DMSCResult<()>

Performs post-shutdown cleanup.

impl DerefToPyAny for DMSCDeviceControlModule

impl ExtractPyClassWithClone for DMSCDeviceControlModule