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
11void topology_normalize_cpu_scale(void);
12int topology_update_cpu_topology(void);
13
14#ifdef CONFIG_ACPI_CPPC_LIB
15void topology_init_cpu_capacity_cppc(void);
16#endif
17
18struct device_node;
19bool topology_parse_cpu_capacity(struct device_node *cpu_node, int cpu);
20
21DECLARE_PER_CPU(unsigned long, cpu_scale);
22
23static inline unsigned long topology_get_cpu_scale(int cpu)
24{
25	return per_cpu(cpu_scale, cpu);
26}
27
28void topology_set_cpu_scale(unsigned int cpu, unsigned long capacity);
29
30DECLARE_PER_CPU(unsigned long, capacity_freq_ref);
31
32static inline unsigned long topology_get_freq_ref(int cpu)
33{
34	return per_cpu(capacity_freq_ref, cpu);
35}
36
37DECLARE_PER_CPU(unsigned long, arch_freq_scale);
38
39static inline unsigned long topology_get_freq_scale(int cpu)
40{
41	return per_cpu(arch_freq_scale, cpu);
42}
43
44void topology_set_freq_scale(const struct cpumask *cpus, unsigned long cur_freq,
45			     unsigned long max_freq);
46bool topology_scale_freq_invariant(void);
47
48enum scale_freq_source {
49	SCALE_FREQ_SOURCE_CPUFREQ = 0,
50	SCALE_FREQ_SOURCE_ARCH,
51	SCALE_FREQ_SOURCE_CPPC,
52};
53
54struct scale_freq_data {
55	enum scale_freq_source source;
56	void (*set_freq_scale)(void);
57};
58
59void topology_scale_freq_tick(void);
60void topology_set_scale_freq_source(struct scale_freq_data *data, const struct cpumask *cpus);
61void topology_clear_scale_freq_source(enum scale_freq_source source, const struct cpumask *cpus);
62
63DECLARE_PER_CPU(unsigned long, thermal_pressure);
64
65static inline unsigned long topology_get_thermal_pressure(int cpu)
66{
67	return per_cpu(thermal_pressure, cpu);
68}
69
70void topology_update_thermal_pressure(const struct cpumask *cpus,
71				      unsigned long capped_freq);
72
73struct 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
85extern 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)
94void init_cpu_topology(void);
95void store_cpu_topology(unsigned int cpuid);
96const struct cpumask *cpu_coregroup_mask(int cpu);
97const struct cpumask *cpu_clustergroup_mask(int cpu);
98void update_siblings_masks(unsigned int cpu);
99void remove_cpu_topology(unsigned int cpuid);
100void reset_cpu_topology(void);
101int parse_acpi_topology(void);
102void freq_inv_set_max_ratio(int cpu, u64 max_rate);
103#endif
104
105#endif /* _LINUX_ARCH_TOPOLOGY_H_ */
106