/* SPDX-License-Identifier: GPL-2.0-only */ /* * governor.h - internal header for devfreq governors. * * Copyright (C) 2011 Samsung Electronics * MyungJoo Ham <[email protected]> * * This header is for devfreq governors in drivers/devfreq/ */ #ifndef _GOVERNOR_H #define _GOVERNOR_H #include <linux/devfreq.h> #define DEVFREQ_NAME_LEN … #define to_devfreq(DEV) … /* Devfreq events */ #define DEVFREQ_GOV_START … #define DEVFREQ_GOV_STOP … #define DEVFREQ_GOV_UPDATE_INTERVAL … #define DEVFREQ_GOV_SUSPEND … #define DEVFREQ_GOV_RESUME … #define DEVFREQ_MIN_FREQ … #define DEVFREQ_MAX_FREQ … /* * Definition of the governor feature flags * - DEVFREQ_GOV_FLAG_IMMUTABLE * : This governor is never changeable to other governors. * - DEVFREQ_GOV_FLAG_IRQ_DRIVEN * : The devfreq won't schedule the work for this governor. */ #define DEVFREQ_GOV_FLAG_IMMUTABLE … #define DEVFREQ_GOV_FLAG_IRQ_DRIVEN … /* * Definition of governor attribute flags except for common sysfs attributes * - DEVFREQ_GOV_ATTR_POLLING_INTERVAL * : Indicate polling_interval sysfs attribute * - DEVFREQ_GOV_ATTR_TIMER * : Indicate timer sysfs attribute */ #define DEVFREQ_GOV_ATTR_POLLING_INTERVAL … #define DEVFREQ_GOV_ATTR_TIMER … /** * struct devfreq_cpu_data - Hold the per-cpu data * @node: list node * @dev: reference to cpu device. * @first_cpu: the cpumask of the first cpu of a policy. * @opp_table: reference to cpu opp table. * @cur_freq: the current frequency of the cpu. * @min_freq: the min frequency of the cpu. * @max_freq: the max frequency of the cpu. * * This structure stores the required cpu_data of a cpu. * This is auto-populated by the governor. */ struct devfreq_cpu_data { … }; /** * struct devfreq_governor - Devfreq policy governor * @node: list node - contains registered devfreq governors * @name: Governor's name * @attrs: Governor's sysfs attribute flags * @flags: Governor's feature flags * @get_target_freq: Returns desired operating frequency for the device. * Basically, get_target_freq will run * devfreq_dev_profile.get_dev_status() to get the * status of the device (load = busy_time / total_time). * @event_handler: Callback for devfreq core framework to notify events * to governors. Events include per device governor * init and exit, opp changes out of devfreq, suspend * and resume of per device devfreq during device idle. * * Note that the callbacks are called with devfreq->lock locked by devfreq. */ struct devfreq_governor { … }; void devfreq_monitor_start(struct devfreq *devfreq); void devfreq_monitor_stop(struct devfreq *devfreq); void devfreq_monitor_suspend(struct devfreq *devfreq); void devfreq_monitor_resume(struct devfreq *devfreq); void devfreq_update_interval(struct devfreq *devfreq, unsigned int *delay); int devfreq_add_governor(struct devfreq_governor *governor); int devfreq_remove_governor(struct devfreq_governor *governor); int devm_devfreq_add_governor(struct device *dev, struct devfreq_governor *governor); int devfreq_update_status(struct devfreq *devfreq, unsigned long freq); int devfreq_update_target(struct devfreq *devfreq, unsigned long freq); void devfreq_get_freq_range(struct devfreq *devfreq, unsigned long *min_freq, unsigned long *max_freq); static inline int devfreq_update_stats(struct devfreq *df) { … } #endif /* _GOVERNOR_H */