1 // SPDX-License-Identifier: GPL-2.0-only
3 * Intel Running Average Power Limit (RAPL) Driver via MSR interface
4 * Copyright (c) 2019, Intel Corporation.
6 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
8 #include <linux/kernel.h>
9 #include <linux/module.h>
10 #include <linux/list.h>
11 #include <linux/types.h>
12 #include <linux/device.h>
13 #include <linux/slab.h>
14 #include <linux/log2.h>
15 #include <linux/bitmap.h>
16 #include <linux/delay.h>
17 #include <linux/sysfs.h>
18 #include <linux/cpu.h>
19 #include <linux/powercap.h>
20 #include <linux/suspend.h>
21 #include <linux/intel_rapl.h>
22 #include <linux/processor.h>
23 #include <linux/platform_device.h>
25 #include <asm/iosf_mbi.h>
26 #include <asm/cpu_device_id.h>
27 #include <asm/intel-family.h>
30 #define MSR_PLATFORM_POWER_LIMIT 0x0000065C
31 #define MSR_VR_CURRENT_CONFIG 0x00000601
33 /* private data for RAPL MSR Interface */
34 static struct rapl_if_priv rapl_msr_priv = {
35 .reg_unit = MSR_RAPL_POWER_UNIT,
36 .regs[RAPL_DOMAIN_PACKAGE] = {
37 MSR_PKG_POWER_LIMIT, MSR_PKG_ENERGY_STATUS, MSR_PKG_PERF_STATUS, 0, MSR_PKG_POWER_INFO },
38 .regs[RAPL_DOMAIN_PP0] = {
39 MSR_PP0_POWER_LIMIT, MSR_PP0_ENERGY_STATUS, 0, MSR_PP0_POLICY, 0 },
40 .regs[RAPL_DOMAIN_PP1] = {
41 MSR_PP1_POWER_LIMIT, MSR_PP1_ENERGY_STATUS, 0, MSR_PP1_POLICY, 0 },
42 .regs[RAPL_DOMAIN_DRAM] = {
43 MSR_DRAM_POWER_LIMIT, MSR_DRAM_ENERGY_STATUS, MSR_DRAM_PERF_STATUS, 0, MSR_DRAM_POWER_INFO },
44 .regs[RAPL_DOMAIN_PLATFORM] = {
45 MSR_PLATFORM_POWER_LIMIT, MSR_PLATFORM_ENERGY_STATUS, 0, 0, 0},
46 .limits[RAPL_DOMAIN_PACKAGE] = 2,
49 /* Handles CPU hotplug on multi-socket systems.
50 * If a CPU goes online as the first CPU of the physical package
51 * we add the RAPL package to the system. Similarly, when the last
52 * CPU of the package is removed, we remove the RAPL package and its
53 * associated domains. Cooling devices are handled accordingly at
56 static int rapl_cpu_online(unsigned int cpu)
58 struct rapl_package *rp;
60 rp = rapl_find_package_domain(cpu, &rapl_msr_priv);
62 rp = rapl_add_package(cpu, &rapl_msr_priv);
66 cpumask_set_cpu(cpu, &rp->cpumask);
70 static int rapl_cpu_down_prep(unsigned int cpu)
72 struct rapl_package *rp;
75 rp = rapl_find_package_domain(cpu, &rapl_msr_priv);
79 cpumask_clear_cpu(cpu, &rp->cpumask);
80 lead_cpu = cpumask_first(&rp->cpumask);
81 if (lead_cpu >= nr_cpu_ids)
82 rapl_remove_package(rp);
83 else if (rp->lead_cpu == cpu)
84 rp->lead_cpu = lead_cpu;
88 static int rapl_msr_read_raw(int cpu, struct reg_action *ra)
90 u32 msr = (u32)ra->reg;
92 if (rdmsrl_safe_on_cpu(cpu, msr, &ra->value)) {
93 pr_debug("failed to read msr 0x%x on cpu %d\n", msr, cpu);
96 ra->value &= ra->mask;
100 static void rapl_msr_update_func(void *info)
102 struct reg_action *ra = info;
103 u32 msr = (u32)ra->reg;
106 ra->err = rdmsrl_safe(msr, &val);
113 ra->err = wrmsrl_safe(msr, val);
116 static int rapl_msr_write_raw(int cpu, struct reg_action *ra)
120 ret = smp_call_function_single(cpu, rapl_msr_update_func, ra, 1);
121 if (WARN_ON_ONCE(ret))
127 /* List of verified CPUs. */
128 static const struct x86_cpu_id pl4_support_ids[] = {
129 { X86_VENDOR_INTEL, 6, INTEL_FAM6_TIGERLAKE_L, X86_FEATURE_ANY },
133 static int rapl_msr_probe(struct platform_device *pdev)
135 const struct x86_cpu_id *id = x86_match_cpu(pl4_support_ids);
138 rapl_msr_priv.read_raw = rapl_msr_read_raw;
139 rapl_msr_priv.write_raw = rapl_msr_write_raw;
142 rapl_msr_priv.limits[RAPL_DOMAIN_PACKAGE] = 3;
143 rapl_msr_priv.regs[RAPL_DOMAIN_PACKAGE][RAPL_DOMAIN_REG_PL4] =
144 MSR_VR_CURRENT_CONFIG;
145 pr_info("PL4 support detected.\n");
148 rapl_msr_priv.control_type = powercap_register_control_type(NULL, "intel-rapl", NULL);
149 if (IS_ERR(rapl_msr_priv.control_type)) {
150 pr_debug("failed to register powercap control_type.\n");
151 return PTR_ERR(rapl_msr_priv.control_type);
154 ret = cpuhp_setup_state(CPUHP_AP_ONLINE_DYN, "powercap/rapl:online",
155 rapl_cpu_online, rapl_cpu_down_prep);
158 rapl_msr_priv.pcap_rapl_online = ret;
160 /* Don't bail out if PSys is not supported */
161 rapl_add_platform_domain(&rapl_msr_priv);
167 powercap_unregister_control_type(rapl_msr_priv.control_type);
171 static int rapl_msr_remove(struct platform_device *pdev)
173 cpuhp_remove_state(rapl_msr_priv.pcap_rapl_online);
174 rapl_remove_platform_domain(&rapl_msr_priv);
175 powercap_unregister_control_type(rapl_msr_priv.control_type);
179 static const struct platform_device_id rapl_msr_ids[] = {
180 { .name = "intel_rapl_msr", },
183 MODULE_DEVICE_TABLE(platform, rapl_msr_ids);
185 static struct platform_driver intel_rapl_msr_driver = {
186 .probe = rapl_msr_probe,
187 .remove = rapl_msr_remove,
188 .id_table = rapl_msr_ids,
190 .name = "intel_rapl_msr",
194 module_platform_driver(intel_rapl_msr_driver);
196 MODULE_DESCRIPTION("Driver for Intel RAPL (Running Average Power Limit) control via MSR interface");
198 MODULE_LICENSE("GPL v2");