1/* 2 * Windfarm PowerMac thermal control. Generic PID helpers 3 * 4 * (c) Copyright 2005 Benjamin Herrenschmidt, IBM Corp. 5 * <benh@kernel.crashing.org> 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 */ 26struct 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 35struct 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 45extern void wf_pid_init(struct wf_pid_state *st, struct wf_pid_param *param); 46extern 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 */ 60struct 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 70struct 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 */ 75 s32 last_delta; /* last Tactual - Ttarget */ 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 83extern void wf_cpu_pid_init(struct wf_cpu_pid_state *st, 84 struct wf_cpu_pid_param *param); 85extern s32 wf_cpu_pid_run(struct wf_cpu_pid_state *st, s32 power, s32 temp); 86