1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * include/linux/arch_topology.h - arch specific cpu topology information
4  */
5 #ifndef _LINUX_ARCH_TOPOLOGY_H_
6 #define _LINUX_ARCH_TOPOLOGY_H_
7 
8 #include <linux/types.h>
9 #include <linux/percpu.h>
10 
11 void topology_normalize_cpu_scale(void);
12 int topology_update_cpu_topology(void);
13 
14 #ifdef CONFIG_ACPI_CPPC_LIB
15 void topology_init_cpu_capacity_cppc(void);
16 #endif
17 
18 struct device_node;
19 bool topology_parse_cpu_capacity(struct device_node *cpu_node, int cpu);
20 
21 DECLARE_PER_CPU(unsigned long, cpu_scale);
22 
topology_get_cpu_scale(int cpu)23 static inline unsigned long topology_get_cpu_scale(int cpu)
24 {
25 	return per_cpu(cpu_scale, cpu);
26 }
27 
28 void topology_set_cpu_scale(unsigned int cpu, unsigned long capacity);
29 
30 DECLARE_PER_CPU(unsigned long, arch_freq_scale);
31 
topology_get_freq_scale(int cpu)32 static inline unsigned long topology_get_freq_scale(int cpu)
33 {
34 	return per_cpu(arch_freq_scale, cpu);
35 }
36 
37 void topology_set_freq_scale(const struct cpumask *cpus, unsigned long cur_freq,
38 			     unsigned long max_freq);
39 bool topology_scale_freq_invariant(void);
40 
41 enum scale_freq_source {
42 	SCALE_FREQ_SOURCE_CPUFREQ = 0,
43 	SCALE_FREQ_SOURCE_ARCH,
44 	SCALE_FREQ_SOURCE_CPPC,
45 };
46 
47 struct scale_freq_data {
48 	enum scale_freq_source source;
49 	void (*set_freq_scale)(void);
50 };
51 
52 void topology_scale_freq_tick(void);
53 void topology_set_scale_freq_source(struct scale_freq_data *data, const struct cpumask *cpus);
54 void topology_clear_scale_freq_source(enum scale_freq_source source, const struct cpumask *cpus);
55 
56 DECLARE_PER_CPU(unsigned long, thermal_pressure);
57 
topology_get_thermal_pressure(int cpu)58 static inline unsigned long topology_get_thermal_pressure(int cpu)
59 {
60 	return per_cpu(thermal_pressure, cpu);
61 }
62 
63 void topology_update_thermal_pressure(const struct cpumask *cpus,
64 				      unsigned long capped_freq);
65 
66 struct cpu_topology {
67 	int thread_id;
68 	int core_id;
69 	int cluster_id;
70 	int package_id;
71 	cpumask_t thread_sibling;
72 	cpumask_t core_sibling;
73 	cpumask_t cluster_sibling;
74 	cpumask_t llc_sibling;
75 };
76 
77 #ifdef CONFIG_GENERIC_ARCH_TOPOLOGY
78 extern struct cpu_topology cpu_topology[NR_CPUS];
79 
80 #define topology_physical_package_id(cpu)	(cpu_topology[cpu].package_id)
81 #define topology_cluster_id(cpu)	(cpu_topology[cpu].cluster_id)
82 #define topology_core_id(cpu)		(cpu_topology[cpu].core_id)
83 #define topology_core_cpumask(cpu)	(&cpu_topology[cpu].core_sibling)
84 #define topology_sibling_cpumask(cpu)	(&cpu_topology[cpu].thread_sibling)
85 #define topology_cluster_cpumask(cpu)	(&cpu_topology[cpu].cluster_sibling)
86 #define topology_llc_cpumask(cpu)	(&cpu_topology[cpu].llc_sibling)
87 void init_cpu_topology(void);
88 void store_cpu_topology(unsigned int cpuid);
89 const struct cpumask *cpu_coregroup_mask(int cpu);
90 const struct cpumask *cpu_clustergroup_mask(int cpu);
91 void update_siblings_masks(unsigned int cpu);
92 void remove_cpu_topology(unsigned int cpuid);
93 void reset_cpu_topology(void);
94 int parse_acpi_topology(void);
95 #endif
96 
97 #endif /* _LINUX_ARCH_TOPOLOGY_H_ */
98