1 // SPDX-License-Identifier: GPL-2.0-only
3 * Mapping of TPMI power domains CPU mapping
5 * Copyright (c) 2024, Intel Corporation.
8 #include <linux/bitfield.h>
9 #include <linux/cleanup.h>
10 #include <linux/cpuhotplug.h>
11 #include <linux/cpumask.h>
12 #include <linux/errno.h>
13 #include <linux/export.h>
14 #include <linux/hashtable.h>
15 #include <linux/module.h>
16 #include <linux/mutex.h>
17 #include <linux/overflow.h>
18 #include <linux/slab.h>
19 #include <linux/topology.h>
20 #include <linux/types.h>
22 #include <asm/cpu_device_id.h>
23 #include <asm/intel-family.h>
26 #include "tpmi_power_domains.h"
28 #define MSR_PM_LOGICAL_ID 0x54
32 * [15:11] PM_DOMAIN_ID
33 * [10:3] MODULE_ID (aka IDI_AGENT_ID)
37 * [1:0] core ID within module
43 #define LP_ID_MASK GENMASK_ULL(2, 0)
44 #define MODULE_ID_MASK GENMASK_ULL(10, 3)
45 #define PM_DOMAIN_ID_MASK GENMASK_ULL(15, 11)
48 * struct tpmi_cpu_info - Mapping information for a CPU
49 * @hnode: Used to add mapping information to hash list
50 * @linux_cpu: Linux CPU number
51 * @pkg_id: Package ID of this CPU
52 * @punit_thread_id: Punit thread id of this CPU
53 * @punit_core_id: Punit core id
54 * @punit_domain_id: Power domain id from Punit
56 * Structure to store mapping information for a Linux CPU
57 * to a Punit core, thread and power domain.
59 struct tpmi_cpu_info {
60 struct hlist_node hnode;
68 static DEFINE_PER_CPU(struct tpmi_cpu_info, tpmi_cpu_info);
70 /* The dynamically assigned cpu hotplug state to free later */
71 static enum cpuhp_state tpmi_hp_state __read_mostly;
73 #define MAX_POWER_DOMAINS 8
75 static cpumask_t *tpmi_power_domain_mask;
77 /* Lock to protect tpmi_power_domain_mask and tpmi_cpu_hash */
78 static DEFINE_MUTEX(tpmi_lock);
80 static const struct x86_cpu_id tpmi_cpu_ids[] = {
81 X86_MATCH_VFM(INTEL_GRANITERAPIDS_X, NULL),
82 X86_MATCH_VFM(INTEL_ATOM_CRESTMONT_X, NULL),
83 X86_MATCH_VFM(INTEL_ATOM_CRESTMONT, NULL),
84 X86_MATCH_VFM(INTEL_GRANITERAPIDS_D, NULL),
87 MODULE_DEVICE_TABLE(x86cpu, tpmi_cpu_ids);
89 static DECLARE_HASHTABLE(tpmi_cpu_hash, 8);
91 static bool tpmi_domain_is_valid(struct tpmi_cpu_info *info)
93 return info->pkg_id < topology_max_packages() &&
94 info->punit_domain_id < MAX_POWER_DOMAINS;
97 int tpmi_get_linux_cpu_number(int package_id, int domain_id, int punit_core_id)
99 struct tpmi_cpu_info *info;
102 guard(mutex)(&tpmi_lock);
103 hash_for_each_possible(tpmi_cpu_hash, info, hnode, punit_core_id) {
104 if (info->punit_domain_id == domain_id && info->pkg_id == package_id) {
105 ret = info->linux_cpu;
112 EXPORT_SYMBOL_NS_GPL(tpmi_get_linux_cpu_number, INTEL_TPMI_POWER_DOMAIN);
114 int tpmi_get_punit_core_number(int cpu_no)
116 if (cpu_no >= num_possible_cpus())
119 return per_cpu(tpmi_cpu_info, cpu_no).punit_core_id;
121 EXPORT_SYMBOL_NS_GPL(tpmi_get_punit_core_number, INTEL_TPMI_POWER_DOMAIN);
123 int tpmi_get_power_domain_id(int cpu_no)
125 if (cpu_no >= num_possible_cpus())
128 return per_cpu(tpmi_cpu_info, cpu_no).punit_domain_id;
130 EXPORT_SYMBOL_NS_GPL(tpmi_get_power_domain_id, INTEL_TPMI_POWER_DOMAIN);
132 cpumask_t *tpmi_get_power_domain_mask(int cpu_no)
134 struct tpmi_cpu_info *info;
138 if (cpu_no >= num_possible_cpus())
141 info = &per_cpu(tpmi_cpu_info, cpu_no);
142 if (!tpmi_domain_is_valid(info))
145 index = info->pkg_id * MAX_POWER_DOMAINS + info->punit_domain_id;
146 guard(mutex)(&tpmi_lock);
147 mask = &tpmi_power_domain_mask[index];
151 EXPORT_SYMBOL_NS_GPL(tpmi_get_power_domain_mask, INTEL_TPMI_POWER_DOMAIN);
153 static int tpmi_get_logical_id(unsigned int cpu, struct tpmi_cpu_info *info)
158 ret = rdmsrl_safe(MSR_PM_LOGICAL_ID, &data);
162 info->punit_domain_id = FIELD_GET(PM_DOMAIN_ID_MASK, data);
163 if (info->punit_domain_id >= MAX_POWER_DOMAINS)
166 info->punit_thread_id = FIELD_GET(LP_ID_MASK, data);
167 info->punit_core_id = FIELD_GET(MODULE_ID_MASK, data);
168 info->pkg_id = topology_physical_package_id(cpu);
169 info->linux_cpu = cpu;
174 static int tpmi_cpu_online(unsigned int cpu)
176 struct tpmi_cpu_info *info = &per_cpu(tpmi_cpu_info, cpu);
179 /* Don't fail CPU online for some bad mapping of CPUs */
180 ret = tpmi_get_logical_id(cpu, info);
184 index = info->pkg_id * MAX_POWER_DOMAINS + info->punit_domain_id;
186 guard(mutex)(&tpmi_lock);
187 cpumask_set_cpu(cpu, &tpmi_power_domain_mask[index]);
188 hash_add(tpmi_cpu_hash, &info->hnode, info->punit_core_id);
193 static int __init tpmi_init(void)
195 const struct x86_cpu_id *id;
199 id = x86_match_cpu(tpmi_cpu_ids);
203 /* Check for MSR 0x54 presence */
204 ret = rdmsrl_safe(MSR_PM_LOGICAL_ID, &data);
208 tpmi_power_domain_mask = kcalloc(size_mul(topology_max_packages(), MAX_POWER_DOMAINS),
209 sizeof(*tpmi_power_domain_mask), GFP_KERNEL);
210 if (!tpmi_power_domain_mask)
213 ret = cpuhp_setup_state(CPUHP_AP_ONLINE_DYN,
214 "platform/x86/tpmi_power_domains:online",
215 tpmi_cpu_online, NULL);
217 kfree(tpmi_power_domain_mask);
225 module_init(tpmi_init)
227 static void __exit tpmi_exit(void)
229 cpuhp_remove_state(tpmi_hp_state);
230 kfree(tpmi_power_domain_mask);
232 module_exit(tpmi_exit)
234 MODULE_DESCRIPTION("TPMI Power Domains Mapping");
235 MODULE_LICENSE("GPL");