Struct Device

pub struct Device<Ctx: DeviceContext = Normal>(/* private fields */);

The platform device representation.

This structure represents the Rust abstraction for a C struct platform_device. The implementation abstracts the usage of an already existing C struct platform_device within Rust code that we get passed from the C side.

Invariants

A Device instance represents a valid struct platform_device created by the C portion of the kernel.

Implementations

impl<Ctx: DeviceContext> Device<Ctx>

pub fn resource_by_index(&self, index: u32) -> Option<&Resource>

Returns the resource at index, if any.

pub fn resource_by_name(&self, name: &CStr) -> Option<&Resource>

Returns the resource with a given name, if any.

impl Device<Bound>

pub fn io_request_by_index(&self, index: u32) -> Option<IoRequest<'_>>

Returns an IoRequest for the resource at index, if any.

pub fn io_request_by_name(&self, name: &CStr) -> Option<IoRequest<'_>>

Returns an IoRequest for the resource with a given name, if any.

impl Device<Bound>

pub fn irq_by_index(&self, index: u32) -> Result<IrqRequest<'_>>

Returns an IrqRequest for the IRQ at the given index, if any.

pub fn optional_irq_by_index(&self, index: u32) -> Result<IrqRequest<'_>>

Returns an IrqRequest for the IRQ at the given index, but does not print an error if the IRQ cannot be obtained.

pub fn irq_by_name(&self, name: &CStr) -> Result<IrqRequest<'_>>

Returns an IrqRequest for the IRQ with the given name, if any.

pub fn optional_irq_by_name(&self, name: &CStr) -> Result<IrqRequest<'_>>

Returns an IrqRequest for the IRQ with the given name, but does not print an error if the IRQ cannot be obtained.

pub fn request_irq_by_index<'a, T: Handler + 'static>( &'a self, flags: Flags, index: u32, name: &'static CStr, handler: impl PinInit<T, Error> + 'a, ) -> Result<impl PinInit<Registration<T>, Error> + 'a>

Returns a irq::Registration for the IRQ at the given index.

pub fn request_irq_by_name<'a, T: Handler + 'static>( &'a self, flags: Flags, irq_name: &CStr, name: &'static CStr, handler: impl PinInit<T, Error> + 'a, ) -> Result<impl PinInit<Registration<T>, Error> + 'a>

Returns a irq::Registration for the IRQ with the given name.

pub fn request_optional_irq_by_index<'a, T: Handler + 'static>( &'a self, flags: Flags, index: u32, name: &'static CStr, handler: impl PinInit<T, Error> + 'a, ) -> Result<impl PinInit<Registration<T>, Error> + 'a>

Does the same as Self::request_irq_by_index, except that it does not print an error message if the IRQ cannot be obtained.

pub fn request_optional_irq_by_name<'a, T: Handler + 'static>( &'a self, flags: Flags, irq_name: &CStr, name: &'static CStr, handler: impl PinInit<T, Error> + 'a, ) -> Result<impl PinInit<Registration<T>, Error> + 'a>

Does the same as Self::request_irq_by_name, except that it does not print an error message if the IRQ cannot be obtained.

pub fn request_threaded_irq_by_index<'a, T: ThreadedHandler + 'static>( &'a self, flags: Flags, index: u32, name: &'static CStr, handler: impl PinInit<T, Error> + 'a, ) -> Result<impl PinInit<ThreadedRegistration<T>, Error> + 'a>

Returns a irq::ThreadedRegistration for the IRQ at the given index.

pub fn request_threaded_irq_by_name<'a, T: ThreadedHandler + 'static>( &'a self, flags: Flags, irq_name: &CStr, name: &'static CStr, handler: impl PinInit<T, Error> + 'a, ) -> Result<impl PinInit<ThreadedRegistration<T>, Error> + 'a>

Returns a irq::ThreadedRegistration for the IRQ with the given name.

pub fn request_optional_threaded_irq_by_index<'a, T: ThreadedHandler + 'static>( &'a self, flags: Flags, index: u32, name: &'static CStr, handler: impl PinInit<T, Error> + 'a, ) -> Result<impl PinInit<ThreadedRegistration<T>, Error> + 'a>

Does the same as Self::request_threaded_irq_by_index, except that it does not print an error message if the IRQ cannot be obtained.

pub fn request_optional_threaded_irq_by_name<'a, T: ThreadedHandler + 'static>( &'a self, flags: Flags, irq_name: &CStr, name: &'static CStr, handler: impl PinInit<T, Error> + 'a, ) -> Result<impl PinInit<ThreadedRegistration<T>, Error> + 'a>

Does the same as Self::request_threaded_irq_by_name, except that it does not print an error message if the IRQ cannot be obtained.

Trait Implementations

impl AlwaysRefCounted for Device

fn inc_ref(&self)

Increments the reference count on the object.

unsafe fn dec_ref(obj: NonNull<Self>)

Decrements the reference count on the object.

impl<Ctx: DeviceContext> AsRef<Device<Ctx>> for Device<Ctx>

fn as_ref(&self) -> &Device<Ctx>

Converts this type into a shared reference of the (usually inferred) input type.

impl Deref for Device<Bound>

type Target = Device

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Deref for Device<Core>

type Target = Device<Bound>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Deref for Device<CoreInternal>

type Target = Device<Core>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Device for Device<Core>

unsafe fn dma_set_mask(&self, mask: DmaMask) -> Result

Set up the device’s DMA streaming addressing capabilities.

unsafe fn dma_set_coherent_mask(&self, mask: DmaMask) -> Result

Set up the device’s DMA coherent addressing capabilities.

unsafe fn dma_set_mask_and_coherent(&self, mask: DmaMask) -> Result

Set up the device’s DMA addressing capabilities.

impl From<&Device<Bound>> for ARef<Device>

fn from(dev: &Device<Bound>) -> Self

Converts to this type from the input type.

impl From<&Device<Core>> for ARef<Device>

fn from(dev: &Device<Core>) -> Self

Converts to this type from the input type.

impl From<&Device<CoreInternal>> for ARef<Device>

fn from(dev: &Device<CoreInternal>) -> Self

Converts to this type from the input type.

impl<Ctx: DeviceContext> TryFrom<&Device<Ctx>> for &Device<Ctx>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(dev: &Device<Ctx>) -> Result<Self, Self::Error>

Performs the conversion.

impl Send for Device

impl Sync for Device