4 * (C) Copyright IBM Deutschland Entwicklung GmbH 2005
6 * PMI (Platform Management Interrupt) is a way to communicate
7 * with the BMC (Baseboard Management Controller) via interrupts.
8 * Unlike IPMI it is bidirectional and has a low latency.
10 * Author: Christian Krafft <krafft@de.ibm.com>
12 * This program is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation; either version 2, or (at your option)
17 * This program is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
22 * You should have received a copy of the GNU General Public License
23 * along with this program; if not, write to the Free Software
24 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
27 #include <linux/interrupt.h>
28 #include <linux/slab.h>
29 #include <linux/completion.h>
30 #include <linux/spinlock.h>
31 #include <linux/workqueue.h>
32 #include <linux/of_device.h>
33 #include <linux/of_platform.h>
40 struct list_head handler
;
41 spinlock_t handler_spinlock
;
42 spinlock_t pmi_spinlock
;
43 struct mutex msg_mutex
;
45 struct completion
*completion
;
46 struct platform_device
*dev
;
49 struct work_struct work
;
52 static struct pmi_data
*data
;
54 static irqreturn_t
pmi_irq_handler(int irq
, void *dev_id
)
59 spin_lock(&data
->pmi_spinlock
);
61 type
= ioread8(data
->pmi_reg
+ PMI_READ_TYPE
);
62 pr_debug("pmi: got message of type %d\n", type
);
64 if (type
& PMI_ACK
&& !data
->completion
) {
65 printk(KERN_WARNING
"pmi: got unexpected ACK message.\n");
70 if (data
->completion
&& !(type
& PMI_ACK
)) {
71 printk(KERN_WARNING
"pmi: expected ACK, but got %d\n", type
);
76 data
->msg
.type
= type
;
77 data
->msg
.data0
= ioread8(data
->pmi_reg
+ PMI_READ_DATA0
);
78 data
->msg
.data1
= ioread8(data
->pmi_reg
+ PMI_READ_DATA1
);
79 data
->msg
.data2
= ioread8(data
->pmi_reg
+ PMI_READ_DATA2
);
82 spin_unlock(&data
->pmi_spinlock
);
89 if (data
->msg
.type
& PMI_ACK
) {
90 complete(data
->completion
);
95 schedule_work(&data
->work
);
103 static struct of_device_id pmi_match
[] = {
104 { .type
= "ibm,pmi", .name
= "ibm,pmi" },
105 { .type
= "ibm,pmi" },
109 MODULE_DEVICE_TABLE(of
, pmi_match
);
111 static void pmi_notify_handlers(struct work_struct
*work
)
113 struct pmi_handler
*handler
;
115 spin_lock(&data
->handler_spinlock
);
116 list_for_each_entry(handler
, &data
->handler
, node
) {
117 pr_debug("pmi: notifying handler %p\n", handler
);
118 if (handler
->type
== data
->msg
.type
)
119 handler
->handle_pmi_message(data
->msg
);
121 spin_unlock(&data
->handler_spinlock
);
124 static int pmi_of_probe(struct platform_device
*dev
)
126 struct device_node
*np
= dev
->dev
.of_node
;
130 printk(KERN_ERR
"pmi: driver has already been initialized.\n");
135 data
= kzalloc(sizeof(struct pmi_data
), GFP_KERNEL
);
137 printk(KERN_ERR
"pmi: could not allocate memory.\n");
142 data
->pmi_reg
= of_iomap(np
, 0);
143 if (!data
->pmi_reg
) {
144 printk(KERN_ERR
"pmi: invalid register address.\n");
146 goto error_cleanup_data
;
149 INIT_LIST_HEAD(&data
->handler
);
151 mutex_init(&data
->msg_mutex
);
152 spin_lock_init(&data
->pmi_spinlock
);
153 spin_lock_init(&data
->handler_spinlock
);
155 INIT_WORK(&data
->work
, pmi_notify_handlers
);
159 data
->irq
= irq_of_parse_and_map(np
, 0);
160 if (data
->irq
== NO_IRQ
) {
161 printk(KERN_ERR
"pmi: invalid interrupt.\n");
163 goto error_cleanup_iomap
;
166 rc
= request_irq(data
->irq
, pmi_irq_handler
, 0, "pmi", NULL
);
168 printk(KERN_ERR
"pmi: can't request IRQ %d: returned %d\n",
170 goto error_cleanup_iomap
;
173 printk(KERN_INFO
"pmi: found pmi device at addr %p.\n", data
->pmi_reg
);
178 iounmap(data
->pmi_reg
);
187 static int pmi_of_remove(struct platform_device
*dev
)
189 struct pmi_handler
*handler
, *tmp
;
191 free_irq(data
->irq
, NULL
);
192 iounmap(data
->pmi_reg
);
194 spin_lock(&data
->handler_spinlock
);
196 list_for_each_entry_safe(handler
, tmp
, &data
->handler
, node
)
197 list_del(&handler
->node
);
199 spin_unlock(&data
->handler_spinlock
);
207 static struct platform_driver pmi_of_platform_driver
= {
208 .probe
= pmi_of_probe
,
209 .remove
= pmi_of_remove
,
212 .owner
= THIS_MODULE
,
213 .of_match_table
= pmi_match
,
217 static int __init
pmi_module_init(void)
219 return platform_driver_register(&pmi_of_platform_driver
);
221 module_init(pmi_module_init
);
223 static void __exit
pmi_module_exit(void)
225 platform_driver_unregister(&pmi_of_platform_driver
);
227 module_exit(pmi_module_exit
);
229 int pmi_send_message(pmi_message_t msg
)
232 DECLARE_COMPLETION_ONSTACK(completion
);
237 mutex_lock(&data
->msg_mutex
);
240 pr_debug("pmi_send_message: msg is %08x\n", *(u32
*)&msg
);
242 data
->completion
= &completion
;
244 spin_lock_irqsave(&data
->pmi_spinlock
, flags
);
245 iowrite8(msg
.data0
, data
->pmi_reg
+ PMI_WRITE_DATA0
);
246 iowrite8(msg
.data1
, data
->pmi_reg
+ PMI_WRITE_DATA1
);
247 iowrite8(msg
.data2
, data
->pmi_reg
+ PMI_WRITE_DATA2
);
248 iowrite8(msg
.type
, data
->pmi_reg
+ PMI_WRITE_TYPE
);
249 spin_unlock_irqrestore(&data
->pmi_spinlock
, flags
);
251 pr_debug("pmi_send_message: wait for completion\n");
253 wait_for_completion_interruptible_timeout(data
->completion
,
256 data
->completion
= NULL
;
258 mutex_unlock(&data
->msg_mutex
);
262 EXPORT_SYMBOL_GPL(pmi_send_message
);
264 int pmi_register_handler(struct pmi_handler
*handler
)
269 spin_lock(&data
->handler_spinlock
);
270 list_add_tail(&handler
->node
, &data
->handler
);
271 spin_unlock(&data
->handler_spinlock
);
275 EXPORT_SYMBOL_GPL(pmi_register_handler
);
277 void pmi_unregister_handler(struct pmi_handler
*handler
)
282 pr_debug("pmi: unregistering handler %p\n", handler
);
284 spin_lock(&data
->handler_spinlock
);
285 list_del(&handler
->node
);
286 spin_unlock(&data
->handler_spinlock
);
288 EXPORT_SYMBOL_GPL(pmi_unregister_handler
);
290 MODULE_LICENSE("GPL");
291 MODULE_AUTHOR("Christian Krafft <krafft@de.ibm.com>");
292 MODULE_DESCRIPTION("IBM Platform Management Interrupt driver");