1 // SPDX-License-Identifier: GPL-2.0-or-later
5 * (C) Copyright IBM Deutschland Entwicklung GmbH 2005
7 * PMI (Platform Management Interrupt) is a way to communicate
8 * with the BMC (Baseboard Management Controller) via interrupts.
9 * Unlike IPMI it is bidirectional and has a low latency.
14 #include <linux/interrupt.h>
15 #include <linux/slab.h>
16 #include <linux/completion.h>
17 #include <linux/spinlock.h>
18 #include <linux/module.h>
19 #include <linux/workqueue.h>
20 #include <linux/of_address.h>
21 #include <linux/of_device.h>
22 #include <linux/of_irq.h>
23 #include <linux/of_platform.h>
29 struct list_head handler;
30 spinlock_t handler_spinlock;
31 spinlock_t pmi_spinlock;
32 struct mutex msg_mutex;
34 struct completion *completion;
35 struct platform_device *dev;
38 struct work_struct work;
41 static struct pmi_data *data;
43 static irqreturn_t pmi_irq_handler(int irq, void *dev_id)
48 spin_lock(&data->pmi_spinlock);
50 type = ioread8(data->pmi_reg + PMI_READ_TYPE);
51 pr_debug("pmi: got message of type %d\n", type);
53 if (type & PMI_ACK && !data->completion) {
54 printk(KERN_WARNING "pmi: got unexpected ACK message.\n");
59 if (data->completion && !(type & PMI_ACK)) {
60 printk(KERN_WARNING "pmi: expected ACK, but got %d\n", type);
65 data->msg.type = type;
66 data->msg.data0 = ioread8(data->pmi_reg + PMI_READ_DATA0);
67 data->msg.data1 = ioread8(data->pmi_reg + PMI_READ_DATA1);
68 data->msg.data2 = ioread8(data->pmi_reg + PMI_READ_DATA2);
71 spin_unlock(&data->pmi_spinlock);
78 if (data->msg.type & PMI_ACK) {
79 complete(data->completion);
84 schedule_work(&data->work);
92 static const struct of_device_id pmi_match[] = {
93 { .type = "ibm,pmi", .name = "ibm,pmi" },
94 { .type = "ibm,pmi" },
98 MODULE_DEVICE_TABLE(of, pmi_match);
100 static void pmi_notify_handlers(struct work_struct *work)
102 struct pmi_handler *handler;
104 spin_lock(&data->handler_spinlock);
105 list_for_each_entry(handler, &data->handler, node) {
106 pr_debug("pmi: notifying handler %p\n", handler);
107 if (handler->type == data->msg.type)
108 handler->handle_pmi_message(data->msg);
110 spin_unlock(&data->handler_spinlock);
113 static int pmi_of_probe(struct platform_device *dev)
115 struct device_node *np = dev->dev.of_node;
119 printk(KERN_ERR "pmi: driver has already been initialized.\n");
124 data = kzalloc(sizeof(struct pmi_data), GFP_KERNEL);
126 printk(KERN_ERR "pmi: could not allocate memory.\n");
131 data->pmi_reg = of_iomap(np, 0);
132 if (!data->pmi_reg) {
133 printk(KERN_ERR "pmi: invalid register address.\n");
135 goto error_cleanup_data;
138 INIT_LIST_HEAD(&data->handler);
140 mutex_init(&data->msg_mutex);
141 spin_lock_init(&data->pmi_spinlock);
142 spin_lock_init(&data->handler_spinlock);
144 INIT_WORK(&data->work, pmi_notify_handlers);
148 data->irq = irq_of_parse_and_map(np, 0);
150 printk(KERN_ERR "pmi: invalid interrupt.\n");
152 goto error_cleanup_iomap;
155 rc = request_irq(data->irq, pmi_irq_handler, 0, "pmi", NULL);
157 printk(KERN_ERR "pmi: can't request IRQ %d: returned %d\n",
159 goto error_cleanup_iomap;
162 printk(KERN_INFO "pmi: found pmi device at addr %p.\n", data->pmi_reg);
167 iounmap(data->pmi_reg);
176 static int pmi_of_remove(struct platform_device *dev)
178 struct pmi_handler *handler, *tmp;
180 free_irq(data->irq, NULL);
181 iounmap(data->pmi_reg);
183 spin_lock(&data->handler_spinlock);
185 list_for_each_entry_safe(handler, tmp, &data->handler, node)
186 list_del(&handler->node);
188 spin_unlock(&data->handler_spinlock);
196 static struct platform_driver pmi_of_platform_driver = {
197 .probe = pmi_of_probe,
198 .remove = pmi_of_remove,
201 .of_match_table = pmi_match,
204 module_platform_driver(pmi_of_platform_driver);
206 int pmi_send_message(pmi_message_t msg)
209 DECLARE_COMPLETION_ONSTACK(completion);
214 mutex_lock(&data->msg_mutex);
217 pr_debug("pmi_send_message: msg is %08x\n", *(u32*)&msg);
219 data->completion = &completion;
221 spin_lock_irqsave(&data->pmi_spinlock, flags);
222 iowrite8(msg.data0, data->pmi_reg + PMI_WRITE_DATA0);
223 iowrite8(msg.data1, data->pmi_reg + PMI_WRITE_DATA1);
224 iowrite8(msg.data2, data->pmi_reg + PMI_WRITE_DATA2);
225 iowrite8(msg.type, data->pmi_reg + PMI_WRITE_TYPE);
226 spin_unlock_irqrestore(&data->pmi_spinlock, flags);
228 pr_debug("pmi_send_message: wait for completion\n");
230 wait_for_completion_interruptible_timeout(data->completion,
233 data->completion = NULL;
235 mutex_unlock(&data->msg_mutex);
239 EXPORT_SYMBOL_GPL(pmi_send_message);
241 int pmi_register_handler(struct pmi_handler *handler)
246 spin_lock(&data->handler_spinlock);
247 list_add_tail(&handler->node, &data->handler);
248 spin_unlock(&data->handler_spinlock);
252 EXPORT_SYMBOL_GPL(pmi_register_handler);
254 void pmi_unregister_handler(struct pmi_handler *handler)
259 pr_debug("pmi: unregistering handler %p\n", handler);
261 spin_lock(&data->handler_spinlock);
262 list_del(&handler->node);
263 spin_unlock(&data->handler_spinlock);
265 EXPORT_SYMBOL_GPL(pmi_unregister_handler);
267 MODULE_LICENSE("GPL");
269 MODULE_DESCRIPTION("IBM Platform Management Interrupt driver");