drm/tyr: Clarify driver/device type names
Subsystems (4)
PATCH 1/1 drm/tyr: Clarify driver/device type names
Currently the TyrDriver struct implements both platform::Driver and drm::Driver. For clarity, split up these two roles:
- Introduce TyrPlatformDeviceData to implement platform::Driver, and
- Introduce TyrDrmDriver to implement drm::Driver.
Also rename other variables to reflect their roles in the DRM context:
- Rename TyrDevice to TyrDrmDevice
- Rename TyrData to TyrDrmDeviceData
- Rename File to TyrDrmFileData
- Rename DrmFile to TyrDrmFile
No functional changes are intended.
Co-developed-by Boris Brezillon <[email protected]>
Signed-off-by Boris Brezillon <[email protected]>
Signed-off-by Deborah Brouwer <[email protected]>
---
This patch depends on:
https://lore.kernel.org/rust-for-linux/[email protected]/
drivers/gpu/drm/tyr/driver.rs | 40 ++++++++++++++++++----------------- drivers/gpu/drm/tyr/file.rs | 17 +++++++-------- drivers/gpu/drm/tyr/gem.rs | 9 +++----- drivers/gpu/drm/tyr/tyr.rs | 4 ++-- 4 files changed, 34 insertions(+), 36 deletions(-)
drivers/gpu/drm/tyr/driver.rs +21 -19
@@ -30,7 +30,7 @@ };use crate ::{ - file::File , + file::TyrDrmFileData , gem::TyrObject , gpu, gpu::GpuInfo ,
@@ -39,16 +39,18 @@pub (crate )type IoMem = kernel::io::mem::IoMem <SZ_2M >; +pub (crate )struct TyrDrmDriver ; +/// Convenience type alias for the DRM device type for this driver. -pub (crate )type TyrDevice = drm::Device <TyrDriver >; +pub (crate )type TyrDrmDevice = drm::Device <TyrDrmDriver >;#[pin_data( PinnedDrop )] -pub (crate )struct TyrDriver { - _device:ARef <TyrDevice >, +pub (crate )struct TyrPlatformDeviceData { + _device:ARef <TyrDrmDevice >, }#[pin_data( PinnedDrop )] -pub (crate )struct TyrData { +pub (crate )struct TyrDrmDeviceData {pub (crate ) pdev:ARef <platform::Device >, #[pin]
@@ -71,9 +73,9 @@ pub(crate) struct TyrData {// that it will be removed in a future patch. // // SAFETY: This will be removed in a future patch. -unsafe impl Send for TyrData {} +unsafe impl Send for TyrDrmDeviceData {}// SAFETY: This will be removed in a future patch. -unsafe impl Sync for TyrData {} +unsafe impl Sync for TyrDrmDeviceData {}fn issue_soft_reset (dev: &Device <Bound >, iomem: &Devres <IoMem >) ->Result { regs::GPU_CMD .write (dev, iomem, regs::GPU_CMD_SOFT_RESET )?;
@@ -92,14 +94,14 @@ fn issue_soft_reset(dev: &Device<Bound>, iomem: &Devres<IoMem>) -> Result { kernel::of_device_table!(OF_TABLE ,MODULE_OF_TABLE , - <TyrDriver as platform::Driver >::IdInfo , + <TyrPlatformDeviceData as platform::Driver >::IdInfo , [ (of::DeviceId ::new (c"rockchip,rk3588-mali" ), ()), (of::DeviceId ::new (c"arm,mali-valhall-csf" ), ()) ] ); -impl platform::Driver for TyrDriver { +impl platform::Driver for TyrPlatformDeviceData {type IdInfo = ();const OF_ID_TABLE :Option <of::IdTable <Self ::IdInfo >> =Some (&OF_TABLE );
@@ -129,7 +131,7 @@ fn probe(let platform:ARef <platform::Device > = pdev.into (); - let data = try_pin_init!(TyrData { + let data = try_pin_init!(TyrDrmDeviceData { pdev: platform.clone(), clks <- new_mutex!(Clocks { core: core_clk,
@@ -143,10 +145,10 @@ fn probe( gpu_info, }); -let tdev:ARef <TyrDevice > = drm::Device ::new (pdev.as_ref (), data)?; - drm::driver::Registration ::new_foreign_owned (&tdev, pdev.as_ref (),0 )?; +let ddev:ARef <TyrDrmDevice > = drm::Device ::new (pdev.as_ref (), data)?; + drm::driver::Registration ::new_foreign_owned (&ddev, pdev.as_ref (),0 )?; -let driver =TyrDriver { _device: tdev }; +let driver =TyrPlatformDeviceData { _device: ddev };// We need this to be dev_info!() because dev_dbg!() does not work at // all in Rust for now, and we need to see whether probe succeeded.
@@ -156,12 +158,12 @@ fn probe( }#[pinned_drop] -impl PinnedDrop for TyrDriver { +impl PinnedDrop for TyrPlatformDeviceData {fn drop (self:Pin <&mut Self >) {} }#[pinned_drop] -impl PinnedDrop for TyrData { +impl PinnedDrop for TyrDrmDeviceData {fn drop (self:Pin <&mut Self >) {// TODO: the type-state pattern for Clks will fix this. let clks = self.clks.lock ();
@@ -182,15 +184,15 @@ fn drop(self: Pin<&mut Self>) { };#[vtable] -impl drm::Driver for TyrDriver { -type Data =TyrData ; -type File =File ; +impl drm::Driver for TyrDrmDriver { +type Data =TyrDrmDeviceData ; +type File =TyrDrmFileData ;type Object = drm::gem::Object <TyrObject >;const INFO : drm::DriverInfo =INFO ; kernel::declare_drm_ioctls! { - (PANTHOR_DEV_QUERY , drm_panthor_dev_query, ioctl::RENDER_ALLOW ,File ::dev_query), + (PANTHOR_DEV_QUERY , drm_panthor_dev_query, ioctl::RENDER_ALLOW ,TyrDrmFileData ::dev_query), } }
drivers/gpu/drm/tyr/file.rs +8 -9
@@ -8,29 +8,28 @@ };use crate ::{ - driver::TyrDevice , -TyrDriver ,// + driver::TyrDrmDriver ,// };#[pin_data] -pub (crate )struct File {} +pub (crate )struct TyrDrmFileData {}/// Convenience type alias for our DRM `File` type -pub (crate )type DrmFile = drm::file::File <File >; +pub (crate )type TyrDrmFile = drm::file::File <TyrDrmFileData >; -impl drm::file::DriverFile for File { -type Driver =TyrDriver ; +impl drm::file::DriverFile for TyrDrmFileData { +type Driver =TyrDrmDriver ;fn open (_dev: &drm::Device <Self ::Driver >) ->Result <Pin <KBox <Self >>> {KBox ::try_pin_init (try_pin_init! (Self {}),GFP_KERNEL ) } } -impl File { +impl TyrDrmFileData {pub (crate )fn dev_query ( - tdev: &TyrDevice , + tdev: &drm::Device <TyrDrmDriver >, devquery: &mut uapi::drm_panthor_dev_query , - _file: &DrmFile , + _file: &TyrDrmFile , ) ->Result <u32 > {if devquery.pointer ==0 {match devquery.type_ {
drivers/gpu/drm/tyr/gem.rs +3 -6
@@ -5,19 +5,16 @@ prelude::*, // }; -use crate ::driver::{ -TyrDevice , -TyrDriver ,// -}; +use crate ::driver::TyrDrmDriver ;/// GEM Object inner driver data #[pin_data] pub (crate )struct TyrObject {}impl gem::DriverObject for TyrObject { -type Driver =TyrDriver ; +type Driver =TyrDrmDriver ; -fn new (_dev: &TyrDevice , _size:usize ) ->impl PinInit <Self ,Error > { +fn new (_dev: &kernel::drm::Device <TyrDrmDriver >, _size:usize ) ->impl PinInit <Self ,Error > {try_pin_init! (TyrObject {}) } }
drivers/gpu/drm/tyr/tyr.rs +2 -2
@@ -5,7 +5,7 @@//! The name "Tyr" is inspired by Norse mythology, reflecting Arm's tradition of //! naming their GPUs after Nordic mythological figures and places. -use crate ::driver::TyrDriver ; +use crate ::driver::TyrPlatformDeviceData ;mod driver;mod file;
@@ -14,7 +14,7 @@mod regs; kernel::module_platform_driver! { -type :TyrDriver , +type :TyrPlatformDeviceData , name:"tyr" , authors: ["The Tyr driver authors" ], description:"Arm Mali Tyr DRM driver" ,
Signature · 1 line
2.52.0