blob: 7b98c067190a01917e31b1189feba430c1f1c5e9 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
2 * ipmi_bt_sm.c
3 *
4 * The state machine for an Open IPMI BT sub-driver under ipmi_si.c, part
5 * of the driver architecture at http://sourceforge.net/project/openipmi
6 *
7 * Author: Rocky Craig <first.last@hp.com>
8 *
9 * This program is free software; you can redistribute it and/or modify it
10 * under the terms of the GNU General Public License as published by the
11 * Free Software Foundation; either version 2 of the License, or (at your
12 * option) any later version.
13 *
14 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
15 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
16 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
17 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
18 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
19 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
20 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
21 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
22 * TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
23 * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24 *
25 * You should have received a copy of the GNU General Public License along
26 * with this program; if not, write to the Free Software Foundation, Inc.,
27 * 675 Mass Ave, Cambridge, MA 02139, USA. */
28
29#include <linux/kernel.h> /* For printk. */
30#include <linux/string.h>
Corey Minyardc4edff12005-11-07 00:59:56 -080031#include <linux/module.h>
32#include <linux/moduleparam.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070033#include <linux/ipmi_msgdefs.h> /* for completion codes */
34#include "ipmi_si_sm.h"
35
Corey Minyard4d7cbac2006-12-06 20:41:14 -080036#define BT_DEBUG_OFF 0 /* Used in production */
37#define BT_DEBUG_ENABLE 1 /* Generic messages */
38#define BT_DEBUG_MSG 2 /* Prints all request/response buffers */
39#define BT_DEBUG_STATES 4 /* Verbose look at state changes */
Corey Minyardc305e3d2008-04-29 01:01:10 -070040/*
41 * BT_DEBUG_OFF must be zero to correspond to the default uninitialized
42 * value
43 */
Linus Torvalds1da177e2005-04-16 15:20:36 -070044
Randy Dunlap0c8204b2006-12-10 02:19:06 -080045static int bt_debug; /* 0 == BT_DEBUG_OFF */
Corey Minyard4d7cbac2006-12-06 20:41:14 -080046
Corey Minyardc4edff12005-11-07 00:59:56 -080047module_param(bt_debug, int, 0644);
48MODULE_PARM_DESC(bt_debug, "debug bitmask, 1=enable, 2=messages, 4=states");
Linus Torvalds1da177e2005-04-16 15:20:36 -070049
Corey Minyardc305e3d2008-04-29 01:01:10 -070050/*
51 * Typical "Get BT Capabilities" values are 2-3 retries, 5-10 seconds,
52 * and 64 byte buffers. However, one HP implementation wants 255 bytes of
53 * buffer (with a documented message of 160 bytes) so go for the max.
54 * Since the Open IPMI architecture is single-message oriented at this
55 * stage, the queue depth of BT is of no concern.
56 */
Linus Torvalds1da177e2005-04-16 15:20:36 -070057
Corey Minyard4d7cbac2006-12-06 20:41:14 -080058#define BT_NORMAL_TIMEOUT 5 /* seconds */
59#define BT_NORMAL_RETRY_LIMIT 2
60#define BT_RESET_DELAY 6 /* seconds after warm reset */
61
Corey Minyardc305e3d2008-04-29 01:01:10 -070062/*
63 * States are written in chronological order and usually cover
64 * multiple rows of the state table discussion in the IPMI spec.
65 */
Linus Torvalds1da177e2005-04-16 15:20:36 -070066
67enum bt_states {
Corey Minyard4d7cbac2006-12-06 20:41:14 -080068 BT_STATE_IDLE = 0, /* Order is critical in this list */
Linus Torvalds1da177e2005-04-16 15:20:36 -070069 BT_STATE_XACTION_START,
70 BT_STATE_WRITE_BYTES,
Linus Torvalds1da177e2005-04-16 15:20:36 -070071 BT_STATE_WRITE_CONSUME,
Corey Minyard4d7cbac2006-12-06 20:41:14 -080072 BT_STATE_READ_WAIT,
73 BT_STATE_CLEAR_B2H,
74 BT_STATE_READ_BYTES,
75 BT_STATE_RESET1, /* These must come last */
Linus Torvalds1da177e2005-04-16 15:20:36 -070076 BT_STATE_RESET2,
77 BT_STATE_RESET3,
78 BT_STATE_RESTART,
Corey Minyard4d7cbac2006-12-06 20:41:14 -080079 BT_STATE_PRINTME,
80 BT_STATE_CAPABILITIES_BEGIN,
81 BT_STATE_CAPABILITIES_END,
82 BT_STATE_LONG_BUSY /* BT doesn't get hosed :-) */
Linus Torvalds1da177e2005-04-16 15:20:36 -070083};
84
Corey Minyardc305e3d2008-04-29 01:01:10 -070085/*
86 * Macros seen at the end of state "case" blocks. They help with legibility
87 * and debugging.
88 */
Corey Minyard4d7cbac2006-12-06 20:41:14 -080089
Corey Minyardc305e3d2008-04-29 01:01:10 -070090#define BT_STATE_CHANGE(X, Y) { bt->state = X; return Y; }
Corey Minyard4d7cbac2006-12-06 20:41:14 -080091
92#define BT_SI_SM_RETURN(Y) { last_printed = BT_STATE_PRINTME; return Y; }
93
Linus Torvalds1da177e2005-04-16 15:20:36 -070094struct si_sm_data {
95 enum bt_states state;
Linus Torvalds1da177e2005-04-16 15:20:36 -070096 unsigned char seq; /* BT sequence number */
97 struct si_sm_io *io;
Corey Minyard4d7cbac2006-12-06 20:41:14 -080098 unsigned char write_data[IPMI_MAX_MSG_LENGTH];
99 int write_count;
100 unsigned char read_data[IPMI_MAX_MSG_LENGTH];
101 int read_count;
102 int truncated;
103 long timeout; /* microseconds countdown */
104 int error_retries; /* end of "common" fields */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700105 int nonzero_status; /* hung BMCs stay all 0 */
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800106 enum bt_states complete; /* to divert the state machine */
107 int BT_CAP_outreqs;
108 long BT_CAP_req2rsp;
109 int BT_CAP_retries; /* Recommended retries */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700110};
111
112#define BT_CLR_WR_PTR 0x01 /* See IPMI 1.5 table 11.6.4 */
113#define BT_CLR_RD_PTR 0x02
114#define BT_H2B_ATN 0x04
115#define BT_B2H_ATN 0x08
116#define BT_SMS_ATN 0x10
117#define BT_OEM0 0x20
118#define BT_H_BUSY 0x40
119#define BT_B_BUSY 0x80
120
Corey Minyardc305e3d2008-04-29 01:01:10 -0700121/*
122 * Some bits are toggled on each write: write once to set it, once
123 * more to clear it; writing a zero does nothing. To absolutely
124 * clear it, check its state and write if set. This avoids the "get
125 * current then use as mask" scheme to modify one bit. Note that the
126 * variable "bt" is hardcoded into these macros.
127 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700128
129#define BT_STATUS bt->io->inputb(bt->io, 0)
130#define BT_CONTROL(x) bt->io->outputb(bt->io, 0, x)
131
132#define BMC2HOST bt->io->inputb(bt->io, 1)
133#define HOST2BMC(x) bt->io->outputb(bt->io, 1, x)
134
135#define BT_INTMASK_R bt->io->inputb(bt->io, 2)
136#define BT_INTMASK_W(x) bt->io->outputb(bt->io, 2, x)
137
Corey Minyardc305e3d2008-04-29 01:01:10 -0700138/*
139 * Convenience routines for debugging. These are not multi-open safe!
140 * Note the macros have hardcoded variables in them.
141 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700142
143static char *state2txt(unsigned char state)
144{
145 switch (state) {
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800146 case BT_STATE_IDLE: return("IDLE");
147 case BT_STATE_XACTION_START: return("XACTION");
148 case BT_STATE_WRITE_BYTES: return("WR_BYTES");
149 case BT_STATE_WRITE_CONSUME: return("WR_CONSUME");
150 case BT_STATE_READ_WAIT: return("RD_WAIT");
151 case BT_STATE_CLEAR_B2H: return("CLEAR_B2H");
152 case BT_STATE_READ_BYTES: return("RD_BYTES");
153 case BT_STATE_RESET1: return("RESET1");
154 case BT_STATE_RESET2: return("RESET2");
155 case BT_STATE_RESET3: return("RESET3");
156 case BT_STATE_RESTART: return("RESTART");
157 case BT_STATE_LONG_BUSY: return("LONG_BUSY");
158 case BT_STATE_CAPABILITIES_BEGIN: return("CAP_BEGIN");
159 case BT_STATE_CAPABILITIES_END: return("CAP_END");
Linus Torvalds1da177e2005-04-16 15:20:36 -0700160 }
161 return("BAD STATE");
162}
163#define STATE2TXT state2txt(bt->state)
164
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800165static char *status2txt(unsigned char status)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700166{
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800167 /*
168 * This cannot be called by two threads at the same time and
169 * the buffer is always consumed immediately, so the static is
170 * safe to use.
171 */
172 static char buf[40];
173
Linus Torvalds1da177e2005-04-16 15:20:36 -0700174 strcpy(buf, "[ ");
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800175 if (status & BT_B_BUSY)
176 strcat(buf, "B_BUSY ");
177 if (status & BT_H_BUSY)
178 strcat(buf, "H_BUSY ");
179 if (status & BT_OEM0)
180 strcat(buf, "OEM0 ");
181 if (status & BT_SMS_ATN)
182 strcat(buf, "SMS ");
183 if (status & BT_B2H_ATN)
184 strcat(buf, "B2H ");
185 if (status & BT_H2B_ATN)
186 strcat(buf, "H2B ");
Linus Torvalds1da177e2005-04-16 15:20:36 -0700187 strcat(buf, "]");
188 return buf;
189}
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800190#define STATUS2TXT status2txt(status)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700191
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800192/* called externally at insmod time, and internally on cleanup */
193
Linus Torvalds1da177e2005-04-16 15:20:36 -0700194static unsigned int bt_init_data(struct si_sm_data *bt, struct si_sm_io *io)
195{
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800196 memset(bt, 0, sizeof(struct si_sm_data));
Corey Minyardc305e3d2008-04-29 01:01:10 -0700197 if (bt->io != io) {
198 /* external: one-time only things */
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800199 bt->io = io;
200 bt->seq = 0;
201 }
202 bt->state = BT_STATE_IDLE; /* start here */
203 bt->complete = BT_STATE_IDLE; /* end here */
204 bt->BT_CAP_req2rsp = BT_NORMAL_TIMEOUT * 1000000;
205 bt->BT_CAP_retries = BT_NORMAL_RETRY_LIMIT;
206 /* BT_CAP_outreqs == zero is a flag to read BT Capabilities */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700207 return 3; /* We claim 3 bytes of space; ought to check SPMI table */
208}
209
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800210/* Jam a completion code (probably an error) into a response */
211
212static void force_result(struct si_sm_data *bt, unsigned char completion_code)
213{
214 bt->read_data[0] = 4; /* # following bytes */
215 bt->read_data[1] = bt->write_data[1] | 4; /* Odd NetFn/LUN */
216 bt->read_data[2] = bt->write_data[2]; /* seq (ignored) */
217 bt->read_data[3] = bt->write_data[3]; /* Command */
218 bt->read_data[4] = completion_code;
219 bt->read_count = 5;
220}
221
222/* The upper state machine starts here */
223
Linus Torvalds1da177e2005-04-16 15:20:36 -0700224static int bt_start_transaction(struct si_sm_data *bt,
225 unsigned char *data,
226 unsigned int size)
227{
228 unsigned int i;
229
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800230 if (size < 2)
231 return IPMI_REQ_LEN_INVALID_ERR;
232 if (size > IPMI_MAX_MSG_LENGTH)
233 return IPMI_REQ_LEN_EXCEEDED_ERR;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700234
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800235 if (bt->state == BT_STATE_LONG_BUSY)
236 return IPMI_NODE_BUSY_ERR;
237
238 if (bt->state != BT_STATE_IDLE)
239 return IPMI_NOT_IN_MY_STATE_ERR;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700240
241 if (bt_debug & BT_DEBUG_MSG) {
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800242 printk(KERN_WARNING "BT: +++++++++++++++++ New command\n");
243 printk(KERN_WARNING "BT: NetFn/LUN CMD [%d data]:", size - 2);
Corey Minyarde8b33612005-09-06 15:18:45 -0700244 for (i = 0; i < size; i ++)
Corey Minyardc305e3d2008-04-29 01:01:10 -0700245 printk(" %02x", data[i]);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700246 printk("\n");
247 }
248 bt->write_data[0] = size + 1; /* all data plus seq byte */
249 bt->write_data[1] = *data; /* NetFn/LUN */
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800250 bt->write_data[2] = bt->seq++;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700251 memcpy(bt->write_data + 3, data + 1, size - 1);
252 bt->write_count = size + 2;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700253 bt->error_retries = 0;
254 bt->nonzero_status = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700255 bt->truncated = 0;
256 bt->state = BT_STATE_XACTION_START;
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800257 bt->timeout = bt->BT_CAP_req2rsp;
258 force_result(bt, IPMI_ERR_UNSPECIFIED);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700259 return 0;
260}
261
Corey Minyardc305e3d2008-04-29 01:01:10 -0700262/*
263 * After the upper state machine has been told SI_SM_TRANSACTION_COMPLETE
264 * it calls this. Strip out the length and seq bytes.
265 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700266
267static int bt_get_result(struct si_sm_data *bt,
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800268 unsigned char *data,
269 unsigned int length)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700270{
271 int i, msg_len;
272
273 msg_len = bt->read_count - 2; /* account for length & seq */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700274 if (msg_len < 3 || msg_len > IPMI_MAX_MSG_LENGTH) {
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800275 force_result(bt, IPMI_ERR_UNSPECIFIED);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700276 msg_len = 3;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700277 }
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800278 data[0] = bt->read_data[1];
279 data[1] = bt->read_data[3];
280 if (length < msg_len || bt->truncated) {
281 data[2] = IPMI_ERR_MSG_TRUNCATED;
282 msg_len = 3;
283 } else
284 memcpy(data + 2, bt->read_data + 4, msg_len - 2);
285
286 if (bt_debug & BT_DEBUG_MSG) {
Corey Minyardc305e3d2008-04-29 01:01:10 -0700287 printk(KERN_WARNING "BT: result %d bytes:", msg_len);
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800288 for (i = 0; i < msg_len; i++)
289 printk(" %02x", data[i]);
Corey Minyardc305e3d2008-04-29 01:01:10 -0700290 printk("\n");
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800291 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700292 return msg_len;
293}
294
295/* This bit's functionality is optional */
296#define BT_BMC_HWRST 0x80
297
298static void reset_flags(struct si_sm_data *bt)
299{
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800300 if (bt_debug)
301 printk(KERN_WARNING "IPMI BT: flag reset %s\n",
302 status2txt(BT_STATUS));
Corey Minyarde8b33612005-09-06 15:18:45 -0700303 if (BT_STATUS & BT_H_BUSY)
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800304 BT_CONTROL(BT_H_BUSY); /* force clear */
305 BT_CONTROL(BT_CLR_WR_PTR); /* always reset */
306 BT_CONTROL(BT_SMS_ATN); /* always clear */
307 BT_INTMASK_W(BT_BMC_HWRST);
308}
Corey Minyardc4edff12005-11-07 00:59:56 -0800309
Corey Minyardc305e3d2008-04-29 01:01:10 -0700310/*
311 * Get rid of an unwanted/stale response. This should only be needed for
312 * BMCs that support multiple outstanding requests.
313 */
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800314
315static void drain_BMC2HOST(struct si_sm_data *bt)
316{
317 int i, size;
318
319 if (!(BT_STATUS & BT_B2H_ATN)) /* Not signalling a response */
320 return;
321
322 BT_CONTROL(BT_H_BUSY); /* now set */
323 BT_CONTROL(BT_B2H_ATN); /* always clear */
324 BT_STATUS; /* pause */
325 BT_CONTROL(BT_B2H_ATN); /* some BMCs are stubborn */
326 BT_CONTROL(BT_CLR_RD_PTR); /* always reset */
327 if (bt_debug)
328 printk(KERN_WARNING "IPMI BT: stale response %s; ",
329 status2txt(BT_STATUS));
330 size = BMC2HOST;
331 for (i = 0; i < size ; i++)
332 BMC2HOST;
333 BT_CONTROL(BT_H_BUSY); /* now clear */
334 if (bt_debug)
335 printk("drained %d bytes\n", size + 1);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700336}
337
338static inline void write_all_bytes(struct si_sm_data *bt)
339{
340 int i;
341
342 if (bt_debug & BT_DEBUG_MSG) {
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800343 printk(KERN_WARNING "BT: write %d bytes seq=0x%02X",
Linus Torvalds1da177e2005-04-16 15:20:36 -0700344 bt->write_count, bt->seq);
345 for (i = 0; i < bt->write_count; i++)
Corey Minyardc305e3d2008-04-29 01:01:10 -0700346 printk(" %02x", bt->write_data[i]);
347 printk("\n");
Linus Torvalds1da177e2005-04-16 15:20:36 -0700348 }
Corey Minyarde8b33612005-09-06 15:18:45 -0700349 for (i = 0; i < bt->write_count; i++)
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800350 HOST2BMC(bt->write_data[i]);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700351}
352
353static inline int read_all_bytes(struct si_sm_data *bt)
354{
355 unsigned char i;
356
Corey Minyardc305e3d2008-04-29 01:01:10 -0700357 /*
358 * length is "framing info", minimum = 4: NetFn, Seq, Cmd, cCode.
359 * Keep layout of first four bytes aligned with write_data[]
360 */
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800361
Linus Torvalds1da177e2005-04-16 15:20:36 -0700362 bt->read_data[0] = BMC2HOST;
363 bt->read_count = bt->read_data[0];
Linus Torvalds1da177e2005-04-16 15:20:36 -0700364
Linus Torvalds1da177e2005-04-16 15:20:36 -0700365 if (bt->read_count < 4 || bt->read_count >= IPMI_MAX_MSG_LENGTH) {
366 if (bt_debug & BT_DEBUG_MSG)
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800367 printk(KERN_WARNING "BT: bad raw rsp len=%d\n",
368 bt->read_count);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700369 bt->truncated = 1;
370 return 1; /* let next XACTION START clean it up */
371 }
Corey Minyarde8b33612005-09-06 15:18:45 -0700372 for (i = 1; i <= bt->read_count; i++)
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800373 bt->read_data[i] = BMC2HOST;
374 bt->read_count++; /* Account internally for length byte */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700375
376 if (bt_debug & BT_DEBUG_MSG) {
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800377 int max = bt->read_count;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700378
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800379 printk(KERN_WARNING "BT: got %d bytes seq=0x%02X",
380 max, bt->read_data[2]);
381 if (max > 16)
382 max = 16;
383 for (i = 0; i < max; i++)
Corey Minyardc305e3d2008-04-29 01:01:10 -0700384 printk(KERN_CONT " %02x", bt->read_data[i]);
385 printk(KERN_CONT "%s\n", bt->read_count == max ? "" : " ...");
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800386 }
387
388 /* per the spec, the (NetFn[1], Seq[2], Cmd[3]) tuples must match */
389 if ((bt->read_data[3] == bt->write_data[3]) &&
390 (bt->read_data[2] == bt->write_data[2]) &&
391 ((bt->read_data[1] & 0xF8) == (bt->write_data[1] & 0xF8)))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700392 return 1;
393
Corey Minyarde8b33612005-09-06 15:18:45 -0700394 if (bt_debug & BT_DEBUG_MSG)
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800395 printk(KERN_WARNING "IPMI BT: bad packet: "
Linus Torvalds1da177e2005-04-16 15:20:36 -0700396 "want 0x(%02X, %02X, %02X) got (%02X, %02X, %02X)\n",
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800397 bt->write_data[1] | 0x04, bt->write_data[2], bt->write_data[3],
Linus Torvalds1da177e2005-04-16 15:20:36 -0700398 bt->read_data[1], bt->read_data[2], bt->read_data[3]);
399 return 0;
400}
401
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800402/* Restart if retries are left, or return an error completion code */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700403
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800404static enum si_sm_result error_recovery(struct si_sm_data *bt,
405 unsigned char status,
406 unsigned char cCode)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700407{
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800408 char *reason;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700409
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800410 bt->timeout = bt->BT_CAP_req2rsp;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700411
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800412 switch (cCode) {
413 case IPMI_TIMEOUT_ERR:
414 reason = "timeout";
415 break;
416 default:
417 reason = "internal error";
418 break;
419 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700420
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800421 printk(KERN_WARNING "IPMI BT: %s in %s %s ", /* open-ended line */
422 reason, STATE2TXT, STATUS2TXT);
423
Corey Minyardc305e3d2008-04-29 01:01:10 -0700424 /*
425 * Per the IPMI spec, retries are based on the sequence number
426 * known only to this module, so manage a restart here.
427 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700428 (bt->error_retries)++;
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800429 if (bt->error_retries < bt->BT_CAP_retries) {
430 printk("%d retries left\n",
431 bt->BT_CAP_retries - bt->error_retries);
432 bt->state = BT_STATE_RESTART;
433 return SI_SM_CALL_WITHOUT_DELAY;
434 }
435
Corey Minyardc305e3d2008-04-29 01:01:10 -0700436 printk(KERN_WARNING "failed %d retries, sending error response\n",
437 bt->BT_CAP_retries);
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800438 if (!bt->nonzero_status)
439 printk(KERN_ERR "IPMI BT: stuck, try power cycle\n");
440
441 /* this is most likely during insmod */
442 else if (bt->seq <= (unsigned char)(bt->BT_CAP_retries & 0xFF)) {
443 printk(KERN_WARNING "IPMI: BT reset (takes 5 secs)\n");
444 bt->state = BT_STATE_RESET1;
445 return SI_SM_CALL_WITHOUT_DELAY;
446 }
447
Corey Minyardc305e3d2008-04-29 01:01:10 -0700448 /*
449 * Concoct a useful error message, set up the next state, and
450 * be done with this sequence.
451 */
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800452
453 bt->state = BT_STATE_IDLE;
454 switch (cCode) {
455 case IPMI_TIMEOUT_ERR:
456 if (status & BT_B_BUSY) {
457 cCode = IPMI_NODE_BUSY_ERR;
458 bt->state = BT_STATE_LONG_BUSY;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700459 }
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800460 break;
461 default:
462 break;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700463 }
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800464 force_result(bt, cCode);
465 return SI_SM_TRANSACTION_COMPLETE;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700466}
467
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800468/* Check status and (usually) take action and change this state machine. */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700469
470static enum si_sm_result bt_event(struct si_sm_data *bt, long time)
471{
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800472 unsigned char status, BT_CAP[8];
473 static enum bt_states last_printed = BT_STATE_PRINTME;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700474 int i;
475
476 status = BT_STATUS;
477 bt->nonzero_status |= status;
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800478 if ((bt_debug & BT_DEBUG_STATES) && (bt->state != last_printed)) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700479 printk(KERN_WARNING "BT: %s %s TO=%ld - %ld \n",
480 STATE2TXT,
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800481 STATUS2TXT,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700482 bt->timeout,
483 time);
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800484 last_printed = bt->state;
485 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700486
Corey Minyardc305e3d2008-04-29 01:01:10 -0700487 /*
488 * Commands that time out may still (eventually) provide a response.
489 * This stale response will get in the way of a new response so remove
490 * it if possible (hopefully during IDLE). Even if it comes up later
491 * it will be rejected by its (now-forgotten) seq number.
492 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700493
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800494 if ((bt->state < BT_STATE_WRITE_BYTES) && (status & BT_B2H_ATN)) {
495 drain_BMC2HOST(bt);
496 BT_SI_SM_RETURN(SI_SM_CALL_WITH_DELAY);
497 }
498
499 if ((bt->state != BT_STATE_IDLE) &&
Corey Minyardc305e3d2008-04-29 01:01:10 -0700500 (bt->state < BT_STATE_PRINTME)) {
501 /* check timeout */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700502 bt->timeout -= time;
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800503 if ((bt->timeout < 0) && (bt->state < BT_STATE_RESET1))
504 return error_recovery(bt,
505 status,
506 IPMI_TIMEOUT_ERR);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700507 }
508
509 switch (bt->state) {
510
Corey Minyardc305e3d2008-04-29 01:01:10 -0700511 /*
512 * Idle state first checks for asynchronous messages from another
513 * channel, then does some opportunistic housekeeping.
514 */
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800515
516 case BT_STATE_IDLE:
Linus Torvalds1da177e2005-04-16 15:20:36 -0700517 if (status & BT_SMS_ATN) {
518 BT_CONTROL(BT_SMS_ATN); /* clear it */
519 return SI_SM_ATTN;
520 }
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800521
522 if (status & BT_H_BUSY) /* clear a leftover H_BUSY */
523 BT_CONTROL(BT_H_BUSY);
524
525 /* Read BT capabilities if it hasn't been done yet */
526 if (!bt->BT_CAP_outreqs)
527 BT_STATE_CHANGE(BT_STATE_CAPABILITIES_BEGIN,
528 SI_SM_CALL_WITHOUT_DELAY);
529 bt->timeout = bt->BT_CAP_req2rsp;
530 BT_SI_SM_RETURN(SI_SM_IDLE);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700531
532 case BT_STATE_XACTION_START:
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800533 if (status & (BT_B_BUSY | BT_H2B_ATN))
534 BT_SI_SM_RETURN(SI_SM_CALL_WITH_DELAY);
535 if (BT_STATUS & BT_H_BUSY)
536 BT_CONTROL(BT_H_BUSY); /* force clear */
537 BT_STATE_CHANGE(BT_STATE_WRITE_BYTES,
538 SI_SM_CALL_WITHOUT_DELAY);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700539
540 case BT_STATE_WRITE_BYTES:
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800541 if (status & BT_H_BUSY)
542 BT_CONTROL(BT_H_BUSY); /* clear */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700543 BT_CONTROL(BT_CLR_WR_PTR);
544 write_all_bytes(bt);
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800545 BT_CONTROL(BT_H2B_ATN); /* can clear too fast to catch */
546 BT_STATE_CHANGE(BT_STATE_WRITE_CONSUME,
547 SI_SM_CALL_WITHOUT_DELAY);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700548
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800549 case BT_STATE_WRITE_CONSUME:
550 if (status & (BT_B_BUSY | BT_H2B_ATN))
551 BT_SI_SM_RETURN(SI_SM_CALL_WITH_DELAY);
552 BT_STATE_CHANGE(BT_STATE_READ_WAIT,
553 SI_SM_CALL_WITHOUT_DELAY);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700554
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800555 /* Spinning hard can suppress B2H_ATN and force a timeout */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700556
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800557 case BT_STATE_READ_WAIT:
558 if (!(status & BT_B2H_ATN))
559 BT_SI_SM_RETURN(SI_SM_CALL_WITH_DELAY);
560 BT_CONTROL(BT_H_BUSY); /* set */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700561
Corey Minyardc305e3d2008-04-29 01:01:10 -0700562 /*
563 * Uncached, ordered writes should just proceeed serially but
564 * some BMCs don't clear B2H_ATN with one hit. Fast-path a
565 * workaround without too much penalty to the general case.
566 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700567
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800568 BT_CONTROL(BT_B2H_ATN); /* clear it to ACK the BMC */
569 BT_STATE_CHANGE(BT_STATE_CLEAR_B2H,
570 SI_SM_CALL_WITHOUT_DELAY);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700571
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800572 case BT_STATE_CLEAR_B2H:
Corey Minyardc305e3d2008-04-29 01:01:10 -0700573 if (status & BT_B2H_ATN) {
574 /* keep hitting it */
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800575 BT_CONTROL(BT_B2H_ATN);
576 BT_SI_SM_RETURN(SI_SM_CALL_WITH_DELAY);
577 }
578 BT_STATE_CHANGE(BT_STATE_READ_BYTES,
579 SI_SM_CALL_WITHOUT_DELAY);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700580
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800581 case BT_STATE_READ_BYTES:
Corey Minyardc305e3d2008-04-29 01:01:10 -0700582 if (!(status & BT_H_BUSY))
583 /* check in case of retry */
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800584 BT_CONTROL(BT_H_BUSY);
585 BT_CONTROL(BT_CLR_RD_PTR); /* start of BMC2HOST buffer */
586 i = read_all_bytes(bt); /* true == packet seq match */
587 BT_CONTROL(BT_H_BUSY); /* NOW clear */
588 if (!i) /* Not my message */
589 BT_STATE_CHANGE(BT_STATE_READ_WAIT,
590 SI_SM_CALL_WITHOUT_DELAY);
591 bt->state = bt->complete;
592 return bt->state == BT_STATE_IDLE ? /* where to next? */
593 SI_SM_TRANSACTION_COMPLETE : /* normal */
594 SI_SM_CALL_WITHOUT_DELAY; /* Startup magic */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700595
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800596 case BT_STATE_LONG_BUSY: /* For example: after FW update */
597 if (!(status & BT_B_BUSY)) {
598 reset_flags(bt); /* next state is now IDLE */
599 bt_init_data(bt, bt->io);
600 }
601 return SI_SM_CALL_WITH_DELAY; /* No repeat printing */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700602
603 case BT_STATE_RESET1:
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800604 reset_flags(bt);
605 drain_BMC2HOST(bt);
606 BT_STATE_CHANGE(BT_STATE_RESET2,
607 SI_SM_CALL_WITH_DELAY);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700608
609 case BT_STATE_RESET2: /* Send a soft reset */
610 BT_CONTROL(BT_CLR_WR_PTR);
611 HOST2BMC(3); /* number of bytes following */
612 HOST2BMC(0x18); /* NetFn/LUN == Application, LUN 0 */
613 HOST2BMC(42); /* Sequence number */
614 HOST2BMC(3); /* Cmd == Soft reset */
615 BT_CONTROL(BT_H2B_ATN);
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800616 bt->timeout = BT_RESET_DELAY * 1000000;
617 BT_STATE_CHANGE(BT_STATE_RESET3,
618 SI_SM_CALL_WITH_DELAY);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700619
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800620 case BT_STATE_RESET3: /* Hold off everything for a bit */
Corey Minyarde8b33612005-09-06 15:18:45 -0700621 if (bt->timeout > 0)
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800622 return SI_SM_CALL_WITH_DELAY;
623 drain_BMC2HOST(bt);
624 BT_STATE_CHANGE(BT_STATE_RESTART,
625 SI_SM_CALL_WITH_DELAY);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700626
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800627 case BT_STATE_RESTART: /* don't reset retries or seq! */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700628 bt->read_count = 0;
629 bt->nonzero_status = 0;
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800630 bt->timeout = bt->BT_CAP_req2rsp;
631 BT_STATE_CHANGE(BT_STATE_XACTION_START,
632 SI_SM_CALL_WITH_DELAY);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700633
Corey Minyardc305e3d2008-04-29 01:01:10 -0700634 /*
635 * Get BT Capabilities, using timing of upper level state machine.
636 * Set outreqs to prevent infinite loop on timeout.
637 */
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800638 case BT_STATE_CAPABILITIES_BEGIN:
639 bt->BT_CAP_outreqs = 1;
640 {
641 unsigned char GetBT_CAP[] = { 0x18, 0x36 };
642 bt->state = BT_STATE_IDLE;
643 bt_start_transaction(bt, GetBT_CAP, sizeof(GetBT_CAP));
644 }
645 bt->complete = BT_STATE_CAPABILITIES_END;
646 BT_STATE_CHANGE(BT_STATE_XACTION_START,
647 SI_SM_CALL_WITH_DELAY);
648
649 case BT_STATE_CAPABILITIES_END:
650 i = bt_get_result(bt, BT_CAP, sizeof(BT_CAP));
651 bt_init_data(bt, bt->io);
652 if ((i == 8) && !BT_CAP[2]) {
653 bt->BT_CAP_outreqs = BT_CAP[3];
654 bt->BT_CAP_req2rsp = BT_CAP[6] * 1000000;
655 bt->BT_CAP_retries = BT_CAP[7];
656 } else
657 printk(KERN_WARNING "IPMI BT: using default values\n");
658 if (!bt->BT_CAP_outreqs)
659 bt->BT_CAP_outreqs = 1;
660 printk(KERN_WARNING "IPMI BT: req2rsp=%ld secs retries=%d\n",
661 bt->BT_CAP_req2rsp / 1000000L, bt->BT_CAP_retries);
662 bt->timeout = bt->BT_CAP_req2rsp;
663 return SI_SM_CALL_WITHOUT_DELAY;
664
665 default: /* should never occur */
666 return error_recovery(bt,
667 status,
668 IPMI_ERR_UNSPECIFIED);
669 }
670 return SI_SM_CALL_WITH_DELAY;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700671}
672
673static int bt_detect(struct si_sm_data *bt)
674{
Corey Minyardc305e3d2008-04-29 01:01:10 -0700675 /*
676 * It's impossible for the BT status and interrupt registers to be
677 * all 1's, (assuming a properly functioning, self-initialized BMC)
678 * but that's what you get from reading a bogus address, so we
679 * test that first. The calling routine uses negative logic.
680 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700681
Corey Minyarde8b33612005-09-06 15:18:45 -0700682 if ((BT_STATUS == 0xFF) && (BT_INTMASK_R == 0xFF))
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800683 return 1;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700684 reset_flags(bt);
685 return 0;
686}
687
688static void bt_cleanup(struct si_sm_data *bt)
689{
690}
691
692static int bt_size(void)
693{
694 return sizeof(struct si_sm_data);
695}
696
Corey Minyardc305e3d2008-04-29 01:01:10 -0700697struct si_sm_handlers bt_smi_handlers = {
Corey Minyard4d7cbac2006-12-06 20:41:14 -0800698 .init_data = bt_init_data,
699 .start_transaction = bt_start_transaction,
700 .get_result = bt_get_result,
701 .event = bt_event,
702 .detect = bt_detect,
703 .cleanup = bt_cleanup,
704 .size = bt_size,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700705};