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