blob: 8b4fc68cebcb2f4c02a716074cb1b1c1045d0d1f [file] [log] [blame]
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +00001/*
2 * PowerNV OPAL high level interfaces
3 *
4 * Copyright 2011 IBM Corp.
5 *
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version
9 * 2 of the License, or (at your option) any later version.
10 */
11
Benjamin Herrenschmidtc8742f82014-12-11 12:39:49 +110012#define pr_fmt(fmt) "opal: " fmt
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +000013
Benjamin Herrenschmidtc8742f82014-12-11 12:39:49 +110014#include <linux/printk.h>
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +000015#include <linux/types.h>
16#include <linux/of.h>
Rob Herring26a20562013-09-26 07:40:04 -050017#include <linux/of_fdt.h>
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +000018#include <linux/of_platform.h>
Benjamin Herrenschmidta125e092011-09-19 17:45:03 +000019#include <linux/interrupt.h>
Gavin Shan1bc98de2013-06-20 18:13:22 +080020#include <linux/notifier.h>
Benjamin Herrenschmidt73ed1482013-05-10 16:59:18 +100021#include <linux/slab.h>
Mahesh Salgaonkarb63a0ff2013-10-30 20:06:13 +053022#include <linux/sched.h>
Vasant Hegde6f68b5e2013-08-27 15:09:52 +053023#include <linux/kobject.h>
Vasant Hegdef7d98d12014-01-15 17:02:04 +110024#include <linux/delay.h>
Mahesh Salgaonkar55672ec2013-12-16 10:46:24 +053025#include <linux/memblock.h>
Benjamin Herrenschmidt3bf57562014-11-14 16:13:50 +110026#include <linux/kthread.h>
27#include <linux/freezer.h>
Michael Ellermanb14726c2014-07-15 22:22:24 +100028
29#include <asm/machdep.h>
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +000030#include <asm/opal.h>
31#include <asm/firmware.h>
Mahesh Salgaonkar36df96f2013-10-30 20:05:40 +053032#include <asm/mce.h>
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +000033
34#include "powernv.h"
35
Vasant Hegde6f68b5e2013-08-27 15:09:52 +053036/* /sys/firmware/opal */
37struct kobject *opal_kobj;
38
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +000039struct opal {
40 u64 base;
41 u64 entry;
Mahesh Salgaonkar55672ec2013-12-16 10:46:24 +053042 u64 size;
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +000043} opal;
44
Mahesh Salgaonkar55672ec2013-12-16 10:46:24 +053045struct mcheck_recoverable_range {
46 u64 start_addr;
47 u64 end_addr;
48 u64 recover_addr;
49};
50
51static struct mcheck_recoverable_range *mc_recoverable_range;
52static int mc_recoverable_range_len;
53
Joel Stanleybfc36892014-04-01 14:28:19 +103054struct device_node *opal_node;
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +000055static DEFINE_SPINLOCK(opal_write_lock);
Mahesh Salgaonkar24366362013-11-18 15:35:58 +053056static struct atomic_notifier_head opal_msg_notifier_head[OPAL_MSG_TYPE_MAX];
Benjamin Herrenschmidt3bf57562014-11-14 16:13:50 +110057static uint32_t opal_heartbeat;
Benjamin Herrenschmidta2036582016-07-04 14:51:44 +100058static struct task_struct *kopald_tsk;
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +000059
Benjamin Herrenschmidtd3cbff12016-07-05 15:03:49 +100060void opal_configure_cores(void)
Benjamin Herrenschmidt49266162014-05-20 11:01:28 +100061{
62 /* Do the actual re-init, This will clobber all FPRs, VRs, etc...
63 *
64 * It will preserve non volatile GPRs and HSPRG0/1. It will
65 * also restore HIDs and other SPRs to their original value
66 * but it might clobber a bunch.
67 */
68#ifdef __BIG_ENDIAN__
69 opal_reinit_cpus(OPAL_REINIT_CPUS_HILE_BE);
70#else
71 opal_reinit_cpus(OPAL_REINIT_CPUS_HILE_LE);
72#endif
Benjamin Herrenschmidtd3cbff12016-07-05 15:03:49 +100073
74 /* Restore some bits */
75 if (cur_cpu_spec->cpu_restore)
76 cur_cpu_spec->cpu_restore();
Benjamin Herrenschmidt49266162014-05-20 11:01:28 +100077}
78
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +000079int __init early_init_dt_scan_opal(unsigned long node,
80 const char *uname, int depth, void *data)
81{
Mahesh Salgaonkar55672ec2013-12-16 10:46:24 +053082 const void *basep, *entryp, *sizep;
Rob Herring9d0c4df2014-04-01 23:49:03 -050083 int basesz, entrysz, runtimesz;
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +000084
85 if (depth != 1 || strcmp(uname, "ibm,opal") != 0)
86 return 0;
87
88 basep = of_get_flat_dt_prop(node, "opal-base-address", &basesz);
89 entryp = of_get_flat_dt_prop(node, "opal-entry-address", &entrysz);
Mahesh Salgaonkar55672ec2013-12-16 10:46:24 +053090 sizep = of_get_flat_dt_prop(node, "opal-runtime-size", &runtimesz);
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +000091
Mahesh Salgaonkar55672ec2013-12-16 10:46:24 +053092 if (!basep || !entryp || !sizep)
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +000093 return 1;
94
95 opal.base = of_read_number(basep, basesz/4);
96 opal.entry = of_read_number(entryp, entrysz/4);
Mahesh Salgaonkar55672ec2013-12-16 10:46:24 +053097 opal.size = of_read_number(sizep, runtimesz/4);
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +000098
Rob Herring9d0c4df2014-04-01 23:49:03 -050099 pr_debug("OPAL Base = 0x%llx (basep=%p basesz=%d)\n",
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000100 opal.base, basep, basesz);
Rob Herring9d0c4df2014-04-01 23:49:03 -0500101 pr_debug("OPAL Entry = 0x%llx (entryp=%p basesz=%d)\n",
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000102 opal.entry, entryp, entrysz);
Rob Herring9d0c4df2014-04-01 23:49:03 -0500103 pr_debug("OPAL Entry = 0x%llx (sizep=%p runtimesz=%d)\n",
Mahesh Salgaonkar55672ec2013-12-16 10:46:24 +0530104 opal.size, sizep, runtimesz);
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000105
Benjamin Herrenschmidt75b93da2013-05-14 15:10:02 +1000106 if (of_flat_dt_is_compatible(node, "ibm,opal-v3")) {
Stewart Smithe4d54f72015-12-09 17:18:20 +1100107 powerpc_firmware_features |= FW_FEATURE_OPAL;
108 pr_info("OPAL detected !\n");
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000109 } else {
Stewart Smith786842b2015-12-09 17:18:18 +1100110 panic("OPAL != V3 detected, no longer supported.\n");
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000111 }
112
Jeremy Kerrc4463b32013-05-01 22:31:50 +0000113 return 1;
114}
115
Mahesh Salgaonkar55672ec2013-12-16 10:46:24 +0530116int __init early_init_dt_scan_recoverable_ranges(unsigned long node,
117 const char *uname, int depth, void *data)
118{
Rob Herring9d0c4df2014-04-01 23:49:03 -0500119 int i, psize, size;
Mahesh Salgaonkar55672ec2013-12-16 10:46:24 +0530120 const __be32 *prop;
121
122 if (depth != 1 || strcmp(uname, "ibm,opal") != 0)
123 return 0;
124
Mahesh Salgaonkar6e556b42014-03-30 11:03:23 +0530125 prop = of_get_flat_dt_prop(node, "mcheck-recoverable-ranges", &psize);
Mahesh Salgaonkar55672ec2013-12-16 10:46:24 +0530126
127 if (!prop)
128 return 1;
129
130 pr_debug("Found machine check recoverable ranges.\n");
131
132 /*
Mahesh Salgaonkar6e556b42014-03-30 11:03:23 +0530133 * Calculate number of available entries.
134 *
135 * Each recoverable address range entry is (start address, len,
136 * recovery address), 2 cells each for start and recovery address,
137 * 1 cell for len, totalling 5 cells per entry.
138 */
139 mc_recoverable_range_len = psize / (sizeof(*prop) * 5);
140
141 /* Sanity check */
142 if (!mc_recoverable_range_len)
143 return 1;
144
145 /* Size required to hold all the entries. */
146 size = mc_recoverable_range_len *
147 sizeof(struct mcheck_recoverable_range);
148
149 /*
Mahesh Salgaonkar55672ec2013-12-16 10:46:24 +0530150 * Allocate a buffer to hold the MC recoverable ranges. We would be
151 * accessing them in real mode, hence it needs to be within
152 * RMO region.
153 */
154 mc_recoverable_range =__va(memblock_alloc_base(size, __alignof__(u64),
155 ppc64_rma_size));
156 memset(mc_recoverable_range, 0, size);
157
Mahesh Salgaonkar6e556b42014-03-30 11:03:23 +0530158 for (i = 0; i < mc_recoverable_range_len; i++) {
Mahesh Salgaonkar55672ec2013-12-16 10:46:24 +0530159 mc_recoverable_range[i].start_addr =
160 of_read_number(prop + (i * 5) + 0, 2);
161 mc_recoverable_range[i].end_addr =
162 mc_recoverable_range[i].start_addr +
163 of_read_number(prop + (i * 5) + 2, 1);
164 mc_recoverable_range[i].recover_addr =
165 of_read_number(prop + (i * 5) + 3, 2);
166
167 pr_debug("Machine check recoverable range: %llx..%llx: %llx\n",
168 mc_recoverable_range[i].start_addr,
169 mc_recoverable_range[i].end_addr,
170 mc_recoverable_range[i].recover_addr);
171 }
Mahesh Salgaonkar55672ec2013-12-16 10:46:24 +0530172 return 1;
173}
174
Jeremy Kerrc4463b32013-05-01 22:31:50 +0000175static int __init opal_register_exception_handlers(void)
176{
Benjamin Herrenschmidt29186092013-09-23 12:05:04 +1000177#ifdef __BIG_ENDIAN__
Jeremy Kerrc4463b32013-05-01 22:31:50 +0000178 u64 glue;
179
180 if (!(powerpc_firmware_features & FW_FEATURE_OPAL))
181 return -ENODEV;
182
Mahesh Salgaonkar28446de2013-10-30 20:05:58 +0530183 /* Hookup some exception handlers except machine check. We use the
184 * fwnmi area at 0x7000 to provide the glue space to OPAL
Benjamin Herrenschmidted79ba92011-09-19 17:45:04 +0000185 */
186 glue = 0x7000;
Mahesh Salgaonkar6507955c2014-10-10 21:28:26 +0530187
188 /*
189 * Check if we are running on newer firmware that exports
190 * OPAL_HANDLE_HMI token. If yes, then don't ask OPAL to patch
191 * the HMI interrupt and we catch it directly in Linux.
192 *
193 * For older firmware (i.e currently released POWER8 System Firmware
194 * as of today <= SV810_087), we fallback to old behavior and let OPAL
195 * patch the HMI vector and handle it inside OPAL firmware.
196 *
197 * For newer firmware (in development/yet to be released) we will
198 * start catching/handling HMI directly in Linux.
199 */
200 if (!opal_check_token(OPAL_HANDLE_HMI)) {
Michael Ellerman08135132015-01-28 15:10:33 +1100201 pr_info("Old firmware detected, OPAL handles HMIs.\n");
Mahesh Salgaonkar6507955c2014-10-10 21:28:26 +0530202 opal_register_exception_handler(
203 OPAL_HYPERVISOR_MAINTENANCE_HANDLER,
204 0, glue);
205 glue += 128;
206 }
207
Benjamin Herrenschmidted79ba92011-09-19 17:45:04 +0000208 opal_register_exception_handler(OPAL_SOFTPATCH_HANDLER, 0, glue);
Benjamin Herrenschmidt29186092013-09-23 12:05:04 +1000209#endif
Benjamin Herrenschmidted79ba92011-09-19 17:45:04 +0000210
Jeremy Kerrc4463b32013-05-01 22:31:50 +0000211 return 0;
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000212}
Michael Ellermanb14726c2014-07-15 22:22:24 +1000213machine_early_initcall(powernv, opal_register_exception_handlers);
Jeremy Kerrc4463b32013-05-01 22:31:50 +0000214
Mahesh Salgaonkar24366362013-11-18 15:35:58 +0530215/*
216 * Opal message notifier based on message type. Allow subscribers to get
217 * notified for specific messgae type.
218 */
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100219int opal_message_notifier_register(enum opal_msg_type msg_type,
Mahesh Salgaonkar24366362013-11-18 15:35:58 +0530220 struct notifier_block *nb)
221{
Neelesh Gupta792f96e2015-02-11 11:57:06 +0530222 if (!nb || msg_type >= OPAL_MSG_TYPE_MAX) {
223 pr_warning("%s: Invalid arguments, msg_type:%d\n",
Mahesh Salgaonkar24366362013-11-18 15:35:58 +0530224 __func__, msg_type);
225 return -EINVAL;
226 }
Neelesh Gupta792f96e2015-02-11 11:57:06 +0530227
Mahesh Salgaonkar24366362013-11-18 15:35:58 +0530228 return atomic_notifier_chain_register(
229 &opal_msg_notifier_head[msg_type], nb);
230}
Jeremy Kerr594fcb92015-05-20 11:23:33 +0800231EXPORT_SYMBOL_GPL(opal_message_notifier_register);
Mahesh Salgaonkar24366362013-11-18 15:35:58 +0530232
Michael Ellermandf60f572015-03-26 20:03:16 +1100233int opal_message_notifier_unregister(enum opal_msg_type msg_type,
Neelesh Guptab921e902015-02-11 11:57:23 +0530234 struct notifier_block *nb)
235{
236 return atomic_notifier_chain_unregister(
237 &opal_msg_notifier_head[msg_type], nb);
238}
Jeremy Kerr594fcb92015-05-20 11:23:33 +0800239EXPORT_SYMBOL_GPL(opal_message_notifier_unregister);
Neelesh Guptab921e902015-02-11 11:57:23 +0530240
Mahesh Salgaonkar24366362013-11-18 15:35:58 +0530241static void opal_message_do_notify(uint32_t msg_type, void *msg)
242{
243 /* notify subscribers */
244 atomic_notifier_call_chain(&opal_msg_notifier_head[msg_type],
245 msg_type, msg);
246}
247
248static void opal_handle_message(void)
249{
250 s64 ret;
251 /*
252 * TODO: pre-allocate a message buffer depending on opal-msg-size
253 * value in /proc/device-tree.
254 */
255 static struct opal_msg msg;
Anton Blanchardbb4398e2014-03-28 16:33:33 +1100256 u32 type;
Mahesh Salgaonkar24366362013-11-18 15:35:58 +0530257
258 ret = opal_get_msg(__pa(&msg), sizeof(msg));
259 /* No opal message pending. */
260 if (ret == OPAL_RESOURCE)
261 return;
262
263 /* check for errors. */
264 if (ret) {
Masanari Iida1a84db52014-08-29 23:37:33 +0900265 pr_warning("%s: Failed to retrieve opal message, err=%lld\n",
Mahesh Salgaonkar24366362013-11-18 15:35:58 +0530266 __func__, ret);
267 return;
268 }
269
Anton Blanchardbb4398e2014-03-28 16:33:33 +1100270 type = be32_to_cpu(msg.msg_type);
271
Mahesh Salgaonkar24366362013-11-18 15:35:58 +0530272 /* Sanity check */
Neelesh Gupta792f96e2015-02-11 11:57:06 +0530273 if (type >= OPAL_MSG_TYPE_MAX) {
Stewart Smith98da62b2015-12-11 12:08:23 +1100274 pr_warn_once("%s: Unknown message type: %u\n", __func__, type);
Mahesh Salgaonkar24366362013-11-18 15:35:58 +0530275 return;
276 }
Anton Blanchardbb4398e2014-03-28 16:33:33 +1100277 opal_message_do_notify(type, (void *)&msg);
Mahesh Salgaonkar24366362013-11-18 15:35:58 +0530278}
279
Alistair Popplea295af22015-05-15 14:06:41 +1000280static irqreturn_t opal_message_notify(int irq, void *data)
Mahesh Salgaonkar24366362013-11-18 15:35:58 +0530281{
Alistair Popplea295af22015-05-15 14:06:41 +1000282 opal_handle_message();
283 return IRQ_HANDLED;
Mahesh Salgaonkar24366362013-11-18 15:35:58 +0530284}
285
Mahesh Salgaonkar24366362013-11-18 15:35:58 +0530286static int __init opal_message_init(void)
287{
Alistair Popplea295af22015-05-15 14:06:41 +1000288 int ret, i, irq;
Mahesh Salgaonkar24366362013-11-18 15:35:58 +0530289
290 for (i = 0; i < OPAL_MSG_TYPE_MAX; i++)
291 ATOMIC_INIT_NOTIFIER_HEAD(&opal_msg_notifier_head[i]);
292
Alistair Popplea295af22015-05-15 14:06:41 +1000293 irq = opal_event_request(ilog2(OPAL_EVENT_MSG_PENDING));
294 if (!irq) {
295 pr_err("%s: Can't register OPAL event irq (%d)\n",
296 __func__, irq);
297 return irq;
298 }
299
300 ret = request_irq(irq, opal_message_notify,
301 IRQ_TYPE_LEVEL_HIGH, "opal-msg", NULL);
Mahesh Salgaonkar24366362013-11-18 15:35:58 +0530302 if (ret) {
Alistair Popplea295af22015-05-15 14:06:41 +1000303 pr_err("%s: Can't request OPAL event irq (%d)\n",
Mahesh Salgaonkar24366362013-11-18 15:35:58 +0530304 __func__, ret);
305 return ret;
306 }
Alistair Popplea295af22015-05-15 14:06:41 +1000307
Mahesh Salgaonkar24366362013-11-18 15:35:58 +0530308 return 0;
309}
Mahesh Salgaonkar24366362013-11-18 15:35:58 +0530310
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000311int opal_get_chars(uint32_t vtermno, char *buf, int count)
312{
Benjamin Herrenschmidt4f893632013-09-23 12:05:02 +1000313 s64 rc;
314 __be64 evt, len;
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000315
316 if (!opal.entry)
Benjamin Herrenschmidtdaea1172011-09-19 17:44:59 +0000317 return -ENODEV;
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000318 opal_poll_events(&evt);
Benjamin Herrenschmidt4f893632013-09-23 12:05:02 +1000319 if ((be64_to_cpu(evt) & OPAL_EVENT_CONSOLE_INPUT) == 0)
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000320 return 0;
Benjamin Herrenschmidt4f893632013-09-23 12:05:02 +1000321 len = cpu_to_be64(count);
Rob Herring9d0c4df2014-04-01 23:49:03 -0500322 rc = opal_console_read(vtermno, &len, buf);
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000323 if (rc == OPAL_SUCCESS)
Benjamin Herrenschmidt4f893632013-09-23 12:05:02 +1000324 return be64_to_cpu(len);
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000325 return 0;
326}
327
328int opal_put_chars(uint32_t vtermno, const char *data, int total_len)
329{
330 int written = 0;
Benjamin Herrenschmidt4f893632013-09-23 12:05:02 +1000331 __be64 olen;
Benjamin Herrenschmidtdaea1172011-09-19 17:44:59 +0000332 s64 len, rc;
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000333 unsigned long flags;
Benjamin Herrenschmidt4f893632013-09-23 12:05:02 +1000334 __be64 evt;
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000335
336 if (!opal.entry)
Benjamin Herrenschmidtdaea1172011-09-19 17:44:59 +0000337 return -ENODEV;
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000338
339 /* We want put_chars to be atomic to avoid mangling of hvsi
340 * packets. To do that, we first test for room and return
Benjamin Herrenschmidtdaea1172011-09-19 17:44:59 +0000341 * -EAGAIN if there isn't enough.
342 *
343 * Unfortunately, opal_console_write_buffer_space() doesn't
344 * appear to work on opal v1, so we just assume there is
345 * enough room and be done with it
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000346 */
347 spin_lock_irqsave(&opal_write_lock, flags);
Stewart Smithe4d54f72015-12-09 17:18:20 +1100348 rc = opal_console_write_buffer_space(vtermno, &olen);
349 len = be64_to_cpu(olen);
350 if (rc || len < total_len) {
351 spin_unlock_irqrestore(&opal_write_lock, flags);
352 /* Closed -> drop characters */
353 if (rc)
354 return total_len;
355 opal_poll_events(NULL);
356 return -EAGAIN;
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000357 }
358
359 /* We still try to handle partial completions, though they
360 * should no longer happen.
361 */
Benjamin Herrenschmidtdaea1172011-09-19 17:44:59 +0000362 rc = OPAL_BUSY;
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000363 while(total_len > 0 && (rc == OPAL_BUSY ||
364 rc == OPAL_BUSY_EVENT || rc == OPAL_SUCCESS)) {
Benjamin Herrenschmidt4f893632013-09-23 12:05:02 +1000365 olen = cpu_to_be64(total_len);
366 rc = opal_console_write(vtermno, &olen, data);
367 len = be64_to_cpu(olen);
Benjamin Herrenschmidt1de14552013-05-08 14:14:26 +1000368
369 /* Closed or other error drop */
370 if (rc != OPAL_SUCCESS && rc != OPAL_BUSY &&
371 rc != OPAL_BUSY_EVENT) {
372 written = total_len;
373 break;
374 }
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000375 if (rc == OPAL_SUCCESS) {
376 total_len -= len;
377 data += len;
378 written += len;
379 }
380 /* This is a bit nasty but we need that for the console to
381 * flush when there aren't any interrupts. We will clean
382 * things a bit later to limit that to synchronous path
383 * such as the kernel console and xmon/udbg
384 */
385 do
386 opal_poll_events(&evt);
Benjamin Herrenschmidt4f893632013-09-23 12:05:02 +1000387 while(rc == OPAL_SUCCESS &&
388 (be64_to_cpu(evt) & OPAL_EVENT_CONSOLE_OUTPUT));
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000389 }
390 spin_unlock_irqrestore(&opal_write_lock, flags);
391 return written;
392}
393
Mahesh Salgaonkarb63a0ff2013-10-30 20:06:13 +0530394static int opal_recover_mce(struct pt_regs *regs,
395 struct machine_check_event *evt)
396{
397 int recovered = 0;
398 uint64_t ea = get_mce_fault_addr(evt);
399
400 if (!(regs->msr & MSR_RI)) {
401 /* If MSR_RI isn't set, we cannot recover */
402 recovered = 0;
403 } else if (evt->disposition == MCE_DISPOSITION_RECOVERED) {
404 /* Platform corrected itself */
405 recovered = 1;
406 } else if (ea && !is_kernel_addr(ea)) {
407 /*
408 * Faulting address is not in kernel text. We should be fine.
409 * We need to find which process uses this address.
410 * For now, kill the task if we have received exception when
411 * in userspace.
412 *
413 * TODO: Queue up this address for hwpoisioning later.
414 */
415 if (user_mode(regs) && !is_global_init(current)) {
416 _exception(SIGBUS, regs, BUS_MCEERR_AR, regs->nip);
417 recovered = 1;
418 } else
419 recovered = 0;
420 } else if (user_mode(regs) && !is_global_init(current) &&
421 evt->severity == MCE_SEV_ERROR_SYNC) {
422 /*
423 * If we have received a synchronous error when in userspace
424 * kill the task.
425 */
426 _exception(SIGBUS, regs, BUS_MCEERR_AR, regs->nip);
427 recovered = 1;
428 }
429 return recovered;
430}
431
Benjamin Herrenschmidted79ba92011-09-19 17:45:04 +0000432int opal_machine_check(struct pt_regs *regs)
433{
Mahesh Salgaonkar36df96f2013-10-30 20:05:40 +0530434 struct machine_check_event evt;
Mahesh Salgaonkare784b642015-07-31 21:24:38 +0530435 int ret;
Benjamin Herrenschmidted79ba92011-09-19 17:45:04 +0000436
Mahesh Salgaonkar36df96f2013-10-30 20:05:40 +0530437 if (!get_mce_event(&evt, MCE_EVENT_RELEASE))
438 return 0;
Benjamin Herrenschmidted79ba92011-09-19 17:45:04 +0000439
440 /* Print things out */
Mahesh Salgaonkar36df96f2013-10-30 20:05:40 +0530441 if (evt.version != MCE_V1) {
Benjamin Herrenschmidted79ba92011-09-19 17:45:04 +0000442 pr_err("Machine Check Exception, Unknown event version %d !\n",
443 evt.version);
444 return 0;
445 }
Mahesh Salgaonkarb5ff4212013-10-30 20:05:49 +0530446 machine_check_print_event_info(&evt);
Benjamin Herrenschmidted79ba92011-09-19 17:45:04 +0000447
Mahesh Salgaonkarb63a0ff2013-10-30 20:06:13 +0530448 if (opal_recover_mce(regs, &evt))
449 return 1;
Mahesh Salgaonkare784b642015-07-31 21:24:38 +0530450
451 /*
452 * Unrecovered machine check, we are heading to panic path.
453 *
454 * We may have hit this MCE in very early stage of kernel
455 * initialization even before opal-prd has started running. If
456 * this is the case then this MCE error may go un-noticed or
457 * un-analyzed if we go down panic path. We need to inform
458 * BMC/OCC about this error so that they can collect relevant
459 * data for error analysis before rebooting.
460 * Use opal_cec_reboot2(OPAL_REBOOT_PLATFORM_ERROR) to do so.
461 * This function may not return on BMC based system.
462 */
463 ret = opal_cec_reboot2(OPAL_REBOOT_PLATFORM_ERROR,
464 "Unrecoverable Machine Check exception");
465 if (ret == OPAL_UNSUPPORTED) {
466 pr_emerg("Reboot type %d not supported\n",
467 OPAL_REBOOT_PLATFORM_ERROR);
468 }
469
470 /*
471 * We reached here. There can be three possibilities:
472 * 1. We are running on a firmware level that do not support
473 * opal_cec_reboot2()
474 * 2. We are running on a firmware level that do not support
475 * OPAL_REBOOT_PLATFORM_ERROR reboot type.
476 * 3. We are running on FSP based system that does not need opal
477 * to trigger checkstop explicitly for error analysis. The FSP
478 * PRD component would have already got notified about this
479 * error through other channels.
480 *
Daniel Axtensf2dd80e2015-09-23 16:41:48 +1000481 * If hardware marked this as an unrecoverable MCE, we are
482 * going to panic anyway. Even if it didn't, it's not safe to
483 * continue at this point, so we should explicitly panic.
Mahesh Salgaonkare784b642015-07-31 21:24:38 +0530484 */
Daniel Axtensf2dd80e2015-09-23 16:41:48 +1000485
486 panic("PowerNV Unrecovered Machine Check");
Mahesh Salgaonkarb63a0ff2013-10-30 20:06:13 +0530487 return 0;
Benjamin Herrenschmidted79ba92011-09-19 17:45:04 +0000488}
489
Mahesh Salgaonkar0869b6f2014-07-29 18:40:01 +0530490/* Early hmi handler called in real mode. */
491int opal_hmi_exception_early(struct pt_regs *regs)
492{
Mahesh Salgaonkar0ef95b42014-07-29 18:40:07 +0530493 s64 rc;
494
495 /*
496 * call opal hmi handler. Pass paca address as token.
497 * The return value OPAL_SUCCESS is an indication that there is
498 * an HMI event generated waiting to pull by Linux.
499 */
500 rc = opal_handle_hmi();
501 if (rc == OPAL_SUCCESS) {
502 local_paca->hmi_event_available = 1;
503 return 1;
504 }
Mahesh Salgaonkar0869b6f2014-07-29 18:40:01 +0530505 return 0;
506}
507
508/* HMI exception handler called in virtual mode during check_irq_replay. */
509int opal_handle_hmi_exception(struct pt_regs *regs)
510{
Mahesh Salgaonkar0ef95b42014-07-29 18:40:07 +0530511 s64 rc;
512 __be64 evt = 0;
513
514 /*
515 * Check if HMI event is available.
516 * if Yes, then call opal_poll_events to pull opal messages and
517 * process them.
518 */
519 if (!local_paca->hmi_event_available)
520 return 0;
521
522 local_paca->hmi_event_available = 0;
523 rc = opal_poll_events(&evt);
Alistair Popple81f2f7c2015-05-15 14:06:44 +1000524 if (rc == OPAL_SUCCESS && evt)
Alistair Popple9f0fd042015-05-15 14:06:37 +1000525 opal_handle_events(be64_to_cpu(evt));
Mahesh Salgaonkar0ef95b42014-07-29 18:40:07 +0530526
527 return 1;
Mahesh Salgaonkar0869b6f2014-07-29 18:40:01 +0530528}
529
Mahesh Salgaonkar55672ec2013-12-16 10:46:24 +0530530static uint64_t find_recovery_address(uint64_t nip)
531{
532 int i;
533
534 for (i = 0; i < mc_recoverable_range_len; i++)
535 if ((nip >= mc_recoverable_range[i].start_addr) &&
536 (nip < mc_recoverable_range[i].end_addr))
537 return mc_recoverable_range[i].recover_addr;
538 return 0;
539}
540
541bool opal_mce_check_early_recovery(struct pt_regs *regs)
542{
543 uint64_t recover_addr = 0;
544
545 if (!opal.base || !opal.size)
546 goto out;
547
548 if ((regs->nip >= opal.base) &&
Andrew Donnellandc3799b2015-12-21 18:28:37 +1100549 (regs->nip < (opal.base + opal.size)))
Mahesh Salgaonkar55672ec2013-12-16 10:46:24 +0530550 recover_addr = find_recovery_address(regs->nip);
551
552 /*
553 * Setup regs->nip to rfi into fixup address.
554 */
555 if (recover_addr)
556 regs->nip = recover_addr;
557
558out:
559 return !!recover_addr;
560}
561
Vasant Hegde6f68b5e2013-08-27 15:09:52 +0530562static int opal_sysfs_init(void)
563{
564 opal_kobj = kobject_create_and_add("opal", firmware_kobj);
565 if (!opal_kobj) {
566 pr_warn("kobject_create_and_add opal failed\n");
567 return -ENOMEM;
568 }
569
570 return 0;
571}
572
Benjamin Herrenschmidtc8742f82014-12-11 12:39:49 +1100573static ssize_t symbol_map_read(struct file *fp, struct kobject *kobj,
574 struct bin_attribute *bin_attr,
575 char *buf, loff_t off, size_t count)
576{
577 return memory_read_from_buffer(buf, count, &off, bin_attr->private,
578 bin_attr->size);
579}
580
581static BIN_ATTR_RO(symbol_map, 0);
582
583static void opal_export_symmap(void)
584{
585 const __be64 *syms;
586 unsigned int size;
587 struct device_node *fw;
588 int rc;
589
590 fw = of_find_node_by_path("/ibm,opal/firmware");
591 if (!fw)
592 return;
593 syms = of_get_property(fw, "symbol-map", &size);
594 if (!syms || size != 2 * sizeof(__be64))
595 return;
596
597 /* Setup attributes */
598 bin_attr_symbol_map.private = __va(be64_to_cpu(syms[0]));
599 bin_attr_symbol_map.size = be64_to_cpu(syms[1]);
600
601 rc = sysfs_create_bin_file(opal_kobj, &bin_attr_symbol_map);
602 if (rc)
603 pr_warn("Error %d creating OPAL symbols file\n", rc);
604}
605
Vasant Hegdeb09c2ec2014-08-09 11:15:45 +0530606static void __init opal_dump_region_init(void)
607{
608 void *addr;
609 uint64_t size;
610 int rc;
611
Stewart Smithb962f5a2015-02-12 16:25:27 +1100612 if (!opal_check_token(OPAL_REGISTER_DUMP_REGION))
613 return;
614
Vasant Hegdeb09c2ec2014-08-09 11:15:45 +0530615 /* Register kernel log buffer */
616 addr = log_buf_addr_get();
Pranith Kumar6501ab5e32015-01-21 21:26:09 -0500617 if (addr == NULL)
618 return;
619
Vasant Hegdeb09c2ec2014-08-09 11:15:45 +0530620 size = log_buf_len_get();
Pranith Kumar6501ab5e32015-01-21 21:26:09 -0500621 if (size == 0)
622 return;
623
Vasant Hegdeb09c2ec2014-08-09 11:15:45 +0530624 rc = opal_register_dump_region(OPAL_DUMP_REGION_LOG_BUF,
625 __pa(addr), size);
626 /* Don't warn if this is just an older OPAL that doesn't
627 * know about that call
628 */
629 if (rc && rc != OPAL_UNSUPPORTED)
630 pr_warn("DUMP: Failed to register kernel log buffer. "
631 "rc = %d\n", rc);
632}
Jeremy Kerr608b2862014-11-06 11:38:27 +0800633
Jeremy Kerr48c06152015-05-20 11:23:33 +0800634static void opal_pdev_init(struct device_node *opal_node,
635 const char *compatible)
Cyril Bured591902015-04-01 14:05:30 +0800636{
637 struct device_node *np;
638
639 for_each_child_of_node(opal_node, np)
Jeremy Kerr48c06152015-05-20 11:23:33 +0800640 if (of_device_is_compatible(np, compatible))
Jeremy Kerr608b2862014-11-06 11:38:27 +0800641 of_platform_device_create(np, NULL, NULL);
642}
643
Neelesh Gupta47083452014-12-13 23:31:05 +0530644static void opal_i2c_create_devs(void)
645{
646 struct device_node *np;
647
648 for_each_compatible_node(np, NULL, "ibm,opal-i2c")
649 of_platform_device_create(np, NULL, NULL);
650}
651
Benjamin Herrenschmidt3bf57562014-11-14 16:13:50 +1100652static int kopald(void *unused)
653{
Benjamin Herrenschmidta2036582016-07-04 14:51:44 +1000654 unsigned long timeout = msecs_to_jiffies(opal_heartbeat) + 1;
Alistair Popple9f0fd042015-05-15 14:06:37 +1000655 __be64 events;
656
Benjamin Herrenschmidt3bf57562014-11-14 16:13:50 +1100657 set_freezable();
658 do {
659 try_to_freeze();
Alistair Popple9f0fd042015-05-15 14:06:37 +1000660 opal_poll_events(&events);
661 opal_handle_events(be64_to_cpu(events));
Benjamin Herrenschmidta2036582016-07-04 14:51:44 +1000662 schedule_timeout_interruptible(timeout);
Benjamin Herrenschmidt3bf57562014-11-14 16:13:50 +1100663 } while (!kthread_should_stop());
664
665 return 0;
666}
667
Benjamin Herrenschmidta2036582016-07-04 14:51:44 +1000668void opal_wake_poller(void)
669{
670 if (kopald_tsk)
671 wake_up_process(kopald_tsk);
672}
673
Benjamin Herrenschmidt3bf57562014-11-14 16:13:50 +1100674static void opal_init_heartbeat(void)
675{
676 /* Old firwmware, we assume the HVC heartbeat is sufficient */
677 if (of_property_read_u32(opal_node, "ibm,heartbeat-ms",
678 &opal_heartbeat) != 0)
679 opal_heartbeat = 0;
680
681 if (opal_heartbeat)
Benjamin Herrenschmidta2036582016-07-04 14:51:44 +1000682 kopald_tsk = kthread_run(kopald, NULL, "kopald");
Benjamin Herrenschmidt3bf57562014-11-14 16:13:50 +1100683}
684
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000685static int __init opal_init(void)
686{
Vasant Hegdec159b592015-08-19 22:19:53 +0530687 struct device_node *np, *consoles, *leds;
Gavin Shanc1c3a522015-01-23 14:25:05 +1100688 int rc;
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000689
690 opal_node = of_find_node_by_path("/ibm,opal");
691 if (!opal_node) {
Michael Ellerman08135132015-01-28 15:10:33 +1100692 pr_warn("Device node not found\n");
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000693 return -ENODEV;
694 }
Benjamin Herrenschmidt2db29d22013-07-15 13:03:14 +1000695
696 /* Register OPAL consoles if any ports */
Stewart Smith7261aaf2015-12-09 17:18:19 +1100697 consoles = of_find_node_by_path("/ibm,opal/consoles");
Benjamin Herrenschmidt2db29d22013-07-15 13:03:14 +1000698 if (consoles) {
699 for_each_child_of_node(consoles, np) {
700 if (strcmp(np->name, "serial"))
701 continue;
702 of_platform_device_create(np, NULL, NULL);
703 }
704 of_node_put(consoles);
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000705 }
Benjamin Herrenschmidta125e092011-09-19 17:45:03 +0000706
Alistair Popple96e023e2015-05-15 14:06:36 +1000707 /* Initialise OPAL messaging system */
708 opal_message_init();
709
710 /* Initialise OPAL asynchronous completion interface */
711 opal_async_comp_init();
712
713 /* Initialise OPAL sensor interface */
714 opal_sensor_init();
715
716 /* Initialise OPAL hypervisor maintainence interrupt handling */
717 opal_hmi_handler_init();
718
Neelesh Gupta47083452014-12-13 23:31:05 +0530719 /* Create i2c platform devices */
720 opal_i2c_create_devs();
721
Benjamin Herrenschmidt3bf57562014-11-14 16:13:50 +1100722 /* Setup a heatbeat thread if requested by OPAL */
723 opal_init_heartbeat();
724
Vasant Hegdec159b592015-08-19 22:19:53 +0530725 /* Create leds platform devices */
726 leds = of_find_node_by_path("/ibm,opal/leds");
727 if (leds) {
728 of_platform_device_create(leds, "opal_leds", NULL);
729 of_node_put(leds);
730 }
731
Andrew Donnellan9b4fffa2016-02-09 18:17:48 +1100732 /* Initialise OPAL message log interface */
733 opal_msglog_init();
734
Vasant Hegde6f68b5e2013-08-27 15:09:52 +0530735 /* Create "opal" kobject under /sys/firmware */
736 rc = opal_sysfs_init();
Vasant Hegde50bd6152013-10-24 16:04:58 +0530737 if (rc == 0) {
Benjamin Herrenschmidtc8742f82014-12-11 12:39:49 +1100738 /* Export symbol map to userspace */
739 opal_export_symmap();
Vasant Hegdeb09c2ec2014-08-09 11:15:45 +0530740 /* Setup dump region interface */
741 opal_dump_region_init();
Stewart Smith774fea12014-02-28 11:58:32 +1100742 /* Setup error log interface */
743 rc = opal_elog_init();
Vasant Hegde50bd6152013-10-24 16:04:58 +0530744 /* Setup code update interface */
Cyril Bured591902015-04-01 14:05:30 +0800745 opal_flash_update_init();
Stewart Smithc7e64b92014-03-03 10:25:42 +1100746 /* Setup platform dump extract interface */
747 opal_platform_dump_init();
Neelesh Gupta4029cd62014-03-07 11:02:09 +0530748 /* Setup system parameters interface */
749 opal_sys_param_init();
Andrew Donnellan9b4fffa2016-02-09 18:17:48 +1100750 /* Setup message log sysfs interface. */
751 opal_msglog_sysfs_init();
Vasant Hegde50bd6152013-10-24 16:04:58 +0530752 }
Vasant Hegde6f68b5e2013-08-27 15:09:52 +0530753
Jeremy Kerr0d7cd852015-06-04 21:51:47 +0800754 /* Initialize platform devices: IPMI backend, PRD & flash interface */
Jeremy Kerr48c06152015-05-20 11:23:33 +0800755 opal_pdev_init(opal_node, "ibm,opal-ipmi");
756 opal_pdev_init(opal_node, "ibm,opal-flash");
Jeremy Kerr0d7cd852015-06-04 21:51:47 +0800757 opal_pdev_init(opal_node, "ibm,opal-prd");
Cyril Bured591902015-04-01 14:05:30 +0800758
Suraj Jitindar Singh43a1dd92016-06-29 13:38:39 +1000759 /* Initialise platform device: oppanel interface */
760 opal_pdev_init(opal_node, "ibm,opal-oppanel");
761
Russell Curreyaffddff2015-11-27 17:23:07 +1100762 /* Initialise OPAL kmsg dumper for flushing console on panic */
763 opal_kmsg_init();
764
Benjamin Herrenschmidt14a43e62011-09-19 17:44:57 +0000765 return 0;
766}
Michael Ellermanb14726c2014-07-15 22:22:24 +1000767machine_subsys_initcall(powernv, opal_init);
Benjamin Herrenschmidt73ed1482013-05-10 16:59:18 +1000768
769void opal_shutdown(void)
770{
Vasant Hegdef7d98d12014-01-15 17:02:04 +1100771 long rc = OPAL_BUSY;
Benjamin Herrenschmidt73ed1482013-05-10 16:59:18 +1000772
Alistair Popple9f0fd042015-05-15 14:06:37 +1000773 opal_event_shutdown();
Vasant Hegdef7d98d12014-01-15 17:02:04 +1100774
775 /*
776 * Then sync with OPAL which ensure anything that can
777 * potentially write to our memory has completed such
778 * as an ongoing dump retrieval
779 */
780 while (rc == OPAL_BUSY || rc == OPAL_BUSY_EVENT) {
781 rc = opal_sync_host_reboot();
782 if (rc == OPAL_BUSY)
783 opal_poll_events(NULL);
784 else
785 mdelay(10);
786 }
Vasant Hegdeb09c2ec2014-08-09 11:15:45 +0530787
788 /* Unregister memory dump region */
Stewart Smithb962f5a2015-02-12 16:25:27 +1100789 if (opal_check_token(OPAL_UNREGISTER_DUMP_REGION))
790 opal_unregister_dump_region(OPAL_DUMP_REGION_LOG_BUF);
Benjamin Herrenschmidt73ed1482013-05-10 16:59:18 +1000791}
Joel Stanleye28b05e2014-04-01 14:28:20 +1030792
793/* Export this so that test modules can use it */
794EXPORT_SYMBOL_GPL(opal_invalid_call);
Jeremy Kerr594fcb92015-05-20 11:23:33 +0800795EXPORT_SYMBOL_GPL(opal_xscom_read);
796EXPORT_SYMBOL_GPL(opal_xscom_write);
Jeremy Kerr608b2862014-11-06 11:38:27 +0800797EXPORT_SYMBOL_GPL(opal_ipmi_send);
798EXPORT_SYMBOL_GPL(opal_ipmi_recv);
Cyril Bured591902015-04-01 14:05:30 +0800799EXPORT_SYMBOL_GPL(opal_flash_read);
800EXPORT_SYMBOL_GPL(opal_flash_write);
801EXPORT_SYMBOL_GPL(opal_flash_erase);
Jeremy Kerr0d7cd852015-06-04 21:51:47 +0800802EXPORT_SYMBOL_GPL(opal_prd_msg);
Anton Blanchard3441f042014-04-22 15:01:26 +1000803
804/* Convert a region of vmalloc memory to an opal sg list */
805struct opal_sg_list *opal_vmalloc_to_sg_list(void *vmalloc_addr,
806 unsigned long vmalloc_size)
807{
808 struct opal_sg_list *sg, *first = NULL;
809 unsigned long i = 0;
810
811 sg = kzalloc(PAGE_SIZE, GFP_KERNEL);
812 if (!sg)
813 goto nomem;
814
815 first = sg;
816
817 while (vmalloc_size > 0) {
818 uint64_t data = vmalloc_to_pfn(vmalloc_addr) << PAGE_SHIFT;
819 uint64_t length = min(vmalloc_size, PAGE_SIZE);
820
821 sg->entry[i].data = cpu_to_be64(data);
822 sg->entry[i].length = cpu_to_be64(length);
823 i++;
824
825 if (i >= SG_ENTRIES_PER_NODE) {
826 struct opal_sg_list *next;
827
828 next = kzalloc(PAGE_SIZE, GFP_KERNEL);
829 if (!next)
830 goto nomem;
831
832 sg->length = cpu_to_be64(
833 i * sizeof(struct opal_sg_entry) + 16);
834 i = 0;
835 sg->next = cpu_to_be64(__pa(next));
836 sg = next;
837 }
838
839 vmalloc_addr += length;
840 vmalloc_size -= length;
841 }
842
843 sg->length = cpu_to_be64(i * sizeof(struct opal_sg_entry) + 16);
844
845 return first;
846
847nomem:
848 pr_err("%s : Failed to allocate memory\n", __func__);
849 opal_free_sg_list(first);
850 return NULL;
851}
852
853void opal_free_sg_list(struct opal_sg_list *sg)
854{
855 while (sg) {
856 uint64_t next = be64_to_cpu(sg->next);
857
858 kfree(sg);
859
860 if (next)
861 sg = __va(next);
862 else
863 sg = NULL;
864 }
865}
Neelesh Gupta16b1d262014-10-14 14:08:36 +0530866
Cédric Le Goatere3c5c2e2015-03-30 12:06:09 +0200867int opal_error_code(int rc)
868{
869 switch (rc) {
870 case OPAL_SUCCESS: return 0;
871
872 case OPAL_PARAMETER: return -EINVAL;
873 case OPAL_ASYNC_COMPLETION: return -EINPROGRESS;
874 case OPAL_BUSY_EVENT: return -EBUSY;
875 case OPAL_NO_MEM: return -ENOMEM;
Cédric Le Goater14aae782015-04-08 09:31:10 +0200876 case OPAL_PERMISSION: return -EPERM;
Cédric Le Goatere3c5c2e2015-03-30 12:06:09 +0200877
878 case OPAL_UNSUPPORTED: return -EIO;
879 case OPAL_HARDWARE: return -EIO;
880 case OPAL_INTERNAL_ERROR: return -EIO;
881 default:
882 pr_err("%s: unexpected OPAL error %d\n", __func__, rc);
883 return -EIO;
884 }
885}
886
Neelesh Gupta16b1d262014-10-14 14:08:36 +0530887EXPORT_SYMBOL_GPL(opal_poll_events);
888EXPORT_SYMBOL_GPL(opal_rtc_read);
889EXPORT_SYMBOL_GPL(opal_rtc_write);
890EXPORT_SYMBOL_GPL(opal_tpo_read);
891EXPORT_SYMBOL_GPL(opal_tpo_write);
Neelesh Gupta47083452014-12-13 23:31:05 +0530892EXPORT_SYMBOL_GPL(opal_i2c_request);
Vasant Hegdec159b592015-08-19 22:19:53 +0530893/* Export these symbols for PowerNV LED class driver */
894EXPORT_SYMBOL_GPL(opal_leds_get_ind);
895EXPORT_SYMBOL_GPL(opal_leds_set_ind);
Suraj Jitindar Singh43a1dd92016-06-29 13:38:39 +1000896/* Export this symbol for PowerNV Operator Panel class driver */
897EXPORT_SYMBOL_GPL(opal_write_oppanel_async);