thermal.h 8.2 KB
Newer Older
Z
Zhang Rui 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29
/*
 *  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>
30
#include <linux/workqueue.h>
Z
Zhang Rui 已提交
31

D
Durgadoss R 已提交
32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
#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"

Z
Zhang Rui 已提交
49 50 51 52 53 54 55 56
/* 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
57

Z
Zhang Rui 已提交
58 59 60
struct thermal_zone_device;
struct thermal_cooling_device;

61 62 63 64 65 66 67 68 69 70 71 72
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,
};

73 74 75 76
enum thermal_trend {
	THERMAL_TREND_STABLE, /* temperature is stable */
	THERMAL_TREND_RAISING, /* temperature is raising */
	THERMAL_TREND_DROPPING, /* temperature is dropping */
77 78
	THERMAL_TREND_RAISE_FULL, /* apply highest cooling action */
	THERMAL_TREND_DROP_FULL, /* apply lowest cooling action */
79 80
};

D
Durgadoss R 已提交
81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104
/* 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)

Z
Zhang Rui 已提交
105 106 107 108 109
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 *);
110 111 112 113 114 115 116 117 118
	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 *);
119 120
	int (*set_trip_temp) (struct thermal_zone_device *, int,
			      unsigned long);
D
Durgadoss R 已提交
121 122 123 124
	int (*get_trip_hyst) (struct thermal_zone_device *, int,
			      unsigned long *);
	int (*set_trip_hyst) (struct thermal_zone_device *, int,
			      unsigned long);
125
	int (*get_crit_temp) (struct thermal_zone_device *, unsigned long *);
126
	int (*set_emul_temp) (struct thermal_zone_device *, unsigned long);
127 128
	int (*get_trend) (struct thermal_zone_device *, int,
			  enum thermal_trend *);
129 130
	int (*notify) (struct thermal_zone_device *, int,
		       enum thermal_trip_type);
Z
Zhang Rui 已提交
131 132 133
};

struct thermal_cooling_device_ops {
134 135 136
	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);
Z
Zhang Rui 已提交
137 138 139 140 141 142 143
};

struct thermal_cooling_device {
	int id;
	char type[THERMAL_NAME_LENGTH];
	struct device device;
	void *devdata;
A
Alan Cox 已提交
144
	const struct thermal_cooling_device_ops *ops;
145
	bool updated; /* true if the cooling device does not need update */
146
	struct mutex lock; /* protect thermal_instances list */
147
	struct list_head thermal_instances;
Z
Zhang Rui 已提交
148 149 150
	struct list_head node;
};

151 152 153 154 155
struct thermal_attr {
	struct device_attribute attr;
	char name[THERMAL_NAME_LENGTH];
};

Z
Zhang Rui 已提交
156 157 158 159
struct thermal_zone_device {
	int id;
	char type[THERMAL_NAME_LENGTH];
	struct device device;
160 161
	struct thermal_attr *trip_temp_attrs;
	struct thermal_attr *trip_type_attrs;
D
Durgadoss R 已提交
162
	struct thermal_attr *trip_hyst_attrs;
Z
Zhang Rui 已提交
163 164
	void *devdata;
	int trips;
165 166
	int passive_delay;
	int polling_delay;
167
	int temperature;
168
	int last_temperature;
169
	int emul_temperature;
170
	int passive;
171
	unsigned int forced_passive;
A
Alan Cox 已提交
172
	const struct thermal_zone_device_ops *ops;
173
	const struct thermal_zone_params *tzp;
174
	struct thermal_governor *governor;
175
	struct list_head thermal_instances;
Z
Zhang Rui 已提交
176
	struct idr idr;
177
	struct mutex lock; /* protect thermal_instances list */
Z
Zhang Rui 已提交
178
	struct list_head node;
179
	struct delayed_work poll_queue;
Z
Zhang Rui 已提交
180
};
181

182 183 184 185 186 187 188 189
/* 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;
};

190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213
/* 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 {
214
	char governor_name[THERMAL_NAME_LENGTH];
215 216 217 218
	int num_tbps;	/* Number of tbp entries */
	struct thermal_bind_params *tbp;
};

219 220 221 222
struct thermal_genl_event {
	u32 orig;
	enum events event;
};
Z
Zhang Rui 已提交
223

D
Durgadoss R 已提交
224
/* Function declarations */
225
struct thermal_zone_device *thermal_zone_device_register(const char *, int, int,
226 227
		void *, const struct thermal_zone_device_ops *,
		const struct thermal_zone_params *, int, int);
Z
Zhang Rui 已提交
228 229 230
void thermal_zone_device_unregister(struct thermal_zone_device *);

int thermal_zone_bind_cooling_device(struct thermal_zone_device *, int,
Z
Zhang Rui 已提交
231 232
				     struct thermal_cooling_device *,
				     unsigned long, unsigned long);
Z
Zhang Rui 已提交
233 234
int thermal_zone_unbind_cooling_device(struct thermal_zone_device *, int,
				       struct thermal_cooling_device *);
235
void thermal_zone_device_update(struct thermal_zone_device *);
D
Durgadoss R 已提交
236

Z
Zhang Rui 已提交
237
struct thermal_cooling_device *thermal_cooling_device_register(char *, void *,
A
Alan Cox 已提交
238
		const struct thermal_cooling_device_ops *);
Z
Zhang Rui 已提交
239
void thermal_cooling_device_unregister(struct thermal_cooling_device *);
240

241 242 243
int get_tz_trend(struct thermal_zone_device *, int);
struct thermal_instance *get_thermal_instance(struct thermal_zone_device *,
		struct thermal_cooling_device *, int);
244
void thermal_cdev_update(struct thermal_cooling_device *);
D
Durgadoss R 已提交
245
void notify_thermal_framework(struct thermal_zone_device *, int);
246

247 248 249
int thermal_register_governor(struct thermal_governor *);
void thermal_unregister_governor(struct thermal_governor *);

250
#ifdef CONFIG_NET
251 252
extern int thermal_generate_netlink_event(struct thermal_zone_device *tz,
						enum events event);
253
#else
254 255
static int thermal_generate_netlink_event(struct thermal_zone_device *tz,
						enum events event)
256 257 258 259
{
	return 0;
}
#endif
Z
Zhang Rui 已提交
260

261
#endif /* __THERMAL_H__ */