1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0-only
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun * Windfarm PowerMac thermal control. Generic PID helpers
4*4882a593Smuzhiyun *
5*4882a593Smuzhiyun * (c) Copyright 2005 Benjamin Herrenschmidt, IBM Corp.
6*4882a593Smuzhiyun * <benh@kernel.crashing.org>
7*4882a593Smuzhiyun */
8*4882a593Smuzhiyun
9*4882a593Smuzhiyun #include <linux/types.h>
10*4882a593Smuzhiyun #include <linux/errno.h>
11*4882a593Smuzhiyun #include <linux/kernel.h>
12*4882a593Smuzhiyun #include <linux/string.h>
13*4882a593Smuzhiyun #include <linux/module.h>
14*4882a593Smuzhiyun
15*4882a593Smuzhiyun #include "windfarm_pid.h"
16*4882a593Smuzhiyun
17*4882a593Smuzhiyun #undef DEBUG
18*4882a593Smuzhiyun
19*4882a593Smuzhiyun #ifdef DEBUG
20*4882a593Smuzhiyun #define DBG(args...) printk(args)
21*4882a593Smuzhiyun #else
22*4882a593Smuzhiyun #define DBG(args...) do { } while(0)
23*4882a593Smuzhiyun #endif
24*4882a593Smuzhiyun
wf_pid_init(struct wf_pid_state * st,struct wf_pid_param * param)25*4882a593Smuzhiyun void wf_pid_init(struct wf_pid_state *st, struct wf_pid_param *param)
26*4882a593Smuzhiyun {
27*4882a593Smuzhiyun memset(st, 0, sizeof(struct wf_pid_state));
28*4882a593Smuzhiyun st->param = *param;
29*4882a593Smuzhiyun st->first = 1;
30*4882a593Smuzhiyun }
31*4882a593Smuzhiyun EXPORT_SYMBOL_GPL(wf_pid_init);
32*4882a593Smuzhiyun
wf_pid_run(struct wf_pid_state * st,s32 new_sample)33*4882a593Smuzhiyun s32 wf_pid_run(struct wf_pid_state *st, s32 new_sample)
34*4882a593Smuzhiyun {
35*4882a593Smuzhiyun s64 error, integ, deriv;
36*4882a593Smuzhiyun s32 target;
37*4882a593Smuzhiyun int i, hlen = st->param.history_len;
38*4882a593Smuzhiyun
39*4882a593Smuzhiyun /* Calculate error term */
40*4882a593Smuzhiyun error = new_sample - st->param.itarget;
41*4882a593Smuzhiyun
42*4882a593Smuzhiyun /* Get samples into our history buffer */
43*4882a593Smuzhiyun if (st->first) {
44*4882a593Smuzhiyun for (i = 0; i < hlen; i++) {
45*4882a593Smuzhiyun st->samples[i] = new_sample;
46*4882a593Smuzhiyun st->errors[i] = error;
47*4882a593Smuzhiyun }
48*4882a593Smuzhiyun st->first = 0;
49*4882a593Smuzhiyun st->index = 0;
50*4882a593Smuzhiyun } else {
51*4882a593Smuzhiyun st->index = (st->index + 1) % hlen;
52*4882a593Smuzhiyun st->samples[st->index] = new_sample;
53*4882a593Smuzhiyun st->errors[st->index] = error;
54*4882a593Smuzhiyun }
55*4882a593Smuzhiyun
56*4882a593Smuzhiyun /* Calculate integral term */
57*4882a593Smuzhiyun for (i = 0, integ = 0; i < hlen; i++)
58*4882a593Smuzhiyun integ += st->errors[(st->index + hlen - i) % hlen];
59*4882a593Smuzhiyun integ *= st->param.interval;
60*4882a593Smuzhiyun
61*4882a593Smuzhiyun /* Calculate derivative term */
62*4882a593Smuzhiyun deriv = st->errors[st->index] -
63*4882a593Smuzhiyun st->errors[(st->index + hlen - 1) % hlen];
64*4882a593Smuzhiyun deriv /= st->param.interval;
65*4882a593Smuzhiyun
66*4882a593Smuzhiyun /* Calculate target */
67*4882a593Smuzhiyun target = (s32)((integ * (s64)st->param.gr + deriv * (s64)st->param.gd +
68*4882a593Smuzhiyun error * (s64)st->param.gp) >> 36);
69*4882a593Smuzhiyun if (st->param.additive)
70*4882a593Smuzhiyun target += st->target;
71*4882a593Smuzhiyun target = max(target, st->param.min);
72*4882a593Smuzhiyun target = min(target, st->param.max);
73*4882a593Smuzhiyun st->target = target;
74*4882a593Smuzhiyun
75*4882a593Smuzhiyun return st->target;
76*4882a593Smuzhiyun }
77*4882a593Smuzhiyun EXPORT_SYMBOL_GPL(wf_pid_run);
78*4882a593Smuzhiyun
wf_cpu_pid_init(struct wf_cpu_pid_state * st,struct wf_cpu_pid_param * param)79*4882a593Smuzhiyun void wf_cpu_pid_init(struct wf_cpu_pid_state *st,
80*4882a593Smuzhiyun struct wf_cpu_pid_param *param)
81*4882a593Smuzhiyun {
82*4882a593Smuzhiyun memset(st, 0, sizeof(struct wf_cpu_pid_state));
83*4882a593Smuzhiyun st->param = *param;
84*4882a593Smuzhiyun st->first = 1;
85*4882a593Smuzhiyun }
86*4882a593Smuzhiyun EXPORT_SYMBOL_GPL(wf_cpu_pid_init);
87*4882a593Smuzhiyun
wf_cpu_pid_run(struct wf_cpu_pid_state * st,s32 new_power,s32 new_temp)88*4882a593Smuzhiyun s32 wf_cpu_pid_run(struct wf_cpu_pid_state *st, s32 new_power, s32 new_temp)
89*4882a593Smuzhiyun {
90*4882a593Smuzhiyun s64 integ, deriv, prop;
91*4882a593Smuzhiyun s32 error, target, sval, adj;
92*4882a593Smuzhiyun int i, hlen = st->param.history_len;
93*4882a593Smuzhiyun
94*4882a593Smuzhiyun /* Calculate error term */
95*4882a593Smuzhiyun error = st->param.pmaxadj - new_power;
96*4882a593Smuzhiyun
97*4882a593Smuzhiyun /* Get samples into our history buffer */
98*4882a593Smuzhiyun if (st->first) {
99*4882a593Smuzhiyun for (i = 0; i < hlen; i++) {
100*4882a593Smuzhiyun st->powers[i] = new_power;
101*4882a593Smuzhiyun st->errors[i] = error;
102*4882a593Smuzhiyun }
103*4882a593Smuzhiyun st->temps[0] = st->temps[1] = new_temp;
104*4882a593Smuzhiyun st->first = 0;
105*4882a593Smuzhiyun st->index = st->tindex = 0;
106*4882a593Smuzhiyun } else {
107*4882a593Smuzhiyun st->index = (st->index + 1) % hlen;
108*4882a593Smuzhiyun st->powers[st->index] = new_power;
109*4882a593Smuzhiyun st->errors[st->index] = error;
110*4882a593Smuzhiyun st->tindex = (st->tindex + 1) % 2;
111*4882a593Smuzhiyun st->temps[st->tindex] = new_temp;
112*4882a593Smuzhiyun }
113*4882a593Smuzhiyun
114*4882a593Smuzhiyun /* Calculate integral term */
115*4882a593Smuzhiyun for (i = 0, integ = 0; i < hlen; i++)
116*4882a593Smuzhiyun integ += st->errors[(st->index + hlen - i) % hlen];
117*4882a593Smuzhiyun integ *= st->param.interval;
118*4882a593Smuzhiyun integ *= st->param.gr;
119*4882a593Smuzhiyun sval = st->param.tmax - (s32)(integ >> 20);
120*4882a593Smuzhiyun adj = min(st->param.ttarget, sval);
121*4882a593Smuzhiyun
122*4882a593Smuzhiyun DBG("integ: %lx, sval: %lx, adj: %lx\n", integ, sval, adj);
123*4882a593Smuzhiyun
124*4882a593Smuzhiyun /* Calculate derivative term */
125*4882a593Smuzhiyun deriv = st->temps[st->tindex] -
126*4882a593Smuzhiyun st->temps[(st->tindex + 2 - 1) % 2];
127*4882a593Smuzhiyun deriv /= st->param.interval;
128*4882a593Smuzhiyun deriv *= st->param.gd;
129*4882a593Smuzhiyun
130*4882a593Smuzhiyun /* Calculate proportional term */
131*4882a593Smuzhiyun prop = st->last_delta = (new_temp - adj);
132*4882a593Smuzhiyun prop *= st->param.gp;
133*4882a593Smuzhiyun
134*4882a593Smuzhiyun DBG("deriv: %lx, prop: %lx\n", deriv, prop);
135*4882a593Smuzhiyun
136*4882a593Smuzhiyun /* Calculate target */
137*4882a593Smuzhiyun target = st->target + (s32)((deriv + prop) >> 36);
138*4882a593Smuzhiyun target = max(target, st->param.min);
139*4882a593Smuzhiyun target = min(target, st->param.max);
140*4882a593Smuzhiyun st->target = target;
141*4882a593Smuzhiyun
142*4882a593Smuzhiyun return st->target;
143*4882a593Smuzhiyun }
144*4882a593Smuzhiyun EXPORT_SYMBOL_GPL(wf_cpu_pid_run);
145*4882a593Smuzhiyun
146*4882a593Smuzhiyun MODULE_AUTHOR("Benjamin Herrenschmidt <benh@kernel.crashing.org>");
147*4882a593Smuzhiyun MODULE_DESCRIPTION("PID algorithm for PowerMacs thermal control");
148*4882a593Smuzhiyun MODULE_LICENSE("GPL");
149