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