1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0-only
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun * Intel Running Average Power Limit (RAPL) Driver via MSR interface
4*4882a593Smuzhiyun * Copyright (c) 2019, Intel Corporation.
5*4882a593Smuzhiyun */
6*4882a593Smuzhiyun #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
7*4882a593Smuzhiyun
8*4882a593Smuzhiyun #include <linux/kernel.h>
9*4882a593Smuzhiyun #include <linux/module.h>
10*4882a593Smuzhiyun #include <linux/list.h>
11*4882a593Smuzhiyun #include <linux/types.h>
12*4882a593Smuzhiyun #include <linux/device.h>
13*4882a593Smuzhiyun #include <linux/slab.h>
14*4882a593Smuzhiyun #include <linux/log2.h>
15*4882a593Smuzhiyun #include <linux/bitmap.h>
16*4882a593Smuzhiyun #include <linux/delay.h>
17*4882a593Smuzhiyun #include <linux/sysfs.h>
18*4882a593Smuzhiyun #include <linux/cpu.h>
19*4882a593Smuzhiyun #include <linux/powercap.h>
20*4882a593Smuzhiyun #include <linux/suspend.h>
21*4882a593Smuzhiyun #include <linux/intel_rapl.h>
22*4882a593Smuzhiyun #include <linux/processor.h>
23*4882a593Smuzhiyun #include <linux/platform_device.h>
24*4882a593Smuzhiyun
25*4882a593Smuzhiyun #include <asm/iosf_mbi.h>
26*4882a593Smuzhiyun #include <asm/cpu_device_id.h>
27*4882a593Smuzhiyun #include <asm/intel-family.h>
28*4882a593Smuzhiyun
29*4882a593Smuzhiyun /* Local defines */
30*4882a593Smuzhiyun #define MSR_PLATFORM_POWER_LIMIT 0x0000065C
31*4882a593Smuzhiyun #define MSR_VR_CURRENT_CONFIG 0x00000601
32*4882a593Smuzhiyun
33*4882a593Smuzhiyun /* private data for RAPL MSR Interface */
34*4882a593Smuzhiyun static struct rapl_if_priv rapl_msr_priv = {
35*4882a593Smuzhiyun .reg_unit = MSR_RAPL_POWER_UNIT,
36*4882a593Smuzhiyun .regs[RAPL_DOMAIN_PACKAGE] = {
37*4882a593Smuzhiyun MSR_PKG_POWER_LIMIT, MSR_PKG_ENERGY_STATUS, MSR_PKG_PERF_STATUS, 0, MSR_PKG_POWER_INFO },
38*4882a593Smuzhiyun .regs[RAPL_DOMAIN_PP0] = {
39*4882a593Smuzhiyun MSR_PP0_POWER_LIMIT, MSR_PP0_ENERGY_STATUS, 0, MSR_PP0_POLICY, 0 },
40*4882a593Smuzhiyun .regs[RAPL_DOMAIN_PP1] = {
41*4882a593Smuzhiyun MSR_PP1_POWER_LIMIT, MSR_PP1_ENERGY_STATUS, 0, MSR_PP1_POLICY, 0 },
42*4882a593Smuzhiyun .regs[RAPL_DOMAIN_DRAM] = {
43*4882a593Smuzhiyun MSR_DRAM_POWER_LIMIT, MSR_DRAM_ENERGY_STATUS, MSR_DRAM_PERF_STATUS, 0, MSR_DRAM_POWER_INFO },
44*4882a593Smuzhiyun .regs[RAPL_DOMAIN_PLATFORM] = {
45*4882a593Smuzhiyun MSR_PLATFORM_POWER_LIMIT, MSR_PLATFORM_ENERGY_STATUS, 0, 0, 0},
46*4882a593Smuzhiyun .limits[RAPL_DOMAIN_PACKAGE] = 2,
47*4882a593Smuzhiyun .limits[RAPL_DOMAIN_PLATFORM] = 2,
48*4882a593Smuzhiyun };
49*4882a593Smuzhiyun
50*4882a593Smuzhiyun /* Handles CPU hotplug on multi-socket systems.
51*4882a593Smuzhiyun * If a CPU goes online as the first CPU of the physical package
52*4882a593Smuzhiyun * we add the RAPL package to the system. Similarly, when the last
53*4882a593Smuzhiyun * CPU of the package is removed, we remove the RAPL package and its
54*4882a593Smuzhiyun * associated domains. Cooling devices are handled accordingly at
55*4882a593Smuzhiyun * per-domain level.
56*4882a593Smuzhiyun */
rapl_cpu_online(unsigned int cpu)57*4882a593Smuzhiyun static int rapl_cpu_online(unsigned int cpu)
58*4882a593Smuzhiyun {
59*4882a593Smuzhiyun struct rapl_package *rp;
60*4882a593Smuzhiyun
61*4882a593Smuzhiyun rp = rapl_find_package_domain(cpu, &rapl_msr_priv);
62*4882a593Smuzhiyun if (!rp) {
63*4882a593Smuzhiyun rp = rapl_add_package(cpu, &rapl_msr_priv);
64*4882a593Smuzhiyun if (IS_ERR(rp))
65*4882a593Smuzhiyun return PTR_ERR(rp);
66*4882a593Smuzhiyun }
67*4882a593Smuzhiyun cpumask_set_cpu(cpu, &rp->cpumask);
68*4882a593Smuzhiyun return 0;
69*4882a593Smuzhiyun }
70*4882a593Smuzhiyun
rapl_cpu_down_prep(unsigned int cpu)71*4882a593Smuzhiyun static int rapl_cpu_down_prep(unsigned int cpu)
72*4882a593Smuzhiyun {
73*4882a593Smuzhiyun struct rapl_package *rp;
74*4882a593Smuzhiyun int lead_cpu;
75*4882a593Smuzhiyun
76*4882a593Smuzhiyun rp = rapl_find_package_domain(cpu, &rapl_msr_priv);
77*4882a593Smuzhiyun if (!rp)
78*4882a593Smuzhiyun return 0;
79*4882a593Smuzhiyun
80*4882a593Smuzhiyun cpumask_clear_cpu(cpu, &rp->cpumask);
81*4882a593Smuzhiyun lead_cpu = cpumask_first(&rp->cpumask);
82*4882a593Smuzhiyun if (lead_cpu >= nr_cpu_ids)
83*4882a593Smuzhiyun rapl_remove_package(rp);
84*4882a593Smuzhiyun else if (rp->lead_cpu == cpu)
85*4882a593Smuzhiyun rp->lead_cpu = lead_cpu;
86*4882a593Smuzhiyun return 0;
87*4882a593Smuzhiyun }
88*4882a593Smuzhiyun
rapl_msr_read_raw(int cpu,struct reg_action * ra)89*4882a593Smuzhiyun static int rapl_msr_read_raw(int cpu, struct reg_action *ra)
90*4882a593Smuzhiyun {
91*4882a593Smuzhiyun u32 msr = (u32)ra->reg;
92*4882a593Smuzhiyun
93*4882a593Smuzhiyun if (rdmsrl_safe_on_cpu(cpu, msr, &ra->value)) {
94*4882a593Smuzhiyun pr_debug("failed to read msr 0x%x on cpu %d\n", msr, cpu);
95*4882a593Smuzhiyun return -EIO;
96*4882a593Smuzhiyun }
97*4882a593Smuzhiyun ra->value &= ra->mask;
98*4882a593Smuzhiyun return 0;
99*4882a593Smuzhiyun }
100*4882a593Smuzhiyun
rapl_msr_update_func(void * info)101*4882a593Smuzhiyun static void rapl_msr_update_func(void *info)
102*4882a593Smuzhiyun {
103*4882a593Smuzhiyun struct reg_action *ra = info;
104*4882a593Smuzhiyun u32 msr = (u32)ra->reg;
105*4882a593Smuzhiyun u64 val;
106*4882a593Smuzhiyun
107*4882a593Smuzhiyun ra->err = rdmsrl_safe(msr, &val);
108*4882a593Smuzhiyun if (ra->err)
109*4882a593Smuzhiyun return;
110*4882a593Smuzhiyun
111*4882a593Smuzhiyun val &= ~ra->mask;
112*4882a593Smuzhiyun val |= ra->value;
113*4882a593Smuzhiyun
114*4882a593Smuzhiyun ra->err = wrmsrl_safe(msr, val);
115*4882a593Smuzhiyun }
116*4882a593Smuzhiyun
rapl_msr_write_raw(int cpu,struct reg_action * ra)117*4882a593Smuzhiyun static int rapl_msr_write_raw(int cpu, struct reg_action *ra)
118*4882a593Smuzhiyun {
119*4882a593Smuzhiyun int ret;
120*4882a593Smuzhiyun
121*4882a593Smuzhiyun ret = smp_call_function_single(cpu, rapl_msr_update_func, ra, 1);
122*4882a593Smuzhiyun if (WARN_ON_ONCE(ret))
123*4882a593Smuzhiyun return ret;
124*4882a593Smuzhiyun
125*4882a593Smuzhiyun return ra->err;
126*4882a593Smuzhiyun }
127*4882a593Smuzhiyun
128*4882a593Smuzhiyun /* List of verified CPUs. */
129*4882a593Smuzhiyun static const struct x86_cpu_id pl4_support_ids[] = {
130*4882a593Smuzhiyun { X86_VENDOR_INTEL, 6, INTEL_FAM6_TIGERLAKE_L, X86_FEATURE_ANY },
131*4882a593Smuzhiyun {}
132*4882a593Smuzhiyun };
133*4882a593Smuzhiyun
rapl_msr_probe(struct platform_device * pdev)134*4882a593Smuzhiyun static int rapl_msr_probe(struct platform_device *pdev)
135*4882a593Smuzhiyun {
136*4882a593Smuzhiyun const struct x86_cpu_id *id = x86_match_cpu(pl4_support_ids);
137*4882a593Smuzhiyun int ret;
138*4882a593Smuzhiyun
139*4882a593Smuzhiyun rapl_msr_priv.read_raw = rapl_msr_read_raw;
140*4882a593Smuzhiyun rapl_msr_priv.write_raw = rapl_msr_write_raw;
141*4882a593Smuzhiyun
142*4882a593Smuzhiyun if (id) {
143*4882a593Smuzhiyun rapl_msr_priv.limits[RAPL_DOMAIN_PACKAGE] = 3;
144*4882a593Smuzhiyun rapl_msr_priv.regs[RAPL_DOMAIN_PACKAGE][RAPL_DOMAIN_REG_PL4] =
145*4882a593Smuzhiyun MSR_VR_CURRENT_CONFIG;
146*4882a593Smuzhiyun pr_info("PL4 support detected.\n");
147*4882a593Smuzhiyun }
148*4882a593Smuzhiyun
149*4882a593Smuzhiyun rapl_msr_priv.control_type = powercap_register_control_type(NULL, "intel-rapl", NULL);
150*4882a593Smuzhiyun if (IS_ERR(rapl_msr_priv.control_type)) {
151*4882a593Smuzhiyun pr_debug("failed to register powercap control_type.\n");
152*4882a593Smuzhiyun return PTR_ERR(rapl_msr_priv.control_type);
153*4882a593Smuzhiyun }
154*4882a593Smuzhiyun
155*4882a593Smuzhiyun ret = cpuhp_setup_state(CPUHP_AP_ONLINE_DYN, "powercap/rapl:online",
156*4882a593Smuzhiyun rapl_cpu_online, rapl_cpu_down_prep);
157*4882a593Smuzhiyun if (ret < 0)
158*4882a593Smuzhiyun goto out;
159*4882a593Smuzhiyun rapl_msr_priv.pcap_rapl_online = ret;
160*4882a593Smuzhiyun
161*4882a593Smuzhiyun return 0;
162*4882a593Smuzhiyun
163*4882a593Smuzhiyun out:
164*4882a593Smuzhiyun if (ret)
165*4882a593Smuzhiyun powercap_unregister_control_type(rapl_msr_priv.control_type);
166*4882a593Smuzhiyun return ret;
167*4882a593Smuzhiyun }
168*4882a593Smuzhiyun
rapl_msr_remove(struct platform_device * pdev)169*4882a593Smuzhiyun static int rapl_msr_remove(struct platform_device *pdev)
170*4882a593Smuzhiyun {
171*4882a593Smuzhiyun cpuhp_remove_state(rapl_msr_priv.pcap_rapl_online);
172*4882a593Smuzhiyun powercap_unregister_control_type(rapl_msr_priv.control_type);
173*4882a593Smuzhiyun return 0;
174*4882a593Smuzhiyun }
175*4882a593Smuzhiyun
176*4882a593Smuzhiyun static const struct platform_device_id rapl_msr_ids[] = {
177*4882a593Smuzhiyun { .name = "intel_rapl_msr", },
178*4882a593Smuzhiyun {}
179*4882a593Smuzhiyun };
180*4882a593Smuzhiyun MODULE_DEVICE_TABLE(platform, rapl_msr_ids);
181*4882a593Smuzhiyun
182*4882a593Smuzhiyun static struct platform_driver intel_rapl_msr_driver = {
183*4882a593Smuzhiyun .probe = rapl_msr_probe,
184*4882a593Smuzhiyun .remove = rapl_msr_remove,
185*4882a593Smuzhiyun .id_table = rapl_msr_ids,
186*4882a593Smuzhiyun .driver = {
187*4882a593Smuzhiyun .name = "intel_rapl_msr",
188*4882a593Smuzhiyun },
189*4882a593Smuzhiyun };
190*4882a593Smuzhiyun
191*4882a593Smuzhiyun module_platform_driver(intel_rapl_msr_driver);
192*4882a593Smuzhiyun
193*4882a593Smuzhiyun MODULE_DESCRIPTION("Driver for Intel RAPL (Running Average Power Limit) control via MSR interface");
194*4882a593Smuzhiyun MODULE_AUTHOR("Zhang Rui <rui.zhang@intel.com>");
195*4882a593Smuzhiyun MODULE_LICENSE("GPL v2");
196