xref: /linux/include/linux/amd-pstate.h (revision bf5802238dc181b1f7375d358af1d01cd72d1c11)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * linux/include/linux/amd-pstate.h
4  *
5  * Copyright (C) 2022 Advanced Micro Devices, Inc.
6  *
7  * Author: Meng Li <li.meng@amd.com>
8  */
9 
10 #ifndef _LINUX_AMD_PSTATE_H
11 #define _LINUX_AMD_PSTATE_H
12 
13 #include <linux/pm_qos.h>
14 
15 #define AMD_CPPC_EPP_PERFORMANCE		0x00
16 #define AMD_CPPC_EPP_BALANCE_PERFORMANCE	0x80
17 #define AMD_CPPC_EPP_BALANCE_POWERSAVE		0xBF
18 #define AMD_CPPC_EPP_POWERSAVE			0xFF
19 
20 /*********************************************************************
21  *                        AMD P-state INTERFACE                       *
22  *********************************************************************/
23 /**
24  * struct  amd_aperf_mperf
25  * @aperf: actual performance frequency clock count
26  * @mperf: maximum performance frequency clock count
27  * @tsc:   time stamp counter
28  */
29 struct amd_aperf_mperf {
30 	u64 aperf;
31 	u64 mperf;
32 	u64 tsc;
33 };
34 
35 /**
36  * struct amd_cpudata - private CPU data for AMD P-State
37  * @cpu: CPU number
38  * @req: constraint request to apply
39  * @cppc_req_cached: cached performance request hints
40  * @highest_perf: the maximum performance an individual processor may reach,
41  *		  assuming ideal conditions
42  * @nominal_perf: the maximum sustained performance level of the processor,
43  *		  assuming ideal operating conditions
44  * @lowest_nonlinear_perf: the lowest performance level at which nonlinear power
45  *			   savings are achieved
46  * @lowest_perf: the absolute lowest performance level of the processor
47  * @max_freq: the frequency that mapped to highest_perf
48  * @min_freq: the frequency that mapped to lowest_perf
49  * @nominal_freq: the frequency that mapped to nominal_perf
50  * @lowest_nonlinear_freq: the frequency that mapped to lowest_nonlinear_perf
51  * @cur: Difference of Aperf/Mperf/tsc count between last and current sample
52  * @prev: Last Aperf/Mperf/tsc count value read from register
53  * @freq: current cpu frequency value
54  * @boost_supported: check whether the Processor or SBIOS supports boost mode
55  * @epp_policy: Last saved policy used to set energy-performance preference
56  * @epp_cached: Cached CPPC energy-performance preference value
57  * @policy: Cpufreq policy value
58  * @cppc_cap1_cached Cached MSR_AMD_CPPC_CAP1 register value
59  *
60  * The amd_cpudata is key private data for each CPU thread in AMD P-State, and
61  * represents all the attributes and goals that AMD P-State requests at runtime.
62  */
63 struct amd_cpudata {
64 	int	cpu;
65 
66 	struct	freq_qos_request req[2];
67 	u64	cppc_req_cached;
68 
69 	u32	highest_perf;
70 	u32	nominal_perf;
71 	u32	lowest_nonlinear_perf;
72 	u32	lowest_perf;
73 	u32     min_limit_perf;
74 	u32     max_limit_perf;
75 	u32     min_limit_freq;
76 	u32     max_limit_freq;
77 
78 	u32	max_freq;
79 	u32	min_freq;
80 	u32	nominal_freq;
81 	u32	lowest_nonlinear_freq;
82 
83 	struct amd_aperf_mperf cur;
84 	struct amd_aperf_mperf prev;
85 
86 	u64	freq;
87 	bool	boost_supported;
88 
89 	/* EPP feature related attributes*/
90 	s16	epp_policy;
91 	s16	epp_cached;
92 	u32	policy;
93 	u64	cppc_cap1_cached;
94 	bool	suspended;
95 };
96 
97 /*
98  * enum amd_pstate_mode - driver working mode of amd pstate
99  */
100 enum amd_pstate_mode {
101 	AMD_PSTATE_UNDEFINED = 0,
102 	AMD_PSTATE_DISABLE,
103 	AMD_PSTATE_PASSIVE,
104 	AMD_PSTATE_ACTIVE,
105 	AMD_PSTATE_GUIDED,
106 	AMD_PSTATE_MAX,
107 };
108 
109 static const char * const amd_pstate_mode_string[] = {
110 	[AMD_PSTATE_UNDEFINED]   = "undefined",
111 	[AMD_PSTATE_DISABLE]     = "disable",
112 	[AMD_PSTATE_PASSIVE]     = "passive",
113 	[AMD_PSTATE_ACTIVE]      = "active",
114 	[AMD_PSTATE_GUIDED]      = "guided",
115 	NULL,
116 };
117 #endif /* _LINUX_AMD_PSTATE_H */
118