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 * @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 */
63struct 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
74 u32 max_freq;
75 u32 min_freq;
76 u32 nominal_freq;
77 u32 lowest_nonlinear_freq;
78
79 struct amd_aperf_mperf cur;
80 struct amd_aperf_mperf prev;
81
82 u64 freq;
83 bool boost_supported;
84
85 /* EPP feature related attributes*/
86 s16 epp_policy;
87 s16 epp_cached;
88 u32 policy;
89 u64 cppc_cap1_cached;
90 bool suspended;
91};
92
93/*
94 * enum amd_pstate_mode - driver working mode of amd pstate
95 */
96enum amd_pstate_mode {
97 AMD_PSTATE_UNDEFINED = 0,
98 AMD_PSTATE_DISABLE,
99 AMD_PSTATE_PASSIVE,
100 AMD_PSTATE_ACTIVE,
101 AMD_PSTATE_GUIDED,
102 AMD_PSTATE_MAX,
103};
104
105static const char * const amd_pstate_mode_string[] = {
106 [AMD_PSTATE_UNDEFINED] = "undefined",
107 [AMD_PSTATE_DISABLE] = "disable",
108 [AMD_PSTATE_PASSIVE] = "passive",
109 [AMD_PSTATE_ACTIVE] = "active",
110 [AMD_PSTATE_GUIDED] = "guided",
111 NULL,
112};
113#endif /* _LINUX_AMD_PSTATE_H */
114

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