include/linux/arch_topology.h

   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_ */