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 | * For platforms that do not support the preferred core feature, the |
43 | * highest_pef may be configured with 166 or 255, to avoid max frequency |
44 | * calculated wrongly. we take the fixed value as the highest_perf. |
45 | * @nominal_perf: the maximum sustained performance level of the processor, |
46 | * assuming ideal operating conditions |
47 | * @lowest_nonlinear_perf: the lowest performance level at which nonlinear power |
48 | * savings are achieved |
49 | * @lowest_perf: the absolute lowest performance level of the processor |
50 | * @prefcore_ranking: the preferred core ranking, the higher value indicates a higher |
51 | * priority. |
52 | * @max_freq: the frequency that mapped to highest_perf |
53 | * @min_freq: the frequency that mapped to lowest_perf |
54 | * @nominal_freq: the frequency that mapped to nominal_perf |
55 | * @lowest_nonlinear_freq: the frequency that mapped to lowest_nonlinear_perf |
56 | * @cur: Difference of Aperf/Mperf/tsc count between last and current sample |
57 | * @prev: Last Aperf/Mperf/tsc count value read from register |
58 | * @freq: current cpu frequency value |
59 | * @boost_supported: check whether the Processor or SBIOS supports boost mode |
60 | * @hw_prefcore: check whether HW supports preferred core featue. |
61 | * Only when hw_prefcore and early prefcore param are true, |
62 | * AMD P-State driver supports preferred core featue. |
63 | * @epp_policy: Last saved policy used to set energy-performance preference |
64 | * @epp_cached: Cached CPPC energy-performance preference value |
65 | * @policy: Cpufreq policy value |
66 | * @cppc_cap1_cached Cached MSR_AMD_CPPC_CAP1 register value |
67 | * |
68 | * The amd_cpudata is key private data for each CPU thread in AMD P-State, and |
69 | * represents all the attributes and goals that AMD P-State requests at runtime. |
70 | */ |
71 | struct amd_cpudata { |
72 | int cpu; |
73 | |
74 | struct freq_qos_request req[2]; |
75 | u64 cppc_req_cached; |
76 | |
77 | u32 highest_perf; |
78 | u32 nominal_perf; |
79 | u32 lowest_nonlinear_perf; |
80 | u32 lowest_perf; |
81 | u32 prefcore_ranking; |
82 | u32 min_limit_perf; |
83 | u32 max_limit_perf; |
84 | u32 min_limit_freq; |
85 | u32 max_limit_freq; |
86 | |
87 | u32 max_freq; |
88 | u32 min_freq; |
89 | u32 nominal_freq; |
90 | u32 lowest_nonlinear_freq; |
91 | |
92 | struct amd_aperf_mperf cur; |
93 | struct amd_aperf_mperf prev; |
94 | |
95 | u64 freq; |
96 | bool boost_supported; |
97 | bool hw_prefcore; |
98 | |
99 | /* EPP feature related attributes*/ |
100 | s16 epp_policy; |
101 | s16 epp_cached; |
102 | u32 policy; |
103 | u64 cppc_cap1_cached; |
104 | bool suspended; |
105 | }; |
106 | |
107 | /* |
108 | * enum amd_pstate_mode - driver working mode of amd pstate |
109 | */ |
110 | enum amd_pstate_mode { |
111 | AMD_PSTATE_UNDEFINED = 0, |
112 | AMD_PSTATE_DISABLE, |
113 | AMD_PSTATE_PASSIVE, |
114 | AMD_PSTATE_ACTIVE, |
115 | AMD_PSTATE_GUIDED, |
116 | AMD_PSTATE_MAX, |
117 | }; |
118 | |
119 | static const char * const amd_pstate_mode_string[] = { |
120 | [AMD_PSTATE_UNDEFINED] = "undefined" , |
121 | [AMD_PSTATE_DISABLE] = "disable" , |
122 | [AMD_PSTATE_PASSIVE] = "passive" , |
123 | [AMD_PSTATE_ACTIVE] = "active" , |
124 | [AMD_PSTATE_GUIDED] = "guided" , |
125 | NULL, |
126 | }; |
127 | #endif /* _LINUX_AMD_PSTATE_H */ |
128 | |