mirror of
https://github.com/edk2-porting/linux-next.git
synced 2024-12-26 06:04:14 +08:00
8ea229511e
This extends the sysfs interface for thermal cooling devices and exposes some pretty useful statistics. These statistics have proven to be quite useful specially while doing benchmarks related to the task scheduler, where we want to make sure that nothing has disrupted the test, specially the cooling device which may have put constraints on the CPUs. The information exposed here tells us to what extent the CPUs were constrained by the thermal framework. The write-only "reset" file is used to reset the statistics. The read-only "time_in_state_ms" file shows the time (in msec) spent by the device in the respective cooling states, and it prints one line per cooling state. The read-only "total_trans" file shows single positive integer value showing the total number of cooling state transitions the device has gone through since the time the cooling device is registered or the time when statistics were reset last. The read-only "trans_table" file shows a two dimensional matrix, where an entry <i,j> (row i, column j) represents the number of transitions from State_i to State_j. This is how the directory structure looks like for a single cooling device: $ ls -R /sys/class/thermal/cooling_device0/ /sys/class/thermal/cooling_device0/: cur_state max_state power stats subsystem type uevent /sys/class/thermal/cooling_device0/power: autosuspend_delay_ms runtime_active_time runtime_suspended_time control runtime_status /sys/class/thermal/cooling_device0/stats: reset time_in_state_ms total_trans trans_table This is tested on ARM 64-bit Hisilicon hikey620 board running Ubuntu and ARM 64-bit Hisilicon hikey960 board running Android. Signed-off-by: Viresh Kumar <viresh.kumar@linaro.org> Signed-off-by: Zhang Rui <rui.zhang@intel.com>
165 lines
5.9 KiB
C
165 lines
5.9 KiB
C
/*
|
|
* thermal_core.h
|
|
*
|
|
* Copyright (C) 2012 Intel Corp
|
|
* Author: Durgadoss R <durgadoss.r@intel.com>
|
|
*
|
|
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; version 2 of the License.
|
|
*
|
|
* This program is distributed in the hope that it will be useful, but
|
|
* WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
* 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
|
|
*
|
|
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
*/
|
|
|
|
#ifndef __THERMAL_CORE_H__
|
|
#define __THERMAL_CORE_H__
|
|
|
|
#include <linux/device.h>
|
|
#include <linux/thermal.h>
|
|
|
|
/* Initial state of a cooling device during binding */
|
|
#define THERMAL_NO_TARGET -1UL
|
|
|
|
/*
|
|
* This structure is used to describe the behavior of
|
|
* a certain cooling device on a certain trip point
|
|
* in a certain thermal zone
|
|
*/
|
|
struct thermal_instance {
|
|
int id;
|
|
char name[THERMAL_NAME_LENGTH];
|
|
struct thermal_zone_device *tz;
|
|
struct thermal_cooling_device *cdev;
|
|
int trip;
|
|
bool initialized;
|
|
unsigned long upper; /* Highest cooling state for this trip point */
|
|
unsigned long lower; /* Lowest cooling state for this trip point */
|
|
unsigned long target; /* expected cooling state */
|
|
char attr_name[THERMAL_NAME_LENGTH];
|
|
struct device_attribute attr;
|
|
char weight_attr_name[THERMAL_NAME_LENGTH];
|
|
struct device_attribute weight_attr;
|
|
struct list_head tz_node; /* node in tz->thermal_instances */
|
|
struct list_head cdev_node; /* node in cdev->thermal_instances */
|
|
unsigned int weight; /* The weight of the cooling device */
|
|
};
|
|
|
|
#define to_thermal_zone(_dev) \
|
|
container_of(_dev, struct thermal_zone_device, device)
|
|
|
|
#define to_cooling_device(_dev) \
|
|
container_of(_dev, struct thermal_cooling_device, device)
|
|
|
|
int thermal_register_governor(struct thermal_governor *);
|
|
void thermal_unregister_governor(struct thermal_governor *);
|
|
void thermal_zone_device_rebind_exception(struct thermal_zone_device *,
|
|
const char *, size_t);
|
|
void thermal_zone_device_unbind_exception(struct thermal_zone_device *,
|
|
const char *, size_t);
|
|
int thermal_zone_device_set_policy(struct thermal_zone_device *, char *);
|
|
int thermal_build_list_of_policies(char *buf);
|
|
|
|
/* sysfs I/F */
|
|
int thermal_zone_create_device_groups(struct thermal_zone_device *, int);
|
|
void thermal_zone_destroy_device_groups(struct thermal_zone_device *);
|
|
void thermal_cooling_device_setup_sysfs(struct thermal_cooling_device *);
|
|
void thermal_cooling_device_destroy_sysfs(struct thermal_cooling_device *cdev);
|
|
/* used only at binding time */
|
|
ssize_t
|
|
thermal_cooling_device_trip_point_show(struct device *,
|
|
struct device_attribute *, char *);
|
|
ssize_t thermal_cooling_device_weight_show(struct device *,
|
|
struct device_attribute *, char *);
|
|
|
|
ssize_t thermal_cooling_device_weight_store(struct device *,
|
|
struct device_attribute *,
|
|
const char *, size_t);
|
|
|
|
#ifdef CONFIG_THERMAL_STATISTICS
|
|
void thermal_cooling_device_stats_update(struct thermal_cooling_device *cdev,
|
|
unsigned long new_state);
|
|
#else
|
|
static inline void
|
|
thermal_cooling_device_stats_update(struct thermal_cooling_device *cdev,
|
|
unsigned long new_state) {}
|
|
#endif /* CONFIG_THERMAL_STATISTICS */
|
|
|
|
#ifdef CONFIG_THERMAL_GOV_STEP_WISE
|
|
int thermal_gov_step_wise_register(void);
|
|
void thermal_gov_step_wise_unregister(void);
|
|
#else
|
|
static inline int thermal_gov_step_wise_register(void) { return 0; }
|
|
static inline void thermal_gov_step_wise_unregister(void) {}
|
|
#endif /* CONFIG_THERMAL_GOV_STEP_WISE */
|
|
|
|
#ifdef CONFIG_THERMAL_GOV_FAIR_SHARE
|
|
int thermal_gov_fair_share_register(void);
|
|
void thermal_gov_fair_share_unregister(void);
|
|
#else
|
|
static inline int thermal_gov_fair_share_register(void) { return 0; }
|
|
static inline void thermal_gov_fair_share_unregister(void) {}
|
|
#endif /* CONFIG_THERMAL_GOV_FAIR_SHARE */
|
|
|
|
#ifdef CONFIG_THERMAL_GOV_BANG_BANG
|
|
int thermal_gov_bang_bang_register(void);
|
|
void thermal_gov_bang_bang_unregister(void);
|
|
#else
|
|
static inline int thermal_gov_bang_bang_register(void) { return 0; }
|
|
static inline void thermal_gov_bang_bang_unregister(void) {}
|
|
#endif /* CONFIG_THERMAL_GOV_BANG_BANG */
|
|
|
|
#ifdef CONFIG_THERMAL_GOV_USER_SPACE
|
|
int thermal_gov_user_space_register(void);
|
|
void thermal_gov_user_space_unregister(void);
|
|
#else
|
|
static inline int thermal_gov_user_space_register(void) { return 0; }
|
|
static inline void thermal_gov_user_space_unregister(void) {}
|
|
#endif /* CONFIG_THERMAL_GOV_USER_SPACE */
|
|
|
|
#ifdef CONFIG_THERMAL_GOV_POWER_ALLOCATOR
|
|
int thermal_gov_power_allocator_register(void);
|
|
void thermal_gov_power_allocator_unregister(void);
|
|
#else
|
|
static inline int thermal_gov_power_allocator_register(void) { return 0; }
|
|
static inline void thermal_gov_power_allocator_unregister(void) {}
|
|
#endif /* CONFIG_THERMAL_GOV_POWER_ALLOCATOR */
|
|
|
|
/* device tree support */
|
|
#ifdef CONFIG_THERMAL_OF
|
|
int of_parse_thermal_zones(void);
|
|
void of_thermal_destroy_zones(void);
|
|
int of_thermal_get_ntrips(struct thermal_zone_device *);
|
|
bool of_thermal_is_trip_valid(struct thermal_zone_device *, int);
|
|
const struct thermal_trip *
|
|
of_thermal_get_trip_points(struct thermal_zone_device *);
|
|
#else
|
|
static inline int of_parse_thermal_zones(void) { return 0; }
|
|
static inline void of_thermal_destroy_zones(void) { }
|
|
static inline int of_thermal_get_ntrips(struct thermal_zone_device *tz)
|
|
{
|
|
return 0;
|
|
}
|
|
static inline bool of_thermal_is_trip_valid(struct thermal_zone_device *tz,
|
|
int trip)
|
|
{
|
|
return false;
|
|
}
|
|
static inline const struct thermal_trip *
|
|
of_thermal_get_trip_points(struct thermal_zone_device *tz)
|
|
{
|
|
return NULL;
|
|
}
|
|
#endif
|
|
|
|
#endif /* __THERMAL_CORE_H__ */
|