Definition:

struct devfreq_dev_status {    unsigned long total_time;    unsigned long busy_time;    unsigned long current_frequency;    void *private_data;};

Members

total_time

The total time represented by this instance ofdevfreq_dev_status

busy_time

The time that the device was working among thetotal_time.

current_frequency

The operating frequency.

private_data

An entry not specified by the devfreq framework.A device and a specific governor may have theirown protocol with private_data. However, becausethis is governor-specific, a governor using thiswill be only compatible with devices aware of it.

Definition:

struct devfreq_dev_profile {    unsigned long initial_freq;    unsigned int polling_ms;    enum devfreq_timer timer;    int (*target)(struct device *dev, unsigned long *freq, u32 flags);    int (*get_dev_status)(struct device *dev, struct devfreq_dev_status *stat);    int (*get_cur_freq)(struct device *dev, unsigned long *freq);    void (*exit)(struct device *dev);    unsigned long *freq_table;    unsigned int max_state;    bool is_cooling_device;    const struct attribute_group **dev_groups;};

Members

initial_freq

The operating frequency whendevfreq_add_device() iscalled.

polling_ms

The polling interval in ms. 0 disables polling.

timer

Timer type is either deferrable or delayed timer.

target

The device should set its operating frequency atfreq or lowest-upper-than-freq value. If freq ishigher than any operable frequency, set maximum.Before returning, target function should setfreq at the current frequency.The “flags” parameter’s possible values areexplained above with “DEVFREQ_FLAG_*” macros.

get_dev_status

The device should provide the current performancestatus to devfreq. Governors are recommended not touse this directly. Instead, governors are recommendedto usedevfreq_update_stats() along withdevfreq.last_status.

get_cur_freq

The device should provide the current frequencyat which it is operating.

exit

An optional callback that is called when devfreqis removing the devfreq object due to error orfromdevfreq_remove_device() call. If the userhas registered devfreq->nb at a notifier-head,this is the time to unregister it.

freq_table

Optional list of frequencies to support statisticsand freq_table must be generated in ascending order.

max_state

The size of freq_table.

is_cooling_device

A self-explanatory boolean giving the device acooling effect property.

dev_groups

Optional device-specific sysfs attribute groups that tobe attached to the devfreq device.

Definition:

struct devfreq_stats {    unsigned int total_trans;    unsigned int *trans_table;    u64 *time_in_state;    u64 last_update;};

Members

total_trans

Number of devfreq transitions.

trans_table

Statistics of devfreq transitions.

time_in_state

Statistics of devfreq states.

last_update

The last time stats were updated.

Definition:

struct devfreq {    struct list_head node;    struct mutex lock;    struct device dev;    struct devfreq_dev_profile *profile;    const struct devfreq_governor *governor;    struct opp_table *opp_table;    struct notifier_block nb;    struct delayed_work work;    unsigned long *freq_table;    unsigned int max_state;    unsigned long previous_freq;    struct devfreq_dev_status last_status;    void *data;    void *governor_data;    struct dev_pm_qos_request user_min_freq_req;    struct dev_pm_qos_request user_max_freq_req;    unsigned long scaling_min_freq;    unsigned long scaling_max_freq;    bool stop_polling;    unsigned long suspend_freq;    unsigned long resume_freq;    atomic_t suspend_count;    struct devfreq_stats stats;    struct srcu_notifier_head transition_notifier_list;    struct thermal_cooling_device *cdev;    struct notifier_block nb_min;    struct notifier_block nb_max;};

Members

node

list node - contains the devices with devfreq that have beenregistered.

lock

a mutex to protect accessing devfreq.

dev

device registered by devfreq class. dev.parent is the deviceusing devfreq.

profile

device-specific devfreq profile

governor

method how to choose frequency based on the usage.

opp_table

Reference to OPP table of dev.parent, if one exists.

nb

notifier block used to notify devfreq object that it shouldreevaluate operable frequencies. Devfreq users may usedevfreq.nb to the corresponding register notifier call chain.

work

delayed work for load monitoring.

freq_table

current frequency table used by the devfreq driver.

max_state

count of entry present in the frequency table.

previous_freq

previously configured frequency value.

last_status

devfreq user device info, performance statistics

data

devfreq driver pass to governors, governor should not change it.

governor_data

private data for governors, devfreq core doesn’t touch it.

user_min_freq_req

PM QoS minimum frequency request from user (via sysfs)

user_max_freq_req

PM QoS maximum frequency request from user (via sysfs)

scaling_min_freq

Limit minimum frequency requested by OPP interface

scaling_max_freq

Limit maximum frequency requested by OPP interface

stop_polling

devfreq polling status of a device.

suspend_freq

frequency of a device set during suspend phase.

resume_freq

frequency of a device set in resume phase.

suspend_count

suspend requests counter for a device.

stats

Statistics of devfreq device behavior

transition_notifier_list

list head of DEVFREQ_TRANSITION_NOTIFIER notifier

cdev

Cooling device pointer if the devfreq has cooling property

nb_min

Notifier block for DEV_PM_QOS_MIN_FREQUENCY

nb_max

Notifier block for DEV_PM_QOS_MAX_FREQUENCY

Definition:

struct devfreq_simple_ondemand_data {    unsigned int upthreshold;    unsigned int downdifferential;};

Members

upthreshold

If the load is over this value, the frequency jumps.Specify 0 to use the default. Valid value = 0 to 100.

downdifferential

If the load is under upthreshold - downdifferential,the governor may consider slowing the frequency down.Specify 0 to use the default. Valid value = 0 to 100.downdifferential < upthreshold must hold.

Definition:

struct devfreq_passive_data {    struct devfreq *parent;    int (*get_target_freq)(struct devfreq *this, unsigned long *freq);    enum devfreq_parent_dev_type parent_type;    struct devfreq *this;    struct notifier_block nb;    struct list_head cpu_data_list;};

Members

parent

the devfreq instance of parent device.

get_target_freq

Optional callback, Returns desired operating frequencyfor the device using passive governor. That is calledwhen passive governor should decide the next frequencyby using the new frequency of parent devfreq deviceusing governors except for passive governor.If the devfreq device has the specific method to decidethe next frequency, should use this callback.

parent_type

the parent type of the device.

this

the devfreq instance of own device.

nb

the notifier block for DEVFREQ_TRANSITION_NOTIFIER orCPUFREQ_TRANSITION_NOTIFIER list.

cpu_data_list

the list of cpu frequency data for all cpufreq_policy.

Definition:

struct devfreq_event_dev {    struct list_head node;    struct device dev;    struct mutex lock;    u32 enable_count;    const struct devfreq_event_desc *desc;};

Members

node

Contain the devfreq-event device that have been registered.

dev

the device registered by devfreq-event class. dev.parent isthe device using devfreq-event.

lock

a mutex to protect accessing devfreq-event.

enable_count

the number of enable function have been called.

desc

the description for devfreq-event device.

Definition:

struct devfreq_event_data {    unsigned long load_count;    unsigned long total_count;};

Members

load_count

load count of devfreq-event device for the given period.

total_count

total count of devfreq-event device for the given period.each count may represent a clock cycle, a time unit(ns/us/...), or anything the device driver wants.Generally, utilization is load_count / total_count.

Definition:

struct devfreq_event_ops {    int (*enable)(struct devfreq_event_dev *edev);    int (*disable)(struct devfreq_event_dev *edev);    int (*reset)(struct devfreq_event_dev *edev);    int (*set_event)(struct devfreq_event_dev *edev);    int (*get_event)(struct devfreq_event_dev *edev, struct devfreq_event_data *edata);};

Members

enable

Enable the devfreq-event device.

disable

Disable the devfreq-event device.

reset

Reset all setting of the devfreq-event device.

set_event

Set the specific event type for the devfreq-event device.

get_event

Get the result of the devfreq-event devie with specificevent type.

Definition:

struct devfreq_event_desc {    const char *name;    u32 event_type;    void *driver_data;    const struct devfreq_event_ops *ops;};

Members

name

the name of devfreq-event device.

event_type

the type of the event determined and used by driver

driver_data

the private data for devfreq-event driver.

ops

the operation to control devfreq-event device.

Parameters

structdevfreq*devfreq

the devfreq instance

unsignedlong*min_freq

the min frequency

unsignedlong*max_freq

the max frequency

Description

This takes into consideration all constraints.

Parameters

structdevfreq*devfreq

the devfreq instance

unsignedlongfreq

the update target frequency

Parameters

structdevfreq*devfreq

the devfreq instance.

unsignedlongfreq

the new frequency of parent device. This argumentis only used for devfreq device using passive governor.

Note

Lock devfreq->lock before calling devfreq_update_target. This function

should be only used by bothupdate_devfreq() and devfreq governors.

Parameters

structdevfreq*devfreq

the devfreq instance.

Note

Lock devfreq->lock before calling update_devfreq

This function is exported for governors.

Parameters

structdevfreq*devfreq

the devfreq instance.

Description

Helper function for starting devfreq device load monitoring. By default,deferrable timer is used for load monitoring. But the users can change thisbehavior using the “timer” type in devfreq_dev_profile. This function will becalled by devfreq governor in response to the DEVFREQ_GOV_START eventgenerated while adding a device to the devfreq framework.

Parameters

structdevfreq*devfreq

the devfreq instance.

Description

Helper function to stop devfreq device load monitoring. Functionto be called from governor in response to DEVFREQ_GOV_STOPevent when device is removed from devfreq framework.

Parameters

structdevfreq*devfreq

the devfreq instance.

Description

Helper function to suspend devfreq device load monitoring. Functionto be called from governor in response to DEVFREQ_GOV_SUSPENDevent or when polling interval is set to zero.

Note

Though this function is same asdevfreq_monitor_stop(),intentionally kept separate to provide hooks for collectingtransition statistics.

Parameters

structdevfreq*devfreq

the devfreq instance.

Description

Helper function to resume devfreq device load monitoring. Functionto be called from governor in response to DEVFREQ_GOV_RESUMEevent or when polling interval is set to non-zero.

Parameters

structdevfreq*devfreq

the devfreq instance.

unsignedint*delay

new polling interval to be set.

Description

Helper function to set new load monitoring polling interval. Functionto be called from governor in response to DEVFREQ_GOV_UPDATE_INTERVAL event.

Parameters

structdevice*dev

the device to add devfreq feature.

structdevfreq_dev_profile*profile

device-specific profile to run devfreq.

constchar*governor_name

name of the policy to choose frequency.

void*data

devfreq driver pass to governors, governor should not change it.

Parameters

structdevfreq*devfreq

the devfreq instance to be removed

Description

The opposite ofdevfreq_add_device().

Parameters

structdevice*dev

the device to add devfreq feature.

structdevfreq_dev_profile*profile

device-specific profile to run devfreq.

constchar*governor_name

name of the policy to choose frequency.

void*data

devfreq driver pass to governors, governor should not change it.

Description

This function manages automatically the memory of devfreq device using deviceresource management and simplify the free operation for memory of devfreqdevice.

Parameters

structdevice*dev

the device from which to remove devfreq feature.

structdevfreq*devfreq

the devfreq instance to be removed

Parameters

structdevfreq*devfreq

the devfreq instance to be suspended

Description

This function is intended to be called by the pm callbacks(e.g., runtime_suspend, suspend) of the device driver thatholds the devfreq.

Parameters

structdevfreq*devfreq

the devfreq instance to be resumed

Description

This function is intended to be called by the pm callbacks(e.g., runtime_resume, resume) of the device driver thatholds the devfreq.

Parameters

structdevfreq_governor*governor

the devfreq governor to be added

Parameters

structdevice*dev

device which adds devfreq governor

structdevfreq_governor*governor

the devfreq governor to be added

Description

This is a resource-managed variant ofdevfreq_add_governor().

Parameters

structdevfreq_governor*governor

the devfreq governor to be removed

Parameters

structdevice*dev

The devfreq user device. (parent of devfreq)

unsignedlong*freq

The frequency given to target function

u32flags

Flags handed from devfreq framework.

Description

The callers are required to calldev_pm_opp_put() for the returned OPP afteruse.

Parameters

structdevice*dev

The devfreq user device. (parent of devfreq)

structdevfreq*devfreq

The devfreq object.

Parameters

structdevice*dev

The devfreq user device. (parent of devfreq)

structdevfreq*devfreq

The devfreq object.

Description

Atexit() callback of devfreq_dev_profile, this must be included ifdevfreq_recommended_opp is used.

Parameters

structdevice*dev

The devfreq user device. (parent of devfreq)

structdevfreq*devfreq

The devfreq object.

Parameters

structdevice*dev

The devfreq user device. (parent of devfreq)

structdevfreq*devfreq

The devfreq object.

Parameters

structdevfreq*devfreq

The devfreq object.

structnotifier_block*nb

The notifier block to register.

unsignedintlist

DEVFREQ_TRANSITION_NOTIFIER.

Parameters

structdevice*dev

The devfreq user device. (parent of devfreq)

structdevfreq*devfreq

The devfreq object.

structnotifier_block*nb

The notifier block to be unregistered.

unsignedintlist

DEVFREQ_TRANSITION_NOTIFIER.

Description

• Resource-manageddevfreq_register_notifier()

Parameters

structdevice*dev

The devfreq user device. (parent of devfreq)

structdevfreq*devfreq

The devfreq object.

structnotifier_block*nb

The notifier block to be unregistered.

unsignedintlist

DEVFREQ_TRANSITION_NOTIFIER.

Description

• Resource-manageddevfreq_unregister_notifier()

Parameters

structdevfreq_event_dev*edev

the devfreq-event device

Description

Note that this function increase the enable_count and enable thedevfreq-event device. The devfreq-event device should be enabled beforeusing it by devfreq device.

Parameters

structdevfreq_event_dev*edev

the devfreq-event device

Description

Note that this function decrease the enable_count and disable thedevfreq-event device. After the devfreq-event device is disabled,devfreq device can’t use the devfreq-event device for get/set/resetoperations.

Parameters

structdevfreq_event_dev*edev

the devfreq-event device

Description

Note that this function check whether devfreq-event dev is enabled or not.If return true, the devfreq-event dev is enabeld. If return false, thedevfreq-event dev is disabled.

Parameters

structdevfreq_event_dev*edev

the devfreq-event device

Description

Note that this function set the event to the devfreq-event device to startfor getting the event data which could be various event type.

Parameters

structdevfreq_event_dev*edev

the devfreq-event device

structdevfreq_event_data*edata

the calculated data of devfreq-event device

Description

Note that this function get the calculated event data from devfreq-event devafter stoping the progress of whole sequence of devfreq-event dev.

Parameters

structdevfreq_event_dev*edev

the devfreq-event device

Description

Note that this function stop all operations of devfreq-event dev and resetthe current event data to make the devfreq-event device into initial state.

Parameters

structdevice*dev

the pointer to the given device

constchar*phandle_name

name of property holding a phandle value

intindex

the index into list of devfreq-event device

Description

Note that this function return the pointer of devfreq-event device.

Parameters

structdevice*dev

the pointer to the given device

constchar*phandle_name

name of property holding a phandle value

Description

Note that this function return the count of devfreq-event devices.

Parameters

structdevice*dev

the device owning the devfreq-event device being created

structdevfreq_event_desc*desc

the devfreq-event device’s descriptor which include essentialdata for devfreq-event device.

Description

Note that this function add new devfreq-event device to devfreq-event classlist and register the device of the devfreq-event device.

Parameters

structdevfreq_event_dev*edev

the devfreq-event device

Description

Note that this function removes the registered devfreq-event device.

Parameters

structdevice*dev

the device owning the devfreq-event device being created

structdevfreq_event_desc*desc

the devfreq-event device’s descriptor which include essentialdata for devfreq-event device.

Description

Note that this function manages automatically the memory of devfreq-eventdevice using device resource management and simplify the free operationfor memory of devfreq-event device.

Parameters

structdevice*dev

the device owning the devfreq-event device being created

structdevfreq_event_dev*edev

the devfreq-event device

Description

Note that this function manages automatically the memory of devfreq-eventdevice using device resource management.