[linux.git] / drivers / macintosh / windfarm_pid.h

/*
 * Windfarm PowerMac thermal control. Generic PID helpers
 *
 * (c) Copyright 2005 Benjamin Herrenschmidt, IBM Corp.
 *                    <[email protected]>
 *
 * Released under the term of the GNU GPL v2.
 *
 * This is a pair of generic PID helpers that can be used by
 * control loops. One is the basic PID implementation, the
 * other one is more specifically tailored to the loops used
 * for CPU control with 2 input sample types (temp and power)
 */

/*
 * *** Simple PID ***
 */

#define WF_PID_MAX_HISTORY	32

/* This parameter array is passed to the PID algorithm. Currently,
 * we don't support changing parameters on the fly as it's not needed
 * but could be implemented (with necessary adjustment of the history
 * buffer
 */
struct wf_pid_param {
	int	interval;	/* Interval between samples in seconds */
	int	history_len;	/* Size of history buffer */
	int	additive;	/* 1: target relative to previous value */
	s32	gd, gp, gr;	/* PID gains */
	s32	itarget;	/* PID input target */
	s32	min,max;	/* min and max target values */
};

struct wf_pid_state {
	int	first;				/* first run of the loop */
	int	index; 				/* index of current sample */
	s32	target;				/* current target value */
	s32	samples[WF_PID_MAX_HISTORY];	/* samples history buffer */
	s32	errors[WF_PID_MAX_HISTORY];	/* error history buffer */

	struct wf_pid_param param;
};

extern void wf_pid_init(struct wf_pid_state *st, struct wf_pid_param *param);
extern s32 wf_pid_run(struct wf_pid_state *st, s32 sample);


/*
 * *** CPU PID ***
 */

#define WF_CPU_PID_MAX_HISTORY	32

/* This parameter array is passed to the CPU PID algorithm. Currently,
 * we don't support changing parameters on the fly as it's not needed
 * but could be implemented (with necessary adjustment of the history
 * buffer
 */
struct wf_cpu_pid_param {
	int	interval;	/* Interval between samples in seconds */
	int	history_len;	/* Size of history buffer */
	s32	gd, gp, gr;	/* PID gains */
	s32	pmaxadj;	/* PID max power adjust */
	s32	ttarget;	/* PID input target */
	s32	tmax;		/* PID input max */
	s32	min,max;	/* min and max target values */
};

struct wf_cpu_pid_state {
	int	first;				/* first run of the loop */
	int	index; 				/* index of current power */
	int	tindex; 			/* index of current temp */
	s32	target;				/* current target value */
	s32	last_delta;			/* last Tactual - Ttarget */
	s32	powers[WF_PID_MAX_HISTORY];	/* power history buffer */
	s32	errors[WF_PID_MAX_HISTORY];	/* error history buffer */
	s32	temps[2];			/* temp. history buffer */

	struct wf_cpu_pid_param param;
};

extern void wf_cpu_pid_init(struct wf_cpu_pid_state *st,
			    struct wf_cpu_pid_param *param);
extern s32 wf_cpu_pid_run(struct wf_cpu_pid_state *st, s32 power, s32 temp);
Commit	Line	Data
75722d39 BH	1	/*
	2	* Windfarm PowerMac thermal control. Generic PID helpers
	3	*
	4	* (c) Copyright 2005 Benjamin Herrenschmidt, IBM Corp.
	5	* <[email protected]>
	6	*
	7	* Released under the term of the GNU GPL v2.
	8	*
	9	* This is a pair of generic PID helpers that can be used by
	10	* control loops. One is the basic PID implementation, the
	11	* other one is more specifically tailored to the loops used
	12	* for CPU control with 2 input sample types (temp and power)
	13	*/
	14
	15	/*
	16	* * Simple PID *
	17	*/
	18
	19	#define WF_PID_MAX_HISTORY 32
	20
	21	/* This parameter array is passed to the PID algorithm. Currently,
	22	* we don't support changing parameters on the fly as it's not needed
	23	* but could be implemented (with necessary adjustment of the history
	24	* buffer
	25	*/
	26	struct wf_pid_param {
	27	int interval; /* Interval between samples in seconds */
	28	int history_len; /* Size of history buffer */
	29	int additive; /* 1: target relative to previous value */
	30	s32 gd, gp, gr; /* PID gains */
	31	s32 itarget; /* PID input target */
	32	s32 min,max; /* min and max target values */
	33	};
	34
	35	struct wf_pid_state {
	36	int first; /* first run of the loop */
	37	int index; /* index of current sample */
	38	s32 target; /* current target value */
	39	s32 samples[WF_PID_MAX_HISTORY]; /* samples history buffer */
	40	s32 errors[WF_PID_MAX_HISTORY]; /* error history buffer */
	41
	42	struct wf_pid_param param;
	43	};
	44
	45	extern void wf_pid_init(struct wf_pid_state st, struct wf_pid_param param);
	46	extern s32 wf_pid_run(struct wf_pid_state *st, s32 sample);
	47
	48
	49	/*
	50	* * CPU PID *
	51	*/
	52
	53	#define WF_CPU_PID_MAX_HISTORY 32
	54
	55	/* This parameter array is passed to the CPU PID algorithm. Currently,
	56	* we don't support changing parameters on the fly as it's not needed
	57	* but could be implemented (with necessary adjustment of the history
	58	* buffer
	59	*/
	60	struct wf_cpu_pid_param {
	61	int interval; /* Interval between samples in seconds */
	62	int history_len; /* Size of history buffer */
	63	s32 gd, gp, gr; /* PID gains */
	64	s32 pmaxadj; /* PID max power adjust */
65	s32 ttarget; /* PID input target */
66	s32 tmax; /* PID input max */
67	s32 min,max; /* min and max target values */
68	};
69
70	struct wf_cpu_pid_state {
71	int first; /* first run of the loop */
72	int index; /* index of current power */
73	int tindex; /* index of current temp */
74	s32 target; /* current target value */
ac171c46	75	s32 last_delta; /* last Tactual - Ttarget */
75722d39 BH	76	s32 powers[WF_PID_MAX_HISTORY]; /* power history buffer */
	77	s32 errors[WF_PID_MAX_HISTORY]; /* error history buffer */
	78	s32 temps[2]; /* temp. history buffer */
	79
	80	struct wf_cpu_pid_param param;
	81	};
	82
	83	extern void wf_cpu_pid_init(struct wf_cpu_pid_state *st,
	84	struct wf_cpu_pid_param *param);
	85	extern s32 wf_cpu_pid_run(struct wf_cpu_pid_state *st, s32 power, s32 temp);