Files
laptops-kernel/samples/rust/rust_driver_serdev.rs
Markus ProbstandDanilo Krummrich 4b2c9156d3 samples: rust: add Rust serial device bus sample device driver
Add a sample Rust serial device bus device driver illustrating the usage
of the serial device bus abstractions.

This drivers probes through either a match of device / driver name or a
match within the OF ID table.

Acked-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Signed-off-by: Markus Probst <markus.probst@posteo.de>
Link: https://patch.msgid.link/20260718-rust_serdev-v16-2-5809384d2e1b@posteo.de
Signed-off-by: Danilo Krummrich <dakr@kernel.org>
2026-07-23 22:48:31 +02:00

91 lines
2.1 KiB
Rust

// SPDX-License-Identifier: GPL-2.0
//! Rust Serial device bus device driver sample.
use kernel::{
acpi,
device::{
Bound,
Core, //
},
of,
prelude::*,
serdev,
sync::aref::ARef, //
};
struct SampleDriver {
sdev: ARef<serdev::Device>,
}
kernel::of_device_table!(
OF_TABLE,
MODULE_OF_TABLE,
<SampleDriver as serdev::Driver>::IdInfo,
[(of::DeviceId::new(c"test,rust_driver_serdev"), ())]
);
kernel::acpi_device_table!(
ACPI_TABLE,
MODULE_ACPI_TABLE,
<SampleDriver as serdev::Driver>::IdInfo,
[(acpi::DeviceId::new(c"LNUXBEEF"), ())]
);
#[vtable]
impl serdev::Driver for SampleDriver {
type IdInfo = ();
type Data<'bound> = Self;
const OF_ID_TABLE: Option<of::IdTable<Self::IdInfo>> = Some(&OF_TABLE);
const ACPI_ID_TABLE: Option<acpi::IdTable<Self::IdInfo>> = Some(&ACPI_TABLE);
fn probe<'bound>(
sdev: &'bound serdev::Device<Core<'_>>,
_info: Option<&'bound Self::IdInfo>,
) -> impl PinInit<Self, Error> + 'bound {
let dev = sdev.as_ref();
dev_dbg!(dev, "Probe Rust Serial device bus device driver sample.\n");
if sdev
.set_baudrate(
dev.fwnode()
.and_then(|fwnode| fwnode.property_read(c"baudrate").optional())
.unwrap_or(115200),
)
.is_err()
{
return Err(EINVAL);
}
sdev.set_flow_control(false);
sdev.set_parity(serdev::Parity::None)?;
Ok(Self { sdev: sdev.into() })
}
fn receive<'bound>(
sdev: &'bound serdev::Device<Bound>,
_this: Pin<&Self>,
data: &[u8],
) -> usize {
sdev.write(data).unwrap_or_default() as usize
}
}
impl Drop for SampleDriver {
fn drop(&mut self) {
dev_dbg!(
self.sdev.as_ref(),
"Remove Rust Serial device bus device driver sample.\n"
);
}
}
kernel::module_serdev_device_driver! {
type: SampleDriver,
name: "rust_driver_serdev",
authors: ["Markus Probst"],
description: "Rust Serial device bus device driver",
license: "GPL v2",
}