mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-09-12 05:48:40 +00:00
5f1a9066fc
DEVFREQ supports the default governors like performance, simple_ondemand and
also allows the devfreq driver to add their own governor like tegra30-devfreq.c
according to their requirement. In result, some sysfs attributes are useful
or not useful. Prior to that the user can access all sysfs attributes
regardless of the available attributes.
So, clarify the access permission of sysfs attributes according to governor.
When adding the devfreq governor, can specify the available attribute
information by using DEVFREQ_GOV_ATTR_* constant variable. The user can
read or write the sysfs attributes in accordance to the specified attributes.
When adding the governor, can add the following attributes
according to the governor feature.
[Definition for speific sysfs attributes]
- DEVFREQ_GOV_ATTR_POLLING_INTERVAL to update polling interval for timer.
: /sys/class/devfreq/[devfreq dev name]/polling_interval
- DEVFREQ_GOV_ATTR_TIMER to change the type of timer on either deferrable
or dealyed timer.
: /sys/class/devfreq/[devfreq dev name]/timer
And all devfreq governors have to support the following common attributes.
The common attributes are added to devfreq class by default.
- governor
- available_governors
- available_frequencies
- cur_freq
- target_freq
- min_freq
- max_freq
- trans_stat
[Table of governor attribute flags for devfreq governors]
------------------------------------------------------------------------------
| simple | perfor | power | user | passive | tegra30
| ondemand | mance | save | space| |
------------------------------------------------------------------------------
governor | O | O | O | O | O | O
available_governors | O | O | O | O | O | O
available_frequencies | O | O | O | O | O | O
cur_freq | O | O | O | O | O | O
target_freq | O | O | O | O | O | O
min_freq | O | O | O | O | O | O
max_freq | O | O | O | O | O | O
trans_stat | O | O | O | O | O | O
--------------------------------------------------------
polling_interval | O | X | X | X | X | O
timer | O | X | X | X | X | X
------------------------------------------------------------------------------
Reviewed-by: Dmitry Osipenko <digetx@gmail.com>
Tested-by: Dmitry Osipenko <digetx@gmail.com>
Signed-off-by: Chanwoo Choi <cw00.choi@samsung.com>
94 lines
3.2 KiB
C
94 lines
3.2 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
/*
|
|
* governor.h - internal header for devfreq governors.
|
|
*
|
|
* Copyright (C) 2011 Samsung Electronics
|
|
* MyungJoo Ham <myungjoo.ham@samsung.com>
|
|
*
|
|
* This header is for devfreq governors in drivers/devfreq/
|
|
*/
|
|
|
|
#ifndef _GOVERNOR_H
|
|
#define _GOVERNOR_H
|
|
|
|
#include <linux/devfreq.h>
|
|
|
|
#define to_devfreq(DEV) container_of((DEV), struct devfreq, dev)
|
|
|
|
/* Devfreq events */
|
|
#define DEVFREQ_GOV_START 0x1
|
|
#define DEVFREQ_GOV_STOP 0x2
|
|
#define DEVFREQ_GOV_UPDATE_INTERVAL 0x3
|
|
#define DEVFREQ_GOV_SUSPEND 0x4
|
|
#define DEVFREQ_GOV_RESUME 0x5
|
|
|
|
#define DEVFREQ_MIN_FREQ 0
|
|
#define DEVFREQ_MAX_FREQ ULONG_MAX
|
|
|
|
/*
|
|
* 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 BIT(0)
|
|
#define DEVFREQ_GOV_FLAG_IRQ_DRIVEN BIT(1)
|
|
|
|
/*
|
|
* Definition of governor attribute flags except for common sysfs attributes
|
|
* - DEVFREQ_GOV_ATTR_POLLING_INTERVAL
|
|
* : Indicate polling_interal sysfs attribute
|
|
* - DEVFREQ_GOV_ATTR_TIMER
|
|
* : Indicate timer sysfs attribute
|
|
*/
|
|
#define DEVFREQ_GOV_ATTR_POLLING_INTERVAL BIT(0)
|
|
#define DEVFREQ_GOV_ATTR_TIMER BIT(1)
|
|
|
|
/**
|
|
* 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).
|
|
* If no_central_polling is set, this callback is called
|
|
* only with update_devfreq() notified by OPP.
|
|
* @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 {
|
|
struct list_head node;
|
|
|
|
const char name[DEVFREQ_NAME_LEN];
|
|
const u64 attrs;
|
|
const u64 flags;
|
|
int (*get_target_freq)(struct devfreq *this, unsigned long *freq);
|
|
int (*event_handler)(struct devfreq *devfreq,
|
|
unsigned int event, void *data);
|
|
};
|
|
|
|
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 devfreq_update_status(struct devfreq *devfreq, unsigned long freq);
|
|
int devfreq_update_target(struct devfreq *devfreq, unsigned long freq);
|
|
|
|
static inline int devfreq_update_stats(struct devfreq *df)
|
|
{
|
|
return df->profile->get_dev_status(df->dev.parent, &df->last_status);
|
|
}
|
|
#endif /* _GOVERNOR_H */
|