[linux-block.git] / include / linux / devfreq_cooling.h

/*
 * devfreq_cooling: Thermal cooling device implementation for devices using
 *                  devfreq
 *
 * Copyright (C) 2014-2015 ARM Limited
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation.
 *
 * This program is distributed "as is" WITHOUT ANY WARRANTY of any
 * kind, whether express or implied; without even the implied warranty
 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 */

#ifndef __DEVFREQ_COOLING_H__
#define __DEVFREQ_COOLING_H__

#include <linux/devfreq.h>
#include <linux/thermal.h>


/**
 * struct devfreq_cooling_power - Devfreq cooling power ops
 * @get_static_power:	Take voltage, in mV, and return the static power
 *			in mW.  If NULL, the static power is assumed
 *			to be 0.
 * @get_dynamic_power:	Take voltage, in mV, and frequency, in HZ, and
 *			return the dynamic power draw in mW.  If NULL,
 *			a simple power model is used.
 * @dyn_power_coeff:	Coefficient for the simple dynamic power model in
 *			mW/(MHz mV mV).
 *			If get_dynamic_power() is NULL, then the
 *			dynamic power is calculated as
 *			@dyn_power_coeff * frequency * voltage^2
 */
struct devfreq_cooling_power {
	unsigned long (*get_static_power)(struct devfreq *devfreq,
					  unsigned long voltage);
	unsigned long (*get_dynamic_power)(struct devfreq *devfreq,
					   unsigned long freq,
					   unsigned long voltage);
	unsigned long dyn_power_coeff;
};

#ifdef CONFIG_DEVFREQ_THERMAL

struct thermal_cooling_device *
of_devfreq_cooling_register_power(struct device_node *np, struct devfreq *df,
				  struct devfreq_cooling_power *dfc_power);
struct thermal_cooling_device *
of_devfreq_cooling_register(struct device_node *np, struct devfreq *df);
struct thermal_cooling_device *devfreq_cooling_register(struct devfreq *df);
void devfreq_cooling_unregister(struct thermal_cooling_device *dfc);

#else /* !CONFIG_DEVFREQ_THERMAL */

struct thermal_cooling_device *
of_devfreq_cooling_register_power(struct device_node *np, struct devfreq *df,
				  struct devfreq_cooling_power *dfc_power)
{
	return ERR_PTR(-EINVAL);
}

static inline struct thermal_cooling_device *
of_devfreq_cooling_register(struct device_node *np, struct devfreq *df)
{
	return ERR_PTR(-EINVAL);
}

static inline struct thermal_cooling_device *
devfreq_cooling_register(struct devfreq *df)
{
	return ERR_PTR(-EINVAL);
}

static inline void
devfreq_cooling_unregister(struct thermal_cooling_device *dfc)
{
}

#endif /* CONFIG_DEVFREQ_THERMAL */
#endif /* __DEVFREQ_COOLING_H__ */
Commit	Line	Data
a76caf55 ØE	1	/*
	2	* devfreq_cooling: Thermal cooling device implementation for devices using
	3	* devfreq
	4	*
	5	* Copyright (C) 2014-2015 ARM Limited
	6	*
	7	* This program is free software; you can redistribute it and/or modify
	8	* it under the terms of the GNU General Public License version 2 as
	9	* published by the Free Software Foundation.
	10	*
	11	* This program is distributed "as is" WITHOUT ANY WARRANTY of any
	12	* kind, whether express or implied; without even the implied warranty
	13	* of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	14	* GNU General Public License for more details.
	15	*/
	16
	17	#ifndef __DEVFREQ_COOLING_H__
	18	#define __DEVFREQ_COOLING_H__
	19
	20	#include <linux/devfreq.h>
	21	#include <linux/thermal.h>
	22
a76caf55 ØE	23
	24	/**
	25	* struct devfreq_cooling_power - Devfreq cooling power ops
	26	* @get_static_power: Take voltage, in mV, and return the static power
	27	* in mW. If NULL, the static power is assumed
	28	* to be 0.
	29	* @get_dynamic_power: Take voltage, in mV, and frequency, in HZ, and
	30	* return the dynamic power draw in mW. If NULL,
	31	* a simple power model is used.
	32	* @dyn_power_coeff: Coefficient for the simple dynamic power model in
	33	* mW/(MHz mV mV).
	34	* If get_dynamic_power() is NULL, then the
	35	* dynamic power is calculated as
	36	* @dyn_power_coeff * frequency * voltage^2
	37	*/
	38	struct devfreq_cooling_power {
3aa53743 JM	39	unsigned long (get_static_power)(struct devfreq devfreq,
	40	unsigned long voltage);
	41	unsigned long (get_dynamic_power)(struct devfreq devfreq,
	42	unsigned long freq,
a76caf55 ØE	43	unsigned long voltage);
	44	unsigned long dyn_power_coeff;
	45	};
	46
1cea4e77 LL	47	#ifdef CONFIG_DEVFREQ_THERMAL
1cea4e77 LL	48
3c99c2ce	49	struct thermal_cooling_device *
a76caf55 ØE	50	of_devfreq_cooling_register_power(struct device_node np, struct devfreq df,
a76caf55 ØE	51	struct devfreq_cooling_power *dfc_power);
3c99c2ce	52	struct thermal_cooling_device *
a76caf55	53	of_devfreq_cooling_register(struct device_node np, struct devfreq df);
3c99c2ce JM	54	struct thermal_cooling_device devfreq_cooling_register(struct devfreq df);
3c99c2ce JM	55	void devfreq_cooling_unregister(struct thermal_cooling_device *dfc);
a76caf55 ØE	56
	57	#else /* !CONFIG_DEVFREQ_THERMAL */
	58
3c99c2ce	59	struct thermal_cooling_device *
a76caf55 ØE	60	of_devfreq_cooling_register_power(struct device_node np, struct devfreq df,
	61	struct devfreq_cooling_power *dfc_power)
	62	{
	63	return ERR_PTR(-EINVAL);
	64	}
	65
3c99c2ce	66	static inline struct thermal_cooling_device *
a76caf55 ØE	67	of_devfreq_cooling_register(struct device_node np, struct devfreq df)
	68	{
	69	return ERR_PTR(-EINVAL);
	70	}
	71
3c99c2ce	72	static inline struct thermal_cooling_device *
a76caf55 ØE	73	devfreq_cooling_register(struct devfreq *df)
	74	{
	75	return ERR_PTR(-EINVAL);
	76	}
	77
	78	static inline void
3c99c2ce	79	devfreq_cooling_unregister(struct thermal_cooling_device *dfc)
a76caf55 ØE	80	{
	81	}
	82
	83	#endif /* CONFIG_DEVFREQ_THERMAL */
	84	#endif /* __DEVFREQ_COOLING_H__ */