Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
Message-ID: <7e4d2d86-ea95-6d4b-1279-18407787306b@amd.com>
Date:   Thu, 12 Jan 2023 23:50:59 -0600
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101
 Thunderbird/102.5.1
Subject: Re: [PATCH v2 6/6] Documentation: amd_pstate: Update amd_pstate
 status sysfs for guided
Content-Language: en-US
To:     Wyes Karny <wyes.karny@amd.com>,
        Rafael J Wysocki <rafael@kernel.org>,
        Huang Rui <ray.huang@amd.com>,
        Jonathan Corbet <corbet@lwn.net>,
        Viresh Kumar <viresh.kumar@linaro.org>, Perry.Yuan@amd.com,
        Ananth Narayan <ananth.narayan@amd.com>, gautham.shenoy@amd.com
Cc:     linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org,
        linux-pm@vger.kernel.org, Bagas Sanjaya <bagasdotme@gmail.com>,
        santosh.shukla@amd.com
References: <20230113052141.2874296-1-wyes.karny@amd.com>
 <20230113052141.2874296-7-wyes.karny@amd.com>
From:   Mario Limonciello <mario.limonciello@amd.com>
In-Reply-To: <20230113052141.2874296-7-wyes.karny@amd.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?TFBUT2hHbWdMNzJBQjhTRXpaM1dnZzlDemo2bUZVdWlpOHlZblV6bUdScGM3?=
 =?utf-8?B?MkFIZ1FCSVJ2RGZQVG9OQ3kxVnZubEJNNnhYb1ZJMHZMTytZWEZ3c04wMFRu?=
 =?utf-8?B?V0JSUHdWTCtxTDVsRzI0QVBTWWFvN2VkdFJITmw1NGNzbnY3anNNeCtlRTBk?=
 =?utf-8?B?Ny9tMGpMaHVDeDVCcGFYazgvaHBRN2UrZnQ0a3hRVzBuaDRZMVdFdDVWMW8r?=
 =?utf-8?B?ZWJ5QWZhampFMmFLRThmS1U0RmJRMitxcU5IelNIbW53eGsvZVNZODVmSm50?=
 =?utf-8?B?SDFUK2c1akVnZG5TN2JQNnhZd0hWMnFWSFFBaktzTVQ0ZUlDdHl6VG14Q2I5?=
 =?utf-8?B?ZUhwSzIrbWgxczZ0ODliRWcwc01Qais0TXNhUlM5bDRBSnFEem1ieW50N1Er?=
 =?utf-8?B?KzZhV0pPZ29hb1lEa0JZQS9Cb1RGY0tOTmdid21VbnFHZDRHTkpJWUh1djRB?=
 =?utf-8?B?TDVGUjhieUFma2tJenhZVnlKRXJFaTVZMk5ZVG8va2JuVC9jN3orcEJiMlB1?=
 =?utf-8?B?N09WemlKeVlhZ2hrNWtKTHp1Z3hiZ0hXR2tqMHR5UjhtWm5iUVB5dTF2UU1C?=
 =?utf-8?B?bzZHa1VPQTJHNitpNW91OTBybXhSNGpwcUU3L1JwYlQrTi9Gc2VqRjdxODM2?=
 =?utf-8?B?VVgxVU5jNEFLOVR4OW5SMmdZS0wwTCtCMjBVVmdPTWY3MkNSY1Avd0pVVDVG?=
 =?utf-8?B?VTE1UStvellJWGJRcXYwRnN6UHdnMmdVMGxLcTlodndpRTdZM0pFVlUxYUZR?=
 =?utf-8?B?ZHNUNU5xY3JrSWwxdWJOTk1YWjZyZnNRR2ZiZ3VVNnl4TW5uRG9YcnY2ZElO?=
 =?utf-8?B?SEFNVEFnRFJEbkhDZGEwWVNzL3dJdEZ1YWZxaHhtbitVWkplTGJuUGJ1Wnk3?=
 =?utf-8?B?YW5lejJHdGphNlNNSmdvQU0zM3lVbzBITGVySmdtZ2FtTkJJRXFWNDJPTml1?=
 =?utf-8?B?cEx4WUh6cEpjT21vdG9IQSsvWWliQU1qTjl2Rzh3eHFuRmk1NXl1a2k2dFBD?=
 =?utf-8?B?cS9Nd0VLMDdSeVZhMGEraHZ4dC9pRnpMcGNrZ09mOHhpTENpLytjY0tOOGZ3?=
 =?utf-8?B?Y2pDbUxGQXBGSjM1c2xwZldSSzZiZldhSVRNdFkrRmFPNW5rVjF2UVRJcUZy?=
 =?utf-8?B?SlYrL3ZaS3NRbHJDaXlvMEU1VW5MWDBXdXFTK3lyUnlMMDArTFhxQ3pWNXA5?=
 =?utf-8?B?SVNMUmVJTENkRlJMOXFzMGVJSE9pQW5venR3cVhDYi85dnBJQ2x5UmZaUkxw?=
 =?utf-8?B?N3hvZm1TSXlCRWppcWgzUlNwcmVqZStNVmxzTnFnd1p3VXRHbkE3RDhDM3o4?=
 =?utf-8?B?Q3NDSi9iWTdtM2ZCa1pWQXFTUXJUbW96d3ZPU3U5eWpGdWtzc0tZbTFNeHpY?=
 =?utf-8?B?YS8xV2Jjem1FU3F6bWoxQndUNFEwalVZVFV6ZzltbEFoeS9QMnBlSDR4RlVP?=
 =?utf-8?B?S2FoVmFnSjdTUDlTUTdYSWEvRXpORnp3K0lVeUZUUzU4S2h6RzUwc0Zjd3VR?=
 =?utf-8?B?VjQ1WEF5RGhzbmxxVG50V0dVVXFiMDFlNmNMM1VVb01xM1dObWJpdTgyRkZh?=
 =?utf-8?B?YUJSM1IwRWVxU0VmdkE1Nmxnb3lXOGUxT01nYW1hTTlHT3YyS0ZCdnZWdncr?=
 =?utf-8?B?Vlo2R2lSL1JkQ2ZreUw1TVhEMlhnYlp5bllldjNldUNhUHltZ0xnUmpWci9n?=
 =?utf-8?B?RGp4cnJOK2hwY3p1Qk9QNG4yK1ZYeHMxcDNVcFpUeFo4WmtWaEtJMnl6SDRK?=
 =?utf-8?B?S3QyVVhEMy9vZDM1SFlUTVI0R3k1bEpOS0pXWDJIZEpzeDJXaFIzWEV2ZytP?=
 =?utf-8?B?RUVFc0tPY3pUbzBvVG1xRDNrc29EVmVZU3NmRVI0NTFEN0h4eitFU0pxNnBW?=
 =?utf-8?B?VVhzYmkzUm9iSlRsZXZWNW0xdWVOaHllaVZkV1Qwb3I2RW5VVGROdDFWUFl1?=
 =?utf-8?B?YXlrZmJFVVQ4OXlURnoxZm9jOEh2eDRmUkZIRmhhMkZvK3k3dUp1bXh1QXVw?=
 =?utf-8?B?VEZyQk5EN2VmRnJUODQrOThqd2ErNDBQRTk2VnpYa1ZBSlpHZ3ZkMlFrYkNt?=
 =?utf-8?B?ZVNEdnpyQk5vNGIwczlTQnR0ZU1LU3YrUktmMFRHS2xoNGFGZmNKaGlBUFVX?=
 =?utf-8?B?NkRDejVDTm5VdUZWY1U5VzN3WUxnWE04SVY1cVBjV0tGZ0VJNHNjZVg2SGN3?=
 =?utf-8?Q?CEBun3IagyDengR73I1KgSRxDulboDMznGJWd+tL11NN?=
X-OriginatorOrg: amd.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 561ce29a-09aa-4ece-1189-08daf52a276c
X-MS-Exchange-CrossTenant-AuthSource: MN0PR12MB6101.namprd12.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Jan 2023 05:51:02.6734
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: lW8AQD1/W1JfuLCwAOLmFLSry/7Gz6/Ku2EXV9v27M+kN3FyxdkZNMLjlj6/IVj4KQ5V2tFCvaqFEmB4eeQO6Q==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: MW4PR12MB7285
X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,
        DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,NICE_REPLY_A,RCVD_IN_DNSWL_NONE,
        RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS autolearn=ham
        autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

On 1/12/23 23:21, Wyes Karny wrote:
> Update amd_pstate status sysfs for guided mode.
> 
> Signed-off-by: Wyes Karny <wyes.karny@amd.com>
> ---
>   Documentation/admin-guide/pm/amd-pstate.rst | 29 ++++++++++++++++-----
>   1 file changed, 22 insertions(+), 7 deletions(-)
> 
> diff --git a/Documentation/admin-guide/pm/amd-pstate.rst b/Documentation/admin-guide/pm/amd-pstate.rst
> index 55396981266a..92fa22e45a2b 100644
> --- a/Documentation/admin-guide/pm/amd-pstate.rst
> +++ b/Documentation/admin-guide/pm/amd-pstate.rst
> @@ -303,13 +303,16 @@ efficiency frequency management method on AMD processors.
>   AMD Pstate Driver Operation Modes
>   =================================
>   
> -``amd_pstate`` CPPC has two operation modes: CPPC Autonomous(active) mode and
> -CPPC non-autonomous(passive) mode.
> -active mode and passive mode can be chosen by different kernel parameters.
> -When in Autonomous mode, CPPC ignores requests done in the Desired Performance
> -Target register and takes into account only the values set to the Minimum requested
> -performance, Maximum requested performance, and Energy Performance Preference
> -registers. When Autonomous is disabled, it only considers the Desired Performance Target.
> +``amd_pstate`` CPPC has 3 operation modes: autonomous (active) mode, guided
> +autonomous (guided) mode and non-autonomous (passive) mode.
> +Active/passive/guided mode can be chosen by different kernel parameters. In
> +autonomous mode, platform ignores the desired performance level request and
> +takes into account only the values set to the Minimum requested performance,
> +Maximum requested performance and Energy Performance Preference registers. In
> +non-autonomous mode, platform gets desired performance level from OS directly
> +through Desired Performance Register. In guided-autonomous mode, platform sets
> +operating performance level autonomously according to the current workload and
> +within the limits set by OS through min and max performance registers.

Your intro and explanation go in different orders.  Also this reads very 
dense.  Maybe it would make sense to put some whitespace between each mode?

>   
>   Active Mode
>   ------------
> @@ -338,6 +341,15 @@ to the Performance Reduction Tolerance register. Above the nominal performance l
>   processor must provide at least nominal performance requested and go higher if current
>   operating conditions allow.
>   
> +Guided Mode
> +-----------
> +
> +``amd_pstate=guided``
> +
> +If ``amd_pstate=guided`` is passed to kernel command line option then this mode
> +is activated.  In this mode, driver requests minimum and maximum performance
> +level and the platform autonomously selects a performance level in this range
> +and appropriate to the current workload.
>   
>   User Space Interface in ``sysfs``
>   =================================
> @@ -358,6 +370,9 @@ control its functionality at the system level.  They are located in the
>   	"passive"
>   		The driver is functional and in the ``passive mode``
>   
> +        "guided"
> +                The driver is functional and in the ``guided mode``
> +
>   	"disable"
>   		The driver is unregistered and not functional now.
>