[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-Id: <ab676d6e-30aa-45ac-85c8-32d093eeb5e3@app.fastmail.com>
Date: Tue, 05 Nov 2024 17:49:23 -0500
From: "Mark Pearson" <mpearson-lenovo@...ebb.ca>
To: "Limonciello, Mario" <mario.limonciello@....com>,
"Hans de Goede" <hdegoede@...hat.com>,
Ilpo Järvinen <ilpo.jarvinen@...ux.intel.com>
Cc: "Rafael J. Wysocki" <rafael@...nel.org>, "Len Brown" <lenb@...nel.org>,
"Maximilian Luz" <luzmaximilian@...il.com>, "Lee Chun-Yi" <jlee@...e.com>,
"Shyam Sundar S K" <Shyam-sundar.S-k@....com>,
"Corentin Chary" <corentin.chary@...il.com>,
"Luke D . Jones" <luke@...nes.dev>, "Ike Panhc" <ike.pan@...onical.com>,
"Henrique de Moraes Holschuh" <hmh@....eng.br>,
"Alexis Belmonte" <alexbelm48@...il.com>,
Uwe Kleine-König <u.kleine-koenig@...gutronix.de>,
"Ai Chao" <aichao@...inos.cn>, "Gergo Koteles" <soyer@....hu>,
"open list" <linux-kernel@...r.kernel.org>,
"linux-acpi@...r.kernel.org" <linux-acpi@...r.kernel.org>,
"platform-driver-x86@...r.kernel.org" <platform-driver-x86@...r.kernel.org>,
"open list:THINKPAD ACPI EXTRAS DRIVER" <ibm-acpi-devel@...ts.sourceforge.net>,
"Matthew Schwartz" <matthew.schwartz@...ux.dev>
Subject: Re: [PATCH v4 20/20] Documentation: Add documentation about class interface
for platform profiles
Hi Mario,
On Tue, Nov 5, 2024, at 10:33 AM, Mario Limonciello wrote:
> The class interface allows changing multiple platform profiles on a system
> to different values. The semantics of it are similar to the legacy
> interface.
>
> Signed-off-by: Mario Limonciello <mario.limonciello@....com>
> ---
> .../userspace-api/sysfs-platform_profile.rst | 28 +++++++++++++++++++
> 1 file changed, 28 insertions(+)
>
> diff --git a/Documentation/userspace-api/sysfs-platform_profile.rst
> b/Documentation/userspace-api/sysfs-platform_profile.rst
> index 4fccde2e45639..418c61b096304 100644
> --- a/Documentation/userspace-api/sysfs-platform_profile.rst
> +++ b/Documentation/userspace-api/sysfs-platform_profile.rst
> @@ -40,3 +40,31 @@ added. Drivers which wish to introduce new profile
> names must:
> 1. Explain why the existing profile names cannot be used.
> 2. Add the new profile name, along with a clear description of the
> expected behaviour, to the sysfs-platform_profile ABI
> documentation.
> +
> +Multiple driver support
> +=======================
> +When multiple drivers on a system advertise a platform profile
> handler, the
> +platform profile handler core will only advertise the profiles that are
> +commong between all drivers to the ``/sys/firmware/acpi`` interfaces.
Typo (commong)
> +
> +This is to ensure there is no ambiguity on what the profile names mean
> when
> +all handlers don't support a profile.
> +
> +Individual drivers will register a 'platform_profile' class device
> that has
> +similar semantics as the ``/sys/firmware/acpi/platform_profile``
> interface.
> +
> +To discover available profiles from the class interface the user can
> read the
> +``choices`` attribute.
> +
> +If a user wants to select a profile for a specific driver, they can do
> so
> +by writing to the ``profile`` attribute of the driver's class device.
> +
> +This will allow users to set different profiles for different drivers
> on the
> +same system. If the selected profile by individual drivers differes the
typo (differes)
> +platform profile handler core will display the profile 'custom' to
> indicate
> +that the profiles are not the same.
> +
> +While the ``platform_profile`` attribute has the value ``custom``,
> writing a
> +common profile from ``platform_profile_choices`` to the
> platform_profile
> +attribute of the platform profile handler core will set the profile
> for all
> +drivers.
> --
> 2.43.0
Thanks
Mark
Powered by blists - more mailing lists