mirror of
https://github.com/torvalds/linux.git
synced 2026-09-22 20:54:03 +02:00
rust: device: make Core and CoreInternal lifetime-parameterized
Device<Core> references in probe callbacks are scoped to the callback, not the full binding duration. Add a lifetime parameter to Core and CoreInternal to accurately represent this in the type system. Suggested-by: Gary Guo <gary@garyguo.net> Reviewed-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Reviewed-by: Alexandre Courbot <acourbot@nvidia.com> Reviewed-by: Eliot Courtney <ecourtney@nvidia.com> Reviewed-by: Gary Guo <gary@garyguo.net> Link: https://patch.msgid.link/20260525202921.124698-12-dakr@kernel.org Signed-off-by: Danilo Krummrich <dakr@kernel.org>
This commit is contained in:
parent
de12e48a1b
commit
24799831d6
|
|
@ -205,7 +205,7 @@ impl platform::Driver for CPUFreqDTDriver {
|
||||||
const OF_ID_TABLE: Option<of::IdTable<Self::IdInfo>> = Some(&OF_TABLE);
|
const OF_ID_TABLE: Option<of::IdTable<Self::IdInfo>> = Some(&OF_TABLE);
|
||||||
|
|
||||||
fn probe(
|
fn probe(
|
||||||
pdev: &platform::Device<Core>,
|
pdev: &platform::Device<Core<'_>>,
|
||||||
_id_info: Option<&Self::IdInfo>,
|
_id_info: Option<&Self::IdInfo>,
|
||||||
) -> impl PinInit<Self, Error> {
|
) -> impl PinInit<Self, Error> {
|
||||||
cpufreq::Registration::<CPUFreqDTDriver>::new_foreign_owned(pdev.as_ref())?;
|
cpufreq::Registration::<CPUFreqDTDriver>::new_foreign_owned(pdev.as_ref())?;
|
||||||
|
|
|
||||||
|
|
@ -54,7 +54,10 @@ impl auxiliary::Driver for NovaDriver {
|
||||||
type Data = Self;
|
type Data = Self;
|
||||||
const ID_TABLE: auxiliary::IdTable<Self::IdInfo> = &AUX_TABLE;
|
const ID_TABLE: auxiliary::IdTable<Self::IdInfo> = &AUX_TABLE;
|
||||||
|
|
||||||
fn probe(adev: &auxiliary::Device<Core>, _info: &Self::IdInfo) -> impl PinInit<Self, Error> {
|
fn probe(
|
||||||
|
adev: &auxiliary::Device<Core<'_>>,
|
||||||
|
_info: &Self::IdInfo,
|
||||||
|
) -> impl PinInit<Self, Error> {
|
||||||
let data = try_pin_init!(NovaData { adev: adev.into() });
|
let data = try_pin_init!(NovaData { adev: adev.into() });
|
||||||
|
|
||||||
let drm = drm::Device::<Self>::new(adev.as_ref(), data)?;
|
let drm = drm::Device::<Self>::new(adev.as_ref(), data)?;
|
||||||
|
|
|
||||||
|
|
@ -95,7 +95,7 @@ impl platform::Driver for TyrPlatformDriverData {
|
||||||
const OF_ID_TABLE: Option<of::IdTable<Self::IdInfo>> = Some(&OF_TABLE);
|
const OF_ID_TABLE: Option<of::IdTable<Self::IdInfo>> = Some(&OF_TABLE);
|
||||||
|
|
||||||
fn probe(
|
fn probe(
|
||||||
pdev: &platform::Device<Core>,
|
pdev: &platform::Device<Core<'_>>,
|
||||||
_info: Option<&Self::IdInfo>,
|
_info: Option<&Self::IdInfo>,
|
||||||
) -> impl PinInit<Self, Error> {
|
) -> impl PinInit<Self, Error> {
|
||||||
let core_clk = Clk::get(pdev.as_ref(), Some(c"core"))?;
|
let core_clk = Clk::get(pdev.as_ref(), Some(c"core"))?;
|
||||||
|
|
|
||||||
|
|
@ -77,7 +77,7 @@ impl pci::Driver for NovaCore {
|
||||||
type Data = Self;
|
type Data = Self;
|
||||||
const ID_TABLE: pci::IdTable<Self::IdInfo> = &PCI_TABLE;
|
const ID_TABLE: pci::IdTable<Self::IdInfo> = &PCI_TABLE;
|
||||||
|
|
||||||
fn probe(pdev: &pci::Device<Core>, _info: &Self::IdInfo) -> impl PinInit<Self, Error> {
|
fn probe(pdev: &pci::Device<Core<'_>>, _info: &Self::IdInfo) -> impl PinInit<Self, Error> {
|
||||||
pin_init::pin_init_scope(move || {
|
pin_init::pin_init_scope(move || {
|
||||||
dev_dbg!(pdev, "Probe Nova Core GPU driver.\n");
|
dev_dbg!(pdev, "Probe Nova Core GPU driver.\n");
|
||||||
|
|
||||||
|
|
@ -109,7 +109,7 @@ fn probe(pdev: &pci::Device<Core>, _info: &Self::IdInfo) -> impl PinInit<Self, E
|
||||||
})
|
})
|
||||||
}
|
}
|
||||||
|
|
||||||
fn unbind(pdev: &pci::Device<Core>, this: Pin<&Self>) {
|
fn unbind(pdev: &pci::Device<Core<'_>>, this: Pin<&Self>) {
|
||||||
this.gpu.unbind(pdev.as_ref());
|
this.gpu.unbind(pdev.as_ref());
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -278,7 +278,7 @@ pub(crate) fn new<'a>(
|
||||||
/// Called when the corresponding [`Device`](device::Device) is unbound.
|
/// Called when the corresponding [`Device`](device::Device) is unbound.
|
||||||
///
|
///
|
||||||
/// Note: This method must only be called from `Driver::unbind`.
|
/// Note: This method must only be called from `Driver::unbind`.
|
||||||
pub(crate) fn unbind(&self, dev: &device::Device<device::Core>) {
|
pub(crate) fn unbind(&self, dev: &device::Device<device::Core<'_>>) {
|
||||||
kernel::warn_on!(self
|
kernel::warn_on!(self
|
||||||
.bar
|
.bar
|
||||||
.access(dev)
|
.access(dev)
|
||||||
|
|
|
||||||
|
|
@ -320,7 +320,7 @@ impl platform::Driver for Th1520PwmPlatformDriver {
|
||||||
const OF_ID_TABLE: Option<of::IdTable<Self::IdInfo>> = Some(&OF_TABLE);
|
const OF_ID_TABLE: Option<of::IdTable<Self::IdInfo>> = Some(&OF_TABLE);
|
||||||
|
|
||||||
fn probe(
|
fn probe(
|
||||||
pdev: &platform::Device<Core>,
|
pdev: &platform::Device<Core<'_>>,
|
||||||
_id_info: Option<&Self::IdInfo>,
|
_id_info: Option<&Self::IdInfo>,
|
||||||
) -> impl PinInit<Self, Error> {
|
) -> impl PinInit<Self, Error> {
|
||||||
let dev = pdev.as_ref();
|
let dev = pdev.as_ref();
|
||||||
|
|
|
||||||
|
|
@ -87,7 +87,7 @@ extern "C" fn probe_callback(
|
||||||
// `struct auxiliary_device`.
|
// `struct auxiliary_device`.
|
||||||
//
|
//
|
||||||
// INVARIANT: `adev` is valid for the duration of `probe_callback()`.
|
// INVARIANT: `adev` is valid for the duration of `probe_callback()`.
|
||||||
let adev = unsafe { &*adev.cast::<Device<device::CoreInternal>>() };
|
let adev = unsafe { &*adev.cast::<Device<device::CoreInternal<'_>>>() };
|
||||||
|
|
||||||
// SAFETY: `DeviceId` is a `#[repr(transparent)`] wrapper of `struct auxiliary_device_id`
|
// SAFETY: `DeviceId` is a `#[repr(transparent)`] wrapper of `struct auxiliary_device_id`
|
||||||
// and does not add additional invariants, so it's safe to transmute.
|
// and does not add additional invariants, so it's safe to transmute.
|
||||||
|
|
@ -107,7 +107,7 @@ extern "C" fn remove_callback(adev: *mut bindings::auxiliary_device) {
|
||||||
// `struct auxiliary_device`.
|
// `struct auxiliary_device`.
|
||||||
//
|
//
|
||||||
// INVARIANT: `adev` is valid for the duration of `remove_callback()`.
|
// INVARIANT: `adev` is valid for the duration of `remove_callback()`.
|
||||||
let adev = unsafe { &*adev.cast::<Device<device::CoreInternal>>() };
|
let adev = unsafe { &*adev.cast::<Device<device::CoreInternal<'_>>>() };
|
||||||
|
|
||||||
// SAFETY: `remove_callback` is only ever called after a successful call to
|
// SAFETY: `remove_callback` is only ever called after a successful call to
|
||||||
// `probe_callback`, hence it's guaranteed that `Device::set_drvdata()` has been called
|
// `probe_callback`, hence it's guaranteed that `Device::set_drvdata()` has been called
|
||||||
|
|
@ -211,8 +211,10 @@ pub trait Driver {
|
||||||
/// Auxiliary driver probe.
|
/// Auxiliary driver probe.
|
||||||
///
|
///
|
||||||
/// Called when an auxiliary device is matches a corresponding driver.
|
/// Called when an auxiliary device is matches a corresponding driver.
|
||||||
fn probe(dev: &Device<device::Core>, id_info: &Self::IdInfo)
|
fn probe(
|
||||||
-> impl PinInit<Self::Data, Error>;
|
dev: &Device<device::Core<'_>>,
|
||||||
|
id_info: &Self::IdInfo,
|
||||||
|
) -> impl PinInit<Self::Data, Error>;
|
||||||
|
|
||||||
/// Auxiliary driver unbind.
|
/// Auxiliary driver unbind.
|
||||||
///
|
///
|
||||||
|
|
@ -224,7 +226,7 @@ fn probe(dev: &Device<device::Core>, id_info: &Self::IdInfo)
|
||||||
/// operations to gracefully tear down the device.
|
/// operations to gracefully tear down the device.
|
||||||
///
|
///
|
||||||
/// Otherwise, release operations for driver resources should be performed in `Drop`.
|
/// Otherwise, release operations for driver resources should be performed in `Drop`.
|
||||||
fn unbind(dev: &Device<device::Core>, this: Pin<&Self::Data>) {
|
fn unbind(dev: &Device<device::Core<'_>>, this: Pin<&Self::Data>) {
|
||||||
let _ = (dev, this);
|
let _ = (dev, this);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -892,7 +892,7 @@ fn register_em(_policy: &mut Policy) {
|
||||||
/// const OF_ID_TABLE: Option<of::IdTable<Self::IdInfo>> = None;
|
/// const OF_ID_TABLE: Option<of::IdTable<Self::IdInfo>> = None;
|
||||||
///
|
///
|
||||||
/// fn probe(
|
/// fn probe(
|
||||||
/// pdev: &platform::Device<Core>,
|
/// pdev: &platform::Device<Core<'_>>,
|
||||||
/// _id_info: Option<&Self::IdInfo>,
|
/// _id_info: Option<&Self::IdInfo>,
|
||||||
/// ) -> impl PinInit<Self, Error> {
|
/// ) -> impl PinInit<Self, Error> {
|
||||||
/// cpufreq::Registration::<SampleDriver>::new_foreign_owned(pdev.as_ref())?;
|
/// cpufreq::Registration::<SampleDriver>::new_foreign_owned(pdev.as_ref())?;
|
||||||
|
|
|
||||||
|
|
@ -201,7 +201,7 @@ pub unsafe fn as_bound(&self) -> &Device<Bound> {
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl Device<CoreInternal> {
|
impl<'a> Device<CoreInternal<'a>> {
|
||||||
/// Store a pointer to the bound driver's private data.
|
/// Store a pointer to the bound driver's private data.
|
||||||
pub fn set_drvdata<T>(&self, data: impl PinInit<T, Error>) -> Result {
|
pub fn set_drvdata<T>(&self, data: impl PinInit<T, Error>) -> Result {
|
||||||
let data = KBox::pin_init(data, GFP_KERNEL)?;
|
let data = KBox::pin_init(data, GFP_KERNEL)?;
|
||||||
|
|
@ -511,7 +511,7 @@ pub trait DeviceContext: private::Sealed {}
|
||||||
/// callback it appears in. It is intended to be used for synchronization purposes. Bus device
|
/// callback it appears in. It is intended to be used for synchronization purposes. Bus device
|
||||||
/// implementations can implement methods for [`Device<Core>`], such that they can only be called
|
/// implementations can implement methods for [`Device<Core>`], such that they can only be called
|
||||||
/// from bus callbacks.
|
/// from bus callbacks.
|
||||||
pub struct Core;
|
pub struct Core<'a>(PhantomData<&'a ()>);
|
||||||
|
|
||||||
/// Semantically the same as [`Core`], but reserved for internal usage of the corresponding bus
|
/// Semantically the same as [`Core`], but reserved for internal usage of the corresponding bus
|
||||||
/// abstraction.
|
/// abstraction.
|
||||||
|
|
@ -522,7 +522,7 @@ pub trait DeviceContext: private::Sealed {}
|
||||||
///
|
///
|
||||||
/// This context mainly exists to share generic [`Device`] infrastructure that should only be called
|
/// This context mainly exists to share generic [`Device`] infrastructure that should only be called
|
||||||
/// from bus callbacks with bus abstractions, but without making them accessible for drivers.
|
/// from bus callbacks with bus abstractions, but without making them accessible for drivers.
|
||||||
pub struct CoreInternal;
|
pub struct CoreInternal<'a>(PhantomData<&'a ()>);
|
||||||
|
|
||||||
/// The [`Bound`] context is the [`DeviceContext`] of a bus specific device when it is guaranteed to
|
/// The [`Bound`] context is the [`DeviceContext`] of a bus specific device when it is guaranteed to
|
||||||
/// be bound to a driver.
|
/// be bound to a driver.
|
||||||
|
|
@ -546,14 +546,14 @@ mod private {
|
||||||
pub trait Sealed {}
|
pub trait Sealed {}
|
||||||
|
|
||||||
impl Sealed for super::Bound {}
|
impl Sealed for super::Bound {}
|
||||||
impl Sealed for super::Core {}
|
impl<'a> Sealed for super::Core<'a> {}
|
||||||
impl Sealed for super::CoreInternal {}
|
impl<'a> Sealed for super::CoreInternal<'a> {}
|
||||||
impl Sealed for super::Normal {}
|
impl Sealed for super::Normal {}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl DeviceContext for Bound {}
|
impl DeviceContext for Bound {}
|
||||||
impl DeviceContext for Core {}
|
impl<'a> DeviceContext for Core<'a> {}
|
||||||
impl DeviceContext for CoreInternal {}
|
impl<'a> DeviceContext for CoreInternal<'a> {}
|
||||||
impl DeviceContext for Normal {}
|
impl DeviceContext for Normal {}
|
||||||
|
|
||||||
impl<Ctx: DeviceContext> AsRef<Device<Ctx>> for Device<Ctx> {
|
impl<Ctx: DeviceContext> AsRef<Device<Ctx>> for Device<Ctx> {
|
||||||
|
|
@ -603,6 +603,22 @@ unsafe fn from_device(dev: &Device<Ctx>) -> &Self
|
||||||
#[doc(hidden)]
|
#[doc(hidden)]
|
||||||
#[macro_export]
|
#[macro_export]
|
||||||
macro_rules! __impl_device_context_deref {
|
macro_rules! __impl_device_context_deref {
|
||||||
|
(unsafe { $device:ident, <$lt:lifetime> $src:ty => $dst:ty }) => {
|
||||||
|
impl<$lt> ::core::ops::Deref for $device<$src> {
|
||||||
|
type Target = $device<$dst>;
|
||||||
|
|
||||||
|
fn deref(&self) -> &Self::Target {
|
||||||
|
let ptr: *const Self = self;
|
||||||
|
|
||||||
|
// CAST: `$device<$src>` and `$device<$dst>` transparently wrap the same type by the
|
||||||
|
// safety requirement of the macro.
|
||||||
|
let ptr = ptr.cast::<Self::Target>();
|
||||||
|
|
||||||
|
// SAFETY: `ptr` was derived from `&self`.
|
||||||
|
unsafe { &*ptr }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
(unsafe { $device:ident, $src:ty => $dst:ty }) => {
|
(unsafe { $device:ident, $src:ty => $dst:ty }) => {
|
||||||
impl ::core::ops::Deref for $device<$src> {
|
impl ::core::ops::Deref for $device<$src> {
|
||||||
type Target = $device<$dst>;
|
type Target = $device<$dst>;
|
||||||
|
|
@ -635,14 +651,14 @@ macro_rules! impl_device_context_deref {
|
||||||
// `__impl_device_context_deref!`.
|
// `__impl_device_context_deref!`.
|
||||||
::kernel::__impl_device_context_deref!(unsafe {
|
::kernel::__impl_device_context_deref!(unsafe {
|
||||||
$device,
|
$device,
|
||||||
$crate::device::CoreInternal => $crate::device::Core
|
<'a> $crate::device::CoreInternal<'a> => $crate::device::Core<'a>
|
||||||
});
|
});
|
||||||
|
|
||||||
// SAFETY: This macro has the exact same safety requirement as
|
// SAFETY: This macro has the exact same safety requirement as
|
||||||
// `__impl_device_context_deref!`.
|
// `__impl_device_context_deref!`.
|
||||||
::kernel::__impl_device_context_deref!(unsafe {
|
::kernel::__impl_device_context_deref!(unsafe {
|
||||||
$device,
|
$device,
|
||||||
$crate::device::Core => $crate::device::Bound
|
<'a> $crate::device::Core<'a> => $crate::device::Bound
|
||||||
});
|
});
|
||||||
|
|
||||||
// SAFETY: This macro has the exact same safety requirement as
|
// SAFETY: This macro has the exact same safety requirement as
|
||||||
|
|
@ -657,6 +673,13 @@ macro_rules! impl_device_context_deref {
|
||||||
#[doc(hidden)]
|
#[doc(hidden)]
|
||||||
#[macro_export]
|
#[macro_export]
|
||||||
macro_rules! __impl_device_context_into_aref {
|
macro_rules! __impl_device_context_into_aref {
|
||||||
|
(<$lt:lifetime> $src:ty, $device:tt) => {
|
||||||
|
impl<$lt> ::core::convert::From<&$device<$src>> for $crate::sync::aref::ARef<$device> {
|
||||||
|
fn from(dev: &$device<$src>) -> Self {
|
||||||
|
(&**dev).into()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
($src:ty, $device:tt) => {
|
($src:ty, $device:tt) => {
|
||||||
impl ::core::convert::From<&$device<$src>> for $crate::sync::aref::ARef<$device> {
|
impl ::core::convert::From<&$device<$src>> for $crate::sync::aref::ARef<$device> {
|
||||||
fn from(dev: &$device<$src>) -> Self {
|
fn from(dev: &$device<$src>) -> Self {
|
||||||
|
|
@ -671,8 +694,12 @@ fn from(dev: &$device<$src>) -> Self {
|
||||||
#[macro_export]
|
#[macro_export]
|
||||||
macro_rules! impl_device_context_into_aref {
|
macro_rules! impl_device_context_into_aref {
|
||||||
($device:tt) => {
|
($device:tt) => {
|
||||||
::kernel::__impl_device_context_into_aref!($crate::device::CoreInternal, $device);
|
::kernel::__impl_device_context_into_aref!(
|
||||||
::kernel::__impl_device_context_into_aref!($crate::device::Core, $device);
|
<'a> $crate::device::CoreInternal<'a>, $device
|
||||||
|
);
|
||||||
|
::kernel::__impl_device_context_into_aref!(
|
||||||
|
<'a> $crate::device::Core<'a>, $device
|
||||||
|
);
|
||||||
::kernel::__impl_device_context_into_aref!($crate::device::Bound, $device);
|
::kernel::__impl_device_context_into_aref!($crate::device::Bound, $device);
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -304,7 +304,7 @@ pub fn device(&self) -> &Device {
|
||||||
/// pci, //
|
/// pci, //
|
||||||
/// };
|
/// };
|
||||||
///
|
///
|
||||||
/// fn from_core(dev: &pci::Device<Core>, devres: Devres<pci::Bar<0x4>>) -> Result {
|
/// fn from_core(dev: &pci::Device<Core<'_>>, devres: Devres<pci::Bar<0x4>>) -> Result {
|
||||||
/// let bar = devres.access(dev.as_ref())?;
|
/// let bar = devres.access(dev.as_ref())?;
|
||||||
///
|
///
|
||||||
/// let _ = bar.read32(0x0);
|
/// let _ = bar.read32(0x0);
|
||||||
|
|
|
||||||
|
|
@ -47,7 +47,7 @@
|
||||||
/// where the underlying bus is DMA capable, such as:
|
/// where the underlying bus is DMA capable, such as:
|
||||||
#[cfg_attr(CONFIG_PCI, doc = "* [`pci::Device`](kernel::pci::Device)")]
|
#[cfg_attr(CONFIG_PCI, doc = "* [`pci::Device`](kernel::pci::Device)")]
|
||||||
/// * [`platform::Device`](::kernel::platform::Device)
|
/// * [`platform::Device`](::kernel::platform::Device)
|
||||||
pub trait Device: AsRef<device::Device<Core>> {
|
pub trait Device<'a>: AsRef<device::Device<Core<'a>>> {
|
||||||
/// Set up the device's DMA streaming addressing capabilities.
|
/// Set up the device's DMA streaming addressing capabilities.
|
||||||
///
|
///
|
||||||
/// This method is usually called once from `probe()` as soon as the device capabilities are
|
/// This method is usually called once from `probe()` as soon as the device capabilities are
|
||||||
|
|
|
||||||
|
|
@ -27,11 +27,11 @@
|
||||||
//! const ACPI_ID_TABLE: Option<acpi::IdTable<Self::IdInfo>> = None;
|
//! const ACPI_ID_TABLE: Option<acpi::IdTable<Self::IdInfo>> = None;
|
||||||
//!
|
//!
|
||||||
//! /// Driver probe.
|
//! /// Driver probe.
|
||||||
//! fn probe(dev: &Device<device::Core>, id_info: &Self::IdInfo)
|
//! fn probe(dev: &Device<device::Core<'_>>, id_info: &Self::IdInfo)
|
||||||
//! -> impl PinInit<Self::Data, Error>;
|
//! -> impl PinInit<Self::Data, Error>;
|
||||||
//!
|
//!
|
||||||
//! /// Driver unbind (optional).
|
//! /// Driver unbind (optional).
|
||||||
//! fn unbind(dev: &Device<device::Core>, this: Pin<&Self::Data>) {
|
//! fn unbind(dev: &Device<device::Core<'_>>, this: Pin<&Self::Data>) {
|
||||||
//! let _ = (dev, this);
|
//! let _ = (dev, this);
|
||||||
//! }
|
//! }
|
||||||
//! }
|
//! }
|
||||||
|
|
@ -191,7 +191,7 @@ extern "C" fn post_unbind_callback(dev: *mut bindings::device) {
|
||||||
// a `struct device`.
|
// a `struct device`.
|
||||||
//
|
//
|
||||||
// INVARIANT: `dev` is valid for the duration of the `post_unbind_callback()`.
|
// INVARIANT: `dev` is valid for the duration of the `post_unbind_callback()`.
|
||||||
let dev = unsafe { &*dev.cast::<device::Device<device::CoreInternal>>() };
|
let dev = unsafe { &*dev.cast::<device::Device<device::CoreInternal<'_>>>() };
|
||||||
|
|
||||||
// `remove()` has been completed at this point; devres resources are still valid and will
|
// `remove()` has been completed at this point; devres resources are still valid and will
|
||||||
// be released after the driver's bus device private data is dropped.
|
// be released after the driver's bus device private data is dropped.
|
||||||
|
|
|
||||||
|
|
@ -157,7 +157,7 @@ extern "C" fn probe_callback(idev: *mut bindings::i2c_client) -> kernel::ffi::c_
|
||||||
// `struct i2c_client`.
|
// `struct i2c_client`.
|
||||||
//
|
//
|
||||||
// INVARIANT: `idev` is valid for the duration of `probe_callback()`.
|
// INVARIANT: `idev` is valid for the duration of `probe_callback()`.
|
||||||
let idev = unsafe { &*idev.cast::<I2cClient<device::CoreInternal>>() };
|
let idev = unsafe { &*idev.cast::<I2cClient<device::CoreInternal<'_>>>() };
|
||||||
|
|
||||||
let info =
|
let info =
|
||||||
Self::i2c_id_info(idev).or_else(|| <Self as driver::Adapter>::id_info(idev.as_ref()));
|
Self::i2c_id_info(idev).or_else(|| <Self as driver::Adapter>::id_info(idev.as_ref()));
|
||||||
|
|
@ -172,7 +172,7 @@ extern "C" fn probe_callback(idev: *mut bindings::i2c_client) -> kernel::ffi::c_
|
||||||
|
|
||||||
extern "C" fn remove_callback(idev: *mut bindings::i2c_client) {
|
extern "C" fn remove_callback(idev: *mut bindings::i2c_client) {
|
||||||
// SAFETY: `idev` is a valid pointer to a `struct i2c_client`.
|
// SAFETY: `idev` is a valid pointer to a `struct i2c_client`.
|
||||||
let idev = unsafe { &*idev.cast::<I2cClient<device::CoreInternal>>() };
|
let idev = unsafe { &*idev.cast::<I2cClient<device::CoreInternal<'_>>>() };
|
||||||
|
|
||||||
// SAFETY: `remove_callback` is only ever called after a successful call to
|
// SAFETY: `remove_callback` is only ever called after a successful call to
|
||||||
// `probe_callback`, hence it's guaranteed that `I2cClient::set_drvdata()` has been called
|
// `probe_callback`, hence it's guaranteed that `I2cClient::set_drvdata()` has been called
|
||||||
|
|
@ -184,7 +184,7 @@ extern "C" fn remove_callback(idev: *mut bindings::i2c_client) {
|
||||||
|
|
||||||
extern "C" fn shutdown_callback(idev: *mut bindings::i2c_client) {
|
extern "C" fn shutdown_callback(idev: *mut bindings::i2c_client) {
|
||||||
// SAFETY: `shutdown_callback` is only ever called for a valid `idev`
|
// SAFETY: `shutdown_callback` is only ever called for a valid `idev`
|
||||||
let idev = unsafe { &*idev.cast::<I2cClient<device::CoreInternal>>() };
|
let idev = unsafe { &*idev.cast::<I2cClient<device::CoreInternal<'_>>>() };
|
||||||
|
|
||||||
// SAFETY: `shutdown_callback` is only ever called after a successful call to
|
// SAFETY: `shutdown_callback` is only ever called after a successful call to
|
||||||
// `probe_callback`, hence it's guaranteed that `Device::set_drvdata()` has been called
|
// `probe_callback`, hence it's guaranteed that `Device::set_drvdata()` has been called
|
||||||
|
|
@ -300,13 +300,13 @@ macro_rules! module_i2c_driver {
|
||||||
/// const ACPI_ID_TABLE: Option<acpi::IdTable<Self::IdInfo>> = Some(&ACPI_TABLE);
|
/// const ACPI_ID_TABLE: Option<acpi::IdTable<Self::IdInfo>> = Some(&ACPI_TABLE);
|
||||||
///
|
///
|
||||||
/// fn probe(
|
/// fn probe(
|
||||||
/// _idev: &i2c::I2cClient<Core>,
|
/// _idev: &i2c::I2cClient<Core<'_>>,
|
||||||
/// _id_info: Option<&Self::IdInfo>,
|
/// _id_info: Option<&Self::IdInfo>,
|
||||||
/// ) -> impl PinInit<Self::Data, Error> {
|
/// ) -> impl PinInit<Self::Data, Error> {
|
||||||
/// Err(ENODEV)
|
/// Err(ENODEV)
|
||||||
/// }
|
/// }
|
||||||
///
|
///
|
||||||
/// fn shutdown(_idev: &i2c::I2cClient<Core>, this: Pin<&Self::Data>) {
|
/// fn shutdown(_idev: &i2c::I2cClient<Core<'_>>, this: Pin<&Self::Data>) {
|
||||||
/// }
|
/// }
|
||||||
/// }
|
/// }
|
||||||
///```
|
///```
|
||||||
|
|
@ -336,7 +336,7 @@ pub trait Driver {
|
||||||
/// Called when a new i2c client is added or discovered.
|
/// Called when a new i2c client is added or discovered.
|
||||||
/// Implementers should attempt to initialize the client here.
|
/// Implementers should attempt to initialize the client here.
|
||||||
fn probe(
|
fn probe(
|
||||||
dev: &I2cClient<device::Core>,
|
dev: &I2cClient<device::Core<'_>>,
|
||||||
id_info: Option<&Self::IdInfo>,
|
id_info: Option<&Self::IdInfo>,
|
||||||
) -> impl PinInit<Self::Data, Error>;
|
) -> impl PinInit<Self::Data, Error>;
|
||||||
|
|
||||||
|
|
@ -351,7 +351,7 @@ fn probe(
|
||||||
/// This callback is distinct from final resource cleanup, as the driver instance remains valid
|
/// This callback is distinct from final resource cleanup, as the driver instance remains valid
|
||||||
/// after it returns. Any deallocation or teardown of driver-owned resources should instead be
|
/// after it returns. Any deallocation or teardown of driver-owned resources should instead be
|
||||||
/// handled in `Drop`.
|
/// handled in `Drop`.
|
||||||
fn shutdown(dev: &I2cClient<device::Core>, this: Pin<&Self::Data>) {
|
fn shutdown(dev: &I2cClient<device::Core<'_>>, this: Pin<&Self::Data>) {
|
||||||
let _ = (dev, this);
|
let _ = (dev, this);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
@ -365,7 +365,7 @@ fn shutdown(dev: &I2cClient<device::Core>, this: Pin<&Self::Data>) {
|
||||||
/// operations to gracefully tear down the device.
|
/// operations to gracefully tear down the device.
|
||||||
///
|
///
|
||||||
/// Otherwise, release operations for driver resources should be performed in `Drop`.
|
/// Otherwise, release operations for driver resources should be performed in `Drop`.
|
||||||
fn unbind(dev: &I2cClient<device::Core>, this: Pin<&Self::Data>) {
|
fn unbind(dev: &I2cClient<device::Core<'_>>, this: Pin<&Self::Data>) {
|
||||||
let _ = (dev, this);
|
let _ = (dev, this);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -65,7 +65,7 @@ pub(crate) unsafe fn new(device: &'a Device<Bound>, resource: &'a Resource) -> S
|
||||||
/// # type Data = Self;
|
/// # type Data = Self;
|
||||||
///
|
///
|
||||||
/// fn probe(
|
/// fn probe(
|
||||||
/// pdev: &platform::Device<Core>,
|
/// pdev: &platform::Device<Core<'_>>,
|
||||||
/// info: Option<&Self::IdInfo>,
|
/// info: Option<&Self::IdInfo>,
|
||||||
/// ) -> impl PinInit<Self, Error> {
|
/// ) -> impl PinInit<Self, Error> {
|
||||||
/// let offset = 0; // Some offset.
|
/// let offset = 0; // Some offset.
|
||||||
|
|
@ -130,7 +130,7 @@ pub fn iomap_exclusive_sized<const SIZE: usize>(
|
||||||
/// # type Data = Self;
|
/// # type Data = Self;
|
||||||
///
|
///
|
||||||
/// fn probe(
|
/// fn probe(
|
||||||
/// pdev: &platform::Device<Core>,
|
/// pdev: &platform::Device<Core<'_>>,
|
||||||
/// info: Option<&Self::IdInfo>,
|
/// info: Option<&Self::IdInfo>,
|
||||||
/// ) -> impl PinInit<Self, Error> {
|
/// ) -> impl PinInit<Self, Error> {
|
||||||
/// let offset = 0; // Some offset.
|
/// let offset = 0; // Some offset.
|
||||||
|
|
|
||||||
|
|
@ -105,7 +105,7 @@ extern "C" fn probe_callback(
|
||||||
// `struct pci_dev`.
|
// `struct pci_dev`.
|
||||||
//
|
//
|
||||||
// INVARIANT: `pdev` is valid for the duration of `probe_callback()`.
|
// INVARIANT: `pdev` is valid for the duration of `probe_callback()`.
|
||||||
let pdev = unsafe { &*pdev.cast::<Device<device::CoreInternal>>() };
|
let pdev = unsafe { &*pdev.cast::<Device<device::CoreInternal<'_>>>() };
|
||||||
|
|
||||||
// SAFETY: `DeviceId` is a `#[repr(transparent)]` wrapper of `struct pci_device_id` and
|
// SAFETY: `DeviceId` is a `#[repr(transparent)]` wrapper of `struct pci_device_id` and
|
||||||
// does not add additional invariants, so it's safe to transmute.
|
// does not add additional invariants, so it's safe to transmute.
|
||||||
|
|
@ -125,7 +125,7 @@ extern "C" fn remove_callback(pdev: *mut bindings::pci_dev) {
|
||||||
// `struct pci_dev`.
|
// `struct pci_dev`.
|
||||||
//
|
//
|
||||||
// INVARIANT: `pdev` is valid for the duration of `remove_callback()`.
|
// INVARIANT: `pdev` is valid for the duration of `remove_callback()`.
|
||||||
let pdev = unsafe { &*pdev.cast::<Device<device::CoreInternal>>() };
|
let pdev = unsafe { &*pdev.cast::<Device<device::CoreInternal<'_>>>() };
|
||||||
|
|
||||||
// SAFETY: `remove_callback` is only ever called after a successful call to
|
// SAFETY: `remove_callback` is only ever called after a successful call to
|
||||||
// `probe_callback`, hence it's guaranteed that `Device::set_drvdata()` has been called
|
// `probe_callback`, hence it's guaranteed that `Device::set_drvdata()` has been called
|
||||||
|
|
@ -283,7 +283,7 @@ macro_rules! pci_device_table {
|
||||||
/// const ID_TABLE: pci::IdTable<Self::IdInfo> = &PCI_TABLE;
|
/// const ID_TABLE: pci::IdTable<Self::IdInfo> = &PCI_TABLE;
|
||||||
///
|
///
|
||||||
/// fn probe(
|
/// fn probe(
|
||||||
/// _pdev: &pci::Device<Core>,
|
/// _pdev: &pci::Device<Core<'_>>,
|
||||||
/// _id_info: &Self::IdInfo,
|
/// _id_info: &Self::IdInfo,
|
||||||
/// ) -> impl PinInit<Self, Error> {
|
/// ) -> impl PinInit<Self, Error> {
|
||||||
/// Err(ENODEV)
|
/// Err(ENODEV)
|
||||||
|
|
@ -311,8 +311,10 @@ pub trait Driver {
|
||||||
///
|
///
|
||||||
/// Called when a new pci device is added or discovered. Implementers should
|
/// Called when a new pci device is added or discovered. Implementers should
|
||||||
/// attempt to initialize the device here.
|
/// attempt to initialize the device here.
|
||||||
fn probe(dev: &Device<device::Core>, id_info: &Self::IdInfo)
|
fn probe(
|
||||||
-> impl PinInit<Self::Data, Error>;
|
dev: &Device<device::Core<'_>>,
|
||||||
|
id_info: &Self::IdInfo,
|
||||||
|
) -> impl PinInit<Self::Data, Error>;
|
||||||
|
|
||||||
/// PCI driver unbind.
|
/// PCI driver unbind.
|
||||||
///
|
///
|
||||||
|
|
@ -324,7 +326,7 @@ fn probe(dev: &Device<device::Core>, id_info: &Self::IdInfo)
|
||||||
/// operations to gracefully tear down the device.
|
/// operations to gracefully tear down the device.
|
||||||
///
|
///
|
||||||
/// Otherwise, release operations for driver resources should be performed in `Drop`.
|
/// Otherwise, release operations for driver resources should be performed in `Drop`.
|
||||||
fn unbind(dev: &Device<device::Core>, this: Pin<&Self::Data>) {
|
fn unbind(dev: &Device<device::Core<'_>>, this: Pin<&Self::Data>) {
|
||||||
let _ = (dev, this);
|
let _ = (dev, this);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
@ -359,7 +361,7 @@ impl Device {
|
||||||
///
|
///
|
||||||
/// ```
|
/// ```
|
||||||
/// # use kernel::{device::Core, pci::{self, Vendor}, prelude::*};
|
/// # use kernel::{device::Core, pci::{self, Vendor}, prelude::*};
|
||||||
/// fn log_device_info(pdev: &pci::Device<Core>) -> Result {
|
/// fn log_device_info(pdev: &pci::Device<Core<'_>>) -> Result {
|
||||||
/// // Get an instance of `Vendor`.
|
/// // Get an instance of `Vendor`.
|
||||||
/// let vendor = pdev.vendor_id();
|
/// let vendor = pdev.vendor_id();
|
||||||
/// dev_info!(
|
/// dev_info!(
|
||||||
|
|
@ -450,7 +452,7 @@ pub fn pci_class(&self) -> Class {
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl Device<device::Core> {
|
impl<'a> Device<device::Core<'a>> {
|
||||||
/// Enable memory resources for this device.
|
/// Enable memory resources for this device.
|
||||||
pub fn enable_device_mem(&self) -> Result {
|
pub fn enable_device_mem(&self) -> Result {
|
||||||
// SAFETY: `self.as_raw` is guaranteed to be a pointer to a valid `struct pci_dev`.
|
// SAFETY: `self.as_raw` is guaranteed to be a pointer to a valid `struct pci_dev`.
|
||||||
|
|
@ -476,7 +478,7 @@ unsafe impl<Ctx: device::DeviceContext> device::AsBusDevice<Ctx> for Device<Ctx>
|
||||||
kernel::impl_device_context_deref!(unsafe { Device });
|
kernel::impl_device_context_deref!(unsafe { Device });
|
||||||
kernel::impl_device_context_into_aref!(Device);
|
kernel::impl_device_context_into_aref!(Device);
|
||||||
|
|
||||||
impl crate::dma::Device for Device<device::Core> {}
|
impl<'a> crate::dma::Device<'a> for Device<device::Core<'a>> {}
|
||||||
|
|
||||||
// SAFETY: Instances of `Device` are always reference-counted.
|
// SAFETY: Instances of `Device` are always reference-counted.
|
||||||
unsafe impl crate::sync::aref::AlwaysRefCounted for Device {
|
unsafe impl crate::sync::aref::AlwaysRefCounted for Device {
|
||||||
|
|
|
||||||
|
|
@ -19,7 +19,7 @@
|
||||||
///
|
///
|
||||||
/// ```
|
/// ```
|
||||||
/// # use kernel::{device::Core, pci::{self, Class}, prelude::*};
|
/// # use kernel::{device::Core, pci::{self, Class}, prelude::*};
|
||||||
/// fn probe_device(pdev: &pci::Device<Core>) -> Result {
|
/// fn probe_device(pdev: &pci::Device<Core<'_>>) -> Result {
|
||||||
/// let pci_class = pdev.pci_class();
|
/// let pci_class = pdev.pci_class();
|
||||||
/// dev_info!(
|
/// dev_info!(
|
||||||
/// pdev,
|
/// pdev,
|
||||||
|
|
|
||||||
|
|
@ -97,7 +97,7 @@ extern "C" fn probe_callback(pdev: *mut bindings::platform_device) -> kernel::ff
|
||||||
// `struct platform_device`.
|
// `struct platform_device`.
|
||||||
//
|
//
|
||||||
// INVARIANT: `pdev` is valid for the duration of `probe_callback()`.
|
// INVARIANT: `pdev` is valid for the duration of `probe_callback()`.
|
||||||
let pdev = unsafe { &*pdev.cast::<Device<device::CoreInternal>>() };
|
let pdev = unsafe { &*pdev.cast::<Device<device::CoreInternal<'_>>>() };
|
||||||
let info = <Self as driver::Adapter>::id_info(pdev.as_ref());
|
let info = <Self as driver::Adapter>::id_info(pdev.as_ref());
|
||||||
|
|
||||||
from_result(|| {
|
from_result(|| {
|
||||||
|
|
@ -113,7 +113,7 @@ extern "C" fn remove_callback(pdev: *mut bindings::platform_device) {
|
||||||
// `struct platform_device`.
|
// `struct platform_device`.
|
||||||
//
|
//
|
||||||
// INVARIANT: `pdev` is valid for the duration of `remove_callback()`.
|
// INVARIANT: `pdev` is valid for the duration of `remove_callback()`.
|
||||||
let pdev = unsafe { &*pdev.cast::<Device<device::CoreInternal>>() };
|
let pdev = unsafe { &*pdev.cast::<Device<device::CoreInternal<'_>>>() };
|
||||||
|
|
||||||
// SAFETY: `remove_callback` is only ever called after a successful call to
|
// SAFETY: `remove_callback` is only ever called after a successful call to
|
||||||
// `probe_callback`, hence it's guaranteed that `Device::set_drvdata()` has been called
|
// `probe_callback`, hence it's guaranteed that `Device::set_drvdata()` has been called
|
||||||
|
|
@ -197,7 +197,7 @@ macro_rules! module_platform_driver {
|
||||||
/// const ACPI_ID_TABLE: Option<acpi::IdTable<Self::IdInfo>> = Some(&ACPI_TABLE);
|
/// const ACPI_ID_TABLE: Option<acpi::IdTable<Self::IdInfo>> = Some(&ACPI_TABLE);
|
||||||
///
|
///
|
||||||
/// fn probe(
|
/// fn probe(
|
||||||
/// _pdev: &platform::Device<Core>,
|
/// _pdev: &platform::Device<Core<'_>>,
|
||||||
/// _id_info: Option<&Self::IdInfo>,
|
/// _id_info: Option<&Self::IdInfo>,
|
||||||
/// ) -> impl PinInit<Self, Error> {
|
/// ) -> impl PinInit<Self, Error> {
|
||||||
/// Err(ENODEV)
|
/// Err(ENODEV)
|
||||||
|
|
@ -227,7 +227,7 @@ pub trait Driver {
|
||||||
/// Called when a new platform device is added or discovered.
|
/// Called when a new platform device is added or discovered.
|
||||||
/// Implementers should attempt to initialize the device here.
|
/// Implementers should attempt to initialize the device here.
|
||||||
fn probe(
|
fn probe(
|
||||||
dev: &Device<device::Core>,
|
dev: &Device<device::Core<'_>>,
|
||||||
id_info: Option<&Self::IdInfo>,
|
id_info: Option<&Self::IdInfo>,
|
||||||
) -> impl PinInit<Self::Data, Error>;
|
) -> impl PinInit<Self::Data, Error>;
|
||||||
|
|
||||||
|
|
@ -241,7 +241,7 @@ fn probe(
|
||||||
/// operations to gracefully tear down the device.
|
/// operations to gracefully tear down the device.
|
||||||
///
|
///
|
||||||
/// Otherwise, release operations for driver resources should be performed in `Drop`.
|
/// Otherwise, release operations for driver resources should be performed in `Drop`.
|
||||||
fn unbind(dev: &Device<device::Core>, this: Pin<&Self::Data>) {
|
fn unbind(dev: &Device<device::Core<'_>>, this: Pin<&Self::Data>) {
|
||||||
let _ = (dev, this);
|
let _ = (dev, this);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
@ -513,7 +513,7 @@ pub fn optional_irq_by_name(&self, name: &CStr) -> Result<IrqRequest<'_>> {
|
||||||
kernel::impl_device_context_deref!(unsafe { Device });
|
kernel::impl_device_context_deref!(unsafe { Device });
|
||||||
kernel::impl_device_context_into_aref!(Device);
|
kernel::impl_device_context_into_aref!(Device);
|
||||||
|
|
||||||
impl crate::dma::Device for Device<device::Core> {}
|
impl<'a> crate::dma::Device<'a> for Device<device::Core<'a>> {}
|
||||||
|
|
||||||
// SAFETY: Instances of `Device` are always reference-counted.
|
// SAFETY: Instances of `Device` are always reference-counted.
|
||||||
unsafe impl crate::sync::aref::AlwaysRefCounted for Device {
|
unsafe impl crate::sync::aref::AlwaysRefCounted for Device {
|
||||||
|
|
|
||||||
|
|
@ -82,7 +82,7 @@ extern "C" fn probe_callback(
|
||||||
// `struct usb_interface` and `struct usb_device_id`.
|
// `struct usb_interface` and `struct usb_device_id`.
|
||||||
//
|
//
|
||||||
// INVARIANT: `intf` is valid for the duration of `probe_callback()`.
|
// INVARIANT: `intf` is valid for the duration of `probe_callback()`.
|
||||||
let intf = unsafe { &*intf.cast::<Interface<device::CoreInternal>>() };
|
let intf = unsafe { &*intf.cast::<Interface<device::CoreInternal<'_>>>() };
|
||||||
|
|
||||||
from_result(|| {
|
from_result(|| {
|
||||||
// SAFETY: `DeviceId` is a `#[repr(transparent)]` wrapper of `struct usb_device_id` and
|
// SAFETY: `DeviceId` is a `#[repr(transparent)]` wrapper of `struct usb_device_id` and
|
||||||
|
|
@ -92,7 +92,7 @@ extern "C" fn probe_callback(
|
||||||
let info = T::ID_TABLE.info(id.index());
|
let info = T::ID_TABLE.info(id.index());
|
||||||
let data = T::probe(intf, id, info);
|
let data = T::probe(intf, id, info);
|
||||||
|
|
||||||
let dev: &device::Device<device::CoreInternal> = intf.as_ref();
|
let dev: &device::Device<device::CoreInternal<'_>> = intf.as_ref();
|
||||||
dev.set_drvdata(data)?;
|
dev.set_drvdata(data)?;
|
||||||
Ok(0)
|
Ok(0)
|
||||||
})
|
})
|
||||||
|
|
@ -103,9 +103,9 @@ extern "C" fn disconnect_callback(intf: *mut bindings::usb_interface) {
|
||||||
// `struct usb_interface`.
|
// `struct usb_interface`.
|
||||||
//
|
//
|
||||||
// INVARIANT: `intf` is valid for the duration of `disconnect_callback()`.
|
// INVARIANT: `intf` is valid for the duration of `disconnect_callback()`.
|
||||||
let intf = unsafe { &*intf.cast::<Interface<device::CoreInternal>>() };
|
let intf = unsafe { &*intf.cast::<Interface<device::CoreInternal<'_>>>() };
|
||||||
|
|
||||||
let dev: &device::Device<device::CoreInternal> = intf.as_ref();
|
let dev: &device::Device<device::CoreInternal<'_>> = intf.as_ref();
|
||||||
|
|
||||||
// SAFETY: `disconnect_callback` is only ever called after a successful call to
|
// SAFETY: `disconnect_callback` is only ever called after a successful call to
|
||||||
// `probe_callback`, hence it's guaranteed that `Device::set_drvdata()` has been called
|
// `probe_callback`, hence it's guaranteed that `Device::set_drvdata()` has been called
|
||||||
|
|
@ -291,14 +291,14 @@ macro_rules! usb_device_table {
|
||||||
/// const ID_TABLE: usb::IdTable<Self::IdInfo> = &USB_TABLE;
|
/// const ID_TABLE: usb::IdTable<Self::IdInfo> = &USB_TABLE;
|
||||||
///
|
///
|
||||||
/// fn probe(
|
/// fn probe(
|
||||||
/// _interface: &usb::Interface<Core>,
|
/// _interface: &usb::Interface<Core<'_>>,
|
||||||
/// _id: &usb::DeviceId,
|
/// _id: &usb::DeviceId,
|
||||||
/// _info: &Self::IdInfo,
|
/// _info: &Self::IdInfo,
|
||||||
/// ) -> impl PinInit<Self::Data, Error> {
|
/// ) -> impl PinInit<Self::Data, Error> {
|
||||||
/// Err(ENODEV)
|
/// Err(ENODEV)
|
||||||
/// }
|
/// }
|
||||||
///
|
///
|
||||||
/// fn disconnect(_interface: &usb::Interface<Core>, _data: Pin<&Self::Data>) {}
|
/// fn disconnect(_interface: &usb::Interface<Core<'_>>, _data: Pin<&Self::Data>) {}
|
||||||
/// }
|
/// }
|
||||||
///```
|
///```
|
||||||
pub trait Driver {
|
pub trait Driver {
|
||||||
|
|
@ -316,7 +316,7 @@ pub trait Driver {
|
||||||
/// Called when a new USB interface is bound to this driver.
|
/// Called when a new USB interface is bound to this driver.
|
||||||
/// Implementers should attempt to initialize the interface here.
|
/// Implementers should attempt to initialize the interface here.
|
||||||
fn probe(
|
fn probe(
|
||||||
interface: &Interface<device::Core>,
|
interface: &Interface<device::Core<'_>>,
|
||||||
id: &DeviceId,
|
id: &DeviceId,
|
||||||
id_info: &Self::IdInfo,
|
id_info: &Self::IdInfo,
|
||||||
) -> impl PinInit<Self::Data, Error>;
|
) -> impl PinInit<Self::Data, Error>;
|
||||||
|
|
@ -324,7 +324,7 @@ fn probe(
|
||||||
/// USB driver disconnect.
|
/// USB driver disconnect.
|
||||||
///
|
///
|
||||||
/// Called when the USB interface is about to be unbound from this driver.
|
/// Called when the USB interface is about to be unbound from this driver.
|
||||||
fn disconnect(interface: &Interface<device::Core>, data: Pin<&Self::Data>);
|
fn disconnect(interface: &Interface<device::Core<'_>>, data: Pin<&Self::Data>);
|
||||||
}
|
}
|
||||||
|
|
||||||
/// A USB interface.
|
/// A USB interface.
|
||||||
|
|
|
||||||
|
|
@ -122,7 +122,7 @@ impl platform::Driver for RustDebugFs {
|
||||||
const ACPI_ID_TABLE: Option<acpi::IdTable<Self::IdInfo>> = Some(&ACPI_TABLE);
|
const ACPI_ID_TABLE: Option<acpi::IdTable<Self::IdInfo>> = Some(&ACPI_TABLE);
|
||||||
|
|
||||||
fn probe(
|
fn probe(
|
||||||
pdev: &platform::Device<Core>,
|
pdev: &platform::Device<Core<'_>>,
|
||||||
_info: Option<&Self::IdInfo>,
|
_info: Option<&Self::IdInfo>,
|
||||||
) -> impl PinInit<Self, Error> {
|
) -> impl PinInit<Self, Error> {
|
||||||
RustDebugFs::new(pdev).pin_chain(|this| {
|
RustDebugFs::new(pdev).pin_chain(|this| {
|
||||||
|
|
@ -147,7 +147,7 @@ fn build_inner(dir: &Dir) -> impl PinInit<File<Mutex<Inner>>> + '_ {
|
||||||
dir.read_write_file(c"pair", new_mutex!(Inner { x: 3, y: 10 }))
|
dir.read_write_file(c"pair", new_mutex!(Inner { x: 3, y: 10 }))
|
||||||
}
|
}
|
||||||
|
|
||||||
fn new(pdev: &platform::Device<Core>) -> impl PinInit<Self, Error> + '_ {
|
fn new<'a>(pdev: &'a platform::Device<Core<'_>>) -> impl PinInit<Self, Error> + 'a {
|
||||||
let debugfs = Dir::new(c"sample_debugfs");
|
let debugfs = Dir::new(c"sample_debugfs");
|
||||||
let dev = pdev.as_ref();
|
let dev = pdev.as_ref();
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -61,7 +61,7 @@ impl pci::Driver for DmaSampleDriver {
|
||||||
type Data = Self;
|
type Data = Self;
|
||||||
const ID_TABLE: pci::IdTable<Self::IdInfo> = &PCI_TABLE;
|
const ID_TABLE: pci::IdTable<Self::IdInfo> = &PCI_TABLE;
|
||||||
|
|
||||||
fn probe(pdev: &pci::Device<Core>, _info: &Self::IdInfo) -> impl PinInit<Self, Error> {
|
fn probe(pdev: &pci::Device<Core<'_>>, _info: &Self::IdInfo) -> impl PinInit<Self, Error> {
|
||||||
pin_init::pin_init_scope(move || {
|
pin_init::pin_init_scope(move || {
|
||||||
dev_info!(pdev, "Probe DMA test driver.\n");
|
dev_info!(pdev, "Probe DMA test driver.\n");
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -35,7 +35,10 @@ impl auxiliary::Driver for AuxiliaryDriver {
|
||||||
|
|
||||||
const ID_TABLE: auxiliary::IdTable<Self::IdInfo> = &AUX_TABLE;
|
const ID_TABLE: auxiliary::IdTable<Self::IdInfo> = &AUX_TABLE;
|
||||||
|
|
||||||
fn probe(adev: &auxiliary::Device<Core>, _info: &Self::IdInfo) -> impl PinInit<Self, Error> {
|
fn probe(
|
||||||
|
adev: &auxiliary::Device<Core<'_>>,
|
||||||
|
_info: &Self::IdInfo,
|
||||||
|
) -> impl PinInit<Self, Error> {
|
||||||
dev_info!(
|
dev_info!(
|
||||||
adev,
|
adev,
|
||||||
"Probing auxiliary driver for auxiliary device with id={}\n",
|
"Probing auxiliary driver for auxiliary device with id={}\n",
|
||||||
|
|
@ -70,7 +73,7 @@ impl pci::Driver for ParentDriver {
|
||||||
|
|
||||||
const ID_TABLE: pci::IdTable<Self::IdInfo> = &PCI_TABLE;
|
const ID_TABLE: pci::IdTable<Self::IdInfo> = &PCI_TABLE;
|
||||||
|
|
||||||
fn probe(pdev: &pci::Device<Core>, _info: &Self::IdInfo) -> impl PinInit<Self, Error> {
|
fn probe(pdev: &pci::Device<Core<'_>>, _info: &Self::IdInfo) -> impl PinInit<Self, Error> {
|
||||||
Ok(Self {
|
Ok(Self {
|
||||||
_reg0: auxiliary::Registration::new(
|
_reg0: auxiliary::Registration::new(
|
||||||
pdev.as_ref(),
|
pdev.as_ref(),
|
||||||
|
|
|
||||||
|
|
@ -42,7 +42,7 @@ impl i2c::Driver for SampleDriver {
|
||||||
const OF_ID_TABLE: Option<of::IdTable<Self::IdInfo>> = Some(&OF_TABLE);
|
const OF_ID_TABLE: Option<of::IdTable<Self::IdInfo>> = Some(&OF_TABLE);
|
||||||
|
|
||||||
fn probe(
|
fn probe(
|
||||||
idev: &i2c::I2cClient<Core>,
|
idev: &i2c::I2cClient<Core<'_>>,
|
||||||
info: Option<&Self::IdInfo>,
|
info: Option<&Self::IdInfo>,
|
||||||
) -> impl PinInit<Self, Error> {
|
) -> impl PinInit<Self, Error> {
|
||||||
let dev = idev.as_ref();
|
let dev = idev.as_ref();
|
||||||
|
|
@ -56,11 +56,11 @@ fn probe(
|
||||||
Ok(Self)
|
Ok(Self)
|
||||||
}
|
}
|
||||||
|
|
||||||
fn shutdown(idev: &i2c::I2cClient<Core>, _this: Pin<&Self>) {
|
fn shutdown(idev: &i2c::I2cClient<Core<'_>>, _this: Pin<&Self>) {
|
||||||
dev_info!(idev.as_ref(), "Shutdown Rust I2C driver sample.\n");
|
dev_info!(idev.as_ref(), "Shutdown Rust I2C driver sample.\n");
|
||||||
}
|
}
|
||||||
|
|
||||||
fn unbind(idev: &i2c::I2cClient<Core>, _this: Pin<&Self>) {
|
fn unbind(idev: &i2c::I2cClient<Core<'_>>, _this: Pin<&Self>) {
|
||||||
dev_info!(idev.as_ref(), "Unbind Rust I2C driver sample.\n");
|
dev_info!(idev.as_ref(), "Unbind Rust I2C driver sample.\n");
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -144,7 +144,7 @@ impl pci::Driver for SampleDriver {
|
||||||
|
|
||||||
const ID_TABLE: pci::IdTable<Self::IdInfo> = &PCI_TABLE;
|
const ID_TABLE: pci::IdTable<Self::IdInfo> = &PCI_TABLE;
|
||||||
|
|
||||||
fn probe(pdev: &pci::Device<Core>, info: &Self::IdInfo) -> impl PinInit<Self, Error> {
|
fn probe(pdev: &pci::Device<Core<'_>>, info: &Self::IdInfo) -> impl PinInit<Self, Error> {
|
||||||
pin_init::pin_init_scope(move || {
|
pin_init::pin_init_scope(move || {
|
||||||
let vendor = pdev.vendor_id();
|
let vendor = pdev.vendor_id();
|
||||||
dev_dbg!(
|
dev_dbg!(
|
||||||
|
|
@ -175,7 +175,7 @@ fn probe(pdev: &pci::Device<Core>, info: &Self::IdInfo) -> impl PinInit<Self, Er
|
||||||
})
|
})
|
||||||
}
|
}
|
||||||
|
|
||||||
fn unbind(pdev: &pci::Device<Core>, this: Pin<&Self>) {
|
fn unbind(pdev: &pci::Device<Core<'_>>, this: Pin<&Self>) {
|
||||||
if let Ok(bar) = this.bar.access(pdev.as_ref()) {
|
if let Ok(bar) = this.bar.access(pdev.as_ref()) {
|
||||||
// Reset pci-testdev by writing a new test index.
|
// Reset pci-testdev by writing a new test index.
|
||||||
bar.write_reg(regs::TEST::zeroed().with_index(this.index));
|
bar.write_reg(regs::TEST::zeroed().with_index(this.index));
|
||||||
|
|
|
||||||
|
|
@ -106,7 +106,7 @@ impl platform::Driver for SampleDriver {
|
||||||
const ACPI_ID_TABLE: Option<acpi::IdTable<Self::IdInfo>> = Some(&ACPI_TABLE);
|
const ACPI_ID_TABLE: Option<acpi::IdTable<Self::IdInfo>> = Some(&ACPI_TABLE);
|
||||||
|
|
||||||
fn probe(
|
fn probe(
|
||||||
pdev: &platform::Device<Core>,
|
pdev: &platform::Device<Core<'_>>,
|
||||||
info: Option<&Self::IdInfo>,
|
info: Option<&Self::IdInfo>,
|
||||||
) -> impl PinInit<Self, Error> {
|
) -> impl PinInit<Self, Error> {
|
||||||
let dev = pdev.as_ref();
|
let dev = pdev.as_ref();
|
||||||
|
|
|
||||||
|
|
@ -30,18 +30,18 @@ impl usb::Driver for SampleDriver {
|
||||||
const ID_TABLE: usb::IdTable<Self::IdInfo> = &USB_TABLE;
|
const ID_TABLE: usb::IdTable<Self::IdInfo> = &USB_TABLE;
|
||||||
|
|
||||||
fn probe(
|
fn probe(
|
||||||
intf: &usb::Interface<Core>,
|
intf: &usb::Interface<Core<'_>>,
|
||||||
_id: &usb::DeviceId,
|
_id: &usb::DeviceId,
|
||||||
_info: &Self::IdInfo,
|
_info: &Self::IdInfo,
|
||||||
) -> impl PinInit<Self, Error> {
|
) -> impl PinInit<Self, Error> {
|
||||||
let dev: &device::Device<Core> = intf.as_ref();
|
let dev: &device::Device<Core<'_>> = intf.as_ref();
|
||||||
dev_info!(dev, "Rust USB driver sample probed\n");
|
dev_info!(dev, "Rust USB driver sample probed\n");
|
||||||
|
|
||||||
Ok(Self { _intf: intf.into() })
|
Ok(Self { _intf: intf.into() })
|
||||||
}
|
}
|
||||||
|
|
||||||
fn disconnect(intf: &usb::Interface<Core>, _data: Pin<&Self>) {
|
fn disconnect(intf: &usb::Interface<Core<'_>>, _data: Pin<&Self>) {
|
||||||
let dev: &device::Device<Core> = intf.as_ref();
|
let dev: &device::Device<Core<'_>> = intf.as_ref();
|
||||||
dev_info!(dev, "Rust USB driver sample disconnected\n");
|
dev_info!(dev, "Rust USB driver sample disconnected\n");
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -111,7 +111,7 @@ impl platform::Driver for SampleDriver {
|
||||||
const ACPI_ID_TABLE: Option<acpi::IdTable<Self::IdInfo>> = Some(&ACPI_TABLE);
|
const ACPI_ID_TABLE: Option<acpi::IdTable<Self::IdInfo>> = Some(&ACPI_TABLE);
|
||||||
|
|
||||||
fn probe(
|
fn probe(
|
||||||
pdev: &platform::Device<device::Core>,
|
pdev: &platform::Device<device::Core<'_>>,
|
||||||
_info: Option<&Self::IdInfo>,
|
_info: Option<&Self::IdInfo>,
|
||||||
) -> impl PinInit<Self, Error> {
|
) -> impl PinInit<Self, Error> {
|
||||||
dev_info!(
|
dev_info!(
|
||||||
|
|
@ -130,7 +130,7 @@ fn probe(
|
||||||
})
|
})
|
||||||
}
|
}
|
||||||
|
|
||||||
fn unbind(pdev: &platform::Device<device::Core>, _this: Pin<&Self>) {
|
fn unbind(pdev: &platform::Device<device::Core<'_>>, _this: Pin<&Self>) {
|
||||||
dev_info!(
|
dev_info!(
|
||||||
pdev.as_ref(),
|
pdev.as_ref(),
|
||||||
"Unbind Rust I2C Client registration sample.\n"
|
"Unbind Rust I2C Client registration sample.\n"
|
||||||
|
|
|
||||||
|
|
@ -42,7 +42,7 @@ impl platform::Driver for SampleSocDriver {
|
||||||
const ACPI_ID_TABLE: Option<acpi::IdTable<Self::IdInfo>> = Some(&ACPI_TABLE);
|
const ACPI_ID_TABLE: Option<acpi::IdTable<Self::IdInfo>> = Some(&ACPI_TABLE);
|
||||||
|
|
||||||
fn probe(
|
fn probe(
|
||||||
pdev: &platform::Device<Core>,
|
pdev: &platform::Device<Core<'_>>,
|
||||||
_info: Option<&Self::IdInfo>,
|
_info: Option<&Self::IdInfo>,
|
||||||
) -> impl PinInit<Self, Error> {
|
) -> impl PinInit<Self, Error> {
|
||||||
dev_dbg!(pdev, "Probe Rust SoC driver sample.\n");
|
dev_dbg!(pdev, "Probe Rust SoC driver sample.\n");
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue
Block a user