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