include/linux/cpufreq.h

63 	unsigned int		cpu;    /* cpu managing this policy, must be online */
74 	unsigned int		policy; /* see above */
75 	unsigned int		last_policy; /* policy before unplug */
96 	 * - Any routine that wants to read from the policy structure will
98 	 * - Any routine that will write to the policy structure and/or may take away
99 	 *   the policy altogether (eg. CPU hotplug), will hold this lock in write
108 	 *   policy and that the change will affect all of the policy CPUs then.
130 	 * the driver to set the frequency for this policy.  To be set by the
144 	/* Per policy boost enabled flag. */
171  * Used for passing new cpufreq policy data to the cpufreq driver's ->verify()
185 	struct cpufreq_policy *policy;
200 void cpufreq_cpu_put(struct cpufreq_policy *policy);
210 static inline void cpufreq_cpu_put(struct cpufreq_policy *policy) { }
213 static inline bool policy_is_inactive(struct cpufreq_policy *policy)
215 	return cpumask_empty(policy->cpus);
218 static inline bool policy_is_shared(struct cpufreq_policy *policy)
220 	return cpumask_weight(policy->cpus) > 1;
233 void cpufreq_cpu_release(struct cpufreq_policy *policy);
234 int cpufreq_get_policy(struct cpufreq_policy *policy, unsigned int cpu);
235 void refresh_frequency_limits(struct cpufreq_policy *policy);
240 struct kobject *get_governor_parent_kobj(struct cpufreq_policy *policy);
241 void cpufreq_enable_fast_switch(struct cpufreq_policy *policy);
242 void cpufreq_disable_fast_switch(struct cpufreq_policy *policy);
270 void cpufreq_stats_create_table(struct cpufreq_policy *policy);
271 void cpufreq_stats_free_table(struct cpufreq_policy *policy);
272 void cpufreq_stats_record_transition(struct cpufreq_policy *policy,
275 static inline void cpufreq_stats_create_table(struct cpufreq_policy *policy) { }
276 static inline void cpufreq_stats_free_table(struct cpufreq_policy *policy) { }
277 static inline void cpufreq_stats_record_transition(struct cpufreq_policy *policy,
332 	int		(*init)(struct cpufreq_policy *policy);
333 	int		(*verify)(struct cpufreq_policy_data *policy);
336 	int		(*setpolicy)(struct cpufreq_policy *policy);
338 	int		(*target)(struct cpufreq_policy *policy,
341 	int		(*target_index)(struct cpufreq_policy *policy,
343 	unsigned int	(*fast_switch)(struct cpufreq_policy *policy,
373 	unsigned int	(*get_intermediate)(struct cpufreq_policy *policy,
375 	int		(*target_intermediate)(struct cpufreq_policy *policy,
381 	/* Called to update policy limits on firmware notifications. */
387 	int		(*online)(struct cpufreq_policy *policy);
388 	int		(*offline)(struct cpufreq_policy *policy);
389 	int		(*exit)(struct cpufreq_policy *policy);
390 	int		(*suspend)(struct cpufreq_policy *policy);
391 	int		(*resume)(struct cpufreq_policy *policy);
394 	void		(*ready)(struct cpufreq_policy *policy);
400 	int		(*set_boost)(struct cpufreq_policy *policy, int state);
404 	 * policy is properly initialized, but before the governor is started.
406 	void		(*register_em)(struct cpufreq_policy *policy);
414  * the diver if the target frequency does not change, but the policy min or max
471 static inline void cpufreq_verify_within_limits(struct cpufreq_policy_data *policy,
475 	policy->max = clamp(policy->max, min, max);
476 	policy->min = clamp(policy->min, min, policy->max);
480 cpufreq_verify_within_cpu_limits(struct cpufreq_policy_data *policy)
482 	cpufreq_verify_within_limits(policy, policy->cpuinfo.min_freq,
483 				     policy->cpuinfo.max_freq);
489 int cpufreq_generic_suspend(struct cpufreq_policy *policy);
514 void cpufreq_freq_transition_begin(struct cpufreq_policy *policy,
516 void cpufreq_freq_transition_end(struct cpufreq_policy *policy,
578 	int	(*init)(struct cpufreq_policy *policy);
579 	void	(*exit)(struct cpufreq_policy *policy);
580 	int	(*start)(struct cpufreq_policy *policy);
581 	void	(*stop)(struct cpufreq_policy *policy);
582 	void	(*limits)(struct cpufreq_policy *policy);
583 	ssize_t	(*show_setspeed)	(struct cpufreq_policy *policy,
585 	int	(*store_setspeed)	(struct cpufreq_policy *policy,
602 unsigned int cpufreq_driver_fast_switch(struct cpufreq_policy *policy,
609 int cpufreq_driver_target(struct cpufreq_policy *policy,
612 int __cpufreq_driver_target(struct cpufreq_policy *policy,
615 unsigned int cpufreq_driver_resolve_freq(struct cpufreq_policy *policy,
617 unsigned int cpufreq_policy_transition_delay_us(struct cpufreq_policy *policy);
620 int cpufreq_start_governor(struct cpufreq_policy *policy);
621 void cpufreq_stop_governor(struct cpufreq_policy *policy);
640 static inline void cpufreq_policy_apply_limits(struct cpufreq_policy *policy)
642 	if (policy->max < policy->cur)
643 		__cpufreq_driver_target(policy, policy->max,
645 	else if (policy->min > policy->cur)
646 		__cpufreq_driver_target(policy, policy->min,
761 int cpufreq_frequency_table_cpuinfo(struct cpufreq_policy *policy,
764 int cpufreq_frequency_table_verify(struct cpufreq_policy_data *policy,
766 int cpufreq_generic_frequency_table_verify(struct cpufreq_policy_data *policy);
768 int cpufreq_table_index_unsorted(struct cpufreq_policy *policy,
771 int cpufreq_frequency_table_get_index(struct cpufreq_policy *policy,
780 bool policy_has_boost_freq(struct cpufreq_policy *policy);
783 static inline int cpufreq_table_find_index_al(struct cpufreq_policy *policy,
787 	struct cpufreq_frequency_table *table = policy->freq_table;
805 static inline int cpufreq_table_find_index_dl(struct cpufreq_policy *policy,
809 	struct cpufreq_frequency_table *table = policy->freq_table;
836 static inline int cpufreq_table_find_index_l(struct cpufreq_policy *policy,
840 	target_freq = clamp_val(target_freq, policy->min, policy->max);
842 	if (policy->freq_table_sorted == CPUFREQ_TABLE_SORTED_ASCENDING)
843 		return cpufreq_table_find_index_al(policy, target_freq,
846 		return cpufreq_table_find_index_dl(policy, target_freq,
851 static inline int cpufreq_table_find_index_ah(struct cpufreq_policy *policy,
855 	struct cpufreq_frequency_table *table = policy->freq_table;
882 static inline int cpufreq_table_find_index_dh(struct cpufreq_policy *policy,
886 	struct cpufreq_frequency_table *table = policy->freq_table;
904 static inline int cpufreq_table_find_index_h(struct cpufreq_policy *policy,
908 	target_freq = clamp_val(target_freq, policy->min, policy->max);
910 	if (policy->freq_table_sorted == CPUFREQ_TABLE_SORTED_ASCENDING)
911 		return cpufreq_table_find_index_ah(policy, target_freq,
914 		return cpufreq_table_find_index_dh(policy, target_freq,
919 static inline int cpufreq_table_find_index_ac(struct cpufreq_policy *policy,
923 	struct cpufreq_frequency_table *table = policy->freq_table;
954 static inline int cpufreq_table_find_index_dc(struct cpufreq_policy *policy,
958 	struct cpufreq_frequency_table *table = policy->freq_table;
989 static inline int cpufreq_table_find_index_c(struct cpufreq_policy *policy,
993 	target_freq = clamp_val(target_freq, policy->min, policy->max);
995 	if (policy->freq_table_sorted == CPUFREQ_TABLE_SORTED_ASCENDING)
996 		return cpufreq_table_find_index_ac(policy, target_freq,
999 		return cpufreq_table_find_index_dc(policy, target_freq,
1003 static inline bool cpufreq_is_in_limits(struct cpufreq_policy *policy, int idx)
1010 	freq = policy->freq_table[idx].frequency;
1012 	return freq == clamp_val(freq, policy->min, policy->max);
1015 static inline int cpufreq_frequency_table_target(struct cpufreq_policy *policy,
1019 	bool efficiencies = policy->efficiencies_available &&
1026 	if (unlikely(policy->freq_table_sorted == CPUFREQ_TABLE_UNSORTED))
1027 		return cpufreq_table_index_unsorted(policy, target_freq,
1032 		idx = cpufreq_table_find_index_l(policy, target_freq,
1036 		idx = cpufreq_table_find_index_h(policy, target_freq,
1040 		idx = cpufreq_table_find_index_c(policy, target_freq,
1048 	/* Limit frequency index to honor policy->min/max */
1049 	if (!cpufreq_is_in_limits(policy, idx) && efficiencies) {
1057 static inline int cpufreq_table_count_valid_entries(const struct cpufreq_policy *policy)
1062 	if (unlikely(!policy->freq_table))
1065 	cpufreq_for_each_valid_entry(pos, policy->freq_table)
1073  * @policy:	the &struct cpufreq_policy containing the inefficient frequency
1082 cpufreq_table_set_inefficient(struct cpufreq_policy *policy,
1088 	if (policy->freq_table_sorted == CPUFREQ_TABLE_UNSORTED)
1091 	cpufreq_for_each_valid_entry(pos, policy->freq_table) {
1094 			policy->efficiencies_available = true;
1167 static inline bool policy_has_boost_freq(struct cpufreq_policy *policy)
1173 cpufreq_table_set_inefficient(struct cpufreq_policy *policy,
1202 int cpufreq_table_validate_and_sort(struct cpufreq_policy *policy);
1205 void cpufreq_generic_init(struct cpufreq_policy *policy,
1209 static inline void cpufreq_register_em_with_opp(struct cpufreq_policy *policy)
1211 	dev_pm_opp_of_register_em(get_cpu_device(policy->cpu),
1212 				  policy->related_cpus);