From nobody Sun Feb 8 17:04:21 2026 Received: from mout02.posteo.de (mout02.posteo.de [185.67.36.66]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id A08E93019A6 for ; Sat, 15 Nov 2025 17:26:02 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=185.67.36.66 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763227564; cv=none; b=CDuNSRPKVrbfhEqJnbz2A6Io+ILsl+10iA8xr+/c33QjzbGlc2IDQvkE3dB/2JB1Z/PcLJu29faOADTwJmvz8IKzMG74rggktaQMfNC1pSUG4/wgB6grEDQyQg7IckMs6pqwsa9e6Ij8H56z4aKYIMUGuZ+4TrW0gImmV+sYUI8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763227564; c=relaxed/simple; bh=t68H8rXu6XmkMh+iLw+R6lOjuYBvGB8PMDn92zVlKYk=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=WGQREhPrssf0DYA1K164ofow3ZWO1WUNloBKdkJ3ospkBZ/gfFVbNTfrQ17H4QRcqsPHsD/KifaBsJcGVx5nLMnDyu/9qpIlU9Y6oLyqUrXjjeFbeL5yylWni88dovLpXwZ+em0//jKgZMt3GdYG3B7ovoAMxMApNovN6MMV2BY= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=posteo.de; spf=pass smtp.mailfrom=posteo.de; dkim=pass (2048-bit key) header.d=posteo.de header.i=@posteo.de header.b=o5FNgKOc; arc=none smtp.client-ip=185.67.36.66 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=posteo.de Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=posteo.de Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=posteo.de header.i=@posteo.de header.b="o5FNgKOc" Received: from submission (posteo.de [185.67.36.169]) by mout02.posteo.de (Postfix) with ESMTPS id D7ADB240105 for ; Sat, 15 Nov 2025 18:26:00 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=posteo.de; s=2017; t=1763227560; bh=4QYoNPwoYQKT22elmcFf1tXNwc4vKowEFwTDurGb5Jc=; h=From:Date:Subject:MIME-Version:Content-Type: Content-Transfer-Encoding:Message-Id:To:Cc:Autocrypt:OpenPGP:From; b=o5FNgKOcECtgoQLWpgHmyDu9Nv8iUmGRYVPY5qcgKRbptfMnPNN3SQUmbHen5RViH dL3HIbFTDUB935N7XGhnODoVc84skDXJMDcmaOyG7VqGEpOStDmfS1U1y8l4ui9Fsb ap1vTRyvVBuicK4WhWZrNBLBN9WfSfT3cAg/y9v8HuDibO56gscQ7VPD0XCphZKOch kQm5tBsQp6NA1LmsM5CfXoIq3yXOMxbM46MacIhOlkX9dpDInKi7+HFUAHzXCP68X4 f2F8G3MbbAg4DGZWgpvoM234x48gMjUD6DC/0zRZkpscxPdge/1dsS6ckZX+xzUUhg FIQwYlyn+DPhQ== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4d81BF3Y3bz9rxN; Sat, 15 Nov 2025 18:25:57 +0100 (CET) From: Markus Probst Date: Sat, 15 Nov 2025 17:25:59 +0000 Subject: [PATCH v8 1/4] rust: Add trait to convert a device reference to a bus device reference Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20251115-rust_leds-v8-1-d9a41f355538@posteo.de> References: <20251115-rust_leds-v8-0-d9a41f355538@posteo.de> In-Reply-To: <20251115-rust_leds-v8-0-d9a41f355538@posteo.de> To: Lee Jones , Pavel Machek , Greg Kroah-Hartman , Dave Ertman , Ira Weiny , Leon Romanovsky , Miguel Ojeda , Alex Gaynor , Boqun Feng , Gary Guo , =?utf-8?q?Bj=C3=B6rn_Roy_Baron?= , Benno Lossin , Andreas Hindborg , Alice Ryhl , Trevor Gross , Danilo Krummrich , "Rafael J. Wysocki" , Bjorn Helgaas , =?utf-8?q?Krzysztof_Wilczy=C5=84ski?= Cc: rust-for-linux@vger.kernel.org, linux-leds@vger.kernel.org, linux-kernel@vger.kernel.org, linux-pci@vger.kernel.org, Markus Probst X-Developer-Signature: v=1; a=openpgp-sha256; l=5575; i=markus.probst@posteo.de; h=from:subject:message-id; bh=t68H8rXu6XmkMh+iLw+R6lOjuYBvGB8PMDn92zVlKYk=; b=kA0DAAgBNHYf+OetQ9IByyZiAGkYt6KgKX/PeBpr9apcWnZAiYnycFTjkPh2p6FjafjF1csrr okCMwQAAQgAHRYhBIJ0GMT0rFjncjDEczR2H/jnrUPSBQJpGLeiAAoJEDR2H/jnrUPSyQwP/2we dxICIPBqDGQomYu6VqQb9I3KtmDWRKlHsAWkzp1avm8yuaY1VuFsNYIvs+ctHKeFXQ+Ab02H9PW nvjjCnJ50f+OAi5tkh5EvcM5EFCiQiLakKE3/heCEmcshkzS5QFvix3k+bYWlWDFZxufyjd3VEO VE9v+mnpIPbO9/2Ryqg2R5/Sldy4NqsECwsVPpHejOW29I6TPg5zHPohJZdClbxUFZOTpvFWxNA WFW48HtSbDg1YGAQGZ49VYE7kN+g7Eyd/nQ+eiyepJ6dK//BAn3ZJfnNDCn7yzuZt/oh+EDBmlI CHGPY/4iURwFGuJV4uIyVqt7n09i3G8c1VfUbnli0/hDw7lzTsPuYtUTPCNeXv9insiTm8y8r1s MzHW3jmpsBcpRYQRg7YIj/IaIFK6cKJvJD8FGaWju+AbL6BnHUmexD84riOUD8u1mRkbr1ciE7h vJbdtoro6J8KzLtSZ3Bffg7JWuDb7UDWNFpEgHU6NThS1a02YyfhQvx0al6KQpihtiq/R7UOFvM +inmn2WG8GVgjJWneAZP+QD0nS03V+G5+5Zw92yiQXJAZA6DjZ465xeRsiAv97SpvZiB0wEHZ/n eh0mJi8lqq5l12iw8p1GMFiQfhrjdJfz07sjWN178hTrcTUvtDyIVD5Z9EmPqQ2KRjn31SAW4s2 +O7Ir X-Developer-Key: i=markus.probst@posteo.de; a=openpgp; fpr=827418C4F4AC58E77230C47334761FF8E7AD43D2 Autocrypt: addr=markus.probst@posteo.de; prefer-encrypt=mutual; keydata=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 aBeNN4ijKZchBXHPgVx+YtWRHfcm4l8= OpenPGP: url=https://posteo.de/keys/markus.probst@posteo.de.asc; preference=encrypt Implement the `AsBusDevice` trait for converting a `Device` reference to a bus device reference for all bus devices. The `AsBusDevice` trait allows abstractions to provide the bus device in class device callbacks. It must not be used by drivers and is intended for bus and class device abstractions only. Signed-off-by: Markus Probst --- rust/kernel/auxiliary.rs | 7 +++++++ rust/kernel/device.rs | 33 +++++++++++++++++++++++++++++++++ rust/kernel/pci.rs | 7 +++++++ rust/kernel/platform.rs | 7 +++++++ rust/kernel/usb.rs | 6 ++++++ 5 files changed, 60 insertions(+) diff --git a/rust/kernel/auxiliary.rs b/rust/kernel/auxiliary.rs index 7a3b0b9c418e..db52062a4355 100644 --- a/rust/kernel/auxiliary.rs +++ b/rust/kernel/auxiliary.rs @@ -15,6 +15,7 @@ }; use core::{ marker::PhantomData, + mem::offset_of, ptr::{addr_of_mut, NonNull}, }; =20 @@ -233,6 +234,12 @@ extern "C" fn release(dev: *mut bindings::device) { } } =20 +// SAFETY: `auxiliary::Device` is a transparent wrapper of `struct auxilia= ry_device`. +// The offset is guaranteed to point to a valid device field inside `auxil= iary::Device`. +unsafe impl device::AsBusDevice for Devic= e { + const OFFSET: usize =3D offset_of!(bindings::auxiliary_device, dev); +} + // SAFETY: `Device` is a transparent wrapper of a type that doesn't depend= on `Device`'s generic // argument. kernel::impl_device_context_deref!(unsafe { Device }); diff --git a/rust/kernel/device.rs b/rust/kernel/device.rs index a849b7dde2fd..bf09fd0b0199 100644 --- a/rust/kernel/device.rs +++ b/rust/kernel/device.rs @@ -511,6 +511,39 @@ impl DeviceContext for Core {} impl DeviceContext for CoreInternal {} impl DeviceContext for Normal {} =20 +/// Convert device references to bus device references. +/// +/// Bus devices can implement this trait to allow abstractions to provide = the bus device in +/// class device callbacks. +/// +/// This must not be used by drivers and is intended for bus and class dev= ice abstractions only. +/// +/// # Safety +/// +/// `AsBusDevice::OFFSET` must be the offset of the embedded base `struct = device` field within a +/// bus device structure. +pub(crate) unsafe trait AsBusDevice: AsRef= > { + /// The relative offset to the device field. + /// + /// Use `offset_of!(bindings, field)` macro to avoid breakage. + const OFFSET: usize; + + /// Convert a reference to [`Device`] into `Self`. + /// + /// # Safety + /// + /// `dev` must be contained in `Self`. + unsafe fn from_device(dev: &Device) -> &Self + where + Self: Sized, + { + let raw =3D dev.as_raw(); + // SAFETY: `raw - Self::OFFSET` is guaranteed by the safety requir= ements + // to be a valid pointer to `Self`. + unsafe { &*raw.byte_sub(Self::OFFSET).cast::() } + } +} + /// # Safety /// /// The type given as `$device` must be a transparent wrapper of a type th= at doesn't depend on the diff --git a/rust/kernel/pci.rs b/rust/kernel/pci.rs index 7fcc5f6022c1..d78f6feeaae9 100644 --- a/rust/kernel/pci.rs +++ b/rust/kernel/pci.rs @@ -19,6 +19,7 @@ }; use core::{ marker::PhantomData, + mem::offset_of, ops::Deref, ptr::{addr_of_mut, NonNull}, }; @@ -593,6 +594,12 @@ pub fn set_master(&self) { } } =20 +// SAFETY: `pci::Device` is a transparent wrapper of `struct pci_dev`. +// The offset is guaranteed to point to a valid device field inside `pci::= Device`. +unsafe impl device::AsBusDevice for Devic= e { + const OFFSET: usize =3D offset_of!(bindings::pci_dev, dev); +} + // SAFETY: `Device` is a transparent wrapper of a type that doesn't depend= on `Device`'s generic // argument. kernel::impl_device_context_deref!(unsafe { Device }); diff --git a/rust/kernel/platform.rs b/rust/kernel/platform.rs index 7205fe3416d3..7197264b5a53 100644 --- a/rust/kernel/platform.rs +++ b/rust/kernel/platform.rs @@ -19,6 +19,7 @@ =20 use core::{ marker::PhantomData, + mem::offset_of, ptr::{addr_of_mut, NonNull}, }; =20 @@ -285,6 +286,12 @@ pub fn io_request_by_name(&self, name: &CStr) -> Optio= n> { } } =20 +// SAFETY: `platform::Device` is a transparent wrapper of `struct platform= _device`. +// The offset is guaranteed to point to a valid device field inside `platf= orm::Device`. +unsafe impl device::AsBusDevice for Devic= e { + const OFFSET: usize =3D offset_of!(bindings::platform_device, dev); +} + macro_rules! define_irq_accessor_by_index { ( $(#[$meta:meta])* $fn_name:ident, diff --git a/rust/kernel/usb.rs b/rust/kernel/usb.rs index 14ddb711bab3..ec21261baf6a 100644 --- a/rust/kernel/usb.rs +++ b/rust/kernel/usb.rs @@ -324,6 +324,12 @@ fn as_raw(&self) -> *mut bindings::usb_interface { } } =20 +// SAFETY: `usb::Interface` is a transparent wrapper of `struct usb_interf= ace`. +// The offset is guaranteed to point to a valid device field inside `usb::= Interface`. +unsafe impl device::AsBusDevice for Inter= face { + const OFFSET: usize =3D offset_of!(bindings::usb_interface, dev); +} + // SAFETY: `Interface` is a transparent wrapper of a type that doesn't dep= end on // `Interface`'s generic argument. kernel::impl_device_context_deref!(unsafe { Interface }); --=20 2.51.0 From nobody Sun Feb 8 17:04:21 2026 Received: from mout01.posteo.de (mout01.posteo.de [185.67.36.65]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 5336F306B11 for ; Sat, 15 Nov 2025 17:26:10 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=185.67.36.65 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763227572; cv=none; b=oID3Qwd4b/5YU6aWY3An0EV3VFhIzX+t2o3QBmXzFNo9Rc5ju/eVjRAgC/3BmVj3Zf5X9BjbiBomqfa3vjpjnwKob7t6tJpVr5LNQjbvo0g7fIKMfjQk0WUMtFbsGrcGB3dH+1y+S1j0yRKUTRKxiiwNQ2xDMd1Eu4+5nXO7Pq8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763227572; c=relaxed/simple; bh=FO6S1kS9xVhUicBZgp8D32j+nFqBUW89GI/EAcO+ohk=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=X/jfr/3t5ZP4yuUpY1vuwC3HMzUfu2xUAJkFk6GPV7Dv+6SNbwgwTlycJPxscFO4c7BfABgnPym3BiQ3Bl1GrLptc7DBGXHn9TX0tvuCQIKy1bmICeyL2nAEmr6OC6TS7nbiwI0WMQY5yuRPbNONcmjY73rHHJtZ+nr4PGJv0eA= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=posteo.de; spf=pass smtp.mailfrom=posteo.de; dkim=pass (2048-bit key) header.d=posteo.de header.i=@posteo.de header.b=U465zz1m; arc=none smtp.client-ip=185.67.36.65 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=posteo.de Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=posteo.de Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=posteo.de header.i=@posteo.de header.b="U465zz1m" Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id E815D240027 for ; Sat, 15 Nov 2025 18:26:02 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=posteo.de; s=2017; t=1763227562; bh=zRINrEkzGD/GwwQOo0qszJT+6UP8GyYFfBqXhtLZCk0=; h=From:Date:Subject:MIME-Version:Content-Type: Content-Transfer-Encoding:Message-Id:To:Cc:Autocrypt:OpenPGP:From; b=U465zz1mb5Lr6PWmcZwJVZPW/XfaaPQKYbpnKoqHttKgZijURa/2LkjIFHflsiaIZ PQDHlEjxRLf2R45I9DxMEjCDK+FI0HS3/bxJbIhUxdysUl0EJbdFX+qOrIGhVC2yej ASTb/jGSZOoY2O11VgZLmbGm4ucaQOVU69/eRWJ5mzg+gVkQ99QQdAYTgn7UFJZ5L5 KAYn/dbR20/8IP1tnux2U+KII7warsNSxS5ReHldEhb0uZFhnJUpHTowZnNvUpQpGB VABxOMWZx2lAUHPaeBfcIPzWSXUlo4yO3NZWfyVzeGnjenLsAYXFDz7D2oWxCMpMto ZgliAaz6ivPDw== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4d81BJ0DBgz9rxQ; Sat, 15 Nov 2025 18:26:00 +0100 (CET) From: Markus Probst Date: Sat, 15 Nov 2025 17:26:02 +0000 Subject: [PATCH v8 2/4] rust: leds: add basic led classdev abstractions Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20251115-rust_leds-v8-2-d9a41f355538@posteo.de> References: <20251115-rust_leds-v8-0-d9a41f355538@posteo.de> In-Reply-To: <20251115-rust_leds-v8-0-d9a41f355538@posteo.de> To: Lee Jones , Pavel Machek , Greg Kroah-Hartman , Dave Ertman , Ira Weiny , Leon Romanovsky , Miguel Ojeda , Alex Gaynor , Boqun Feng , Gary Guo , =?utf-8?q?Bj=C3=B6rn_Roy_Baron?= , Benno Lossin , Andreas Hindborg , Alice Ryhl , Trevor Gross , Danilo Krummrich , "Rafael J. Wysocki" , Bjorn Helgaas , =?utf-8?q?Krzysztof_Wilczy=C5=84ski?= Cc: rust-for-linux@vger.kernel.org, linux-leds@vger.kernel.org, linux-kernel@vger.kernel.org, linux-pci@vger.kernel.org, Markus Probst X-Developer-Signature: v=1; a=openpgp-sha256; l=18809; i=markus.probst@posteo.de; h=from:subject:message-id; bh=FO6S1kS9xVhUicBZgp8D32j+nFqBUW89GI/EAcO+ohk=; b=owEBbQKS/ZANAwAIATR2H/jnrUPSAcsmYgBpGLeiX9zoj5Fgxt0W1j4goRuZgYo5vPHoAuLJK JX+DqQH832JAjMEAAEIAB0WIQSCdBjE9KxY53IwxHM0dh/4561D0gUCaRi3ogAKCRA0dh/4561D 0gASD/48KTcKUKXLq52ndboIYjY+zga7wKMlApHEHkIudDcEKREysCePoTR7tG9vWe/QEknnn6e pDoCttFLnRaym9k8wMsW4D/lBB6IMgtUWjrhwNeot+slkY/Ea3L93QW10ifqmY7JbDGBil5czC7 x8WeVAW+VNLvwBB/ieY6uz8koVqaQVlb9Mni7v6jDduA79ZygRelBtLWtattvt0ABi0SDC+JFFV /Z/uEYg/6UVNryAjmvrxGN2HVl5p5exkCEUsrMkNguH2/9oJMByTh8e2T+UvUHqpdcXkt++C3hN liKxLkbBOY35EJudScLXVxbxXKZT9KdrlfjqhviEJFrVPuEN/fpRURWyeS71X9o1eYQ0zGWYj5q xbkCFNxERNHPRL07rQKu1XHJ0rD4+T+0ZM/oDYq5a0UGXBEoRZ+bLcVh7cK1aJt0vXHKeCbrXku tOfq7GcqRZQY7B60UONKbsa7kyGsYaMSHu153ZlF0ijJd8wOBtrVKtlH/K+ML4nK840XUjxw1HM HhRCI6pky5vfrSyd9Qz0t8WpcpAuOqOiEk3/38B6vFO6RXleIl3fBU61yU2cfZ2T7bOrir41UdE PbqKNkRSjjRkNYSVr2sUvjMnwJocKnkzJt/O9YPyf5gAdqP9xVTT6cRitz1bpR1OZ80WOoeA3GH 5gLrwxKa8irznng== X-Developer-Key: i=markus.probst@posteo.de; a=openpgp; fpr=827418C4F4AC58E77230C47334761FF8E7AD43D2 Autocrypt: addr=markus.probst@posteo.de; prefer-encrypt=mutual; keydata=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 aBeNN4ijKZchBXHPgVx+YtWRHfcm4l8= OpenPGP: url=https://posteo.de/keys/markus.probst@posteo.de.asc; preference=encrypt Implement the core abstractions needed for led class devices, including: * `led::LedOps` - the trait for handling leds, including `brightness_set`, `brightness_get` and `blink_set` * `led::InitData` - data set for the led class device * `led::Device` - a safe wrapper around `led_classdev` Signed-off-by: Markus Probst --- MAINTAINERS | 7 + rust/kernel/led.rs | 477 +++++++++++++++++++++++++++++++++++++++++++++++++= ++++ rust/kernel/lib.rs | 1 + 3 files changed, 485 insertions(+) diff --git a/MAINTAINERS b/MAINTAINERS index ddecf1ef3bed..2d66db23a63b 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -14104,6 +14104,13 @@ F: drivers/leds/ F: include/dt-bindings/leds/ F: include/linux/leds.h =20 +LED SUBSYSTEM [RUST] +M: Markus Probst +L: linux-leds@vger.kernel.org +L: rust-for-linux@vger.kernel.org +S: Maintained +F: rust/kernel/led.rs + LEGO MINDSTORMS EV3 R: David Lechner S: Maintained diff --git a/rust/kernel/led.rs b/rust/kernel/led.rs new file mode 100644 index 000000000000..4c1b72c998e1 --- /dev/null +++ b/rust/kernel/led.rs @@ -0,0 +1,477 @@ +// SPDX-License-Identifier: GPL-2.0 + +//! Abstractions for the leds driver model. +//! +//! C header: [`include/linux/leds.h`](srctree/include/linux/leds.h) + +use core::{ + marker::PhantomData, + mem::transmute, + pin::Pin, + ptr::NonNull, // +}; + +use pin_init::{ + pin_data, + pinned_drop, + PinInit, // +}; + +use crate::{ + build_error, + container_of, + device::{ + self, + property::FwNode, + AsBusDevice, + Bound, // + }, + devres::Devres, + error::{ + code::EINVAL, + from_result, + to_result, + Error, + Result, + VTABLE_DEFAULT_ERROR, // + }, + macros::vtable, + str::CStr, + try_pin_init, + types::{ + ARef, + Opaque, // + }, // +}; + +/// The led class device representation. +/// +/// This structure represents the Rust abstraction for a C `struct led_cla= ssdev`. +#[pin_data(PinnedDrop)] +pub struct Device { + ops: T, + #[pin] + classdev: Opaque, +} + +/// The led init data representation. +/// +/// This structure represents the Rust abstraction for a C `struct led_ini= t_data` with additional +/// fields from `struct led_classdev`. +#[derive(Default)] +pub struct InitData<'a> { + fwnode: Option<&'a FwNode>, + default_label: Option<&'a CStr>, + devicename: Option<&'a CStr>, + devname_mandatory: bool, + initial_brightness: u32, + default_trigger: Option<&'a CStr>, + color: Color, +} + +impl InitData<'static> { + /// Creates a new [`InitData`] + pub fn new() -> Self { + Self::default() + } +} + +impl<'a> InitData<'a> { + /// Sets the firmware node + pub fn fwnode(self, fwnode: &'a FwNode) -> Self { + InitData { + fwnode: Some(fwnode), + ..self + } + } + + /// Sets a default label + pub fn default_label(self, label: &'a CStr) -> Self { + InitData { + default_label: Some(label), + ..self + } + } + + /// Sets the device name + pub fn devicename(self, devicename: &'a CStr) -> Self { + Self { + devicename: Some(devicename), + ..self + } + } + + /// Sets if a device name is mandatory + pub fn devicename_mandatory(self, mandatory: bool) -> Self { + Self { + devname_mandatory: mandatory, + ..self + } + } + + /// Sets the initial brightness value for the led + /// + /// The default brightness is 0. + /// If [`LedOps::brightness_get`] is implemented, this value will be i= gnored. + pub fn initial_brightness(self, brightness: u32) -> Self { + Self { + initial_brightness: brightness, + ..self + } + } + + /// Set the default led trigger + /// + /// This value can be overwritten by the "linux,default-trigger" fwnod= e property. + pub fn default_trigger(self, trigger: &'a CStr) -> Self { + Self { + default_trigger: Some(trigger), + ..self + } + } + + /// Sets the color of the led + /// + /// This value can be overwritten by the "color" fwnode property. + pub fn color(self, color: Color) -> Self { + Self { color, ..self } + } +} + +/// Trait defining the operations for a LED driver. +/// +/// # Examples +/// +///``` +/// # use kernel::{ +/// # c_str, device, devres::Devres, +/// # error::Result, led, +/// # macros::vtable, platform, prelude::*, +/// # }; +/// # use core::pin::Pin; +/// +/// struct MyLedOps; +/// +/// +/// #[vtable] +/// impl led::LedOps for MyLedOps { +/// type Bus =3D platform::Device; +/// const BLOCKING: bool =3D false; +/// const MAX_BRIGHTNESS: u32 =3D 255; +/// +/// fn brightness_set( +/// &self, +/// _dev: &platform::Device, +/// _classdev: &led::Device, +/// _brightness: u32 +/// ) -> Result<()> { +/// // Set the brightness for the led here +/// Ok(()) +/// } +/// } +/// +/// fn register_my_led( +/// parent: &platform::Device, +/// ) -> Result>>>> { +/// KBox::pin_init(led::Device::new( +/// parent, +/// led::InitData::new() +/// .default_label(c_str!("my_led")), +/// MyLedOps, +/// ), GFP_KERNEL) +/// } +///``` +/// Led drivers must implement this trait in order to register and handle = a [`Device`]. +#[vtable] +pub trait LedOps: Send + 'static + Sized { + /// The bus device required by the implementation. + #[allow(private_bounds)] + type Bus: AsBusDevice; + /// If set true, [`LedOps::brightness_set`] and [`LedOps::blink_set`] = must perform the + /// operation immediately. If set false, they must not sleep. + const BLOCKING: bool; + /// The max brightness level + const MAX_BRIGHTNESS: u32; + + /// Sets the brightness level. + /// + /// See also [`LedOps::BLOCKING`]. + fn brightness_set( + &self, + dev: &Self::Bus, + classdev: &Device, + brightness: u32, + ) -> Result<()>; + + /// Gets the current brightness level. + fn brightness_get(&self, _dev: &Self::Bus, _classdev: &Device) -= > u32 { + build_error!(VTABLE_DEFAULT_ERROR) + } + + /// Activates hardware accelerated blinking. + /// + /// delays are in milliseconds. If both are zero, a sensible default s= hould be chosen. + /// The caller should adjust the timings in that case and if it can't = match the values + /// specified exactly. Setting the brightness to 0 will disable the ha= rdware accelerated + /// blinking. + /// + /// See also [`LedOps::BLOCKING`]. + fn blink_set( + &self, + _dev: &Self::Bus, + _classdev: &Device, + _delay_on: &mut usize, + _delay_off: &mut usize, + ) -> Result<()> { + build_error!(VTABLE_DEFAULT_ERROR) + } +} + +/// Led colors. +#[derive(Copy, Clone, Debug, Default)] +#[repr(u32)] +#[non_exhaustive] +#[expect( + missing_docs, + reason =3D "it shouldn't be necessary to document each color" +)] +pub enum Color { + #[default] + White =3D bindings::LED_COLOR_ID_WHITE, + Red =3D bindings::LED_COLOR_ID_RED, + Green =3D bindings::LED_COLOR_ID_GREEN, + Blue =3D bindings::LED_COLOR_ID_BLUE, + Amber =3D bindings::LED_COLOR_ID_AMBER, + Violet =3D bindings::LED_COLOR_ID_VIOLET, + Yellow =3D bindings::LED_COLOR_ID_YELLOW, + Ir =3D bindings::LED_COLOR_ID_IR, + Multi =3D bindings::LED_COLOR_ID_MULTI, + Rgb =3D bindings::LED_COLOR_ID_RGB, + Purple =3D bindings::LED_COLOR_ID_PURPLE, + Orange =3D bindings::LED_COLOR_ID_ORANGE, + Pink =3D bindings::LED_COLOR_ID_PINK, + Cyan =3D bindings::LED_COLOR_ID_CYAN, + Lime =3D bindings::LED_COLOR_ID_LIME, +} + +impl TryFrom for Color { + type Error =3D Error; + + fn try_from(value: u32) -> core::result::Result { + const _: () =3D { + assert!(bindings::LED_COLOR_ID_MAX =3D=3D 15); + }; + if value < bindings::LED_COLOR_ID_MAX { + // SAFETY: + // - `Color` is represented as `u32` + // - the const block above guarantees that no additional color= has been added + // - `value` is guaranteed to be in the color id range + Ok(unsafe { transmute::(value) }) + } else { + Err(EINVAL) + } + } +} + +// SAFETY: A `led::Device` can be unregistered from any thread. +unsafe impl Send for Device {} + +// SAFETY: `led::Device` can be shared among threads because all methods o= f `led::Device` +// are thread safe. +unsafe impl Sync for Device {} + +impl Device { + /// Registers a new led classdev. + /// + /// The [`Device`] will be unregistered on drop. + pub fn new<'a>( + parent: &'a T::Bus, + init_data: InitData<'a>, + ops: T, + ) -> impl PinInit, Error> + 'a { + Devres::new( + parent.as_ref(), + try_pin_init!(Self { + ops, + classdev <- Opaque::try_ffi_init(|ptr: *mut bindings::led_= classdev| { + // SAFETY: `try_ffi_init` guarantees that `ptr` is val= id for write. + // `led_classdev` gets fully initialized in-place by + // `led_classdev_register_ext` including `mutex` and `= list_head`. + unsafe { + ptr.write(bindings::led_classdev { + brightness_set: (!T::BLOCKING) + .then_some(Adapter::::brightness_set_ca= llback), + brightness_set_blocking: T::BLOCKING + .then_some(Adapter::::brightness_set_bl= ocking_callback), + brightness_get: T::HAS_BRIGHTNESS_GET + .then_some(Adapter::::brightness_get_ca= llback), + blink_set: T::HAS_BLINK_SET.then_some(Adapter:= :::blink_set_callback), + max_brightness: T::MAX_BRIGHTNESS, + brightness: init_data.initial_brightness, + default_trigger: init_data.default_trigger + .map_or(core::ptr::null(), CStr::as_char_p= tr), + color: init_data.color as u32, + ..bindings::led_classdev::default() + }) + }; + + let fwnode =3D init_data.fwnode.map(ARef::from); + + let mut init_data =3D bindings::led_init_data { + fwnode: fwnode + .as_ref() + .map_or(core::ptr::null_mut(), |fwnode| fwnode= .as_raw()), + default_label: init_data + .default_label + .map_or(core::ptr::null(), CStr::as_char_ptr), + devicename: init_data + .devicename + .map_or(core::ptr::null(), CStr::as_char_ptr), + devname_mandatory: init_data.devname_mandatory, + }; + + // SAFETY: + // - `parent.as_raw()` is guaranteed to be a pointer t= o a valid `device` + // or a null pointer. + // - `ptr` is guaranteed to be a pointer to an initial= ized `led_classdev`. + to_result(unsafe { + bindings::led_classdev_register_ext( + parent.as_ref().as_raw(), + ptr, + &mut init_data, + ) + })?; + + core::mem::forget(fwnode); // keep the reference count= incremented + + Ok::<_, Error>(()) + }), + }), + ) + } + + /// # Safety + /// `led_cdev` must be a valid pointer to a `led_classdev` embedded wi= thin a + /// `led::Device`. + unsafe fn from_raw<'a>(led_cdev: *mut bindings::led_classdev) -> &'a S= elf { + // SAFETY: The function's contract guarantees that `led_cdev` poin= ts to a `led_classdev` + // field embedded within a valid `led::Device`. `container_of!` ca= n therefore + // safely calculate the address of the containing struct. + unsafe { &*container_of!(Opaque::cast_from(led_cdev), Self, classd= ev) } + } + + fn parent(&self) -> &device::Device { + // SAFETY: + // - `self.classdev.get()` is guaranteed to be a valid pointer to = `led_classdev`. + unsafe { device::Device::from_raw((*(*self.classdev.get()).dev).pa= rent) } + } +} + +struct Adapter { + _p: PhantomData, +} + +impl Adapter { + /// # Safety + /// `led_cdev` must be a valid pointer to a `led_classdev` embedded wi= thin a + /// `led::Device`. + /// This function is called on setting the brightness of a led. + unsafe extern "C" fn brightness_set_callback( + led_cdev: *mut bindings::led_classdev, + brightness: u32, + ) { + // SAFETY: The function's contract guarantees that `led_cdev` is a= valid pointer to a + // `led_classdev` embedded within a `led::Device`. + let classdev =3D unsafe { Device::::from_raw(led_cdev) }; + // SAFETY: `classdev.parent()` is guaranteed to be contained in `T= ::Bus`. + let parent =3D unsafe { T::Bus::from_device(classdev.parent()) }; + + let _ =3D classdev.ops.brightness_set(parent, classdev, brightness= ); + } + + /// # Safety + /// `led_cdev` must be a valid pointer to a `led_classdev` embedded wi= thin a + /// `led::Device`. + /// This function is called on setting the brightness of a led immedia= tely. + unsafe extern "C" fn brightness_set_blocking_callback( + led_cdev: *mut bindings::led_classdev, + brightness: u32, + ) -> i32 { + from_result(|| { + // SAFETY: The function's contract guarantees that `led_cdev` = is a valid pointer to a + // `led_classdev` embedded within a `led::Device`. + let classdev =3D unsafe { Device::::from_raw(led_cdev) }; + // SAFETY: `classdev.parent()` is guaranteed to be contained i= n `T::Bus`. + let parent =3D unsafe { T::Bus::from_device(classdev.parent())= }; + + classdev.ops.brightness_set(parent, classdev, brightness)?; + Ok(0) + }) + } + + /// # Safety + /// `led_cdev` must be a valid pointer to a `led_classdev` embedded wi= thin a + /// `led::Device`. + /// This function is called on getting the brightness of a led. + unsafe extern "C" fn brightness_get_callback(led_cdev: *mut bindings::= led_classdev) -> u32 { + // SAFETY: The function's contract guarantees that `led_cdev` is a= valid pointer to a + // `led_classdev` embedded within a `led::Device`. + let classdev =3D unsafe { Device::::from_raw(led_cdev) }; + // SAFETY: `classdev.parent()` is guaranteed to be contained in `T= ::Bus`. + let parent =3D unsafe { T::Bus::from_device(classdev.parent()) }; + + classdev.ops.brightness_get(parent, classdev) + } + + /// # Safety + /// `led_cdev` must be a valid pointer to a `led_classdev` embedded wi= thin a + /// `led::Device`. + /// `delay_on` and `delay_off` must be valid pointers to `usize` and h= ave + /// exclusive access for the period of this function. + /// This function is called on enabling hardware accelerated blinking. + unsafe extern "C" fn blink_set_callback( + led_cdev: *mut bindings::led_classdev, + delay_on: *mut usize, + delay_off: *mut usize, + ) -> i32 { + from_result(|| { + // SAFETY: The function's contract guarantees that `led_cdev` = is a valid pointer to a + // `led_classdev` embedded within a `led::Device`. + let classdev =3D unsafe { Device::::from_raw(led_cdev) }; + // SAFETY: `classdev.parent()` is guaranteed to be contained i= n `T::Bus`. + let parent =3D unsafe { T::Bus::from_device(classdev.parent())= }; + + classdev.ops.blink_set( + parent, + classdev, + // SAFETY: The function's contract guarantees that `delay_= on` points to a `usize` + // and is exclusive for the period of this function. + unsafe { &mut *delay_on }, + // SAFETY: The function's contract guarantees that `delay_= off` points to a `usize` + // and is exclusive for the period of this function. + unsafe { &mut *delay_off }, + )?; + Ok(0) + }) + } +} + +#[pinned_drop] +impl PinnedDrop for Device { + fn drop(self: Pin<&mut Self>) { + let raw =3D self.classdev.get(); + // SAFETY: The existence of `self` guarantees that `self.classdev.= get()` is a pointer to a + // valid `struct led_classdev`. + let dev: &device::Device =3D unsafe { device::Device::from_raw((*r= aw).dev) }; + + let _fwnode =3D dev + .fwnode() + // SAFETY: the reference count of `fwnode` has previously been + // incremented in `led::Device::new`. + .map(|fwnode| unsafe { ARef::from_raw(NonNull::from(fwnode)) }= ); + + // SAFETY: The existence of `self` guarantees that `self.classdev`= has previously been + // successfully registered with `led_classdev_register_ext`. + unsafe { bindings::led_classdev_unregister(self.classdev.get()) }; + } +} diff --git a/rust/kernel/lib.rs b/rust/kernel/lib.rs index 3dd7bebe7888..c03b7b242a2b 100644 --- a/rust/kernel/lib.rs +++ b/rust/kernel/lib.rs @@ -103,6 +103,7 @@ pub mod jump_label; #[cfg(CONFIG_KUNIT)] pub mod kunit; +pub mod led; pub mod list; pub mod maple_tree; pub mod miscdevice; --=20 2.51.0 From nobody Sun Feb 8 17:04:21 2026 Received: from mout02.posteo.de (mout02.posteo.de [185.67.36.66]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id B2D9B305054 for ; Sat, 15 Nov 2025 17:26:06 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=185.67.36.66 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763227569; cv=none; b=fGuzgZnvjd6+0VgWmYhXdain+GOGgglYdGQgWbNWYz1yE3349D8j7fjaytGnFo/oPGFbfc6FdTC+dytk/RlvKMMjMdV8kbA5SJ/3ARSULwxeT6oONq1djB0zrEVcaOVfG9hQ1kN+MOlmgP1b2pX31xozLQqlWMQ0RsBCZOIr+Cc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763227569; c=relaxed/simple; bh=A8PASku3wjBmTYTV7Ab+jIu3B9a8YlZHY4U82WjvKuo=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=L2ZCfV+8eaiTFe67iC3v7NWAZqLIytstJXoXpm3+1fyC2+QRVqKYYMKXPGXrHKLIKj+vFoiDcs0OsQGudxaGLT94IsXds8N56+x0QtIgqYt8tNCsqPQwApsQlSWlRmzWPMrVg8tgoomsBCFrGptpGUXwIv4B99/hbbNcw8h0UUg= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=posteo.de; spf=pass smtp.mailfrom=posteo.de; dkim=pass (2048-bit key) header.d=posteo.de header.i=@posteo.de header.b=pGHMdosT; arc=none smtp.client-ip=185.67.36.66 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=posteo.de Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=posteo.de Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=posteo.de header.i=@posteo.de header.b="pGHMdosT" Received: from submission (posteo.de [185.67.36.169]) by mout02.posteo.de (Postfix) with ESMTPS id 2D1B6240105 for ; Sat, 15 Nov 2025 18:26:05 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=posteo.de; s=2017; t=1763227565; bh=9WEkyzR3zNFQYQ4mh0OuLi1FlkE280iEnRB/aZPlmcc=; h=From:Date:Subject:MIME-Version:Content-Type: Content-Transfer-Encoding:Message-Id:To:Cc:Autocrypt:OpenPGP:From; b=pGHMdosTuhh2bQbBsAw+iuR6D63pUB50ugAxC3WGc2S60AOS7LJxAvA4m2FuZdeMJ TZISqCx963MjOkC0A6zcoB9BF+r0DF8Hxt81sT2mdIjVVahHvzwKbGlvITiWIxAWas 31t2jXLJ/ovwNSsy8YFnV4L7c5b9Vup2FeE10rNOathtGOZ1LCWehesKuKBirlf+76 bQm02rqZxmB6ug/HFi5Ol9jLldgahjmceWLVGR6RkLFz0ZHqc5UtVXt+z6Y6F01wnG QBA5zMQIuqT942qdCMSjgvuzDlRSTW1cVneRw1r7PWbTfjJFNdYWZKH+LCHdkKCH2a j9EABvFq+H58Q== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4d81BL1BvSz9rxD; Sat, 15 Nov 2025 18:26:02 +0100 (CET) From: Markus Probst Date: Sat, 15 Nov 2025 17:26:04 +0000 Subject: [PATCH v8 3/4] rust: leds: split generic and normal led classdev abstractions up Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20251115-rust_leds-v8-3-d9a41f355538@posteo.de> References: <20251115-rust_leds-v8-0-d9a41f355538@posteo.de> In-Reply-To: <20251115-rust_leds-v8-0-d9a41f355538@posteo.de> To: Lee Jones , Pavel Machek , Greg Kroah-Hartman , Dave Ertman , Ira Weiny , Leon Romanovsky , Miguel Ojeda , Alex Gaynor , Boqun Feng , Gary Guo , =?utf-8?q?Bj=C3=B6rn_Roy_Baron?= , Benno Lossin , Andreas Hindborg , Alice Ryhl , Trevor Gross , Danilo Krummrich , "Rafael J. Wysocki" , Bjorn Helgaas , =?utf-8?q?Krzysztof_Wilczy=C5=84ski?= Cc: rust-for-linux@vger.kernel.org, linux-leds@vger.kernel.org, linux-kernel@vger.kernel.org, linux-pci@vger.kernel.org, Markus Probst X-Developer-Signature: v=1; a=openpgp-sha256; l=14996; i=markus.probst@posteo.de; h=from:subject:message-id; bh=A8PASku3wjBmTYTV7Ab+jIu3B9a8YlZHY4U82WjvKuo=; b=owEBbQKS/ZANAwAIATR2H/jnrUPSAcsmYgBpGLeilNsacAciFqr7hgTUsahyNI9X/LbyZv7lC hVHGm4Cm6qJAjMEAAEIAB0WIQSCdBjE9KxY53IwxHM0dh/4561D0gUCaRi3ogAKCRA0dh/4561D 0n71D/904oiypNU190D2MwRnLPgTFSZCDd6v/O9Fkg53MyCnTMsp8517RKvX4uqgqRNmDUlAY3l yRUOHkfeOR2gGsXJTUJyuLcWwOjylf88Micjvyc+SjDQok2aRM33MoQdfsehqXk+TiThBM/Kuh0 3qHNH0q6iDFxQY7jSEyeFPch3pLQ+PgOSUybb3cMb8RBWcPTVA5+3nPhO5x7eVahUIS+y6/by6C 0JtF9Yt9AzrVs2THAe9P7ZBHC7ECEKtxGy3Ejs3L2BrAgzxVnhEiPAlzO1KRV3kSxhWOgBx0TUd +jRQKQoDKPNx9WIqWkmPBBOd4spS4EiDHWSPEhyh1S72fmYa6u4kdcUFUecyWDUVriuGNBC9qiq frzypjOJwGxcCx/aqJsJG2LhJCug5r79a88gS6eRn6eYkVxcoQQSiq+/JFKzKSaogMy7SI8d9DF v3LXaQNktppFXXladnMYD4iXx8/B/21CisFHZYxbu/uqXUgnbVzfssQrUER2wLTxGdLcy1vg1vn RcpxrMp6fiGUinkFRKNmuvTRP4r3kdXSTsi0L6stM1XdeBVNRX+KLPk8jegmGe3OYi3OFBWj9F5 95FmFMyXB6FE1M3h+BBdDTC7eLD6y2gCL8rs3hNUXBnFcR080kfbW9wzLauvUJb72XmQdxfMDGp D76SF5cobStw8TQ== X-Developer-Key: i=markus.probst@posteo.de; a=openpgp; fpr=827418C4F4AC58E77230C47334761FF8E7AD43D2 Autocrypt: addr=markus.probst@posteo.de; prefer-encrypt=mutual; keydata=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 aBeNN4ijKZchBXHPgVx+YtWRHfcm4l8= OpenPGP: url=https://posteo.de/keys/markus.probst@posteo.de.asc; preference=encrypt Move code specific to normal led class devices into a separate file and introduce the `led::Mode` trait to allow for other types of led class devices. Signed-off-by: Markus Probst --- MAINTAINERS | 1 + rust/kernel/device.rs | 2 +- rust/kernel/led.rs | 128 +++++++++++++++++++++++++++++++++++-------= ---- rust/kernel/led/normal.rs | 39 ++++++++++++++ 4 files changed, 139 insertions(+), 31 deletions(-) diff --git a/MAINTAINERS b/MAINTAINERS index 2d66db23a63b..03081d2ac9f8 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -14110,6 +14110,7 @@ L: linux-leds@vger.kernel.org L: rust-for-linux@vger.kernel.org S: Maintained F: rust/kernel/led.rs +F: rust/kernel/led/ =20 LEGO MINDSTORMS EV3 R: David Lechner diff --git a/rust/kernel/device.rs b/rust/kernel/device.rs index bf09fd0b0199..1d5d8e7581f2 100644 --- a/rust/kernel/device.rs +++ b/rust/kernel/device.rs @@ -250,7 +250,7 @@ pub(crate) fn as_raw(&self) -> *mut bindings::device { } =20 /// Returns a reference to the parent device, if any. - #[cfg_attr(not(CONFIG_AUXILIARY_BUS), expect(dead_code))] + #[cfg_attr(not(any(CONFIG_AUXILIARY_BUS, CONFIG_LEDS_CLASS)), expect(d= ead_code))] pub(crate) fn parent(&self) -> Option<&Device> { // SAFETY: // - By the type invariant `self.as_raw()` is always valid. diff --git a/rust/kernel/led.rs b/rust/kernel/led.rs index 4c1b72c998e1..c55f9852d378 100644 --- a/rust/kernel/led.rs +++ b/rust/kernel/led.rs @@ -44,14 +44,18 @@ }, // }; =20 +mod normal; + +pub use normal::Normal; + /// The led class device representation. /// -/// This structure represents the Rust abstraction for a C `struct led_cla= ssdev`. +/// This structure represents the Rust abstraction for a led class device. #[pin_data(PinnedDrop)] pub struct Device { ops: T, #[pin] - classdev: Opaque, + classdev: Opaque<::Type>, } =20 /// The led init data representation. @@ -156,6 +160,7 @@ pub fn color(self, color: Color) -> Self { /// #[vtable] /// impl led::LedOps for MyLedOps { /// type Bus =3D platform::Device; +/// type Mode =3D led::Normal; /// const BLOCKING: bool =3D false; /// const MAX_BRIGHTNESS: u32 =3D 255; /// @@ -187,6 +192,12 @@ pub trait LedOps: Send + 'static + Sized { /// The bus device required by the implementation. #[allow(private_bounds)] type Bus: AsBusDevice; + + /// The led mode to use. + /// + /// See [`Mode`]. + type Mode: Mode; + /// If set true, [`LedOps::brightness_set`] and [`LedOps::blink_set`] = must perform the /// operation immediately. If set false, they must not sleep. const BLOCKING: bool; @@ -273,6 +284,42 @@ fn try_from(value: u32) -> core::result::Result { } } =20 +/// The led mode. +/// +/// Each led mode has its own led class device type with different capabil= ities. +/// +/// See [`Normal`]. +pub trait Mode: private::Mode {} + +impl Mode for T {} + +type RegisterFunc =3D + unsafe extern "C" fn(*mut bindings::device, *mut T, *mut bindings::led= _init_data) -> i32; + +type UnregisterFunc =3D unsafe extern "C" fn(*mut T); + +mod private { + pub trait Mode { + type Type; + const REGISTER: super::RegisterFunc; + const UNREGISTER: super::UnregisterFunc; + + /// # Safety + /// `raw` must be a valid pointer to [`Self::Type`]. + unsafe fn device<'a>(raw: *mut Self::Type) -> &'a crate::device::D= evice; + + /// # Safety + /// `led_cdev` must be a valid pointer to `led_classdev` embedded = within [`Self::Type`]. + unsafe fn from_classdev(led_cdev: *mut bindings::led_classdev) -> = *mut Self::Type; + + /// # Safety + /// `raw` must be a valid pointer to [`Self::Type`]. + unsafe fn pre_brightness_set(_raw: *mut Self::Type, _brightness: u= 32) {} + + fn release(_led_cdev: &mut Self::Type) {} + } +} + // SAFETY: A `led::Device` can be unregistered from any thread. unsafe impl Send for Device {} =20 @@ -281,24 +328,22 @@ unsafe impl Send for Device {} unsafe impl Sync for Device {} =20 impl Device { - /// Registers a new led classdev. - /// - /// The [`Device`] will be unregistered on drop. - pub fn new<'a>( + fn __new<'a>( parent: &'a T::Bus, init_data: InitData<'a>, ops: T, + func: impl FnOnce(bindings::led_classdev) -> Result<::Type> + 'a, ) -> impl PinInit, Error> + 'a { Devres::new( parent.as_ref(), try_pin_init!(Self { ops, - classdev <- Opaque::try_ffi_init(|ptr: *mut bindings::led_= classdev| { + classdev <- Opaque::try_ffi_init(|ptr: *mut ::Type| { // SAFETY: `try_ffi_init` guarantees that `ptr` is val= id for write. - // `led_classdev` gets fully initialized in-place by - // `led_classdev_register_ext` including `mutex` and `= list_head`. + // `T::Mode::Type` (and the embedded led_classdev) get= s fully initialized + // in-place by `T::Mode::REGISTER` including `mutex` a= nd `list_head`. unsafe { - ptr.write(bindings::led_classdev { + ptr.write((func)(bindings::led_classdev { brightness_set: (!T::BLOCKING) .then_some(Adapter::::brightness_set_ca= llback), brightness_set_blocking: T::BLOCKING @@ -312,7 +357,7 @@ pub fn new<'a>( .map_or(core::ptr::null(), CStr::as_char_p= tr), color: init_data.color as u32, ..bindings::led_classdev::default() - }) + })?) }; =20 let fwnode =3D init_data.fwnode.map(ARef::from); @@ -331,11 +376,11 @@ pub fn new<'a>( }; =20 // SAFETY: - // - `parent.as_raw()` is guaranteed to be a pointer t= o a valid `device` - // or a null pointer. - // - `ptr` is guaranteed to be a pointer to an initial= ized `led_classdev`. + // - `parent.as_ref().as_raw()` is guaranteed to be a = pointer to a valid + // `device`. + // - `ptr` is guaranteed to be a pointer to an initial= ized `T::Mode::Type`. to_result(unsafe { - bindings::led_classdev_register_ext( + (::REGISTER)( parent.as_ref().as_raw(), ptr, &mut init_data, @@ -355,15 +400,22 @@ pub fn new<'a>( /// `led::Device`. unsafe fn from_raw<'a>(led_cdev: *mut bindings::led_classdev) -> &'a S= elf { // SAFETY: The function's contract guarantees that `led_cdev` poin= ts to a `led_classdev` - // field embedded within a valid `led::Device`. `container_of!` ca= n therefore - // safely calculate the address of the containing struct. - unsafe { &*container_of!(Opaque::cast_from(led_cdev), Self, classd= ev) } + // embedded within a `led::Device` and thus is embedded within `T:= :Mode::Type`. + let raw =3D unsafe { ::from_classdev(led= _cdev) }; + + // SAFETY: The function's contract guarantees that `raw` points to= a `led_classdev` field + // embedded within a valid `led::Device`. `container_of!` can ther= efore safely calculate + // the address of the containing struct. + unsafe { &*container_of!(Opaque::cast_from(raw), Self, classdev) } } =20 fn parent(&self) -> &device::Device { - // SAFETY: - // - `self.classdev.get()` is guaranteed to be a valid pointer to = `led_classdev`. - unsafe { device::Device::from_raw((*(*self.classdev.get()).dev).pa= rent) } + // SAFETY: `self.classdev.get()` is guaranteed to be a valid point= er to `T::Mode::Type`. + let device =3D unsafe { ::device(self.cl= assdev.get()) }; + // SAFETY: `led::Device::__new` doesn't allow to register a class = device without an parent. + let parent =3D unsafe { device.parent().unwrap_unchecked() }; + // SAFETY: the existence of `self` guarantees that `parent` is bou= nd to a driver. + unsafe { parent.as_bound() } } } =20 @@ -381,11 +433,17 @@ impl Adapter { brightness: u32, ) { // SAFETY: The function's contract guarantees that `led_cdev` is a= valid pointer to a - // `led_classdev` embedded within a `led::Device`. + // `T::Mode::Type` embedded within a `led::Device`. let classdev =3D unsafe { Device::::from_raw(led_cdev) }; // SAFETY: `classdev.parent()` is guaranteed to be contained in `T= ::Bus`. let parent =3D unsafe { T::Bus::from_device(classdev.parent()) }; =20 + // SAFETY: `classdev.classdev.get()` is guaranteed to be a valid p= ointer to a + // `T::Mode::Type`. + unsafe { + ::pre_brightness_set(classdev.classd= ev.get(), brightness); + } + let _ =3D classdev.ops.brightness_set(parent, classdev, brightness= ); } =20 @@ -399,11 +457,17 @@ impl Adapter { ) -> i32 { from_result(|| { // SAFETY: The function's contract guarantees that `led_cdev` = is a valid pointer to a - // `led_classdev` embedded within a `led::Device`. + // `T::Mode::Type` embedded within a `led::Device`. let classdev =3D unsafe { Device::::from_raw(led_cdev) }; // SAFETY: `classdev.parent()` is guaranteed to be contained i= n `T::Bus`. let parent =3D unsafe { T::Bus::from_device(classdev.parent())= }; =20 + // SAFETY: `classdev.classdev.get()` is guaranteed to be a val= id pointer to a + // `T::Mode::Type`. + unsafe { + ::pre_brightness_set(classdev.cl= assdev.get(), brightness); + } + classdev.ops.brightness_set(parent, classdev, brightness)?; Ok(0) }) @@ -415,7 +479,7 @@ impl Adapter { /// This function is called on getting the brightness of a led. unsafe extern "C" fn brightness_get_callback(led_cdev: *mut bindings::= led_classdev) -> u32 { // SAFETY: The function's contract guarantees that `led_cdev` is a= valid pointer to a - // `led_classdev` embedded within a `led::Device`. + // `T::Mode::Type` embedded within a `led::Device`. let classdev =3D unsafe { Device::::from_raw(led_cdev) }; // SAFETY: `classdev.parent()` is guaranteed to be contained in `T= ::Bus`. let parent =3D unsafe { T::Bus::from_device(classdev.parent()) }; @@ -436,7 +500,7 @@ impl Adapter { ) -> i32 { from_result(|| { // SAFETY: The function's contract guarantees that `led_cdev` = is a valid pointer to a - // `led_classdev` embedded within a `led::Device`. + // `T::Mode::Type` embedded within a `led::Device`. let classdev =3D unsafe { Device::::from_raw(led_cdev) }; // SAFETY: `classdev.parent()` is guaranteed to be contained i= n `T::Bus`. let parent =3D unsafe { T::Bus::from_device(classdev.parent())= }; @@ -461,17 +525,21 @@ impl PinnedDrop for Device { fn drop(self: Pin<&mut Self>) { let raw =3D self.classdev.get(); // SAFETY: The existence of `self` guarantees that `self.classdev.= get()` is a pointer to a - // valid `struct led_classdev`. - let dev: &device::Device =3D unsafe { device::Device::from_raw((*r= aw).dev) }; + // valid `T::Mode::Type`. + let dev: &device::Device =3D unsafe { ::= device(raw) }; =20 let _fwnode =3D dev .fwnode() // SAFETY: the reference count of `fwnode` has previously been - // incremented in `led::Device::new`. + // incremented in `led::Device::__new`. .map(|fwnode| unsafe { ARef::from_raw(NonNull::from(fwnode)) }= ); =20 // SAFETY: The existence of `self` guarantees that `self.classdev`= has previously been - // successfully registered with `led_classdev_register_ext`. - unsafe { bindings::led_classdev_unregister(self.classdev.get()) }; + // successfully registered with `T::Mode::REGISTER`. + unsafe { (::UNREGISTER)(raw) }; + + // SAFETY: The existence of `self` guarantees that `self.classdev.= get()` is a pointer to a + // valid `T::Mode::Type`. + ::release(unsafe { &mut *raw }); } } diff --git a/rust/kernel/led/normal.rs b/rust/kernel/led/normal.rs new file mode 100644 index 000000000000..13feeb3256f3 --- /dev/null +++ b/rust/kernel/led/normal.rs @@ -0,0 +1,39 @@ +// SPDX-License-Identifier: GPL-2.0 + +//! Led mode for the `struct led_classdev`. +//! +//! C header: [`include/linux/leds.h`](srctree/include/linux/leds.h) + +use super::*; + +/// The led mode for the `struct led_classdev`. Leds with this mode can on= ly have a fixed color. +pub enum Normal {} + +impl private::Mode for Normal { + type Type =3D bindings::led_classdev; + const REGISTER: RegisterFunc =3D bindings::led_classdev_re= gister_ext; + const UNREGISTER: UnregisterFunc =3D bindings::led_classde= v_unregister; + + unsafe fn device<'a>(raw: *mut Self::Type) -> &'a device::Device { + // SAFETY: + // - The function's contract guarantees that `raw` is a valid poin= ter to `led_classdev`. + unsafe { device::Device::from_raw((*raw).dev) } + } + + unsafe fn from_classdev(led_cdev: *mut bindings::led_classdev) -> *mut= Self::Type { + led_cdev + } +} + +impl> Device { + /// Registers a new led classdev. + /// + /// The [`Device`] will be unregistered on drop. + pub fn new<'a>( + parent: &'a T::Bus, + init_data: InitData<'a>, + ops: T, + ) -> impl PinInit, Error> + 'a { + Self::__new(parent, init_data, ops, Ok) + } +} --=20 2.51.0 From nobody Sun Feb 8 17:04:21 2026 Received: from mout02.posteo.de (mout02.posteo.de [185.67.36.66]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id BD11D305E2E for ; Sat, 15 Nov 2025 17:26:08 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=185.67.36.66 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763227572; cv=none; b=V3oaAdDUMnqcFSbFeuvxO+8VDXISLDkV2tyLbdQu5Umd+cHcAtt6REPsvs++24+M7vxPPsV8iSNO+lHJeP5uoReHRxHhzC8yTUh8efO3Xkvd9NUxsN1um9GUQNF1qhX1pzM2/YDAg2+UBSAjLwBr1vun+spUYtwVZ9nWCrKZV3M= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763227572; c=relaxed/simple; bh=Uohd819v/S6bIx68JfE/asm+yhU2CxYdcSIDKKM7zLI=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=mH4R++6FFIL5RaNlP++ROveOw4J658jglMKmdYhG6aqQ6GsO+OWuCa93lHdCYMAiHBijWKdorT3eLel6KJHjpXYyOOLZSh29hcl5FzYJvNfrJDkaoHUQcgiXlBlcOE/V+kUkbHltPazPqtVE8XrKUR2KUWJHRbqjUGULrbShVso= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=posteo.de; spf=pass smtp.mailfrom=posteo.de; dkim=pass (2048-bit key) header.d=posteo.de header.i=@posteo.de header.b=B+PDPrAq; arc=none smtp.client-ip=185.67.36.66 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=posteo.de Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=posteo.de Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=posteo.de header.i=@posteo.de header.b="B+PDPrAq" Received: from submission (posteo.de [185.67.36.169]) by mout02.posteo.de (Postfix) with ESMTPS id 2E865240101 for ; Sat, 15 Nov 2025 18:26:07 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=posteo.de; s=2017; t=1763227567; bh=zqKg1rOa6hGcURHxMPuTQZ+rpn6vivHG4MhrXG7HuXU=; h=From:Date:Subject:MIME-Version:Content-Type: Content-Transfer-Encoding:Message-Id:To:Cc:Autocrypt:OpenPGP:From; b=B+PDPrAqbcnfmqLEN/DD+XLbWiPXCem9loYJoD6Tk0EM4bJTi5gPPBqtKrP6ZQSXi SsLoiM7e7hBXbLHnA+4sPBU6VZEbYqaS/JPXjD8I8ZE30H44zs7HXHhnDYZ3v/4Bvu QsRG6Uda5xGzHzfROFmLRnPuKAeuEG63riYhQC0zBNiprJvrLnhaWMZjR+2eVs42CS vxLxQLFljdDUJZUCKl2cQieHRIsSxJQZGivllXX5l2jE8xpDQeg2lrJ7cSDlon1Bzs u82eD2Xnj3Cj7t1bShQTDSY0l/sj/BekQehL38ToSIm5CAuuv4p78GYlbNIVftkuIN RcCQRf4CsRvBg== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4d81BN28Lnz9rxP; Sat, 15 Nov 2025 18:26:04 +0100 (CET) From: Markus Probst Date: Sat, 15 Nov 2025 17:26:06 +0000 Subject: [PATCH v8 4/4] rust: leds: add multicolor classdev abstractions Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20251115-rust_leds-v8-4-d9a41f355538@posteo.de> References: <20251115-rust_leds-v8-0-d9a41f355538@posteo.de> In-Reply-To: <20251115-rust_leds-v8-0-d9a41f355538@posteo.de> To: Lee Jones , Pavel Machek , Greg Kroah-Hartman , Dave Ertman , Ira Weiny , Leon Romanovsky , Miguel Ojeda , Alex Gaynor , Boqun Feng , Gary Guo , =?utf-8?q?Bj=C3=B6rn_Roy_Baron?= , Benno Lossin , Andreas Hindborg , Alice Ryhl , Trevor Gross , Danilo Krummrich , "Rafael J. Wysocki" , Bjorn Helgaas , =?utf-8?q?Krzysztof_Wilczy=C5=84ski?= Cc: rust-for-linux@vger.kernel.org, linux-leds@vger.kernel.org, linux-kernel@vger.kernel.org, linux-pci@vger.kernel.org, Markus Probst X-Developer-Signature: v=1; a=openpgp-sha256; l=9531; i=markus.probst@posteo.de; h=from:subject:message-id; bh=Uohd819v/S6bIx68JfE/asm+yhU2CxYdcSIDKKM7zLI=; b=owEBbQKS/ZANAwAIATR2H/jnrUPSAcsmYgBpGLeiXjdtIOhoUbd0+4XTbYeQmUy/cSXUFP6HL EifxJFwJ1aJAjMEAAEIAB0WIQSCdBjE9KxY53IwxHM0dh/4561D0gUCaRi3ogAKCRA0dh/4561D 0g22D/0Vake9v7h9gKLTz7I+t7b8STaVgeJKrkel5YlOEdbVt44QckXzVbEyKnRaxOYz7Hy2Tk8 Uunl0WR/lQQ6a0lXKH3osHu/zeTM6YZRJ0oTuWmKR/tZyrZG+BYJakZySvpodRTDvmo4vgerXK5 7cSxfHFMwfR1+nZWP/MdNlNJedSjFBJqYJbkgPKLSGtCglVRaMNqj5/XuQv23cRxqwIxy9YdpKT JUJ2iuxlDZjgPTMp44B0ey3tt6OEyqb+0XnFKzGtjo1npOYGFpVdQedRvR6o6mv5ptNOo2uGEqk 3v2yzcgOf2Csj+yUSnzx+7pABS/6oDa7le4+MZDpIxvxkxJJQb4RROPV5xCMNIjFZjlqUNEs5Kn XL8b1cZxQwZwxFbOCMjWfgsDgz/eELR4ip3AoGlX4LaZPRC5lwWYwCgGQKeT4AccoQYFyGzbkJF cD/rrgb1rvtjeYswFj85JfK5xHofLFU38EcIbISWRHTjskFjLHyOdL66CoDscRmZlZg9w6+rAvg EDPfTi9/ZRjm+ifWyiolsy30llgp8xCu4zbi+RWZ1vzZ/tnXqKa++/dgwcbe597nsNa4A0ybT84 Todz0B+gRSzsD7PRF63Q+jqB99JCGXeyTWBwODJ5eKOxUOAXnNnEAm0HvbkLZ+haGb0ZM7j7GHs 3DPgdRhe5/jX0Kw== X-Developer-Key: i=markus.probst@posteo.de; a=openpgp; fpr=827418C4F4AC58E77230C47334761FF8E7AD43D2 Autocrypt: addr=markus.probst@posteo.de; prefer-encrypt=mutual; keydata=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 aBeNN4ijKZchBXHPgVx+YtWRHfcm4l8= OpenPGP: url=https://posteo.de/keys/markus.probst@posteo.de.asc; preference=encrypt Implement the abstractions needed for multicolor led class devices, including: * `led::MultiColor` - the led mode implementation * `MultiColorSubLed` - a safe wrapper arround `mc_subled` * `led::Device::new_multicolor()` - the function to register a multicolor led class device * `led::Device::subleds()` - the function to access the brightness and intensity of the individual sub leds Signed-off-by: Markus Probst --- rust/bindings/bindings_helper.h | 1 + rust/kernel/led.rs | 7 +- rust/kernel/led/multicolor.rs | 195 ++++++++++++++++++++++++++++++++++++= ++++ 3 files changed, 202 insertions(+), 1 deletion(-) diff --git a/rust/bindings/bindings_helper.h b/rust/bindings/bindings_helpe= r.h index 2e43c66635a2..ba8605eeecce 100644 --- a/rust/bindings/bindings_helper.h +++ b/rust/bindings/bindings_helper.h @@ -61,6 +61,7 @@ #include #include #include +#include #include #include #include diff --git a/rust/kernel/led.rs b/rust/kernel/led.rs index c55f9852d378..4add9d15a5e0 100644 --- a/rust/kernel/led.rs +++ b/rust/kernel/led.rs @@ -44,8 +44,12 @@ }, // }; =20 +#[cfg(CONFIG_LEDS_CLASS_MULTICOLOR)] +mod multicolor; mod normal; =20 +#[cfg(CONFIG_LEDS_CLASS_MULTICOLOR)] +pub use multicolor::{MultiColor, MultiColorSubLed}; pub use normal::Normal; =20 /// The led class device representation. @@ -288,7 +292,8 @@ fn try_from(value: u32) -> core::result::Result { /// /// Each led mode has its own led class device type with different capabil= ities. /// -/// See [`Normal`]. +#[cfg_attr(CONFIG_LEDS_CLASS_MULTICOLOR, doc =3D "See [`Normal`] and [`Mul= tiColor`].")] +#[cfg_attr(not(CONFIG_LEDS_CLASS_MULTICOLOR), doc =3D "See [`Normal`] and = `MultiColor`.")] pub trait Mode: private::Mode {} =20 impl Mode for T {} diff --git a/rust/kernel/led/multicolor.rs b/rust/kernel/led/multicolor.rs new file mode 100644 index 000000000000..3afefaef6498 --- /dev/null +++ b/rust/kernel/led/multicolor.rs @@ -0,0 +1,195 @@ +// SPDX-License-Identifier: GPL-2.0 + +//! Led mode for the `struct led_classdev_mc`. +//! +//! C header: [`include/linux/led-class-multicolor.h`](srctree/include/lin= ux/led-class-multicolor.h) + +use crate::{ + alloc::KVec, + error::code::EINVAL, + prelude::*, // +}; + +use super::*; + +/// The led mode for the `struct led_classdev_mc`. Leds with this mode can= have multiple colors. +pub enum MultiColor {} + +/// The multicolor sub led info representation. +/// +/// This structure represents the Rust abstraction for a C `struct mc_subl= ed`. +#[repr(C)] +#[derive(Copy, Clone, Debug)] +pub struct MultiColorSubLed { + /// the color of the sub led + pub color: Color, + /// the brightness of the sub led. + /// + /// The value will be automatically calculated. + /// See `MultiColor::pre_brightness_set`. + pub brightness: u32, + /// the intensity of the sub led. + pub intensity: u32, + /// arbitrary data for the driver to store. + pub channel: u32, + _p: PhantomData<()>, // Only allow creation with `MultiColorSubLed::ne= w`. +} + +// We directly pass a reference to the `subled_info` field in `led_classde= v_mc` to the driver via +// `Device::subleds()`. +// We need safeguards to ensure `MultiColorSubLed` and `mc_subled` stay id= entical. +const _: () =3D { + use core::mem::offset_of; + + const fn assert_same_type(_: &T, _: &T) {} + + let rust_zeroed =3D MultiColorSubLed { + color: Color::White, + brightness: 0, + intensity: 0, + channel: 0, + _p: PhantomData, + }; + let c_zeroed =3D bindings::mc_subled { + color_index: 0, + brightness: 0, + intensity: 0, + channel: 0, + }; + + assert!(offset_of!(MultiColorSubLed, color) =3D=3D offset_of!(bindings= ::mc_subled, color_index)); + assert_same_type(&0u32, &c_zeroed.color_index); + + assert!( + offset_of!(MultiColorSubLed, brightness) =3D=3D offset_of!(binding= s::mc_subled, brightness) + ); + assert_same_type(&rust_zeroed.brightness, &c_zeroed.brightness); + + assert!(offset_of!(MultiColorSubLed, intensity) =3D=3D offset_of!(bind= ings::mc_subled, intensity)); + assert_same_type(&rust_zeroed.intensity, &c_zeroed.intensity); + + assert!(offset_of!(MultiColorSubLed, channel) =3D=3D offset_of!(bindin= gs::mc_subled, channel)); + assert_same_type(&rust_zeroed.channel, &c_zeroed.channel); + + assert!(size_of::() =3D=3D size_of::()); +}; + +impl MultiColorSubLed { + /// Create a new multicolor sub led info. + pub fn new(color: Color) -> Self { + Self { + color, + brightness: 0, + intensity: 0, + channel: 0, + _p: PhantomData, + } + } + + /// Set arbitrary data for the driver. + pub fn channel(mut self, channel: u32) -> Self { + self.channel =3D channel; + self + } + + /// Set the initial intensity of the subled. + pub fn initial_intensity(mut self, intensity: u32) -> Self { + self.intensity =3D intensity; + self + } +} + +impl private::Mode for MultiColor { + type Type =3D bindings::led_classdev_mc; + const REGISTER: RegisterFunc =3D bindings::led_classdev_mu= lticolor_register_ext; + const UNREGISTER: UnregisterFunc =3D bindings::led_classde= v_multicolor_unregister; + + unsafe fn device<'a>(raw: *mut Self::Type) -> &'a device::Device { + // SAFETY: + // - The function's contract guarantees that `raw` is a valid poin= ter to `led_classdev`. + unsafe { device::Device::from_raw((*raw).led_cdev.dev) } + } + + unsafe fn from_classdev(led_cdev: *mut bindings::led_classdev) -> *mut= Self::Type { + // SAFETY: The function's contract guarantees that `led_cdev` is a= valid pointer to + // `led_classdev` embedded within a `Self::Type`. + unsafe { container_of!(led_cdev, bindings::led_classdev_mc, led_cd= ev) } + } + + unsafe fn pre_brightness_set(raw: *mut Self::Type, brightness: u32) { + // SAFETY: The function's contract guarantees that `raw` is a vali= d pointer to + // `led_classdev_mc`. + unsafe { bindings::led_mc_calc_color_components(raw, brightness) }; + } + + fn release(led_cdev: &mut Self::Type) { + // SAFETY: `subled_info` is guaranteed to be a valid array pointer= to `mc_subled` with the + // length and capacity of `led_cdev.num_colors`. See `led::Device:= :new_multicolor`. + let _subleds_vec =3D unsafe { + KVec::from_raw_parts( + led_cdev.subled_info, + led_cdev.num_colors as usize, + led_cdev.num_colors as usize, + ) + }; + } +} + +impl> Device { + /// Registers a new multicolor led classdev. + /// + /// The [`Device`] will be unregistered on drop. + pub fn new_multicolor<'a>( + parent: &'a T::Bus, + init_data: InitData<'a>, + ops: T, + subleds: &'a [MultiColorSubLed], + ) -> impl PinInit, Error> + 'a { + assert!(subleds.len() <=3D u32::MAX as usize); + Self::__new(parent, init_data, ops, |led_cdev| { + let mut subleds_vec =3D KVec::new(); + subleds_vec.extend_from_slice(subleds, GFP_KERNEL)?; + let (subled_info, num_colors, capacity) =3D subleds_vec.into_r= aw_parts(); + debug_assert_eq!(num_colors, capacity); + + let mut used =3D 0; + if subleds.iter().any(|subled| { + let bit =3D 1 << (subled.color as u32); + if (used & bit) !=3D 0 { + true + } else { + used |=3D bit; + false + } + }) { + dev_err!(parent.as_ref(), "duplicate color in multicolor l= ed\n"); + return Err(EINVAL); + } + + Ok(bindings::led_classdev_mc { + led_cdev, + // CAST: We checked above that the length of subleds fits = into a u32. + num_colors: num_colors as u32, + // CAST: The safeguards in the const block ensure that `Mu= ltiColorSubLed` has an + // identical layout to `mc_subled`. + subled_info: subled_info.cast::(), + }) + }) + } + + /// Returns the subleds passed to [`Device::new_multicolor`]. + pub fn subleds(&self) -> &[MultiColorSubLed] { + // SAFETY: The existence of `self` guarantees that `self.classdev.= get()` is a pointer to a + // valid `led_classdev_mc`. + let raw =3D unsafe { &*self.classdev.get() }; + // SAFETY: `raw.subled_info` is a valid pointer to `mc_subled[num_= colors]`. + // CAST: The safeguards in the const block ensure that `MultiColor= SubLed` has an identical + // layout to `mc_subled`. + unsafe { + core::slice::from_raw_parts( + raw.subled_info.cast::(), + raw.num_colors as usize, + ) + } + } +} --=20 2.51.0