mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-10-30 08:02:30 +00:00
e6e238c38b
This patch adds support to set the emulated temperature method in thermal zone (sensor). After setting this feature thermal zone may report this temperature and not the actual temperature. The emulation implementation may be based on sensor capability through platform specific handler or pure software emulation if no platform handler defined. This is useful in debugging different temperature threshold and its associated cooling action. Critical threshold's cannot be emulated. Writing 0 on this node should disable emulation. Signed-off-by: Amit Daniel Kachhap <amit.daniel@samsung.com> Acked-by: Kukjin Kim <kgene.kim@samsung.com> Signed-off-by: Zhang Rui <rui.zhang@intel.com>
261 lines
8.2 KiB
C
261 lines
8.2 KiB
C
/*
|
|
* thermal.h ($Revision: 0 $)
|
|
*
|
|
* Copyright (C) 2008 Intel Corp
|
|
* Copyright (C) 2008 Zhang Rui <rui.zhang@intel.com>
|
|
* Copyright (C) 2008 Sujith Thomas <sujith.thomas@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_H__
|
|
#define __THERMAL_H__
|
|
|
|
#include <linux/idr.h>
|
|
#include <linux/device.h>
|
|
#include <linux/workqueue.h>
|
|
|
|
#define THERMAL_TRIPS_NONE -1
|
|
#define THERMAL_MAX_TRIPS 12
|
|
#define THERMAL_NAME_LENGTH 20
|
|
|
|
/* No upper/lower limit requirement */
|
|
#define THERMAL_NO_LIMIT -1UL
|
|
|
|
/* Unit conversion macros */
|
|
#define KELVIN_TO_CELSIUS(t) (long)(((long)t-2732 >= 0) ? \
|
|
((long)t-2732+5)/10 : ((long)t-2732-5)/10)
|
|
#define CELSIUS_TO_KELVIN(t) ((t)*10+2732)
|
|
|
|
/* Adding event notification support elements */
|
|
#define THERMAL_GENL_FAMILY_NAME "thermal_event"
|
|
#define THERMAL_GENL_VERSION 0x01
|
|
#define THERMAL_GENL_MCAST_GROUP_NAME "thermal_mc_group"
|
|
|
|
/* Default Thermal Governor */
|
|
#if defined(CONFIG_THERMAL_DEFAULT_GOV_STEP_WISE)
|
|
#define DEFAULT_THERMAL_GOVERNOR "step_wise"
|
|
#elif defined(CONFIG_THERMAL_DEFAULT_GOV_FAIR_SHARE)
|
|
#define DEFAULT_THERMAL_GOVERNOR "fair_share"
|
|
#elif defined(CONFIG_THERMAL_DEFAULT_GOV_USER_SPACE)
|
|
#define DEFAULT_THERMAL_GOVERNOR "user_space"
|
|
#endif
|
|
|
|
struct thermal_zone_device;
|
|
struct thermal_cooling_device;
|
|
|
|
enum thermal_device_mode {
|
|
THERMAL_DEVICE_DISABLED = 0,
|
|
THERMAL_DEVICE_ENABLED,
|
|
};
|
|
|
|
enum thermal_trip_type {
|
|
THERMAL_TRIP_ACTIVE = 0,
|
|
THERMAL_TRIP_PASSIVE,
|
|
THERMAL_TRIP_HOT,
|
|
THERMAL_TRIP_CRITICAL,
|
|
};
|
|
|
|
enum thermal_trend {
|
|
THERMAL_TREND_STABLE, /* temperature is stable */
|
|
THERMAL_TREND_RAISING, /* temperature is raising */
|
|
THERMAL_TREND_DROPPING, /* temperature is dropping */
|
|
THERMAL_TREND_RAISE_FULL, /* apply highest cooling action */
|
|
THERMAL_TREND_DROP_FULL, /* apply lowest cooling action */
|
|
};
|
|
|
|
/* Events supported by Thermal Netlink */
|
|
enum events {
|
|
THERMAL_AUX0,
|
|
THERMAL_AUX1,
|
|
THERMAL_CRITICAL,
|
|
THERMAL_DEV_FAULT,
|
|
};
|
|
|
|
/* attributes of thermal_genl_family */
|
|
enum {
|
|
THERMAL_GENL_ATTR_UNSPEC,
|
|
THERMAL_GENL_ATTR_EVENT,
|
|
__THERMAL_GENL_ATTR_MAX,
|
|
};
|
|
#define THERMAL_GENL_ATTR_MAX (__THERMAL_GENL_ATTR_MAX - 1)
|
|
|
|
/* commands supported by the thermal_genl_family */
|
|
enum {
|
|
THERMAL_GENL_CMD_UNSPEC,
|
|
THERMAL_GENL_CMD_EVENT,
|
|
__THERMAL_GENL_CMD_MAX,
|
|
};
|
|
#define THERMAL_GENL_CMD_MAX (__THERMAL_GENL_CMD_MAX - 1)
|
|
|
|
struct thermal_zone_device_ops {
|
|
int (*bind) (struct thermal_zone_device *,
|
|
struct thermal_cooling_device *);
|
|
int (*unbind) (struct thermal_zone_device *,
|
|
struct thermal_cooling_device *);
|
|
int (*get_temp) (struct thermal_zone_device *, unsigned long *);
|
|
int (*get_mode) (struct thermal_zone_device *,
|
|
enum thermal_device_mode *);
|
|
int (*set_mode) (struct thermal_zone_device *,
|
|
enum thermal_device_mode);
|
|
int (*get_trip_type) (struct thermal_zone_device *, int,
|
|
enum thermal_trip_type *);
|
|
int (*get_trip_temp) (struct thermal_zone_device *, int,
|
|
unsigned long *);
|
|
int (*set_trip_temp) (struct thermal_zone_device *, int,
|
|
unsigned long);
|
|
int (*get_trip_hyst) (struct thermal_zone_device *, int,
|
|
unsigned long *);
|
|
int (*set_trip_hyst) (struct thermal_zone_device *, int,
|
|
unsigned long);
|
|
int (*get_crit_temp) (struct thermal_zone_device *, unsigned long *);
|
|
int (*set_emul_temp) (struct thermal_zone_device *, unsigned long);
|
|
int (*get_trend) (struct thermal_zone_device *, int,
|
|
enum thermal_trend *);
|
|
int (*notify) (struct thermal_zone_device *, int,
|
|
enum thermal_trip_type);
|
|
};
|
|
|
|
struct thermal_cooling_device_ops {
|
|
int (*get_max_state) (struct thermal_cooling_device *, unsigned long *);
|
|
int (*get_cur_state) (struct thermal_cooling_device *, unsigned long *);
|
|
int (*set_cur_state) (struct thermal_cooling_device *, unsigned long);
|
|
};
|
|
|
|
struct thermal_cooling_device {
|
|
int id;
|
|
char type[THERMAL_NAME_LENGTH];
|
|
struct device device;
|
|
void *devdata;
|
|
const struct thermal_cooling_device_ops *ops;
|
|
bool updated; /* true if the cooling device does not need update */
|
|
struct mutex lock; /* protect thermal_instances list */
|
|
struct list_head thermal_instances;
|
|
struct list_head node;
|
|
};
|
|
|
|
struct thermal_attr {
|
|
struct device_attribute attr;
|
|
char name[THERMAL_NAME_LENGTH];
|
|
};
|
|
|
|
struct thermal_zone_device {
|
|
int id;
|
|
char type[THERMAL_NAME_LENGTH];
|
|
struct device device;
|
|
struct thermal_attr *trip_temp_attrs;
|
|
struct thermal_attr *trip_type_attrs;
|
|
struct thermal_attr *trip_hyst_attrs;
|
|
void *devdata;
|
|
int trips;
|
|
int passive_delay;
|
|
int polling_delay;
|
|
int temperature;
|
|
int last_temperature;
|
|
int emul_temperature;
|
|
int passive;
|
|
unsigned int forced_passive;
|
|
const struct thermal_zone_device_ops *ops;
|
|
const struct thermal_zone_params *tzp;
|
|
struct thermal_governor *governor;
|
|
struct list_head thermal_instances;
|
|
struct idr idr;
|
|
struct mutex lock; /* protect thermal_instances list */
|
|
struct list_head node;
|
|
struct delayed_work poll_queue;
|
|
};
|
|
|
|
/* Structure that holds thermal governor information */
|
|
struct thermal_governor {
|
|
char name[THERMAL_NAME_LENGTH];
|
|
int (*throttle)(struct thermal_zone_device *tz, int trip);
|
|
struct list_head governor_list;
|
|
struct module *owner;
|
|
};
|
|
|
|
/* Structure that holds binding parameters for a zone */
|
|
struct thermal_bind_params {
|
|
struct thermal_cooling_device *cdev;
|
|
|
|
/*
|
|
* This is a measure of 'how effectively these devices can
|
|
* cool 'this' thermal zone. The shall be determined by platform
|
|
* characterization. This is on a 'percentage' scale.
|
|
* See Documentation/thermal/sysfs-api.txt for more information.
|
|
*/
|
|
int weight;
|
|
|
|
/*
|
|
* This is a bit mask that gives the binding relation between this
|
|
* thermal zone and cdev, for a particular trip point.
|
|
* See Documentation/thermal/sysfs-api.txt for more information.
|
|
*/
|
|
int trip_mask;
|
|
int (*match) (struct thermal_zone_device *tz,
|
|
struct thermal_cooling_device *cdev);
|
|
};
|
|
|
|
/* Structure to define Thermal Zone parameters */
|
|
struct thermal_zone_params {
|
|
char governor_name[THERMAL_NAME_LENGTH];
|
|
int num_tbps; /* Number of tbp entries */
|
|
struct thermal_bind_params *tbp;
|
|
};
|
|
|
|
struct thermal_genl_event {
|
|
u32 orig;
|
|
enum events event;
|
|
};
|
|
|
|
/* Function declarations */
|
|
struct thermal_zone_device *thermal_zone_device_register(const char *, int, int,
|
|
void *, const struct thermal_zone_device_ops *,
|
|
const struct thermal_zone_params *, int, int);
|
|
void thermal_zone_device_unregister(struct thermal_zone_device *);
|
|
|
|
int thermal_zone_bind_cooling_device(struct thermal_zone_device *, int,
|
|
struct thermal_cooling_device *,
|
|
unsigned long, unsigned long);
|
|
int thermal_zone_unbind_cooling_device(struct thermal_zone_device *, int,
|
|
struct thermal_cooling_device *);
|
|
void thermal_zone_device_update(struct thermal_zone_device *);
|
|
|
|
struct thermal_cooling_device *thermal_cooling_device_register(char *, void *,
|
|
const struct thermal_cooling_device_ops *);
|
|
void thermal_cooling_device_unregister(struct thermal_cooling_device *);
|
|
|
|
int get_tz_trend(struct thermal_zone_device *, int);
|
|
struct thermal_instance *get_thermal_instance(struct thermal_zone_device *,
|
|
struct thermal_cooling_device *, int);
|
|
void thermal_cdev_update(struct thermal_cooling_device *);
|
|
void notify_thermal_framework(struct thermal_zone_device *, int);
|
|
|
|
int thermal_register_governor(struct thermal_governor *);
|
|
void thermal_unregister_governor(struct thermal_governor *);
|
|
|
|
#ifdef CONFIG_NET
|
|
extern int thermal_generate_netlink_event(struct thermal_zone_device *tz,
|
|
enum events event);
|
|
#else
|
|
static int thermal_generate_netlink_event(struct thermal_zone_device *tz,
|
|
enum events event)
|
|
{
|
|
return 0;
|
|
}
|
|
#endif
|
|
|
|
#endif /* __THERMAL_H__ */
|