xref: /linux/include/linux/arch_topology.h (revision 7f71507851fc7764b36a3221839607d3a45c2025)
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 struct device_node;
15 bool topology_parse_cpu_capacity(struct device_node *cpu_node, int cpu);
16 
17 DECLARE_PER_CPU(unsigned long, cpu_scale);
18 
19 static inline unsigned long topology_get_cpu_scale(int cpu)
20 {
21 	return per_cpu(cpu_scale, cpu);
22 }
23 
24 void topology_set_cpu_scale(unsigned int cpu, unsigned long capacity);
25 
26 DECLARE_PER_CPU(unsigned long, capacity_freq_ref);
27 
28 static inline unsigned long topology_get_freq_ref(int cpu)
29 {
30 	return per_cpu(capacity_freq_ref, cpu);
31 }
32 
33 DECLARE_PER_CPU(unsigned long, arch_freq_scale);
34 
35 static inline unsigned long topology_get_freq_scale(int cpu)
36 {
37 	return per_cpu(arch_freq_scale, cpu);
38 }
39 
40 void topology_set_freq_scale(const struct cpumask *cpus, unsigned long cur_freq,
41 			     unsigned long max_freq);
42 bool topology_scale_freq_invariant(void);
43 
44 enum scale_freq_source {
45 	SCALE_FREQ_SOURCE_CPUFREQ = 0,
46 	SCALE_FREQ_SOURCE_ARCH,
47 	SCALE_FREQ_SOURCE_CPPC,
48 	SCALE_FREQ_SOURCE_VIRT,
49 };
50 
51 struct scale_freq_data {
52 	enum scale_freq_source source;
53 	void (*set_freq_scale)(void);
54 };
55 
56 void topology_scale_freq_tick(void);
57 void topology_set_scale_freq_source(struct scale_freq_data *data, const struct cpumask *cpus);
58 void topology_clear_scale_freq_source(enum scale_freq_source source, const struct cpumask *cpus);
59 
60 DECLARE_PER_CPU(unsigned long, hw_pressure);
61 
62 static inline unsigned long topology_get_hw_pressure(int cpu)
63 {
64 	return per_cpu(hw_pressure, cpu);
65 }
66 
67 void topology_update_hw_pressure(const struct cpumask *cpus,
68 				      unsigned long capped_freq);
69 
70 struct cpu_topology {
71 	int thread_id;
72 	int core_id;
73 	int cluster_id;
74 	int package_id;
75 	cpumask_t thread_sibling;
76 	cpumask_t core_sibling;
77 	cpumask_t cluster_sibling;
78 	cpumask_t llc_sibling;
79 };
80 
81 #ifdef CONFIG_GENERIC_ARCH_TOPOLOGY
82 extern struct cpu_topology cpu_topology[NR_CPUS];
83 
84 #define topology_physical_package_id(cpu)	(cpu_topology[cpu].package_id)
85 #define topology_cluster_id(cpu)	(cpu_topology[cpu].cluster_id)
86 #define topology_core_id(cpu)		(cpu_topology[cpu].core_id)
87 #define topology_core_cpumask(cpu)	(&cpu_topology[cpu].core_sibling)
88 #define topology_sibling_cpumask(cpu)	(&cpu_topology[cpu].thread_sibling)
89 #define topology_cluster_cpumask(cpu)	(&cpu_topology[cpu].cluster_sibling)
90 #define topology_llc_cpumask(cpu)	(&cpu_topology[cpu].llc_sibling)
91 void init_cpu_topology(void);
92 void store_cpu_topology(unsigned int cpuid);
93 const struct cpumask *cpu_coregroup_mask(int cpu);
94 const struct cpumask *cpu_clustergroup_mask(int cpu);
95 void update_siblings_masks(unsigned int cpu);
96 void remove_cpu_topology(unsigned int cpuid);
97 void reset_cpu_topology(void);
98 int parse_acpi_topology(void);
99 void freq_inv_set_max_ratio(int cpu, u64 max_rate);
100 #endif
101 
102 #endif /* _LINUX_ARCH_TOPOLOGY_H_ */
103