thermal.h 7.7 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"

49 50 51
/* Default Thermal Governor: Does Linear Throttling */
#define DEFAULT_THERMAL_GOVERNOR	"step_wise"

Z
Zhang Rui 已提交
52 53 54
struct thermal_zone_device;
struct thermal_cooling_device;

55 56 57 58 59 60 61 62 63 64 65 66
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,
};

67 68 69 70 71 72
enum thermal_trend {
	THERMAL_TREND_STABLE, /* temperature is stable */
	THERMAL_TREND_RAISING, /* temperature is raising */
	THERMAL_TREND_DROPPING, /* temperature is dropping */
};

D
Durgadoss R 已提交
73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96
/* 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 已提交
97 98 99 100 101
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 *);
102 103 104 105 106 107 108 109 110
	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 *);
111 112
	int (*set_trip_temp) (struct thermal_zone_device *, int,
			      unsigned long);
D
Durgadoss R 已提交
113 114 115 116
	int (*get_trip_hyst) (struct thermal_zone_device *, int,
			      unsigned long *);
	int (*set_trip_hyst) (struct thermal_zone_device *, int,
			      unsigned long);
117
	int (*get_crit_temp) (struct thermal_zone_device *, unsigned long *);
118 119
	int (*get_trend) (struct thermal_zone_device *, int,
			  enum thermal_trend *);
120 121
	int (*notify) (struct thermal_zone_device *, int,
		       enum thermal_trip_type);
Z
Zhang Rui 已提交
122 123 124
};

struct thermal_cooling_device_ops {
125 126 127
	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 已提交
128 129 130 131 132 133 134
};

struct thermal_cooling_device {
	int id;
	char type[THERMAL_NAME_LENGTH];
	struct device device;
	void *devdata;
A
Alan Cox 已提交
135
	const struct thermal_cooling_device_ops *ops;
136
	bool updated; /* true if the cooling device does not need update */
137
	struct mutex lock; /* protect thermal_instances list */
138
	struct list_head thermal_instances;
Z
Zhang Rui 已提交
139 140 141
	struct list_head node;
};

142 143 144 145 146
struct thermal_attr {
	struct device_attribute attr;
	char name[THERMAL_NAME_LENGTH];
};

Z
Zhang Rui 已提交
147 148 149 150
struct thermal_zone_device {
	int id;
	char type[THERMAL_NAME_LENGTH];
	struct device device;
151 152
	struct thermal_attr *trip_temp_attrs;
	struct thermal_attr *trip_type_attrs;
D
Durgadoss R 已提交
153
	struct thermal_attr *trip_hyst_attrs;
Z
Zhang Rui 已提交
154 155
	void *devdata;
	int trips;
156 157
	int passive_delay;
	int polling_delay;
158
	int temperature;
159
	int last_temperature;
160
	int passive;
161
	unsigned int forced_passive;
A
Alan Cox 已提交
162
	const struct thermal_zone_device_ops *ops;
163
	const struct thermal_zone_params *tzp;
164
	struct thermal_governor *governor;
165
	struct list_head thermal_instances;
Z
Zhang Rui 已提交
166
	struct idr idr;
167
	struct mutex lock; /* protect thermal_instances list */
Z
Zhang Rui 已提交
168
	struct list_head node;
169
	struct delayed_work poll_queue;
Z
Zhang Rui 已提交
170
};
171

172 173 174 175 176 177 178 179
/* 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;
};

180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203
/* 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 {
204
	char governor_name[THERMAL_NAME_LENGTH];
205 206 207 208
	int num_tbps;	/* Number of tbp entries */
	struct thermal_bind_params *tbp;
};

209 210 211 212
struct thermal_genl_event {
	u32 orig;
	enum events event;
};
Z
Zhang Rui 已提交
213

D
Durgadoss R 已提交
214
/* Function declarations */
215
struct thermal_zone_device *thermal_zone_device_register(const char *, int, int,
216 217
		void *, const struct thermal_zone_device_ops *,
		const struct thermal_zone_params *, int, int);
Z
Zhang Rui 已提交
218 219 220
void thermal_zone_device_unregister(struct thermal_zone_device *);

int thermal_zone_bind_cooling_device(struct thermal_zone_device *, int,
Z
Zhang Rui 已提交
221 222
				     struct thermal_cooling_device *,
				     unsigned long, unsigned long);
Z
Zhang Rui 已提交
223 224
int thermal_zone_unbind_cooling_device(struct thermal_zone_device *, int,
				       struct thermal_cooling_device *);
225
void thermal_zone_device_update(struct thermal_zone_device *);
D
Durgadoss R 已提交
226

Z
Zhang Rui 已提交
227
struct thermal_cooling_device *thermal_cooling_device_register(char *, void *,
A
Alan Cox 已提交
228
		const struct thermal_cooling_device_ops *);
Z
Zhang Rui 已提交
229
void thermal_cooling_device_unregister(struct thermal_cooling_device *);
230

231 232 233
int get_tz_trend(struct thermal_zone_device *, int);
struct thermal_instance *get_thermal_instance(struct thermal_zone_device *,
		struct thermal_cooling_device *, int);
234
void thermal_cdev_update(struct thermal_cooling_device *);
D
Durgadoss R 已提交
235
void notify_thermal_framework(struct thermal_zone_device *, int);
236

237 238 239
int thermal_register_governor(struct thermal_governor *);
void thermal_unregister_governor(struct thermal_governor *);

240
#ifdef CONFIG_NET
241
extern int thermal_generate_netlink_event(u32 orig, enum events event);
242
#else
243
static inline int thermal_generate_netlink_event(u32 orig, enum events event)
244 245 246 247
{
	return 0;
}
#endif
Z
Zhang Rui 已提交
248

249
#endif /* __THERMAL_H__ */