diff mbox series

[v4,6/6] cpufreq: CPPC: Support for autonomous selection in cppc_cpufreq

Message ID 20250113122104.3870673-7-zhenglifeng1@huawei.com
State New
Headers show
Series Support for autonomous selection in cppc_cpufreq | expand

Commit Message

zhenglifeng (A) Jan. 13, 2025, 12:21 p.m. UTC
Add sysfs interfaces for CPPC autonomous selection in the cppc_cpufreq
driver.

Signed-off-by: Lifeng Zheng <zhenglifeng1@huawei.com>
---
 .../ABI/testing/sysfs-devices-system-cpu      |  54 +++++++++
 drivers/cpufreq/cppc_cpufreq.c                | 109 ++++++++++++++++++
 2 files changed, 163 insertions(+)

Comments

Gautham R. Shenoy Jan. 15, 2025, 2:51 p.m. UTC | #1
Hello Lifeng,


On Mon, Jan 13, 2025 at 08:21:04PM +0800, Lifeng Zheng wrote:
> Add sysfs interfaces for CPPC autonomous selection in the cppc_cpufreq
> driver.
> 

[..snip..]

> diff --git a/drivers/cpufreq/cppc_cpufreq.c b/drivers/cpufreq/cppc_cpufreq.c
> index bd8f75accfa0..ea6c6a5bbd8c 100644
> --- a/drivers/cpufreq/cppc_cpufreq.c
> +++ b/drivers/cpufreq/cppc_cpufreq.c
> @@ -814,10 +814,119 @@ static ssize_t show_freqdomain_cpus(struct cpufreq_policy *policy, char *buf)
>  
>  	return cpufreq_show_cpus(cpu_data->shared_cpu_map, buf);
>  }
> +
> +static ssize_t show_auto_select(struct cpufreq_policy *policy, char *buf)
> +{
> +	bool val;
> +	int ret;
> +
> +	ret = cppc_get_auto_sel(policy->cpu, &val);
> +
> +	/* show "<unsupported>" when this register is not supported by cpc */
> +	if (ret == -EOPNOTSUPP)
> +		return sysfs_emit(buf, "%s\n", "<unsupported>");
> +
> +	if (ret)
> +		return ret;
> +
> +	return sysfs_emit(buf, "%d\n", val);
> +}
> +
> +static ssize_t store_auto_select(struct cpufreq_policy *policy,
> +				 const char *buf, size_t count)
> +{
> +	bool val;
> +	int ret;
> +
> +	ret = kstrtobool(buf, &val);
> +	if (ret)
> +		return ret;
> +
> +	ret = cppc_set_auto_sel(policy->cpu, val);

When the auto_select register is not supported, since
cppc_set_reg_val() doesn't have the !CPC_SUPPORTED(reg) check, that
function won't return an error, and thus this store function won't
return an error either. Should there be a !CPC_SUPPORTED(reg) check in
cppc_set_reg_val() as well? Or should the store function call
cppc_get_auto_sel() to figure out if the register is supported or not?

--
Thanks and Regards
gautham.
zhenglifeng (A) Jan. 16, 2025, 8:01 a.m. UTC | #2
On 2025/1/16 14:13, Gautham R. Shenoy wrote:

> On Thu, Jan 16, 2025 at 09:26:37AM +0800, zhenglifeng (A) wrote:
>> On 2025/1/15 22:51, Gautham R. Shenoy wrote:
>>
>>> Hello Lifeng,
>>>
>>>
>>> On Mon, Jan 13, 2025 at 08:21:04PM +0800, Lifeng Zheng wrote:
>>>> Add sysfs interfaces for CPPC autonomous selection in the cppc_cpufreq
>>>> driver.
>>>>
>>>
>>> [..snip..]
>>>
>>>> diff --git a/drivers/cpufreq/cppc_cpufreq.c b/drivers/cpufreq/cppc_cpufreq.c
>>>> index bd8f75accfa0..ea6c6a5bbd8c 100644
>>>> --- a/drivers/cpufreq/cppc_cpufreq.c
>>>> +++ b/drivers/cpufreq/cppc_cpufreq.c
>>>> @@ -814,10 +814,119 @@ static ssize_t show_freqdomain_cpus(struct cpufreq_policy *policy, char *buf)
>>>>  
>>>>  	return cpufreq_show_cpus(cpu_data->shared_cpu_map, buf);
>>>>  }
>>>> +
>>>> +static ssize_t show_auto_select(struct cpufreq_policy *policy, char *buf)
>>>> +{
>>>> +	bool val;
>>>> +	int ret;
>>>> +
>>>> +	ret = cppc_get_auto_sel(policy->cpu, &val);
>>>> +
>>>> +	/* show "<unsupported>" when this register is not supported by cpc */
>>>> +	if (ret == -EOPNOTSUPP)
>>>> +		return sysfs_emit(buf, "%s\n", "<unsupported>");
>>>> +
>>>> +	if (ret)
>>>> +		return ret;
>>>> +
>>>> +	return sysfs_emit(buf, "%d\n", val);
>>>> +}
>>>> +
>>>> +static ssize_t store_auto_select(struct cpufreq_policy *policy,
>>>> +				 const char *buf, size_t count)
>>>> +{
>>>> +	bool val;
>>>> +	int ret;
>>>> +
>>>> +	ret = kstrtobool(buf, &val);
>>>> +	if (ret)
>>>> +		return ret;
>>>> +
>>>> +	ret = cppc_set_auto_sel(policy->cpu, val);
>>>
>>> When the auto_select register is not supported, since
>>> cppc_set_reg_val() doesn't have the !CPC_SUPPORTED(reg) check, that
>>> function won't return an error, and thus this store function won't
>>> return an error either. Should there be a !CPC_SUPPORTED(reg) check in
>>> cppc_set_reg_val() as well? Or should the store function call
>>> cppc_get_auto_sel() to figure out if the register is supported or not?
>>
>> In patch 2, I have this check in cppc_set_reg_val():
>>
>> +	/* if a register is writeable, it must be a buffer */
>> +	if ((reg->type != ACPI_TYPE_BUFFER) ||
>> +	    (IS_OPTIONAL_CPC_REG(reg_idx) && IS_NULL_REG(&reg->cpc_entry.reg))) {
>> +		pr_debug("CPC register (reg_idx=%d) is not supported\n", reg_idx);
>> +		return -EOPNOTSUPP;
>> +	}
>>
>> If a register is not a cpc supported one, it must be either an integer type
>> or a null one. So it won't pass this check I think.
> 
> Ah, I see. In that case, you can remove the cppc_get_auto_sel() in
> shmem_init_perf() function in amd_pstate.c (in Patch 5/6) from the
> following snippet. The auto_sel value is nowhere used in the rest of
> the code.
> 
> @@ -399,6 +399,7 @@ static int shmem_init_perf(struct amd_cpudata *cpudata)
>  {
>  	struct cppc_perf_caps cppc_perf;
>  	u64 numerator;
> +	bool auto_sel; <--- Not needed.
>  
>  	int ret = cppc_get_perf_caps(cpudata->cpu, &cppc_perf);
>  	if (ret)
> @@ -420,7 +421,7 @@ static int shmem_init_perf(struct amd_cpudata *cpudata)
>  	if (cppc_state == AMD_PSTATE_ACTIVE)
>  		return 0;
>  
> -	ret = cppc_get_auto_sel_caps(cpudata->cpu, &cppc_perf);   <--- Not needed.
> +	ret = cppc_get_auto_sel(cpudata->cpu, &auto_sel);         <--- Not needed.
>  	if (ret) {                                                <--- Not needed.
>  		pr_warn("failed to get auto_sel, ret: %d\n", ret); <--- Not needed.
> 

If auto_sel is not supported, this function will return 0 after getting
fail. But after removing cppc_get_auto_sel(), this function will return
-EOPNOTSUPP by setting. Is this alright?

> 
> --
> Thanks and Regards
> gautham.
Russell Haley Jan. 16, 2025, 11:39 a.m. UTC | #3
Hello,

I noticed something here just as a user casually browsing the mailing list.

On 1/13/25 6:21 AM, Lifeng Zheng wrote:
> Add sysfs interfaces for CPPC autonomous selection in the cppc_cpufreq
> driver.
> 
> Signed-off-by: Lifeng Zheng <zhenglifeng1@huawei.com>
> ---
>  .../ABI/testing/sysfs-devices-system-cpu      |  54 +++++++++
>  drivers/cpufreq/cppc_cpufreq.c                | 109 ++++++++++++++++++
>  2 files changed, 163 insertions(+)
> 
> diff --git a/Documentation/ABI/testing/sysfs-devices-system-cpu b/Documentation/ABI/testing/sysfs-devices-system-cpu
> index 206079d3bd5b..3d87c3bb3fe2 100644
> --- a/Documentation/ABI/testing/sysfs-devices-system-cpu
> +++ b/Documentation/ABI/testing/sysfs-devices-system-cpu
> @@ -268,6 +268,60 @@ Description:	Discover CPUs in the same CPU frequency coordination domain
>  		This file is only present if the acpi-cpufreq or the cppc-cpufreq
>  		drivers are in use.
>  

[...snip...]

> +What:		/sys/devices/system/cpu/cpuX/cpufreq/energy_perf
> +Date:		October 2024
> +Contact:	linux-pm@vger.kernel.org
> +Description:	Energy performance preference
> +
> +		Read/write an 8-bit integer from/to this file. This file
> +		represents a range of values from 0 (performance preference) to
> +		0xFF (energy efficiency preference) that influences the rate of
> +		performance increase/decrease and the result of the hardware's
> +		energy efficiency and performance optimization policies.
> +
> +		Writing to this file only has meaning when Autonomous Selection is
> +		enabled.
> +
> +		This file only presents if the cppc-cpufreq driver is in use.

In intel_pstate driver, there is file with near-identical semantics:

/sys/devices/system/cpu/cpuX/cpufreq/energy_performance_preference

It also accepts a few string arguments and converts them to integers.

Perhaps the same name should be used, and the semantics made exactly
identical, and then it could be documented as present for either
cppc_cpufreq OR intel_pstate?

I think would be more elegant if userspace tooling could Just Work with
either driver.

One might object that the frequency selection behavior that results from
any particular value of the register itself might be different, but they
are *already* different between Intel's P and E-cores in the same CPU
package. (Ugh.)

--
Thanks,
Russell
Gautham R. Shenoy Jan. 16, 2025, 2:33 p.m. UTC | #4
On Thu, Jan 16, 2025 at 04:01:08PM +0800, zhenglifeng (A) wrote:

> > @@ -399,6 +399,7 @@ static int shmem_init_perf(struct amd_cpudata *cpudata)
> >  {
> >  	struct cppc_perf_caps cppc_perf;
> >  	u64 numerator;
> > +	bool auto_sel; <--- Not needed.
> >  
> >  	int ret = cppc_get_perf_caps(cpudata->cpu, &cppc_perf);
> >  	if (ret)
> > @@ -420,7 +421,7 @@ static int shmem_init_perf(struct amd_cpudata *cpudata)
> >  	if (cppc_state == AMD_PSTATE_ACTIVE)
> >  		return 0;
> >  
> > -	ret = cppc_get_auto_sel_caps(cpudata->cpu, &cppc_perf);   <--- Not needed.
> > +	ret = cppc_get_auto_sel(cpudata->cpu, &auto_sel);         <--- Not needed.
> >  	if (ret) {                                                <--- Not needed.
> >  		pr_warn("failed to get auto_sel, ret: %d\n", ret); <--- Not needed.
> > 
> 
> If auto_sel is not supported, this function will return 0 after getting
> fail. But after removing cppc_get_auto_sel(), this function will return
> -EOPNOTSUPP by setting. Is this alright?

This is not ok. The shmem_init_perf() function shouldn't error out if
the auto-selection register is not supported.

Also, looking at the function, there may be a few additional cleanups
required in that one. For now, let us just retain the
cppc_get_auto_sel() and cppc_set_auto_sel() functions as you have done
in this patchset.

--
Thanks and Regards
gautham.
zhenglifeng (A) Jan. 17, 2025, 3:11 a.m. UTC | #5
On 2025/1/16 19:39, Russell Haley wrote:

> Hello,
> 
> I noticed something here just as a user casually browsing the mailing list.
> 
> On 1/13/25 6:21 AM, Lifeng Zheng wrote:
>> Add sysfs interfaces for CPPC autonomous selection in the cppc_cpufreq
>> driver.
>>
>> Signed-off-by: Lifeng Zheng <zhenglifeng1@huawei.com>
>> ---
>>  .../ABI/testing/sysfs-devices-system-cpu      |  54 +++++++++
>>  drivers/cpufreq/cppc_cpufreq.c                | 109 ++++++++++++++++++
>>  2 files changed, 163 insertions(+)
>>
>> diff --git a/Documentation/ABI/testing/sysfs-devices-system-cpu b/Documentation/ABI/testing/sysfs-devices-system-cpu
>> index 206079d3bd5b..3d87c3bb3fe2 100644
>> --- a/Documentation/ABI/testing/sysfs-devices-system-cpu
>> +++ b/Documentation/ABI/testing/sysfs-devices-system-cpu
>> @@ -268,6 +268,60 @@ Description:	Discover CPUs in the same CPU frequency coordination domain
>>  		This file is only present if the acpi-cpufreq or the cppc-cpufreq
>>  		drivers are in use.
>>  
> 
> [...snip...]
> 
>> +What:		/sys/devices/system/cpu/cpuX/cpufreq/energy_perf
>> +Date:		October 2024
>> +Contact:	linux-pm@vger.kernel.org
>> +Description:	Energy performance preference
>> +
>> +		Read/write an 8-bit integer from/to this file. This file
>> +		represents a range of values from 0 (performance preference) to
>> +		0xFF (energy efficiency preference) that influences the rate of
>> +		performance increase/decrease and the result of the hardware's
>> +		energy efficiency and performance optimization policies.
>> +
>> +		Writing to this file only has meaning when Autonomous Selection is
>> +		enabled.
>> +
>> +		This file only presents if the cppc-cpufreq driver is in use.
> 
> In intel_pstate driver, there is file with near-identical semantics:
> 
> /sys/devices/system/cpu/cpuX/cpufreq/energy_performance_preference
> 
> It also accepts a few string arguments and converts them to integers.
> 
> Perhaps the same name should be used, and the semantics made exactly
> identical, and then it could be documented as present for either
> cppc_cpufreq OR intel_pstate?
> 
> I think would be more elegant if userspace tooling could Just Work with
> either driver.
> 
> One might object that the frequency selection behavior that results from
> any particular value of the register itself might be different, but they
> are *already* different between Intel's P and E-cores in the same CPU
> package. (Ugh.)

Yes, I should use the same name. Thanks.

As for accepting string arguments and converting them to integers, I don't
think it is necessary. It'll be a litte confused if someone writes a raw
value and reads a string I think. I prefer to let users freely set this
value.

In addition, there are many differences between the implementations of
energy_performance_preference in intel_pstate and cppc_cpufreq (and
amd-pstate...). It is really difficult to explain all this differences in
this document. So I'll leave it to be documented as present for
cppc_cpufreq only.

> 
> --
> Thanks,
> Russell
> 
> 
>
Mario Limonciello Jan. 17, 2025, 2:30 p.m. UTC | #6
On 1/16/2025 21:11, zhenglifeng (A) wrote:
> On 2025/1/16 19:39, Russell Haley wrote:
> 
>> Hello,
>>
>> I noticed something here just as a user casually browsing the mailing list.
>>
>> On 1/13/25 6:21 AM, Lifeng Zheng wrote:
>>> Add sysfs interfaces for CPPC autonomous selection in the cppc_cpufreq
>>> driver.
>>>
>>> Signed-off-by: Lifeng Zheng <zhenglifeng1@huawei.com>
>>> ---
>>>   .../ABI/testing/sysfs-devices-system-cpu      |  54 +++++++++
>>>   drivers/cpufreq/cppc_cpufreq.c                | 109 ++++++++++++++++++
>>>   2 files changed, 163 insertions(+)
>>>
>>> diff --git a/Documentation/ABI/testing/sysfs-devices-system-cpu b/Documentation/ABI/testing/sysfs-devices-system-cpu
>>> index 206079d3bd5b..3d87c3bb3fe2 100644
>>> --- a/Documentation/ABI/testing/sysfs-devices-system-cpu
>>> +++ b/Documentation/ABI/testing/sysfs-devices-system-cpu
>>> @@ -268,6 +268,60 @@ Description:	Discover CPUs in the same CPU frequency coordination domain
>>>   		This file is only present if the acpi-cpufreq or the cppc-cpufreq
>>>   		drivers are in use.
>>>   
>>
>> [...snip...]
>>
>>> +What:		/sys/devices/system/cpu/cpuX/cpufreq/energy_perf
>>> +Date:		October 2024
>>> +Contact:	linux-pm@vger.kernel.org
>>> +Description:	Energy performance preference
>>> +
>>> +		Read/write an 8-bit integer from/to this file. This file
>>> +		represents a range of values from 0 (performance preference) to
>>> +		0xFF (energy efficiency preference) that influences the rate of
>>> +		performance increase/decrease and the result of the hardware's
>>> +		energy efficiency and performance optimization policies.
>>> +
>>> +		Writing to this file only has meaning when Autonomous Selection is
>>> +		enabled.
>>> +
>>> +		This file only presents if the cppc-cpufreq driver is in use.
>>
>> In intel_pstate driver, there is file with near-identical semantics:
>>
>> /sys/devices/system/cpu/cpuX/cpufreq/energy_performance_preference
>>
>> It also accepts a few string arguments and converts them to integers.
>>
>> Perhaps the same name should be used, and the semantics made exactly
>> identical, and then it could be documented as present for either
>> cppc_cpufreq OR intel_pstate?
>>
>> I think would be more elegant if userspace tooling could Just Work with
>> either driver.
>>
>> One might object that the frequency selection behavior that results from
>> any particular value of the register itself might be different, but they
>> are *already* different between Intel's P and E-cores in the same CPU
>> package. (Ugh.)
> 
> Yes, I should use the same name. Thanks.
> 
> As for accepting string arguments and converting them to integers, I don't
> think it is necessary. It'll be a litte confused if someone writes a raw
> value and reads a string I think. I prefer to let users freely set this
> value.
> 
> In addition, there are many differences between the implementations of
> energy_performance_preference in intel_pstate and cppc_cpufreq (and
> amd-pstate...). It is really difficult to explain all this differences in
> this document. So I'll leave it to be documented as present for
> cppc_cpufreq only.

At least the interface to userspace I think we should do the best we can 
to be the same between all the drivers if possible.

For example; I've got a patch that I may bring up in a future kernel 
cycle that adds raw integer writes to amd-pstates 
energy_performance_profile to behave the same way intel-pstate does.

> 
>>
>> --
>> Thanks,
>> Russell
>>
>>
>>
>
zhenglifeng (A) Jan. 20, 2025, 3:15 a.m. UTC | #7
On 2025/1/17 22:30, Mario Limonciello wrote:

> On 1/16/2025 21:11, zhenglifeng (A) wrote:
>> On 2025/1/16 19:39, Russell Haley wrote:
>>
>>> Hello,
>>>
>>> I noticed something here just as a user casually browsing the mailing list.
>>>
>>> On 1/13/25 6:21 AM, Lifeng Zheng wrote:
>>>> Add sysfs interfaces for CPPC autonomous selection in the cppc_cpufreq
>>>> driver.
>>>>
>>>> Signed-off-by: Lifeng Zheng <zhenglifeng1@huawei.com>
>>>> ---
>>>>   .../ABI/testing/sysfs-devices-system-cpu      |  54 +++++++++
>>>>   drivers/cpufreq/cppc_cpufreq.c                | 109 ++++++++++++++++++
>>>>   2 files changed, 163 insertions(+)
>>>>
>>>> diff --git a/Documentation/ABI/testing/sysfs-devices-system-cpu b/Documentation/ABI/testing/sysfs-devices-system-cpu
>>>> index 206079d3bd5b..3d87c3bb3fe2 100644
>>>> --- a/Documentation/ABI/testing/sysfs-devices-system-cpu
>>>> +++ b/Documentation/ABI/testing/sysfs-devices-system-cpu
>>>> @@ -268,6 +268,60 @@ Description:    Discover CPUs in the same CPU frequency coordination domain
>>>>           This file is only present if the acpi-cpufreq or the cppc-cpufreq
>>>>           drivers are in use.
>>>>   
>>>
>>> [...snip...]
>>>
>>>> +What:        /sys/devices/system/cpu/cpuX/cpufreq/energy_perf
>>>> +Date:        October 2024
>>>> +Contact:    linux-pm@vger.kernel.org
>>>> +Description:    Energy performance preference
>>>> +
>>>> +        Read/write an 8-bit integer from/to this file. This file
>>>> +        represents a range of values from 0 (performance preference) to
>>>> +        0xFF (energy efficiency preference) that influences the rate of
>>>> +        performance increase/decrease and the result of the hardware's
>>>> +        energy efficiency and performance optimization policies.
>>>> +
>>>> +        Writing to this file only has meaning when Autonomous Selection is
>>>> +        enabled.
>>>> +
>>>> +        This file only presents if the cppc-cpufreq driver is in use.
>>>
>>> In intel_pstate driver, there is file with near-identical semantics:
>>>
>>> /sys/devices/system/cpu/cpuX/cpufreq/energy_performance_preference
>>>
>>> It also accepts a few string arguments and converts them to integers.
>>>
>>> Perhaps the same name should be used, and the semantics made exactly
>>> identical, and then it could be documented as present for either
>>> cppc_cpufreq OR intel_pstate?
>>>
>>> I think would be more elegant if userspace tooling could Just Work with
>>> either driver.
>>>
>>> One might object that the frequency selection behavior that results from
>>> any particular value of the register itself might be different, but they
>>> are *already* different between Intel's P and E-cores in the same CPU
>>> package. (Ugh.)
>>
>> Yes, I should use the same name. Thanks.
>>
>> As for accepting string arguments and converting them to integers, I don't
>> think it is necessary. It'll be a litte confused if someone writes a raw
>> value and reads a string I think. I prefer to let users freely set this
>> value.
>>
>> In addition, there are many differences between the implementations of
>> energy_performance_preference in intel_pstate and cppc_cpufreq (and
>> amd-pstate...). It is really difficult to explain all this differences in
>> this document. So I'll leave it to be documented as present for
>> cppc_cpufreq only.
> 
> At least the interface to userspace I think we should do the best we can to be the same between all the drivers if possible.
> 
> For example; I've got a patch that I may bring up in a future kernel cycle that adds raw integer writes to amd-pstates energy_performance_profile to behave the same way intel-pstate does.

I agree that it's better to keep this interface consistent across different
drivers. But in my opinion, the implementation of intel_pstate
energy_performance_preference is not really nice. Someone may write a raw
value but read a string, or read strings for some values and read raw
values for some other values. It is inconsistent. It may be better to use
some other implementation, such as seperating the operations of r/w strings
and raw values into two files.

I think it's better to consult Rafael and Viresh about how this should
evolve.

> 
>>
>>>
>>> -- 
>>> Thanks,
>>> Russell
>>>
>>>
>>>
>>
>
Pierre Gondois Jan. 20, 2025, 2:49 p.m. UTC | #8
On 1/20/25 04:15, zhenglifeng (A) wrote:
> On 2025/1/17 22:30, Mario Limonciello wrote:
> 
>> On 1/16/2025 21:11, zhenglifeng (A) wrote:
>>> On 2025/1/16 19:39, Russell Haley wrote:
>>>
>>>> Hello,
>>>>
>>>> I noticed something here just as a user casually browsing the mailing list.
>>>>
>>>> On 1/13/25 6:21 AM, Lifeng Zheng wrote:
>>>>> Add sysfs interfaces for CPPC autonomous selection in the cppc_cpufreq
>>>>> driver.
>>>>>
>>>>> Signed-off-by: Lifeng Zheng <zhenglifeng1@huawei.com>
>>>>> ---
>>>>>    .../ABI/testing/sysfs-devices-system-cpu      |  54 +++++++++
>>>>>    drivers/cpufreq/cppc_cpufreq.c                | 109 ++++++++++++++++++
>>>>>    2 files changed, 163 insertions(+)
>>>>>
>>>>> diff --git a/Documentation/ABI/testing/sysfs-devices-system-cpu b/Documentation/ABI/testing/sysfs-devices-system-cpu
>>>>> index 206079d3bd5b..3d87c3bb3fe2 100644
>>>>> --- a/Documentation/ABI/testing/sysfs-devices-system-cpu
>>>>> +++ b/Documentation/ABI/testing/sysfs-devices-system-cpu
>>>>> @@ -268,6 +268,60 @@ Description:    Discover CPUs in the same CPU frequency coordination domain
>>>>>            This file is only present if the acpi-cpufreq or the cppc-cpufreq
>>>>>            drivers are in use.
>>>>>    
>>>>
>>>> [...snip...]
>>>>
>>>>> +What:        /sys/devices/system/cpu/cpuX/cpufreq/energy_perf
>>>>> +Date:        October 2024
>>>>> +Contact:    linux-pm@vger.kernel.org
>>>>> +Description:    Energy performance preference
>>>>> +
>>>>> +        Read/write an 8-bit integer from/to this file. This file
>>>>> +        represents a range of values from 0 (performance preference) to
>>>>> +        0xFF (energy efficiency preference) that influences the rate of
>>>>> +        performance increase/decrease and the result of the hardware's
>>>>> +        energy efficiency and performance optimization policies.
>>>>> +
>>>>> +        Writing to this file only has meaning when Autonomous Selection is
>>>>> +        enabled.
>>>>> +
>>>>> +        This file only presents if the cppc-cpufreq driver is in use.
>>>>
>>>> In intel_pstate driver, there is file with near-identical semantics:
>>>>
>>>> /sys/devices/system/cpu/cpuX/cpufreq/energy_performance_preference
>>>>
>>>> It also accepts a few string arguments and converts them to integers.
>>>>
>>>> Perhaps the same name should be used, and the semantics made exactly
>>>> identical, and then it could be documented as present for either
>>>> cppc_cpufreq OR intel_pstate?
>>>>
>>>> I think would be more elegant if userspace tooling could Just Work with
>>>> either driver.
>>>>
>>>> One might object that the frequency selection behavior that results from
>>>> any particular value of the register itself might be different, but they
>>>> are *already* different between Intel's P and E-cores in the same CPU
>>>> package. (Ugh.)
>>>
>>> Yes, I should use the same name. Thanks.
>>>
>>> As for accepting string arguments and converting them to integers, I don't
>>> think it is necessary. It'll be a litte confused if someone writes a raw
>>> value and reads a string I think. I prefer to let users freely set this
>>> value.
>>>
>>> In addition, there are many differences between the implementations of
>>> energy_performance_preference in intel_pstate and cppc_cpufreq (and
>>> amd-pstate...). It is really difficult to explain all this differences in
>>> this document. So I'll leave it to be documented as present for
>>> cppc_cpufreq only.
>>
>> At least the interface to userspace I think we should do the best we can to be the same between all the drivers if possible.
>>
>> For example; I've got a patch that I may bring up in a future kernel cycle that adds raw integer writes to amd-pstates energy_performance_profile to behave the same way intel-pstate does.
> 
> I agree that it's better to keep this interface consistent across different
> drivers. But in my opinion, the implementation of intel_pstate
> energy_performance_preference is not really nice. Someone may write a raw
> value but read a string, or read strings for some values and read raw
> values for some other values. It is inconsistent. It may be better to use
> some other implementation, such as seperating the operations of r/w strings
> and raw values into two files.

I agree it would be better to be sure of the type to expect when reading the
energy_performance_preference file. The epp values in the range 0-255 with 0
being the performance value for all interfaces.

In the current epp strings, it seems there is a big gap between the PERFORMANCE
and the BALANCE_PERFORMANCE strings. Maybe it would be good to complete it:
EPP_PERFORMANCE		0x00
EPP_BALANCE_PERFORMANCE	0x40      // state value changed
EPP_BALANCE		0x80      // new state
EPP_BALANCE_POWERSAVE	0xC0
EPP_POWERSAVE		0xFF

NIT: The mapping seems to be slightly different for intel_pstate and amd-pstate
currently:
drivers/cpufreq/amd-pstate.c
#define AMD_CPPC_EPP_PERFORMANCE		0x00
#define AMD_CPPC_EPP_BALANCE_PERFORMANCE	0x80
#define AMD_CPPC_EPP_BALANCE_POWERSAVE		0xBF
#define AMD_CPPC_EPP_POWERSAVE			0xFF

arch/x86/include/asm/msr-index.h
#define HWP_EPP_PERFORMANCE		0x00
#define HWP_EPP_BALANCE_PERFORMANCE	0x80
#define HWP_EPP_BALANCE_POWERSAVE	0xC0   <------ Different from AMD_CPPC_EPP_BALANCE_POWERSAVE
#define HWP_EPP_POWERSAVE		0xFF

> 
> I think it's better to consult Rafael and Viresh about how this should
> evolve.

Yes indeed
Mario Limonciello Jan. 20, 2025, 5:44 p.m. UTC | #9
On 1/20/2025 08:49, Pierre Gondois wrote:
> 
> 
> On 1/20/25 04:15, zhenglifeng (A) wrote:
>> On 2025/1/17 22:30, Mario Limonciello wrote:
>>
>>> On 1/16/2025 21:11, zhenglifeng (A) wrote:
>>>> On 2025/1/16 19:39, Russell Haley wrote:
>>>>
>>>>> Hello,
>>>>>
>>>>> I noticed something here just as a user casually browsing the 
>>>>> mailing list.
>>>>>
>>>>> On 1/13/25 6:21 AM, Lifeng Zheng wrote:
>>>>>> Add sysfs interfaces for CPPC autonomous selection in the 
>>>>>> cppc_cpufreq
>>>>>> driver.
>>>>>>
>>>>>> Signed-off-by: Lifeng Zheng <zhenglifeng1@huawei.com>
>>>>>> ---
>>>>>>    .../ABI/testing/sysfs-devices-system-cpu      |  54 +++++++++
>>>>>>    drivers/cpufreq/cppc_cpufreq.c                | 109 +++++++++++ 
>>>>>> +++++++
>>>>>>    2 files changed, 163 insertions(+)
>>>>>>
>>>>>> diff --git a/Documentation/ABI/testing/sysfs-devices-system-cpu b/ 
>>>>>> Documentation/ABI/testing/sysfs-devices-system-cpu
>>>>>> index 206079d3bd5b..3d87c3bb3fe2 100644
>>>>>> --- a/Documentation/ABI/testing/sysfs-devices-system-cpu
>>>>>> +++ b/Documentation/ABI/testing/sysfs-devices-system-cpu
>>>>>> @@ -268,6 +268,60 @@ Description:    Discover CPUs in the same CPU 
>>>>>> frequency coordination domain
>>>>>>            This file is only present if the acpi-cpufreq or the 
>>>>>> cppc-cpufreq
>>>>>>            drivers are in use.
>>>>>
>>>>> [...snip...]
>>>>>
>>>>>> +What:        /sys/devices/system/cpu/cpuX/cpufreq/energy_perf
>>>>>> +Date:        October 2024
>>>>>> +Contact:    linux-pm@vger.kernel.org
>>>>>> +Description:    Energy performance preference
>>>>>> +
>>>>>> +        Read/write an 8-bit integer from/to this file. This file
>>>>>> +        represents a range of values from 0 (performance 
>>>>>> preference) to
>>>>>> +        0xFF (energy efficiency preference) that influences the 
>>>>>> rate of
>>>>>> +        performance increase/decrease and the result of the 
>>>>>> hardware's
>>>>>> +        energy efficiency and performance optimization policies.
>>>>>> +
>>>>>> +        Writing to this file only has meaning when Autonomous 
>>>>>> Selection is
>>>>>> +        enabled.
>>>>>> +
>>>>>> +        This file only presents if the cppc-cpufreq driver is in 
>>>>>> use.
>>>>>
>>>>> In intel_pstate driver, there is file with near-identical semantics:
>>>>>
>>>>> /sys/devices/system/cpu/cpuX/cpufreq/energy_performance_preference
>>>>>
>>>>> It also accepts a few string arguments and converts them to integers.
>>>>>
>>>>> Perhaps the same name should be used, and the semantics made exactly
>>>>> identical, and then it could be documented as present for either
>>>>> cppc_cpufreq OR intel_pstate?
>>>>>
>>>>> I think would be more elegant if userspace tooling could Just Work 
>>>>> with
>>>>> either driver.
>>>>>
>>>>> One might object that the frequency selection behavior that results 
>>>>> from
>>>>> any particular value of the register itself might be different, but 
>>>>> they
>>>>> are *already* different between Intel's P and E-cores in the same CPU
>>>>> package. (Ugh.)
>>>>
>>>> Yes, I should use the same name. Thanks.
>>>>
>>>> As for accepting string arguments and converting them to integers, I 
>>>> don't
>>>> think it is necessary. It'll be a litte confused if someone writes a 
>>>> raw
>>>> value and reads a string I think. I prefer to let users freely set this
>>>> value.
>>>>
>>>> In addition, there are many differences between the implementations of
>>>> energy_performance_preference in intel_pstate and cppc_cpufreq (and
>>>> amd-pstate...). It is really difficult to explain all this 
>>>> differences in
>>>> this document. So I'll leave it to be documented as present for
>>>> cppc_cpufreq only.
>>>
>>> At least the interface to userspace I think we should do the best we 
>>> can to be the same between all the drivers if possible.
>>>
>>> For example; I've got a patch that I may bring up in a future kernel 
>>> cycle that adds raw integer writes to amd-pstates 
>>> energy_performance_profile to behave the same way intel-pstate does.
>>
>> I agree that it's better to keep this interface consistent across 
>> different
>> drivers. But in my opinion, the implementation of intel_pstate
>> energy_performance_preference is not really nice. Someone may write a raw
>> value but read a string, or read strings for some values and read raw
>> values for some other values. It is inconsistent. It may be better to use
>> some other implementation, such as seperating the operations of r/w 
>> strings
>> and raw values into two files.
> 
> I agree it would be better to be sure of the type to expect when reading 
> the
> energy_performance_preference file. The epp values in the range 0-255 
> with 0
> being the performance value for all interfaces.
> 
> In the current epp strings, it seems there is a big gap between the 
> PERFORMANCE
> and the BALANCE_PERFORMANCE strings. Maybe it would be good to complete it:
> EPP_PERFORMANCE        0x00
> EPP_BALANCE_PERFORMANCE    0x40      // state value changed
> EPP_BALANCE        0x80      // new state
> EPP_BALANCE_POWERSAVE    0xC0
> EPP_POWERSAVE        0xFF
> 
> NIT: The mapping seems to be slightly different for intel_pstate and 
> amd-pstate
> currently:
> drivers/cpufreq/amd-pstate.c
> #define AMD_CPPC_EPP_PERFORMANCE        0x00
> #define AMD_CPPC_EPP_BALANCE_PERFORMANCE    0x80
> #define AMD_CPPC_EPP_BALANCE_POWERSAVE        0xBF
> #define AMD_CPPC_EPP_POWERSAVE            0xFF
> 
> arch/x86/include/asm/msr-index.h
> #define HWP_EPP_PERFORMANCE        0x00
> #define HWP_EPP_BALANCE_PERFORMANCE    0x80
> #define HWP_EPP_BALANCE_POWERSAVE    0xC0   <------ Different from 
> AMD_CPPC_EPP_BALANCE_POWERSAVE
> #define HWP_EPP_POWERSAVE        0xFF
> 
>>
>> I think it's better to consult Rafael and Viresh about how this should
>> evolve.
> 
> Yes indeed

Maybe it's best to discuss what the goal of raw EPP number writes is to 
decide what to do with it.

IE in intel-pstate is it for userspace to be able to actually utilize 
something besides the strings all the time?  Or is it just for debugging 
to find better values for strings in the future?

If the former maybe we're better off splitting to 
'energy_performance_preference' and 'energy_performance_preference_int'.

If the latter maybe we're better off putting the integer writes and 
reads into debugfs instead and making 'energy_performance_preference' 
return -EINVAL while a non-predefined value is in use.
zhenglifeng (A) Jan. 24, 2025, 3:53 a.m. UTC | #10
On 2025/1/24 1:05, Mario Limonciello wrote:

> On 1/23/2025 10:46, Srinivas Pandruvada wrote:
>>
>> On 1/20/25 18:42, zhenglifeng (A) wrote:
>>> On 2025/1/21 1:44, Mario Limonciello wrote:
>>>
>>>> On 1/20/2025 08:49, Pierre Gondois wrote:
>>>>>
>>>>> On 1/20/25 04:15, zhenglifeng (A) wrote:
>>>>>> On 2025/1/17 22:30, Mario Limonciello wrote:
>>>>>>
>>>>>>> On 1/16/2025 21:11, zhenglifeng (A) wrote:
>>>>>>>> On 2025/1/16 19:39, Russell Haley wrote:
>>>>>>>>
>>>>>>>>> Hello,
>>>>>>>>>
>>>>>>>>> I noticed something here just as a user casually browsing the mailing list.
>>>>>>>>>
>>>>>>>>> On 1/13/25 6:21 AM, Lifeng Zheng wrote:
>>>>>>>>>> Add sysfs interfaces for CPPC autonomous selection in the cppc_cpufreq
>>>>>>>>>> driver.
>>>>>>>>>>
>>>>>>>>>> Signed-off-by: Lifeng Zheng <zhenglifeng1@huawei.com>
>>>>>>>>>> ---
>>>>>>>>>>     .../ABI/testing/sysfs-devices-system-cpu      |  54 +++++++++
>>>>>>>>>>     drivers/cpufreq/cppc_cpufreq.c                | 109 +++++++ ++++ +++++++
>>>>>>>>>>     2 files changed, 163 insertions(+)
>>>>>>>>>>
>>>>>>>>>> diff --git a/Documentation/ABI/testing/sysfs-devices-system-cpu b/ Documentation/ABI/testing/sysfs-devices-system-cpu
>>>>>>>>>> index 206079d3bd5b..3d87c3bb3fe2 100644
>>>>>>>>>> --- a/Documentation/ABI/testing/sysfs-devices-system-cpu
>>>>>>>>>> +++ b/Documentation/ABI/testing/sysfs-devices-system-cpu
>>>>>>>>>> @@ -268,6 +268,60 @@ Description:    Discover CPUs in the same CPU frequency coordination domain
>>>>>>>>>>             This file is only present if the acpi-cpufreq or the cppc-cpufreq
>>>>>>>>>>             drivers are in use.
>>>>>>>>> [...snip...]
>>>>>>>>>
>>>>>>>>>> +What:        /sys/devices/system/cpu/cpuX/cpufreq/energy_perf
>>>>>>>>>> +Date:        October 2024
>>>>>>>>>> +Contact:    linux-pm@vger.kernel.org
>>>>>>>>>> +Description:    Energy performance preference
>>>>>>>>>> +
>>>>>>>>>> +        Read/write an 8-bit integer from/to this file. This file
>>>>>>>>>> +        represents a range of values from 0 (performance preference) to
>>>>>>>>>> +        0xFF (energy efficiency preference) that influences the rate of
>>>>>>>>>> +        performance increase/decrease and the result of the hardware's
>>>>>>>>>> +        energy efficiency and performance optimization policies.
>>>>>>>>>> +
>>>>>>>>>> +        Writing to this file only has meaning when Autonomous Selection is
>>>>>>>>>> +        enabled.
>>>>>>>>>> +
>>>>>>>>>> +        This file only presents if the cppc-cpufreq driver is in use.
>>>>>>>>> In intel_pstate driver, there is file with near-identical semantics:
>>>>>>>>>
>>>>>>>>> /sys/devices/system/cpu/cpuX/cpufreq/energy_performance_preference
>>>>>>>>>
>>>>>>>>> It also accepts a few string arguments and converts them to integers.
>>>>>>>>>
>>>>>>>>> Perhaps the same name should be used, and the semantics made exactly
>>>>>>>>> identical, and then it could be documented as present for either
>>>>>>>>> cppc_cpufreq OR intel_pstate?
>>>>>>>>>
>>>>>>>>> I think would be more elegant if userspace tooling could Just Work with
>>>>>>>>> either driver.
>>>>>>>>>
>>>>>>>>> One might object that the frequency selection behavior that results from
>>>>>>>>> any particular value of the register itself might be different, but they
>>>>>>>>> are *already* different between Intel's P and E-cores in the same CPU
>>>>>>>>> package. (Ugh.)
>>>>>>>> Yes, I should use the same name. Thanks.
>>>>>>>>
>>>>>>>> As for accepting string arguments and converting them to integers, I don't
>>>>>>>> think it is necessary. It'll be a litte confused if someone writes a raw
>>>>>>>> value and reads a string I think. I prefer to let users freely set this
>>>>>>>> value.
>>>>>>>>
>>>>>>>> In addition, there are many differences between the implementations of
>>>>>>>> energy_performance_preference in intel_pstate and cppc_cpufreq (and
>>>>>>>> amd-pstate...). It is really difficult to explain all this differences in
>>>>>>>> this document. So I'll leave it to be documented as present for
>>>>>>>> cppc_cpufreq only.
>>>>>>> At least the interface to userspace I think we should do the best we can to be the same between all the drivers if possible.
>>>>>>>
>>>>>>> For example; I've got a patch that I may bring up in a future kernel cycle that adds raw integer writes to amd-pstates energy_performance_profile to behave the same way intel-pstate does.
>>>>>> I agree that it's better to keep this interface consistent across different
>>>>>> drivers. But in my opinion, the implementation of intel_pstate
>>>>>> energy_performance_preference is not really nice. Someone may write a raw
>>>>>> value but read a string, or read strings for some values and read raw
>>>>>> values for some other values. It is inconsistent. It may be better to use
>>>>>> some other implementation, such as seperating the operations of r/w strings
>>>>>> and raw values into two files.
>>>>> I agree it would be better to be sure of the type to expect when reading the
>>>>> energy_performance_preference file. The epp values in the range 0-255 with 0
>>>>> being the performance value for all interfaces.
>>>>>
>>>>> In the current epp strings, it seems there is a big gap between the PERFORMANCE
>>>>> and the BALANCE_PERFORMANCE strings. Maybe it would be good to complete it:
>>>>> EPP_PERFORMANCE        0x00
>>>>> EPP_BALANCE_PERFORMANCE    0x40      // state value changed
>>>>> EPP_BALANCE        0x80      // new state
>>>>> EPP_BALANCE_POWERSAVE    0xC0
>>>>> EPP_POWERSAVE        0xFF
>>>>>
>>>>> NIT: The mapping seems to be slightly different for intel_pstate and amd-pstate
>>>>> currently:
>>>>> drivers/cpufreq/amd-pstate.c
>>>>> #define AMD_CPPC_EPP_PERFORMANCE        0x00
>>>>> #define AMD_CPPC_EPP_BALANCE_PERFORMANCE    0x80
>>>>> #define AMD_CPPC_EPP_BALANCE_POWERSAVE        0xBF
>>>>> #define AMD_CPPC_EPP_POWERSAVE            0xFF
>>>>>
>>>>> arch/x86/include/asm/msr-index.h
>>>>> #define HWP_EPP_PERFORMANCE        0x00
>>>>> #define HWP_EPP_BALANCE_PERFORMANCE    0x80
>>>>> #define HWP_EPP_BALANCE_POWERSAVE    0xC0   <------ Different from AMD_CPPC_EPP_BALANCE_POWERSAVE
>>>>> #define HWP_EPP_POWERSAVE        0xFF
>>>>>
>>>>>> I think it's better to consult Rafael and Viresh about how this should
>>>>>> evolve.
>>>>> Yes indeed
>>>> Maybe it's best to discuss what the goal of raw EPP number writes is to decide what to do with it.
>>>>
>>>> IE in intel-pstate is it for userspace to be able to actually utilize something besides the strings all the time?  Or is it just for debugging to find better values for strings in the future?
>>>>
>>>> If the former maybe we're better off splitting to 'energy_performance_preference' and 'energy_performance_preference_int'.
>>>>
>>>> If the latter maybe we're better off putting the integer writes and reads into debugfs instead and making 'energy_performance_preference' return -EINVAL while a non-predefined value is in use.
>>
>> In Intel case EPP values can be different based on processor. In some case they they end up sharing the same CPU model. So strings are not suitable for all cases. Also there is different preference of EPP between Chrome systems and non chrome distro. For example Chrome has some resource manager which can change and same on Intel distros with LPMD.
>>
> 
> Thanks for confirming it is intentional and changing it would break existing userspace.
> 
> And FWIW even in Windows there are more than 4 situational values used like we have in Linux today.
> 
> As the status quo is there I personally feel that we should do the exact same for other implementation of energy_performance_preference.

I still don't think this implementation is nice, for the following reasons:

1. Users may write raw value but read string. It's odd.

2. Sometimes a raw value is read and sometimes a character string is read.
The userspace tool needs to adapt this.

3. Reading and writing EPP strings is not really general in driver. It is
more reasonable to use the userspace tool to implement it.

In order not to break existing userspace, I'll rename the file to
'energy_performance_preference_int' or 'energy_performance_preference_val'
in cppc_cpufreq and only support reading and writing raw value. As for
accepting string arguments, it's not necessary for cppc_cpufreq for now.
It's easy to add this feature but hard to remove, so I'll leave it to the
future if it is really needed.

As for amd-pstate and intel_pstate, you can decide how
energy_performance_preference should evolve. But I strongly recommend
splitting it.

Regards,

Lifeng

> 
>>
>> Thanks,
>>
>> Srinivas
>>
>>
>>> I think it's the former.
>>>
>>> I added the author of the patch that allows raw energy performance
>>> preference value in intel_pstate to ask about what the goal is and if this
>>> would be ok to do the modification mentioned above.
>>>
>>> To see the patch from https://lore.kernel.org/ all/20200626183401.1495090-3-srinivas.pandruvada@linux.intel.com/
>>>
>>> Anyway, the purpose of this patch is to allow users write and read raw EPP
>>> number. So maybe I can just rename the file to
>>> 'energy_performance_preference_int'?
>>>
>
Srinivas Pandruvada Jan. 24, 2025, 2:18 p.m. UTC | #11
On Fri, 2025-01-24 at 11:53 +0800, zhenglifeng (A) wrote:
> On 2025/1/24 1:05, Mario Limonciello wrote:
> 
> > On 1/23/2025 10:46, Srinivas Pandruvada wrote:
> > > 
> > > On 1/20/25 18:42, zhenglifeng (A) wrote:
> > > > On 2025/1/21 1:44, Mario Limonciello wrote:
> > > > 
> > > > > On 1/20/2025 08:49, Pierre Gondois wrote:
> > > > > > 
> > > > > > On 1/20/25 04:15, zhenglifeng (A) wrote:
> > > > > > > On 2025/1/17 22:30, Mario Limonciello wrote:
> > > > > > > 
> > > > > > > > On 1/16/2025 21:11, zhenglifeng (A) wrote:
> > > > > > > > > On 2025/1/16 19:39, Russell Haley wrote:
> > > > > > > > > 
> > > > > > > > > > Hello,
> > > > > > > > > > 
> > > > > > > > > > I noticed something here just as a user casually
> > > > > > > > > > browsing the mailing list.
> > > > > > > > > > 
> > > > > > > > > > On 1/13/25 6:21 AM, Lifeng Zheng wrote:
> > > > > > > > > > > Add sysfs interfaces for CPPC autonomous
> > > > > > > > > > > selection in the cppc_cpufreq
> > > > > > > > > > > driver.
> > > > > > > > > > > 
> > > > > > > > > > > Signed-off-by: Lifeng Zheng
> > > > > > > > > > > <zhenglifeng1@huawei.com>
> > > > > > > > > > > ---
> > > > > > > > > > >     .../ABI/testing/sysfs-devices-system-cpu     
> > > > > > > > > > > |  54 +++++++++
> > > > > > > > > > >     drivers/cpufreq/cppc_cpufreq.c               
> > > > > > > > > > > | 109 +++++++ ++++ +++++++
> > > > > > > > > > >     2 files changed, 163 insertions(+)
> > > > > > > > > > > 
> > > > > > > > > > > diff --git a/Documentation/ABI/testing/sysfs-
> > > > > > > > > > > devices-system-cpu b/
> > > > > > > > > > > Documentation/ABI/testing/sysfs-devices-system-
> > > > > > > > > > > cpu
> > > > > > > > > > > index 206079d3bd5b..3d87c3bb3fe2 100644
> > > > > > > > > > > --- a/Documentation/ABI/testing/sysfs-devices-
> > > > > > > > > > > system-cpu
> > > > > > > > > > > +++ b/Documentation/ABI/testing/sysfs-devices-
> > > > > > > > > > > system-cpu
> > > > > > > > > > > @@ -268,6 +268,60 @@ Description:    Discover
> > > > > > > > > > > CPUs in the same CPU frequency coordination
> > > > > > > > > > > domain
> > > > > > > > > > >             This file is only present if the
> > > > > > > > > > > acpi-cpufreq or the cppc-cpufreq
> > > > > > > > > > >             drivers are in use.
> > > > > > > > > > [...snip...]
> > > > > > > > > > 
> > > > > > > > > > > +What:       
> > > > > > > > > > > /sys/devices/system/cpu/cpuX/cpufreq/energy_perf
> > > > > > > > > > > +Date:        October 2024
> > > > > > > > > > > +Contact:    linux-pm@vger.kernel.org
> > > > > > > > > > > +Description:    Energy performance preference
> > > > > > > > > > > +
> > > > > > > > > > > +        Read/write an 8-bit integer from/to this
> > > > > > > > > > > file. This file
> > > > > > > > > > > +        represents a range of values from 0
> > > > > > > > > > > (performance preference) to
> > > > > > > > > > > +        0xFF (energy efficiency preference) that
> > > > > > > > > > > influences the rate of
> > > > > > > > > > > +        performance increase/decrease and the
> > > > > > > > > > > result of the hardware's
> > > > > > > > > > > +        energy efficiency and performance
> > > > > > > > > > > optimization policies.
> > > > > > > > > > > +
> > > > > > > > > > > +        Writing to this file only has meaning
> > > > > > > > > > > when Autonomous Selection is
> > > > > > > > > > > +        enabled.
> > > > > > > > > > > +
> > > > > > > > > > > +        This file only presents if the cppc-
> > > > > > > > > > > cpufreq driver is in use.
> > > > > > > > > > In intel_pstate driver, there is file with near-
> > > > > > > > > > identical semantics:
> > > > > > > > > > 
> > > > > > > > > > /sys/devices/system/cpu/cpuX/cpufreq/energy_perform
> > > > > > > > > > ance_preference
> > > > > > > > > > 
> > > > > > > > > > It also accepts a few string arguments and converts
> > > > > > > > > > them to integers.
> > > > > > > > > > 
> > > > > > > > > > Perhaps the same name should be used, and the
> > > > > > > > > > semantics made exactly
> > > > > > > > > > identical, and then it could be documented as
> > > > > > > > > > present for either
> > > > > > > > > > cppc_cpufreq OR intel_pstate?
> > > > > > > > > > 
> > > > > > > > > > I think would be more elegant if userspace tooling
> > > > > > > > > > could Just Work with
> > > > > > > > > > either driver.
> > > > > > > > > > 
> > > > > > > > > > One might object that the frequency selection
> > > > > > > > > > behavior that results from
> > > > > > > > > > any particular value of the register itself might
> > > > > > > > > > be different, but they
> > > > > > > > > > are *already* different between Intel's P and E-
> > > > > > > > > > cores in the same CPU
> > > > > > > > > > package. (Ugh.)
> > > > > > > > > Yes, I should use the same name. Thanks.
> > > > > > > > > 
> > > > > > > > > As for accepting string arguments and converting them
> > > > > > > > > to integers, I don't
> > > > > > > > > think it is necessary. It'll be a litte confused if
> > > > > > > > > someone writes a raw
> > > > > > > > > value and reads a string I think. I prefer to let
> > > > > > > > > users freely set this
> > > > > > > > > value.
> > > > > > > > > 
> > > > > > > > > In addition, there are many differences between the
> > > > > > > > > implementations of
> > > > > > > > > energy_performance_preference in intel_pstate and
> > > > > > > > > cppc_cpufreq (and
> > > > > > > > > amd-pstate...). It is really difficult to explain all
> > > > > > > > > this differences in
> > > > > > > > > this document. So I'll leave it to be documented as
> > > > > > > > > present for
> > > > > > > > > cppc_cpufreq only.
> > > > > > > > At least the interface to userspace I think we should
> > > > > > > > do the best we can to be the same between all the
> > > > > > > > drivers if possible.
> > > > > > > > 
> > > > > > > > For example; I've got a patch that I may bring up in a
> > > > > > > > future kernel cycle that adds raw integer writes to
> > > > > > > > amd-pstates energy_performance_profile to behave the
> > > > > > > > same way intel-pstate does.
> > > > > > > I agree that it's better to keep this interface
> > > > > > > consistent across different
> > > > > > > drivers. But in my opinion, the implementation of
> > > > > > > intel_pstate
> > > > > > > energy_performance_preference is not really nice. Someone
> > > > > > > may write a raw
> > > > > > > value but read a string, or read strings for some values
> > > > > > > and read raw
> > > > > > > values for some other values. It is inconsistent. It may
> > > > > > > be better to use
> > > > > > > some other implementation, such as seperating the
> > > > > > > operations of r/w strings
> > > > > > > and raw values into two files.
> > > > > > I agree it would be better to be sure of the type to expect
> > > > > > when reading the
> > > > > > energy_performance_preference file. The epp values in the
> > > > > > range 0-255 with 0
> > > > > > being the performance value for all interfaces.
> > > > > > 
> > > > > > In the current epp strings, it seems there is a big gap
> > > > > > between the PERFORMANCE
> > > > > > and the BALANCE_PERFORMANCE strings. Maybe it would be good
> > > > > > to complete it:
> > > > > > EPP_PERFORMANCE        0x00
> > > > > > EPP_BALANCE_PERFORMANCE    0x40      // state value changed
> > > > > > EPP_BALANCE        0x80      // new state
> > > > > > EPP_BALANCE_POWERSAVE    0xC0
> > > > > > EPP_POWERSAVE        0xFF
> > > > > > 
> > > > > > NIT: The mapping seems to be slightly different for
> > > > > > intel_pstate and amd-pstate
> > > > > > currently:
> > > > > > drivers/cpufreq/amd-pstate.c
> > > > > > #define AMD_CPPC_EPP_PERFORMANCE        0x00
> > > > > > #define AMD_CPPC_EPP_BALANCE_PERFORMANCE    0x80
> > > > > > #define AMD_CPPC_EPP_BALANCE_POWERSAVE        0xBF
> > > > > > #define AMD_CPPC_EPP_POWERSAVE            0xFF
> > > > > > 
> > > > > > arch/x86/include/asm/msr-index.h
> > > > > > #define HWP_EPP_PERFORMANCE        0x00
> > > > > > #define HWP_EPP_BALANCE_PERFORMANCE    0x80
> > > > > > #define HWP_EPP_BALANCE_POWERSAVE    0xC0   <------
> > > > > > Different from AMD_CPPC_EPP_BALANCE_POWERSAVE
> > > > > > #define HWP_EPP_POWERSAVE        0xFF
> > > > > > 
> > > > > > > I think it's better to consult Rafael and Viresh about
> > > > > > > how this should
> > > > > > > evolve.
> > > > > > Yes indeed
> > > > > Maybe it's best to discuss what the goal of raw EPP number
> > > > > writes is to decide what to do with it.
> > > > > 
> > > > > IE in intel-pstate is it for userspace to be able to actually
> > > > > utilize something besides the strings all the time?  Or is it
> > > > > just for debugging to find better values for strings in the
> > > > > future?
> > > > > 
> > > > > If the former maybe we're better off splitting to
> > > > > 'energy_performance_preference' and
> > > > > 'energy_performance_preference_int'.
> > > > > 
> > > > > If the latter maybe we're better off putting the integer
> > > > > writes and reads into debugfs instead and making
> > > > > 'energy_performance_preference' return -EINVAL while a non-
> > > > > predefined value is in use.
> > > 
> > > In Intel case EPP values can be different based on processor. In
> > > some case they they end up sharing the same CPU model. So strings
> > > are not suitable for all cases. Also there is different
> > > preference of EPP between Chrome systems and non chrome distro.
> > > For example Chrome has some resource manager which can change and
> > > same on Intel distros with LPMD.
> > > 
> > 
> > Thanks for confirming it is intentional and changing it would break
> > existing userspace.
> > 
> > And FWIW even in Windows there are more than 4 situational values
> > used like we have in Linux today.
> > 
> > As the status quo is there I personally feel that we should do the
> > exact same for other implementation of
> > energy_performance_preference.
> 
> I still don't think this implementation is nice, for the following
> reasons:
> 
> 1. Users may write raw value but read string. It's odd.
> 
> 2. Sometimes a raw value is read and sometimes a character string is
> read.
> The userspace tool needs to adapt this.
> 
> 3. Reading and writing EPP strings is not really general in driver.
> It is
> more reasonable to use the userspace tool to implement it.
> 
> In order not to break existing userspace, I'll rename the file to
> 'energy_performance_preference_int' or
> 'energy_performance_preference_val'
> in cppc_cpufreq and only support reading and writing raw value. As
> for
> accepting string arguments, it's not necessary for cppc_cpufreq for
> now.
> It's easy to add this feature but hard to remove, so I'll leave it to
> the
> future if it is really needed.
> 
> As for amd-pstate and intel_pstate, you can decide how
> energy_performance_preference should evolve. But I strongly recommend
> splitting it.

No. User space can deal with this already. Atleast this has one
interface. If you split you need to keep them consistent. You can write
a raw value  to new attribute and then can read a string from the other
attribute, which means different.

This is not the only place where strings and raw values can be written
in sysfs. Also true for energy_perf_bias.


Thanks,
Srinivas



> 
> Regards,
> 
> Lifeng
> 
> > 
> > > 
> > > Thanks,
> > > 
> > > Srinivas
> > > 
> > > 
> > > > I think it's the former.
> > > > 
> > > > I added the author of the patch that allows raw energy
> > > > performance
> > > > preference value in intel_pstate to ask about what the goal is
> > > > and if this
> > > > would be ok to do the modification mentioned above.
> > > > 
> > > > To see the patch from
> > > > https://lore.kernel.org/ all/20200626183401.1495090-3-srinivas.pandruvada@linux.intel.c
> > > > om/
> > > > 
> > > > Anyway, the purpose of this patch is to allow users write and
> > > > read raw EPP
> > > > number. So maybe I can just rename the file to
> > > > 'energy_performance_preference_int'?
> > > > 
> > 
>
Russell Haley Jan. 24, 2025, 2:32 p.m. UTC | #12
On 1/23/25 9:53 PM, zhenglifeng (A) wrote:
> On 2025/1/24 1:05, Mario Limonciello wrote:
> 
>> On 1/23/2025 10:46, Srinivas Pandruvada wrote:
>>>
>>> On 1/20/25 18:42, zhenglifeng (A) wrote:
>>>> On 2025/1/21 1:44, Mario Limonciello wrote:
>>>>
>>>>> On 1/20/2025 08:49, Pierre Gondois wrote:
>>>>>>
>>>>>> On 1/20/25 04:15, zhenglifeng (A) wrote:
>>>>>>> On 2025/1/17 22:30, Mario Limonciello wrote:
>>>>>>>
>>>>>>>> On 1/16/2025 21:11, zhenglifeng (A) wrote:
>>>>>>>>> On 2025/1/16 19:39, Russell Haley wrote:
>>>>>>>>>
>>>>>>>>>> Hello,
>>>>>>>>>>
>>>>>>>>>> I noticed something here just as a user casually browsing the mailing list.
>>>>>>>>>>
>>>>>>>>>> On 1/13/25 6:21 AM, Lifeng Zheng wrote:
>>>>>>>>>>> Add sysfs interfaces for CPPC autonomous selection in the cppc_cpufreq
>>>>>>>>>>> driver.
>>>>>>>>>>>
>>>>>>>>>>> Signed-off-by: Lifeng Zheng <zhenglifeng1@huawei.com>
>>>>>>>>>>> ---
>>>>>>>>>>>     .../ABI/testing/sysfs-devices-system-cpu      |  54 +++++++++
>>>>>>>>>>>     drivers/cpufreq/cppc_cpufreq.c                | 109 +++++++ ++++ +++++++
>>>>>>>>>>>     2 files changed, 163 insertions(+)
>>>>>>>>>>>
>>>>>>>>>>> diff --git a/Documentation/ABI/testing/sysfs-devices-system-cpu b/ Documentation/ABI/testing/sysfs-devices-system-cpu
>>>>>>>>>>> index 206079d3bd5b..3d87c3bb3fe2 100644
>>>>>>>>>>> --- a/Documentation/ABI/testing/sysfs-devices-system-cpu
>>>>>>>>>>> +++ b/Documentation/ABI/testing/sysfs-devices-system-cpu
>>>>>>>>>>> @@ -268,6 +268,60 @@ Description:    Discover CPUs in the same CPU frequency coordination domain
>>>>>>>>>>>             This file is only present if the acpi-cpufreq or the cppc-cpufreq
>>>>>>>>>>>             drivers are in use.
>>>>>>>>>> [...snip...]
>>>>>>>>>>
>>>>>>>>>>> +What:        /sys/devices/system/cpu/cpuX/cpufreq/energy_perf
>>>>>>>>>>> +Date:        October 2024
>>>>>>>>>>> +Contact:    linux-pm@vger.kernel.org
>>>>>>>>>>> +Description:    Energy performance preference
>>>>>>>>>>> +
>>>>>>>>>>> +        Read/write an 8-bit integer from/to this file. This file
>>>>>>>>>>> +        represents a range of values from 0 (performance preference) to
>>>>>>>>>>> +        0xFF (energy efficiency preference) that influences the rate of
>>>>>>>>>>> +        performance increase/decrease and the result of the hardware's
>>>>>>>>>>> +        energy efficiency and performance optimization policies.
>>>>>>>>>>> +
>>>>>>>>>>> +        Writing to this file only has meaning when Autonomous Selection is
>>>>>>>>>>> +        enabled.
>>>>>>>>>>> +
>>>>>>>>>>> +        This file only presents if the cppc-cpufreq driver is in use.
>>>>>>>>>> In intel_pstate driver, there is file with near-identical semantics:
>>>>>>>>>>
>>>>>>>>>> /sys/devices/system/cpu/cpuX/cpufreq/energy_performance_preference
>>>>>>>>>>
>>>>>>>>>> It also accepts a few string arguments and converts them to integers.
>>>>>>>>>>
>>>>>>>>>> Perhaps the same name should be used, and the semantics made exactly
>>>>>>>>>> identical, and then it could be documented as present for either
>>>>>>>>>> cppc_cpufreq OR intel_pstate?
>>>>>>>>>>
>>>>>>>>>> I think would be more elegant if userspace tooling could Just Work with
>>>>>>>>>> either driver.
>>>>>>>>>>
>>>>>>>>>> One might object that the frequency selection behavior that results from
>>>>>>>>>> any particular value of the register itself might be different, but they
>>>>>>>>>> are *already* different between Intel's P and E-cores in the same CPU
>>>>>>>>>> package. (Ugh.)
>>>>>>>>> Yes, I should use the same name. Thanks.
>>>>>>>>>
>>>>>>>>> As for accepting string arguments and converting them to integers, I don't
>>>>>>>>> think it is necessary. It'll be a litte confused if someone writes a raw
>>>>>>>>> value and reads a string I think. I prefer to let users freely set this
>>>>>>>>> value.
>>>>>>>>>
>>>>>>>>> In addition, there are many differences between the implementations of
>>>>>>>>> energy_performance_preference in intel_pstate and cppc_cpufreq (and
>>>>>>>>> amd-pstate...). It is really difficult to explain all this differences in
>>>>>>>>> this document. So I'll leave it to be documented as present for
>>>>>>>>> cppc_cpufreq only.
>>>>>>>> At least the interface to userspace I think we should do the best we can to be the same between all the drivers if possible.
>>>>>>>>
>>>>>>>> For example; I've got a patch that I may bring up in a future kernel cycle that adds raw integer writes to amd-pstates energy_performance_profile to behave the same way intel-pstate does.
>>>>>>> I agree that it's better to keep this interface consistent across different
>>>>>>> drivers. But in my opinion, the implementation of intel_pstate
>>>>>>> energy_performance_preference is not really nice. Someone may write a raw
>>>>>>> value but read a string, or read strings for some values and read raw
>>>>>>> values for some other values. It is inconsistent. It may be better to use
>>>>>>> some other implementation, such as seperating the operations of r/w strings
>>>>>>> and raw values into two files.
>>>>>> I agree it would be better to be sure of the type to expect when reading the
>>>>>> energy_performance_preference file. The epp values in the range 0-255 with 0
>>>>>> being the performance value for all interfaces.
>>>>>>
>>>>>> In the current epp strings, it seems there is a big gap between the PERFORMANCE
>>>>>> and the BALANCE_PERFORMANCE strings. Maybe it would be good to complete it:
>>>>>> EPP_PERFORMANCE        0x00
>>>>>> EPP_BALANCE_PERFORMANCE    0x40      // state value changed
>>>>>> EPP_BALANCE        0x80      // new state
>>>>>> EPP_BALANCE_POWERSAVE    0xC0
>>>>>> EPP_POWERSAVE        0xFF
>>>>>>
>>>>>> NIT: The mapping seems to be slightly different for intel_pstate and amd-pstate
>>>>>> currently:
>>>>>> drivers/cpufreq/amd-pstate.c
>>>>>> #define AMD_CPPC_EPP_PERFORMANCE        0x00
>>>>>> #define AMD_CPPC_EPP_BALANCE_PERFORMANCE    0x80
>>>>>> #define AMD_CPPC_EPP_BALANCE_POWERSAVE        0xBF
>>>>>> #define AMD_CPPC_EPP_POWERSAVE            0xFF
>>>>>>
>>>>>> arch/x86/include/asm/msr-index.h
>>>>>> #define HWP_EPP_PERFORMANCE        0x00
>>>>>> #define HWP_EPP_BALANCE_PERFORMANCE    0x80
>>>>>> #define HWP_EPP_BALANCE_POWERSAVE    0xC0   <------ Different from AMD_CPPC_EPP_BALANCE_POWERSAVE
>>>>>> #define HWP_EPP_POWERSAVE        0xFF
>>>>>>
>>>>>>> I think it's better to consult Rafael and Viresh about how this should
>>>>>>> evolve.
>>>>>> Yes indeed
>>>>> Maybe it's best to discuss what the goal of raw EPP number writes is to decide what to do with it.
>>>>>
>>>>> IE in intel-pstate is it for userspace to be able to actually utilize something besides the strings all the time?  Or is it just for debugging to find better values for strings in the future?
>>>>>
>>>>> If the former maybe we're better off splitting to 'energy_performance_preference' and 'energy_performance_preference_int'.
>>>>>
>>>>> If the latter maybe we're better off putting the integer writes and reads into debugfs instead and making 'energy_performance_preference' return -EINVAL while a non-predefined value is in use.
>>>
>>> In Intel case EPP values can be different based on processor. In some case they they end up sharing the same CPU model. So strings are not suitable for all cases. Also there is different preference of EPP between Chrome systems and non chrome distro. For example Chrome has some resource manager which can change and same on Intel distros with LPMD.
>>>
>>
>> Thanks for confirming it is intentional and changing it would break existing userspace.
>>
>> And FWIW even in Windows there are more than 4 situational values used like we have in Linux today.
>>
>> As the status quo is there I personally feel that we should do the exact same for other implementation of energy_performance_preference.
> 
> I still don't think this implementation is nice, for the following reasons:
> 
> 1. Users may write raw value but read string. It's odd.
> 
> 2. Sometimes a raw value is read and sometimes a character string is read.
> The userspace tool needs to adapt this.
> 
> 3. Reading and writing EPP strings is not really general in driver. It is
> more reasonable to use the userspace tool to implement it.
> 
> In order not to break existing userspace, I'll rename the file to
> 'energy_performance_preference_int' or 'energy_performance_preference_val'
> in cppc_cpufreq and only support reading and writing raw value. As for
> accepting string arguments, it's not necessary for cppc_cpufreq for now.
> It's easy to add this feature but hard to remove, so I'll leave it to the
> future if it is really needed.
> 
> As for amd-pstate and intel_pstate, you can decide how
> energy_performance_preference should evolve. But I strongly recommend
> splitting it.
> 
> Regards,
> 
> Lifeng

I agree that not being able to write-read-confirm a numeric value that
happens to match one of the strings is... ugly. I have seen cases of
userspace fighting with firmware for control of the EPP, and detecting
that's happening is difficult if there are *other* reasons you might not
get back what you just wrote.

However, the desktop userspace pretty much only uses the strings anyway,
and they serve to translate arbitrary non-linear hardware-specific
scales into something userspace can build policy on. They are somewhat
less magic than the raw values, although still, IMO, pretty magic.

The raw values don't have consistent interpretation other than that
higher numbers give monotonically increasing efficiency for that
specific core, and I use that wording particularly. Lower numbers may
not increase performance because of long-term power/thermal limits, and
on asymmetric-CPU machines, the same number may not mean the same thing
for different cores in the same CPU package.

Leaving it up to userspace means either you need machine-model-specific
golden images, manually tuned by a skilled administrator, or CPU model
checks and an out-of-tree hardware database that somehow everyone
collaborates on. That database would likely miss a lot of things that
aren't popular X86 CPUs less than 5 years old.

Thanks,

Russell
>>
>
diff mbox series

Patch

diff --git a/Documentation/ABI/testing/sysfs-devices-system-cpu b/Documentation/ABI/testing/sysfs-devices-system-cpu
index 206079d3bd5b..3d87c3bb3fe2 100644
--- a/Documentation/ABI/testing/sysfs-devices-system-cpu
+++ b/Documentation/ABI/testing/sysfs-devices-system-cpu
@@ -268,6 +268,60 @@  Description:	Discover CPUs in the same CPU frequency coordination domain
 		This file is only present if the acpi-cpufreq or the cppc-cpufreq
 		drivers are in use.
 
+What:		/sys/devices/system/cpu/cpuX/cpufreq/auto_select
+Date:		October 2024
+Contact:	linux-pm@vger.kernel.org
+Description:	Autonomous selection enable
+
+		Read/write interface to control autonomous selection enable
+			Read returns autonomous selection status:
+				0: autonomous selection is disabled
+				1: autonomous selection is enabled
+
+			Write 'y' or '1' or 'on' to enable autonomous selection.
+			Write 'n' or '0' or 'off' to disable autonomous selection.
+
+		This file only presents if the cppc-cpufreq driver is in use.
+
+What:		/sys/devices/system/cpu/cpuX/cpufreq/auto_act_window
+Date:		October 2024
+Contact:	linux-pm@vger.kernel.org
+Description:	Autonomous activity window
+
+		This file indicates a moving utilization sensitivity window to
+		the platform's autonomous selection policy.
+
+		Read/write an integer represents autonomous activity window (in
+		microseconds) from/to this file. The max value to write is
+		1270000000 but the max significand is 127. This means that if 128
+		is written to this file, 127 will be stored. If the value is
+		greater than 130, only the first two digits will be saved as
+		significand.
+
+		Writing a zero value to this file enable the platform to
+		determine an appropriate Activity Window depending on the workload.
+
+		Writing to this file only has meaning when Autonomous Selection is
+		enabled.
+
+		This file only presents if the cppc-cpufreq driver is in use.
+
+What:		/sys/devices/system/cpu/cpuX/cpufreq/energy_perf
+Date:		October 2024
+Contact:	linux-pm@vger.kernel.org
+Description:	Energy performance preference
+
+		Read/write an 8-bit integer from/to this file. This file
+		represents a range of values from 0 (performance preference) to
+		0xFF (energy efficiency preference) that influences the rate of
+		performance increase/decrease and the result of the hardware's
+		energy efficiency and performance optimization policies.
+
+		Writing to this file only has meaning when Autonomous Selection is
+		enabled.
+
+		This file only presents if the cppc-cpufreq driver is in use.
+
 
 What:		/sys/devices/system/cpu/cpu*/cache/index3/cache_disable_{0,1}
 Date:		August 2008
diff --git a/drivers/cpufreq/cppc_cpufreq.c b/drivers/cpufreq/cppc_cpufreq.c
index bd8f75accfa0..ea6c6a5bbd8c 100644
--- a/drivers/cpufreq/cppc_cpufreq.c
+++ b/drivers/cpufreq/cppc_cpufreq.c
@@ -814,10 +814,119 @@  static ssize_t show_freqdomain_cpus(struct cpufreq_policy *policy, char *buf)
 
 	return cpufreq_show_cpus(cpu_data->shared_cpu_map, buf);
 }
+
+static ssize_t show_auto_select(struct cpufreq_policy *policy, char *buf)
+{
+	bool val;
+	int ret;
+
+	ret = cppc_get_auto_sel(policy->cpu, &val);
+
+	/* show "<unsupported>" when this register is not supported by cpc */
+	if (ret == -EOPNOTSUPP)
+		return sysfs_emit(buf, "%s\n", "<unsupported>");
+
+	if (ret)
+		return ret;
+
+	return sysfs_emit(buf, "%d\n", val);
+}
+
+static ssize_t store_auto_select(struct cpufreq_policy *policy,
+				 const char *buf, size_t count)
+{
+	bool val;
+	int ret;
+
+	ret = kstrtobool(buf, &val);
+	if (ret)
+		return ret;
+
+	ret = cppc_set_auto_sel(policy->cpu, val);
+	if (ret)
+		return ret;
+
+	return count;
+}
+
+static ssize_t show_auto_act_window(struct cpufreq_policy *policy, char *buf)
+{
+	u64 val;
+	int ret;
+
+	ret = cppc_get_auto_act_window(policy->cpu, &val);
+
+	/* show "<unsupported>" when this register is not supported by cpc */
+	if (ret == -EOPNOTSUPP)
+		return sysfs_emit(buf, "%s\n", "<unsupported>");
+
+	if (ret)
+		return ret;
+
+	return sysfs_emit(buf, "%llu\n", val);
+}
+
+static ssize_t store_auto_act_window(struct cpufreq_policy *policy,
+				     const char *buf, size_t count)
+{
+	u64 usec;
+	int ret;
+
+	ret = kstrtou64(buf, 0, &usec);
+	if (ret)
+		return ret;
+
+	ret = cppc_set_auto_act_window(policy->cpu, usec);
+	if (ret)
+		return ret;
+
+	return count;
+}
+
+static ssize_t show_energy_perf(struct cpufreq_policy *policy, char *buf)
+{
+	u64 val;
+	int ret;
+
+	ret = cppc_get_epp_perf(policy->cpu, &val);
+
+	/* show "<unsupported>" when this register is not supported by cpc */
+	if (ret == -EOPNOTSUPP)
+		return sysfs_emit(buf, "%s\n", "<unsupported>");
+
+	if (ret)
+		return ret;
+
+	return sysfs_emit(buf, "%llu\n", val);
+}
+
+static ssize_t store_energy_perf(struct cpufreq_policy *policy,
+				 const char *buf, size_t count)
+{
+	u64 val;
+	int ret;
+
+	ret = kstrtou64(buf, 0, &val);
+	if (ret)
+		return ret;
+
+	ret = cppc_set_epp(policy->cpu, val);
+	if (ret)
+		return ret;
+
+	return count;
+}
+
 cpufreq_freq_attr_ro(freqdomain_cpus);
+cpufreq_freq_attr_rw(auto_select);
+cpufreq_freq_attr_rw(auto_act_window);
+cpufreq_freq_attr_rw(energy_perf);
 
 static struct freq_attr *cppc_cpufreq_attr[] = {
 	&freqdomain_cpus,
+	&auto_select,
+	&auto_act_window,
+	&energy_perf,
 	NULL,
 };