4 * Copyright (C) 1999-2002 Red Hat Software
6 * Written by Alan Cox, Building Number Three Ltd
8 * This program is free software; you can redistribute it and/or modify it
9 * under the terms of the GNU General Public License as published by the
10 * Free Software Foundation; either version 2 of the License, or (at your
11 * option) any later version.
13 * A lot of the I2O message side code from this is taken from the Red
14 * Creek RCPCI45 adapter driver by Red Creek Communications
18 * Juha Sievänen <Juha.Sievanen@cs.Helsinki.FI>
19 * Auvo Häkkinen <Auvo.Hakkinen@cs.Helsinki.FI>
20 * Deepak Saxena <deepak@plexity.net>
21 * Boji T Kannanthanam <boji.t.kannanthanam@intel.com>
22 * Alan Cox <alan@redhat.com>:
23 * Ported to Linux 2.5.
24 * Markus Lidel <Markus.Lidel@shadowconnect.com>:
25 * Minor fixes for 2.6.
26 * Markus Lidel <Markus.Lidel@shadowconnect.com>:
27 * Support for sysfs included.
30 #include <linux/module.h>
31 #include <linux/i2o.h>
32 #include <linux/delay.h>
33 #include <linux/workqueue.h>
34 #include <linux/string.h>
35 #include <linux/slab.h>
36 #include <linux/sched.h> /* wait_event_interruptible_timeout() needs this */
37 #include <asm/param.h> /* HZ */
40 #define OSM_NAME "exec-osm"
42 struct i2o_driver i2o_exec_driver;
44 static int i2o_exec_lct_notify(struct i2o_controller *c, u32 change_ind);
46 /* global wait list for POST WAIT */
47 static LIST_HEAD(i2o_exec_wait_list);
49 /* Wait struct needed for POST WAIT */
50 struct i2o_exec_wait {
51 wait_queue_head_t *wq; /* Pointer to Wait queue */
52 struct i2o_dma dma; /* DMA buffers to free on failure */
53 u32 tcntxt; /* transaction context from reply */
54 int complete; /* 1 if reply received otherwise 0 */
55 u32 m; /* message id */
56 struct i2o_message *msg; /* pointer to the reply message */
57 struct list_head list; /* node in global wait list */
58 spinlock_t lock; /* lock before modifying */
61 /* Work struct needed to handle LCT NOTIFY replies */
62 struct i2o_exec_lct_notify_work {
63 struct work_struct work; /* work struct */
64 struct i2o_controller *c; /* controller on which the LCT NOTIFY
68 /* Exec OSM class handling definition */
69 static struct i2o_class_id i2o_exec_class_id[] = {
70 {I2O_CLASS_EXECUTIVE},
75 * i2o_exec_wait_alloc - Allocate a i2o_exec_wait struct an initialize it
77 * Allocate the i2o_exec_wait struct and initialize the wait.
79 * Returns i2o_exec_wait pointer on success or negative error code on
82 static struct i2o_exec_wait *i2o_exec_wait_alloc(void)
84 struct i2o_exec_wait *wait;
86 wait = kzalloc(sizeof(*wait), GFP_KERNEL);
90 INIT_LIST_HEAD(&wait->list);
91 spin_lock_init(&wait->lock);
97 * i2o_exec_wait_free - Free an i2o_exec_wait struct
98 * @wait: I2O wait data which should be cleaned up
100 static void i2o_exec_wait_free(struct i2o_exec_wait *wait)
106 * i2o_msg_post_wait_mem - Post and wait a message with DMA buffers
108 * @msg: message to post
109 * @timeout: time in seconds to wait
110 * @dma: i2o_dma struct of the DMA buffer to free on failure
112 * This API allows an OSM to post a message and then be told whether or
113 * not the system received a successful reply. If the message times out
114 * then the value '-ETIMEDOUT' is returned. This is a special case. In
115 * this situation the message may (should) complete at an indefinite time
116 * in the future. When it completes it will use the memory buffer
117 * attached to the request. If -ETIMEDOUT is returned then the memory
118 * buffer must not be freed. Instead the event completion will free them
119 * for you. In all other cases the buffer are your problem.
121 * Returns 0 on success, negative error code on timeout or positive error
124 int i2o_msg_post_wait_mem(struct i2o_controller *c, struct i2o_message *msg,
125 unsigned long timeout, struct i2o_dma *dma)
127 DECLARE_WAIT_QUEUE_HEAD_ONSTACK(wq);
128 struct i2o_exec_wait *wait;
129 static u32 tcntxt = 0x80000000;
133 wait = i2o_exec_wait_alloc();
139 if (tcntxt == 0xffffffff)
146 * Fill in the message initiator context and transaction context.
147 * We will only use transaction contexts >= 0x80000000 for POST WAIT,
148 * so we could find a POST WAIT reply easier in the reply handler.
150 msg->u.s.icntxt = cpu_to_le32(i2o_exec_driver.context);
151 wait->tcntxt = tcntxt++;
152 msg->u.s.tcntxt = cpu_to_le32(wait->tcntxt);
156 * we add elements to the head, because if a entry in the list will
157 * never be removed, we have to iterate over it every time
159 list_add(&wait->list, &i2o_exec_wait_list);
162 * Post the message to the controller. At some point later it will
163 * return. If we time out before it returns then complete will be zero.
165 i2o_msg_post(c, msg);
167 wait_event_interruptible_timeout(wq, wait->complete, timeout * HZ);
169 spin_lock_irqsave(&wait->lock, flags);
174 rc = le32_to_cpu(wait->msg->body[0]) >> 24;
177 * We cannot remove it now. This is important. When it does
178 * terminate (which it must do if the controller has not
179 * died...) then it will otherwise scribble on stuff.
181 * FIXME: try abort message
189 spin_unlock_irqrestore(&wait->lock, flags);
191 if (rc != -ETIMEDOUT) {
192 i2o_flush_reply(c, wait->m);
193 i2o_exec_wait_free(wait);
200 * i2o_msg_post_wait_complete - Reply to a i2o_msg_post request from IOP
201 * @c: I2O controller which answers
203 * @msg: pointer to the I2O reply message
204 * @context: transaction context of request
206 * This function is called in interrupt context only. If the reply reached
207 * before the timeout, the i2o_exec_wait struct is filled with the message
208 * and the task will be waked up. The task is now responsible for returning
209 * the message m back to the controller! If the message reaches us after
210 * the timeout clean up the i2o_exec_wait struct (including allocated
213 * Return 0 on success and if the message m should not be given back to the
214 * I2O controller, or >0 on success and if the message should be given back
215 * afterwords. Returns negative error code on failure. In this case the
216 * message must also be given back to the controller.
218 static int i2o_msg_post_wait_complete(struct i2o_controller *c, u32 m,
219 struct i2o_message *msg, u32 context)
221 struct i2o_exec_wait *wait, *tmp;
226 * We need to search through the i2o_exec_wait_list to see if the given
227 * message is still outstanding. If not, it means that the IOP took
228 * longer to respond to the message than we had allowed and timer has
229 * already expired. Not much we can do about that except log it for
230 * debug purposes, increase timeout, and recompile.
232 list_for_each_entry_safe(wait, tmp, &i2o_exec_wait_list, list) {
233 if (wait->tcntxt == context) {
234 spin_lock_irqsave(&wait->lock, flags);
236 list_del(&wait->list);
247 spin_unlock_irqrestore(&wait->lock, flags);
254 pr_debug("%s: timedout reply received!\n",
256 i2o_dma_free(dev, &wait->dma);
257 i2o_exec_wait_free(wait);
259 wake_up_interruptible(wait->wq);
265 osm_warn("%s: Bogus reply in POST WAIT (tr-context: %08x)!\n", c->name,
272 * i2o_exec_show_vendor_id - Displays Vendor ID of controller
273 * @d: device of which the Vendor ID should be displayed
274 * @attr: device_attribute to display
275 * @buf: buffer into which the Vendor ID should be printed
277 * Returns number of bytes printed into buffer.
279 static ssize_t i2o_exec_show_vendor_id(struct device *d,
280 struct device_attribute *attr, char *buf)
282 struct i2o_device *dev = to_i2o_device(d);
285 if (!i2o_parm_field_get(dev, 0x0000, 0, &id, 2)) {
286 sprintf(buf, "0x%04x", le16_to_cpu(id));
287 return strlen(buf) + 1;
294 * i2o_exec_show_product_id - Displays Product ID of controller
295 * @d: device of which the Product ID should be displayed
296 * @attr: device_attribute to display
297 * @buf: buffer into which the Product ID should be printed
299 * Returns number of bytes printed into buffer.
301 static ssize_t i2o_exec_show_product_id(struct device *d,
302 struct device_attribute *attr,
305 struct i2o_device *dev = to_i2o_device(d);
308 if (!i2o_parm_field_get(dev, 0x0000, 1, &id, 2)) {
309 sprintf(buf, "0x%04x", le16_to_cpu(id));
310 return strlen(buf) + 1;
316 /* Exec-OSM device attributes */
317 static DEVICE_ATTR(vendor_id, S_IRUGO, i2o_exec_show_vendor_id, NULL);
318 static DEVICE_ATTR(product_id, S_IRUGO, i2o_exec_show_product_id, NULL);
321 * i2o_exec_probe - Called if a new I2O device (executive class) appears
322 * @dev: I2O device which should be probed
324 * Registers event notification for every event from Executive device. The
325 * return is always 0, because we want all devices of class Executive.
327 * Returns 0 on success.
329 static int i2o_exec_probe(struct device *dev)
331 struct i2o_device *i2o_dev = to_i2o_device(dev);
334 rc = i2o_event_register(i2o_dev, &i2o_exec_driver, 0, 0xffffffff);
335 if (rc) goto err_out;
337 rc = device_create_file(dev, &dev_attr_vendor_id);
338 if (rc) goto err_evtreg;
339 rc = device_create_file(dev, &dev_attr_product_id);
340 if (rc) goto err_vid;
342 i2o_dev->iop->exec = i2o_dev;
347 device_remove_file(dev, &dev_attr_vendor_id);
349 i2o_event_register(to_i2o_device(dev), &i2o_exec_driver, 0, 0);
355 * i2o_exec_remove - Called on I2O device removal
356 * @dev: I2O device which was removed
358 * Unregisters event notification from Executive I2O device.
360 * Returns 0 on success.
362 static int i2o_exec_remove(struct device *dev)
364 device_remove_file(dev, &dev_attr_product_id);
365 device_remove_file(dev, &dev_attr_vendor_id);
367 i2o_event_register(to_i2o_device(dev), &i2o_exec_driver, 0, 0);
373 * i2o_exec_lct_modified - Called on LCT NOTIFY reply
374 * @_work: work struct for a specific controller
376 * This function handles asynchronus LCT NOTIFY replies. It parses the
377 * new LCT and if the buffer for the LCT was to small sends a LCT NOTIFY
378 * again, otherwise send LCT NOTIFY to get informed on next LCT change.
380 static void i2o_exec_lct_modified(struct work_struct *_work)
382 struct i2o_exec_lct_notify_work *work =
383 container_of(_work, struct i2o_exec_lct_notify_work, work);
385 struct i2o_controller *c = work->c;
389 if (i2o_device_parse_lct(c) != -EAGAIN)
390 change_ind = c->lct->change_ind + 1;
392 #ifdef CONFIG_I2O_LCT_NOTIFY_ON_CHANGES
393 i2o_exec_lct_notify(c, change_ind);
398 * i2o_exec_reply - I2O Executive reply handler
399 * @c: I2O controller from which the reply comes
401 * @msg: pointer to the I2O reply message
403 * This function is always called from interrupt context. If a POST WAIT
404 * reply was received, pass it to the complete function. If a LCT NOTIFY
405 * reply was received, a new event is created to handle the update.
407 * Returns 0 on success and if the reply should not be flushed or > 0
408 * on success and if the reply should be flushed. Returns negative error
409 * code on failure and if the reply should be flushed.
411 static int i2o_exec_reply(struct i2o_controller *c, u32 m,
412 struct i2o_message *msg)
416 if (le32_to_cpu(msg->u.head[0]) & MSG_FAIL) {
417 struct i2o_message __iomem *pmsg;
421 * If Fail bit is set we must take the transaction context of
422 * the preserved message to find the right request again.
425 pm = le32_to_cpu(msg->body[3]);
426 pmsg = i2o_msg_in_to_virt(c, pm);
427 context = readl(&pmsg->u.s.tcntxt);
429 i2o_report_status(KERN_INFO, "i2o_core", msg);
431 /* Release the preserved msg */
432 i2o_msg_nop_mfa(c, pm);
434 context = le32_to_cpu(msg->u.s.tcntxt);
436 if (context & 0x80000000)
437 return i2o_msg_post_wait_complete(c, m, msg, context);
439 if ((le32_to_cpu(msg->u.head[1]) >> 24) == I2O_CMD_LCT_NOTIFY) {
440 struct i2o_exec_lct_notify_work *work;
442 pr_debug("%s: LCT notify received\n", c->name);
444 work = kmalloc(sizeof(*work), GFP_ATOMIC);
450 INIT_WORK(&work->work, i2o_exec_lct_modified);
451 queue_work(i2o_exec_driver.event_queue, &work->work);
456 * If this happens, we want to dump the message to the syslog so
457 * it can be sent back to the card manufacturer by the end user
458 * to aid in debugging.
461 printk(KERN_WARNING "%s: Unsolicited message reply sent to core!"
462 "Message dumped to syslog\n", c->name);
463 i2o_dump_message(msg);
469 * i2o_exec_event - Event handling function
470 * @work: Work item in occurring event
472 * Handles events send by the Executive device. At the moment does not do
475 static void i2o_exec_event(struct work_struct *work)
477 struct i2o_event *evt = container_of(work, struct i2o_event, work);
479 if (likely(evt->i2o_dev))
480 osm_debug("Event received from device: %d\n",
481 evt->i2o_dev->lct_data.tid);
486 * i2o_exec_lct_get - Get the IOP's Logical Configuration Table
487 * @c: I2O controller from which the LCT should be fetched
489 * Send a LCT NOTIFY request to the controller, and wait
490 * I2O_TIMEOUT_LCT_GET seconds until arrival of response. If the LCT is
491 * to large, retry it.
493 * Returns 0 on success or negative error code on failure.
495 int i2o_exec_lct_get(struct i2o_controller *c)
497 struct i2o_message *msg;
501 for (i = 1; i <= I2O_LCT_GET_TRIES; i++) {
502 msg = i2o_msg_get_wait(c, I2O_TIMEOUT_MESSAGE_GET);
507 cpu_to_le32(EIGHT_WORD_MSG_SIZE | SGL_OFFSET_6);
509 cpu_to_le32(I2O_CMD_LCT_NOTIFY << 24 | HOST_TID << 12 |
511 msg->body[0] = cpu_to_le32(0xffffffff);
512 msg->body[1] = cpu_to_le32(0x00000000);
513 msg->body[2] = cpu_to_le32(0xd0000000 | c->dlct.len);
514 msg->body[3] = cpu_to_le32(c->dlct.phys);
516 rc = i2o_msg_post_wait(c, msg, I2O_TIMEOUT_LCT_GET);
520 rc = i2o_device_parse_lct(c);
529 * i2o_exec_lct_notify - Send a asynchronus LCT NOTIFY request
530 * @c: I2O controller to which the request should be send
531 * @change_ind: change indicator
533 * This function sends a LCT NOTIFY request to the I2O controller with
534 * the change indicator change_ind. If the change_ind == 0 the controller
535 * replies immediately after the request. If change_ind > 0 the reply is
536 * send after change indicator of the LCT is > change_ind.
538 static int i2o_exec_lct_notify(struct i2o_controller *c, u32 change_ind)
540 i2o_status_block *sb = c->status_block.virt;
542 struct i2o_message *msg;
544 mutex_lock(&c->lct_lock);
549 (dev, &c->dlct, le32_to_cpu(sb->expected_lct_size), GFP_KERNEL))
552 msg = i2o_msg_get_wait(c, I2O_TIMEOUT_MESSAGE_GET);
556 msg->u.head[0] = cpu_to_le32(EIGHT_WORD_MSG_SIZE | SGL_OFFSET_6);
557 msg->u.head[1] = cpu_to_le32(I2O_CMD_LCT_NOTIFY << 24 | HOST_TID << 12 |
559 msg->u.s.icntxt = cpu_to_le32(i2o_exec_driver.context);
560 msg->u.s.tcntxt = cpu_to_le32(0x00000000);
561 msg->body[0] = cpu_to_le32(0xffffffff);
562 msg->body[1] = cpu_to_le32(change_ind);
563 msg->body[2] = cpu_to_le32(0xd0000000 | c->dlct.len);
564 msg->body[3] = cpu_to_le32(c->dlct.phys);
566 i2o_msg_post(c, msg);
568 mutex_unlock(&c->lct_lock);
573 /* Exec OSM driver struct */
574 struct i2o_driver i2o_exec_driver = {
576 .reply = i2o_exec_reply,
577 .event = i2o_exec_event,
578 .classes = i2o_exec_class_id,
580 .probe = i2o_exec_probe,
581 .remove = i2o_exec_remove,
586 * i2o_exec_init - Registers the Exec OSM
588 * Registers the Exec OSM in the I2O core.
590 * Returns 0 on success or negative error code on failure.
592 int __init i2o_exec_init(void)
594 return i2o_driver_register(&i2o_exec_driver);
598 * i2o_exec_exit - Removes the Exec OSM
600 * Unregisters the Exec OSM from the I2O core.
602 void i2o_exec_exit(void)
604 i2o_driver_unregister(&i2o_exec_driver);
607 EXPORT_SYMBOL(i2o_msg_post_wait_mem);
608 EXPORT_SYMBOL(i2o_exec_lct_get);