162306a36Sopenharmony_ci// SPDX-License-Identifier: GPL-2.0-only
262306a36Sopenharmony_ci/*
362306a36Sopenharmony_ci * Intel Running Average Power Limit (RAPL) Driver via MSR interface
462306a36Sopenharmony_ci * Copyright (c) 2019, Intel Corporation.
562306a36Sopenharmony_ci */
662306a36Sopenharmony_ci#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
762306a36Sopenharmony_ci
862306a36Sopenharmony_ci#include <linux/kernel.h>
962306a36Sopenharmony_ci#include <linux/module.h>
1062306a36Sopenharmony_ci#include <linux/list.h>
1162306a36Sopenharmony_ci#include <linux/types.h>
1262306a36Sopenharmony_ci#include <linux/device.h>
1362306a36Sopenharmony_ci#include <linux/slab.h>
1462306a36Sopenharmony_ci#include <linux/log2.h>
1562306a36Sopenharmony_ci#include <linux/bitmap.h>
1662306a36Sopenharmony_ci#include <linux/delay.h>
1762306a36Sopenharmony_ci#include <linux/sysfs.h>
1862306a36Sopenharmony_ci#include <linux/cpu.h>
1962306a36Sopenharmony_ci#include <linux/powercap.h>
2062306a36Sopenharmony_ci#include <linux/suspend.h>
2162306a36Sopenharmony_ci#include <linux/intel_rapl.h>
2262306a36Sopenharmony_ci#include <linux/processor.h>
2362306a36Sopenharmony_ci#include <linux/platform_device.h>
2462306a36Sopenharmony_ci
2562306a36Sopenharmony_ci#include <asm/cpu_device_id.h>
2662306a36Sopenharmony_ci#include <asm/intel-family.h>
2762306a36Sopenharmony_ci
2862306a36Sopenharmony_ci/* Local defines */
2962306a36Sopenharmony_ci#define MSR_PLATFORM_POWER_LIMIT	0x0000065C
3062306a36Sopenharmony_ci#define MSR_VR_CURRENT_CONFIG		0x00000601
3162306a36Sopenharmony_ci
3262306a36Sopenharmony_ci/* private data for RAPL MSR Interface */
3362306a36Sopenharmony_cistatic struct rapl_if_priv *rapl_msr_priv;
3462306a36Sopenharmony_ci
3562306a36Sopenharmony_cistatic struct rapl_if_priv rapl_msr_priv_intel = {
3662306a36Sopenharmony_ci	.type = RAPL_IF_MSR,
3762306a36Sopenharmony_ci	.reg_unit.msr = MSR_RAPL_POWER_UNIT,
3862306a36Sopenharmony_ci	.regs[RAPL_DOMAIN_PACKAGE][RAPL_DOMAIN_REG_LIMIT].msr	= MSR_PKG_POWER_LIMIT,
3962306a36Sopenharmony_ci	.regs[RAPL_DOMAIN_PACKAGE][RAPL_DOMAIN_REG_STATUS].msr	= MSR_PKG_ENERGY_STATUS,
4062306a36Sopenharmony_ci	.regs[RAPL_DOMAIN_PACKAGE][RAPL_DOMAIN_REG_PERF].msr	= MSR_PKG_PERF_STATUS,
4162306a36Sopenharmony_ci	.regs[RAPL_DOMAIN_PACKAGE][RAPL_DOMAIN_REG_INFO].msr	= MSR_PKG_POWER_INFO,
4262306a36Sopenharmony_ci	.regs[RAPL_DOMAIN_PP0][RAPL_DOMAIN_REG_LIMIT].msr	= MSR_PP0_POWER_LIMIT,
4362306a36Sopenharmony_ci	.regs[RAPL_DOMAIN_PP0][RAPL_DOMAIN_REG_STATUS].msr	= MSR_PP0_ENERGY_STATUS,
4462306a36Sopenharmony_ci	.regs[RAPL_DOMAIN_PP0][RAPL_DOMAIN_REG_POLICY].msr	= MSR_PP0_POLICY,
4562306a36Sopenharmony_ci	.regs[RAPL_DOMAIN_PP1][RAPL_DOMAIN_REG_LIMIT].msr	= MSR_PP1_POWER_LIMIT,
4662306a36Sopenharmony_ci	.regs[RAPL_DOMAIN_PP1][RAPL_DOMAIN_REG_STATUS].msr	= MSR_PP1_ENERGY_STATUS,
4762306a36Sopenharmony_ci	.regs[RAPL_DOMAIN_PP1][RAPL_DOMAIN_REG_POLICY].msr	= MSR_PP1_POLICY,
4862306a36Sopenharmony_ci	.regs[RAPL_DOMAIN_DRAM][RAPL_DOMAIN_REG_LIMIT].msr	= MSR_DRAM_POWER_LIMIT,
4962306a36Sopenharmony_ci	.regs[RAPL_DOMAIN_DRAM][RAPL_DOMAIN_REG_STATUS].msr	= MSR_DRAM_ENERGY_STATUS,
5062306a36Sopenharmony_ci	.regs[RAPL_DOMAIN_DRAM][RAPL_DOMAIN_REG_PERF].msr	= MSR_DRAM_PERF_STATUS,
5162306a36Sopenharmony_ci	.regs[RAPL_DOMAIN_DRAM][RAPL_DOMAIN_REG_INFO].msr	= MSR_DRAM_POWER_INFO,
5262306a36Sopenharmony_ci	.regs[RAPL_DOMAIN_PLATFORM][RAPL_DOMAIN_REG_LIMIT].msr	= MSR_PLATFORM_POWER_LIMIT,
5362306a36Sopenharmony_ci	.regs[RAPL_DOMAIN_PLATFORM][RAPL_DOMAIN_REG_STATUS].msr	= MSR_PLATFORM_ENERGY_STATUS,
5462306a36Sopenharmony_ci	.limits[RAPL_DOMAIN_PACKAGE] = BIT(POWER_LIMIT2),
5562306a36Sopenharmony_ci	.limits[RAPL_DOMAIN_PLATFORM] = BIT(POWER_LIMIT2),
5662306a36Sopenharmony_ci};
5762306a36Sopenharmony_ci
5862306a36Sopenharmony_cistatic struct rapl_if_priv rapl_msr_priv_amd = {
5962306a36Sopenharmony_ci	.type = RAPL_IF_MSR,
6062306a36Sopenharmony_ci	.reg_unit.msr = MSR_AMD_RAPL_POWER_UNIT,
6162306a36Sopenharmony_ci	.regs[RAPL_DOMAIN_PACKAGE][RAPL_DOMAIN_REG_STATUS].msr	= MSR_AMD_PKG_ENERGY_STATUS,
6262306a36Sopenharmony_ci	.regs[RAPL_DOMAIN_PP0][RAPL_DOMAIN_REG_STATUS].msr	= MSR_AMD_CORE_ENERGY_STATUS,
6362306a36Sopenharmony_ci};
6462306a36Sopenharmony_ci
6562306a36Sopenharmony_ci/* Handles CPU hotplug on multi-socket systems.
6662306a36Sopenharmony_ci * If a CPU goes online as the first CPU of the physical package
6762306a36Sopenharmony_ci * we add the RAPL package to the system. Similarly, when the last
6862306a36Sopenharmony_ci * CPU of the package is removed, we remove the RAPL package and its
6962306a36Sopenharmony_ci * associated domains. Cooling devices are handled accordingly at
7062306a36Sopenharmony_ci * per-domain level.
7162306a36Sopenharmony_ci */
7262306a36Sopenharmony_cistatic int rapl_cpu_online(unsigned int cpu)
7362306a36Sopenharmony_ci{
7462306a36Sopenharmony_ci	struct rapl_package *rp;
7562306a36Sopenharmony_ci
7662306a36Sopenharmony_ci	rp = rapl_find_package_domain_cpuslocked(cpu, rapl_msr_priv, true);
7762306a36Sopenharmony_ci	if (!rp) {
7862306a36Sopenharmony_ci		rp = rapl_add_package_cpuslocked(cpu, rapl_msr_priv, true);
7962306a36Sopenharmony_ci		if (IS_ERR(rp))
8062306a36Sopenharmony_ci			return PTR_ERR(rp);
8162306a36Sopenharmony_ci	}
8262306a36Sopenharmony_ci	cpumask_set_cpu(cpu, &rp->cpumask);
8362306a36Sopenharmony_ci	return 0;
8462306a36Sopenharmony_ci}
8562306a36Sopenharmony_ci
8662306a36Sopenharmony_cistatic int rapl_cpu_down_prep(unsigned int cpu)
8762306a36Sopenharmony_ci{
8862306a36Sopenharmony_ci	struct rapl_package *rp;
8962306a36Sopenharmony_ci	int lead_cpu;
9062306a36Sopenharmony_ci
9162306a36Sopenharmony_ci	rp = rapl_find_package_domain_cpuslocked(cpu, rapl_msr_priv, true);
9262306a36Sopenharmony_ci	if (!rp)
9362306a36Sopenharmony_ci		return 0;
9462306a36Sopenharmony_ci
9562306a36Sopenharmony_ci	cpumask_clear_cpu(cpu, &rp->cpumask);
9662306a36Sopenharmony_ci	lead_cpu = cpumask_first(&rp->cpumask);
9762306a36Sopenharmony_ci	if (lead_cpu >= nr_cpu_ids)
9862306a36Sopenharmony_ci		rapl_remove_package_cpuslocked(rp);
9962306a36Sopenharmony_ci	else if (rp->lead_cpu == cpu)
10062306a36Sopenharmony_ci		rp->lead_cpu = lead_cpu;
10162306a36Sopenharmony_ci	return 0;
10262306a36Sopenharmony_ci}
10362306a36Sopenharmony_ci
10462306a36Sopenharmony_cistatic int rapl_msr_read_raw(int cpu, struct reg_action *ra)
10562306a36Sopenharmony_ci{
10662306a36Sopenharmony_ci	if (rdmsrl_safe_on_cpu(cpu, ra->reg.msr, &ra->value)) {
10762306a36Sopenharmony_ci		pr_debug("failed to read msr 0x%x on cpu %d\n", ra->reg.msr, cpu);
10862306a36Sopenharmony_ci		return -EIO;
10962306a36Sopenharmony_ci	}
11062306a36Sopenharmony_ci	ra->value &= ra->mask;
11162306a36Sopenharmony_ci	return 0;
11262306a36Sopenharmony_ci}
11362306a36Sopenharmony_ci
11462306a36Sopenharmony_cistatic void rapl_msr_update_func(void *info)
11562306a36Sopenharmony_ci{
11662306a36Sopenharmony_ci	struct reg_action *ra = info;
11762306a36Sopenharmony_ci	u64 val;
11862306a36Sopenharmony_ci
11962306a36Sopenharmony_ci	ra->err = rdmsrl_safe(ra->reg.msr, &val);
12062306a36Sopenharmony_ci	if (ra->err)
12162306a36Sopenharmony_ci		return;
12262306a36Sopenharmony_ci
12362306a36Sopenharmony_ci	val &= ~ra->mask;
12462306a36Sopenharmony_ci	val |= ra->value;
12562306a36Sopenharmony_ci
12662306a36Sopenharmony_ci	ra->err = wrmsrl_safe(ra->reg.msr, val);
12762306a36Sopenharmony_ci}
12862306a36Sopenharmony_ci
12962306a36Sopenharmony_cistatic int rapl_msr_write_raw(int cpu, struct reg_action *ra)
13062306a36Sopenharmony_ci{
13162306a36Sopenharmony_ci	int ret;
13262306a36Sopenharmony_ci
13362306a36Sopenharmony_ci	ret = smp_call_function_single(cpu, rapl_msr_update_func, ra, 1);
13462306a36Sopenharmony_ci	if (WARN_ON_ONCE(ret))
13562306a36Sopenharmony_ci		return ret;
13662306a36Sopenharmony_ci
13762306a36Sopenharmony_ci	return ra->err;
13862306a36Sopenharmony_ci}
13962306a36Sopenharmony_ci
14062306a36Sopenharmony_ci/* List of verified CPUs. */
14162306a36Sopenharmony_cistatic const struct x86_cpu_id pl4_support_ids[] = {
14262306a36Sopenharmony_ci	X86_MATCH_INTEL_FAM6_MODEL(TIGERLAKE_L, NULL),
14362306a36Sopenharmony_ci	X86_MATCH_INTEL_FAM6_MODEL(ALDERLAKE, NULL),
14462306a36Sopenharmony_ci	X86_MATCH_INTEL_FAM6_MODEL(ALDERLAKE_L, NULL),
14562306a36Sopenharmony_ci	X86_MATCH_INTEL_FAM6_MODEL(ATOM_GRACEMONT, NULL),
14662306a36Sopenharmony_ci	X86_MATCH_INTEL_FAM6_MODEL(RAPTORLAKE, NULL),
14762306a36Sopenharmony_ci	X86_MATCH_INTEL_FAM6_MODEL(RAPTORLAKE_P, NULL),
14862306a36Sopenharmony_ci	X86_MATCH_INTEL_FAM6_MODEL(METEORLAKE, NULL),
14962306a36Sopenharmony_ci	X86_MATCH_INTEL_FAM6_MODEL(METEORLAKE_L, NULL),
15062306a36Sopenharmony_ci	{}
15162306a36Sopenharmony_ci};
15262306a36Sopenharmony_ci
15362306a36Sopenharmony_cistatic int rapl_msr_probe(struct platform_device *pdev)
15462306a36Sopenharmony_ci{
15562306a36Sopenharmony_ci	const struct x86_cpu_id *id = x86_match_cpu(pl4_support_ids);
15662306a36Sopenharmony_ci	int ret;
15762306a36Sopenharmony_ci
15862306a36Sopenharmony_ci	switch (boot_cpu_data.x86_vendor) {
15962306a36Sopenharmony_ci	case X86_VENDOR_INTEL:
16062306a36Sopenharmony_ci		rapl_msr_priv = &rapl_msr_priv_intel;
16162306a36Sopenharmony_ci		break;
16262306a36Sopenharmony_ci	case X86_VENDOR_HYGON:
16362306a36Sopenharmony_ci	case X86_VENDOR_AMD:
16462306a36Sopenharmony_ci		rapl_msr_priv = &rapl_msr_priv_amd;
16562306a36Sopenharmony_ci		break;
16662306a36Sopenharmony_ci	default:
16762306a36Sopenharmony_ci		pr_err("intel-rapl does not support CPU vendor %d\n", boot_cpu_data.x86_vendor);
16862306a36Sopenharmony_ci		return -ENODEV;
16962306a36Sopenharmony_ci	}
17062306a36Sopenharmony_ci	rapl_msr_priv->read_raw = rapl_msr_read_raw;
17162306a36Sopenharmony_ci	rapl_msr_priv->write_raw = rapl_msr_write_raw;
17262306a36Sopenharmony_ci
17362306a36Sopenharmony_ci	if (id) {
17462306a36Sopenharmony_ci		rapl_msr_priv->limits[RAPL_DOMAIN_PACKAGE] |= BIT(POWER_LIMIT4);
17562306a36Sopenharmony_ci		rapl_msr_priv->regs[RAPL_DOMAIN_PACKAGE][RAPL_DOMAIN_REG_PL4].msr =
17662306a36Sopenharmony_ci			MSR_VR_CURRENT_CONFIG;
17762306a36Sopenharmony_ci		pr_info("PL4 support detected.\n");
17862306a36Sopenharmony_ci	}
17962306a36Sopenharmony_ci
18062306a36Sopenharmony_ci	rapl_msr_priv->control_type = powercap_register_control_type(NULL, "intel-rapl", NULL);
18162306a36Sopenharmony_ci	if (IS_ERR(rapl_msr_priv->control_type)) {
18262306a36Sopenharmony_ci		pr_debug("failed to register powercap control_type.\n");
18362306a36Sopenharmony_ci		return PTR_ERR(rapl_msr_priv->control_type);
18462306a36Sopenharmony_ci	}
18562306a36Sopenharmony_ci
18662306a36Sopenharmony_ci	ret = cpuhp_setup_state(CPUHP_AP_ONLINE_DYN, "powercap/rapl:online",
18762306a36Sopenharmony_ci				rapl_cpu_online, rapl_cpu_down_prep);
18862306a36Sopenharmony_ci	if (ret < 0)
18962306a36Sopenharmony_ci		goto out;
19062306a36Sopenharmony_ci	rapl_msr_priv->pcap_rapl_online = ret;
19162306a36Sopenharmony_ci
19262306a36Sopenharmony_ci	return 0;
19362306a36Sopenharmony_ci
19462306a36Sopenharmony_ciout:
19562306a36Sopenharmony_ci	if (ret)
19662306a36Sopenharmony_ci		powercap_unregister_control_type(rapl_msr_priv->control_type);
19762306a36Sopenharmony_ci	return ret;
19862306a36Sopenharmony_ci}
19962306a36Sopenharmony_ci
20062306a36Sopenharmony_cistatic int rapl_msr_remove(struct platform_device *pdev)
20162306a36Sopenharmony_ci{
20262306a36Sopenharmony_ci	cpuhp_remove_state(rapl_msr_priv->pcap_rapl_online);
20362306a36Sopenharmony_ci	powercap_unregister_control_type(rapl_msr_priv->control_type);
20462306a36Sopenharmony_ci	return 0;
20562306a36Sopenharmony_ci}
20662306a36Sopenharmony_ci
20762306a36Sopenharmony_cistatic const struct platform_device_id rapl_msr_ids[] = {
20862306a36Sopenharmony_ci	{ .name = "intel_rapl_msr", },
20962306a36Sopenharmony_ci	{}
21062306a36Sopenharmony_ci};
21162306a36Sopenharmony_ciMODULE_DEVICE_TABLE(platform, rapl_msr_ids);
21262306a36Sopenharmony_ci
21362306a36Sopenharmony_cistatic struct platform_driver intel_rapl_msr_driver = {
21462306a36Sopenharmony_ci	.probe = rapl_msr_probe,
21562306a36Sopenharmony_ci	.remove = rapl_msr_remove,
21662306a36Sopenharmony_ci	.id_table = rapl_msr_ids,
21762306a36Sopenharmony_ci	.driver = {
21862306a36Sopenharmony_ci		.name = "intel_rapl_msr",
21962306a36Sopenharmony_ci	},
22062306a36Sopenharmony_ci};
22162306a36Sopenharmony_ci
22262306a36Sopenharmony_cimodule_platform_driver(intel_rapl_msr_driver);
22362306a36Sopenharmony_ci
22462306a36Sopenharmony_ciMODULE_DESCRIPTION("Driver for Intel RAPL (Running Average Power Limit) control via MSR interface");
22562306a36Sopenharmony_ciMODULE_AUTHOR("Zhang Rui <rui.zhang@intel.com>");
22662306a36Sopenharmony_ciMODULE_LICENSE("GPL v2");
227