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 */
29struct 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 */
71struct 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 */
110enum 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
119static 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

source code of linux/include/linux/amd-pstate.h