From patchwork Tue Oct 29 13:56:15 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Marek_Beh=C3=BAn?= X-Patchwork-Id: 13854950 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (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 25A1C206E70 for ; Tue, 29 Oct 2024 13:56:56 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1730210217; cv=none; b=MqDGXXaxBmjbbQTadnDNVpQALGv/tG+VtwpDxnEMbNMKOJa03cOc4I/+303UxtRwKiDUgAX52bt9A1nfLLNelXvOiigqZb1CTNg0v10yMo8+DMRFC50E6es446SCSdySIx3DR+FH0jvyLq1toVyqPaOjMWDMeAWI8fHr/06DNfM= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1730210217; c=relaxed/simple; bh=wCvR1DsmVcTKlbR4ZRdGJLWwzhcOYcxjtGptt9x3GTc=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=Kgi5EKroxcxsy2oiEyxdfuoe6eBb5O09KZVatKRl91A1hWqgBlesYRH5GVjqmYfukev9lYE+acQvGRhFAJ9/Dino8IEGMIe7nVx2ID+zclwWg04ofeWFyuERFwu1/W/xUGvRjoW8BjuJrSeJrEX4Ho0vs+cq1keK0yiJ8Lfe5DA= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=TBzZTaMX; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="TBzZTaMX" Received: by smtp.kernel.org (Postfix) id DCDDCC4AF0B; Tue, 29 Oct 2024 13:56:56 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 6933EC4CEE6; Tue, 29 Oct 2024 13:56:53 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1730210216; bh=wCvR1DsmVcTKlbR4ZRdGJLWwzhcOYcxjtGptt9x3GTc=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=TBzZTaMXn3Dd+Q6HH/kgaa3P/8/1ndZw02zIFqeRsqr2J+2H6/F5FQ0ijhAwzQbql bohvr7w9pnvp8EkDzRujWOD4E9qTnknn3kjhkuYxaICi7gDJNzkhk5Vwb2mFePSx6V tqIvXbzxGgT93T4FH30Nepkt6D3g6Qu1mObuGmHhKUeJ21TIXBIRzL4Jh0mmWEtsf3 B7bjFo65YyEzFOI6hy9SMwdH8v33Ims0YHuN5OxKK1oFuSVN7FugRxt1b1WYGnKBSu 0atl4+5/csRx9jzmUaA75nEpRRK5JWtrRDxp+MOiYNNRcnWCk8f6/l9iSpM03o1uPq TEjlOFfQTPvjA== From: =?utf-8?q?Marek_Beh=C3=BAn?= To: Lee Jones Cc: Pavel Machek , linux-leds@vger.kernel.org, Arnd Bergmann , soc@kernel.org, Gregory CLEMENT , arm@kernel.org, Andy Shevchenko , Hans de Goede , =?utf-8?q?Ilpo_J=C3=A4rvinen?= , Andrew Lunn , Sebastian Hesselbarth , Rob Herring , Krzysztof Kozlowski , Conor Dooley , devicetree@vger.kernel.org, =?utf-8?q?M?= =?utf-8?q?arek_Beh=C3=BAn?= Subject: [PATCH leds v4 06/12] leds: turris-omnia: Document driver private structures Date: Tue, 29 Oct 2024 14:56:15 +0100 Message-ID: <20241029135621.12546-7-kabel@kernel.org> X-Mailer: git-send-email 2.45.2 In-Reply-To: <20241029135621.12546-1-kabel@kernel.org> References: <20241029135621.12546-1-kabel@kernel.org> Precedence: bulk X-Mailing-List: soc@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Add documentation for driver private structures, `struct omnia_leds` and `struct omnia_led`. Signed-off-by: Marek Behún --- drivers/leds/leds-turris-omnia.c | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/drivers/leds/leds-turris-omnia.c b/drivers/leds/leds-turris-omnia.c index 82cf58fbe946..b13b3b269ae9 100644 --- a/drivers/leds/leds-turris-omnia.c +++ b/drivers/leds/leds-turris-omnia.c @@ -19,6 +19,15 @@ /* MCU controller I2C address 0x2a, needed for detecting MCU features */ #define OMNIA_MCU_I2C_ADDR 0x2a +/** + * struct omnia_led - per-LED part of driver private data structure + * @mc_cdev: multi-color LED class device + * @subled_info: per-channel information + * @cached_channels: cached values of per-channel brightness that was sent to the MCU + * @on: whether the LED was set on + * @hwtrig: whether the LED blinking was offloaded to the MCU + * @reg: LED identifier to the MCU + */ struct omnia_led { struct led_classdev_mc mc_cdev; struct mc_subled subled_info[OMNIA_LED_NUM_CHANNELS]; @@ -29,6 +38,13 @@ struct omnia_led { #define to_omnia_led(l) container_of(l, struct omnia_led, mc_cdev) +/** + * struct omnia_leds - driver private data structure + * @client: I2C client device + * @lock: mutex to protect + * @has_gamma_correction: whether the MCU firmware supports gamma correction + * @leds: flexible array of per-LED data + */ struct omnia_leds { struct i2c_client *client; struct mutex lock;