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 * @hw_prefcore: check whether HW supports preferred core featue. 56 * Only when hw_prefcore and early prefcore param are true, 57 * AMD P-State driver supports preferred core featue. 58 * @epp_policy: Last saved policy used to set energy-performance preference 59 * @epp_cached: Cached CPPC energy-performance preference value 60 * @policy: Cpufreq policy value 61 * @cppc_cap1_cached Cached MSR_AMD_CPPC_CAP1 register value 62 * 63 * The amd_cpudata is key private data for each CPU thread in AMD P-State, and 64 * represents all the attributes and goals that AMD P-State requests at runtime. 65 */ 66 struct amd_cpudata { 67 int cpu; 68 69 struct freq_qos_request req[2]; 70 u64 cppc_req_cached; 71 72 u32 highest_perf; 73 u32 nominal_perf; 74 u32 lowest_nonlinear_perf; 75 u32 lowest_perf; 76 u32 min_limit_perf; 77 u32 max_limit_perf; 78 u32 min_limit_freq; 79 u32 max_limit_freq; 80 81 u32 max_freq; 82 u32 min_freq; 83 u32 nominal_freq; 84 u32 lowest_nonlinear_freq; 85 86 struct amd_aperf_mperf cur; 87 struct amd_aperf_mperf prev; 88 89 u64 freq; 90 bool boost_supported; 91 bool hw_prefcore; 92 93 /* EPP feature related attributes*/ 94 s16 epp_policy; 95 s16 epp_cached; 96 u32 policy; 97 u64 cppc_cap1_cached; 98 bool suspended; 99 }; 100 101 /* 102 * enum amd_pstate_mode - driver working mode of amd pstate 103 */ 104 enum amd_pstate_mode { 105 AMD_PSTATE_UNDEFINED = 0, 106 AMD_PSTATE_DISABLE, 107 AMD_PSTATE_PASSIVE, 108 AMD_PSTATE_ACTIVE, 109 AMD_PSTATE_GUIDED, 110 AMD_PSTATE_MAX, 111 }; 112 113 static const char * const amd_pstate_mode_string[] = { 114 [AMD_PSTATE_UNDEFINED] = "undefined", 115 [AMD_PSTATE_DISABLE] = "disable", 116 [AMD_PSTATE_PASSIVE] = "passive", 117 [AMD_PSTATE_ACTIVE] = "active", 118 [AMD_PSTATE_GUIDED] = "guided", 119 NULL, 120 }; 121 #endif /* _LINUX_AMD_PSTATE_H */ 122