blob: 9784c9241c70323ef31f0a26d65f3d1b344a763d [file] [log] [blame]
Michael Ellermand800ba12015-02-17 20:01:53 +11001/*
Michael Ellermand7cf83f2015-02-17 20:01:54 +11002 * OPAL API definitions.
Michael Ellermand800ba12015-02-17 20:01:53 +11003 *
Michael Ellermand7cf83f2015-02-17 20:01:54 +11004 * Copyright 2011-2015 IBM Corp.
Michael Ellermand800ba12015-02-17 20:01:53 +11005 *
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
12#ifndef __OPAL_API_H
13#define __OPAL_API_H
14
15/****** OPAL APIs ******/
16
17/* Return codes */
Michael Ellermand7cf83f2015-02-17 20:01:54 +110018#define OPAL_SUCCESS 0
Michael Ellermand800ba12015-02-17 20:01:53 +110019#define OPAL_PARAMETER -1
20#define OPAL_BUSY -2
21#define OPAL_PARTIAL -3
22#define OPAL_CONSTRAINED -4
23#define OPAL_CLOSED -5
24#define OPAL_HARDWARE -6
25#define OPAL_UNSUPPORTED -7
26#define OPAL_PERMISSION -8
27#define OPAL_NO_MEM -9
28#define OPAL_RESOURCE -10
29#define OPAL_INTERNAL_ERROR -11
30#define OPAL_BUSY_EVENT -12
31#define OPAL_HARDWARE_FROZEN -13
32#define OPAL_WRONG_STATE -14
33#define OPAL_ASYNC_COMPLETION -15
Michael Ellermand7cf83f2015-02-17 20:01:54 +110034#define OPAL_EMPTY -16
Michael Ellermand800ba12015-02-17 20:01:53 +110035#define OPAL_I2C_TIMEOUT -17
36#define OPAL_I2C_INVALID_CMD -18
37#define OPAL_I2C_LBUS_PARITY -19
38#define OPAL_I2C_BKEND_OVERRUN -20
39#define OPAL_I2C_BKEND_ACCESS -21
40#define OPAL_I2C_ARBT_LOST -22
41#define OPAL_I2C_NACK_RCVD -23
42#define OPAL_I2C_STOP_ERR -24
43
44/* API Tokens (in r0) */
Michael Ellermand7cf83f2015-02-17 20:01:54 +110045#define OPAL_INVALID_CALL -1
46#define OPAL_TEST 0
Michael Ellermand800ba12015-02-17 20:01:53 +110047#define OPAL_CONSOLE_WRITE 1
48#define OPAL_CONSOLE_READ 2
49#define OPAL_RTC_READ 3
50#define OPAL_RTC_WRITE 4
51#define OPAL_CEC_POWER_DOWN 5
52#define OPAL_CEC_REBOOT 6
53#define OPAL_READ_NVRAM 7
54#define OPAL_WRITE_NVRAM 8
55#define OPAL_HANDLE_INTERRUPT 9
56#define OPAL_POLL_EVENTS 10
57#define OPAL_PCI_SET_HUB_TCE_MEMORY 11
58#define OPAL_PCI_SET_PHB_TCE_MEMORY 12
59#define OPAL_PCI_CONFIG_READ_BYTE 13
60#define OPAL_PCI_CONFIG_READ_HALF_WORD 14
61#define OPAL_PCI_CONFIG_READ_WORD 15
62#define OPAL_PCI_CONFIG_WRITE_BYTE 16
63#define OPAL_PCI_CONFIG_WRITE_HALF_WORD 17
64#define OPAL_PCI_CONFIG_WRITE_WORD 18
65#define OPAL_SET_XIVE 19
66#define OPAL_GET_XIVE 20
67#define OPAL_GET_COMPLETION_TOKEN_STATUS 21 /* obsolete */
68#define OPAL_REGISTER_OPAL_EXCEPTION_HANDLER 22
69#define OPAL_PCI_EEH_FREEZE_STATUS 23
70#define OPAL_PCI_SHPC 24
71#define OPAL_CONSOLE_WRITE_BUFFER_SPACE 25
72#define OPAL_PCI_EEH_FREEZE_CLEAR 26
73#define OPAL_PCI_PHB_MMIO_ENABLE 27
74#define OPAL_PCI_SET_PHB_MEM_WINDOW 28
75#define OPAL_PCI_MAP_PE_MMIO_WINDOW 29
76#define OPAL_PCI_SET_PHB_TABLE_MEMORY 30
77#define OPAL_PCI_SET_PE 31
78#define OPAL_PCI_SET_PELTV 32
79#define OPAL_PCI_SET_MVE 33
80#define OPAL_PCI_SET_MVE_ENABLE 34
81#define OPAL_PCI_GET_XIVE_REISSUE 35
82#define OPAL_PCI_SET_XIVE_REISSUE 36
83#define OPAL_PCI_SET_XIVE_PE 37
84#define OPAL_GET_XIVE_SOURCE 38
85#define OPAL_GET_MSI_32 39
86#define OPAL_GET_MSI_64 40
87#define OPAL_START_CPU 41
88#define OPAL_QUERY_CPU_STATUS 42
Michael Ellermand7cf83f2015-02-17 20:01:54 +110089#define OPAL_WRITE_OPPANEL 43 /* unimplemented */
Michael Ellermand800ba12015-02-17 20:01:53 +110090#define OPAL_PCI_MAP_PE_DMA_WINDOW 44
91#define OPAL_PCI_MAP_PE_DMA_WINDOW_REAL 45
92#define OPAL_PCI_RESET 49
93#define OPAL_PCI_GET_HUB_DIAG_DATA 50
94#define OPAL_PCI_GET_PHB_DIAG_DATA 51
95#define OPAL_PCI_FENCE_PHB 52
96#define OPAL_PCI_REINIT 53
97#define OPAL_PCI_MASK_PE_ERROR 54
98#define OPAL_SET_SLOT_LED_STATUS 55
99#define OPAL_GET_EPOW_STATUS 56
100#define OPAL_SET_SYSTEM_ATTENTION_LED 57
101#define OPAL_RESERVED1 58
102#define OPAL_RESERVED2 59
103#define OPAL_PCI_NEXT_ERROR 60
104#define OPAL_PCI_EEH_FREEZE_STATUS2 61
105#define OPAL_PCI_POLL 62
106#define OPAL_PCI_MSI_EOI 63
107#define OPAL_PCI_GET_PHB_DIAG_DATA2 64
108#define OPAL_XSCOM_READ 65
109#define OPAL_XSCOM_WRITE 66
110#define OPAL_LPC_READ 67
111#define OPAL_LPC_WRITE 68
112#define OPAL_RETURN_CPU 69
113#define OPAL_REINIT_CPUS 70
114#define OPAL_ELOG_READ 71
115#define OPAL_ELOG_WRITE 72
116#define OPAL_ELOG_ACK 73
117#define OPAL_ELOG_RESEND 74
118#define OPAL_ELOG_SIZE 75
119#define OPAL_FLASH_VALIDATE 76
120#define OPAL_FLASH_MANAGE 77
121#define OPAL_FLASH_UPDATE 78
122#define OPAL_RESYNC_TIMEBASE 79
123#define OPAL_CHECK_TOKEN 80
124#define OPAL_DUMP_INIT 81
125#define OPAL_DUMP_INFO 82
126#define OPAL_DUMP_READ 83
127#define OPAL_DUMP_ACK 84
128#define OPAL_GET_MSG 85
129#define OPAL_CHECK_ASYNC_COMPLETION 86
130#define OPAL_SYNC_HOST_REBOOT 87
131#define OPAL_SENSOR_READ 88
132#define OPAL_GET_PARAM 89
133#define OPAL_SET_PARAM 90
134#define OPAL_DUMP_RESEND 91
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100135#define OPAL_ELOG_SEND 92 /* Deprecated */
136#define OPAL_PCI_SET_PHB_CAPI_MODE 93
Michael Ellermand800ba12015-02-17 20:01:53 +1100137#define OPAL_DUMP_INFO2 94
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100138#define OPAL_WRITE_OPPANEL_ASYNC 95
Michael Ellermand800ba12015-02-17 20:01:53 +1100139#define OPAL_PCI_ERR_INJECT 96
140#define OPAL_PCI_EEH_FREEZE_SET 97
141#define OPAL_HANDLE_HMI 98
142#define OPAL_CONFIG_CPU_IDLE_STATE 99
143#define OPAL_SLW_SET_REG 100
144#define OPAL_REGISTER_DUMP_REGION 101
145#define OPAL_UNREGISTER_DUMP_REGION 102
146#define OPAL_WRITE_TPO 103
147#define OPAL_READ_TPO 104
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100148#define OPAL_GET_DPO_STATUS 105
149#define OPAL_OLD_I2C_REQUEST 106 /* Deprecated */
Michael Ellermand800ba12015-02-17 20:01:53 +1100150#define OPAL_IPMI_SEND 107
151#define OPAL_IPMI_RECV 108
152#define OPAL_I2C_REQUEST 109
Cyril Bured591902015-04-01 14:05:30 +0800153#define OPAL_FLASH_READ 110
154#define OPAL_FLASH_WRITE 111
155#define OPAL_FLASH_ERASE 112
Jeremy Kerr0d7cd852015-06-04 21:51:47 +0800156#define OPAL_PRD_MSG 113
Anshuman Khandual8a8d9182015-08-19 22:19:52 +0530157#define OPAL_LEDS_GET_INDICATOR 114
158#define OPAL_LEDS_SET_INDICATOR 115
Mahesh Salgaonkare784b642015-07-31 21:24:38 +0530159#define OPAL_CEC_REBOOT2 116
160#define OPAL_LAST 116
Michael Ellermand800ba12015-02-17 20:01:53 +1100161
162/* Device tree flags */
163
164/* Flags set in power-mgmt nodes in device tree if
165 * respective idle states are supported in the platform.
166 */
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100167#define OPAL_PM_NAP_ENABLED 0x00010000
168#define OPAL_PM_SLEEP_ENABLED 0x00020000
169#define OPAL_PM_WINKLE_ENABLED 0x00040000
170#define OPAL_PM_SLEEP_ENABLED_ER1 0x00080000 /* with workaround */
Michael Ellermand800ba12015-02-17 20:01:53 +1100171
Shreyas B. Prabhu5703d2f2015-04-20 10:32:58 +0530172/*
173 * OPAL_CONFIG_CPU_IDLE_STATE parameters
174 */
175#define OPAL_CONFIG_IDLE_FASTSLEEP 1
176#define OPAL_CONFIG_IDLE_UNDO 0
177#define OPAL_CONFIG_IDLE_APPLY 1
178
Michael Ellermand800ba12015-02-17 20:01:53 +1100179#ifndef __ASSEMBLY__
180
181/* Other enums */
Michael Ellermand800ba12015-02-17 20:01:53 +1100182enum OpalFreezeState {
183 OPAL_EEH_STOPPED_NOT_FROZEN = 0,
184 OPAL_EEH_STOPPED_MMIO_FREEZE = 1,
185 OPAL_EEH_STOPPED_DMA_FREEZE = 2,
186 OPAL_EEH_STOPPED_MMIO_DMA_FREEZE = 3,
187 OPAL_EEH_STOPPED_RESET = 4,
188 OPAL_EEH_STOPPED_TEMP_UNAVAIL = 5,
189 OPAL_EEH_STOPPED_PERM_UNAVAIL = 6
190};
191
192enum OpalEehFreezeActionToken {
193 OPAL_EEH_ACTION_CLEAR_FREEZE_MMIO = 1,
194 OPAL_EEH_ACTION_CLEAR_FREEZE_DMA = 2,
195 OPAL_EEH_ACTION_CLEAR_FREEZE_ALL = 3,
196
197 OPAL_EEH_ACTION_SET_FREEZE_MMIO = 1,
198 OPAL_EEH_ACTION_SET_FREEZE_DMA = 2,
199 OPAL_EEH_ACTION_SET_FREEZE_ALL = 3
200};
201
202enum OpalPciStatusToken {
203 OPAL_EEH_NO_ERROR = 0,
204 OPAL_EEH_IOC_ERROR = 1,
205 OPAL_EEH_PHB_ERROR = 2,
206 OPAL_EEH_PE_ERROR = 3,
207 OPAL_EEH_PE_MMIO_ERROR = 4,
208 OPAL_EEH_PE_DMA_ERROR = 5
209};
210
211enum OpalPciErrorSeverity {
212 OPAL_EEH_SEV_NO_ERROR = 0,
213 OPAL_EEH_SEV_IOC_DEAD = 1,
214 OPAL_EEH_SEV_PHB_DEAD = 2,
215 OPAL_EEH_SEV_PHB_FENCED = 3,
216 OPAL_EEH_SEV_PE_ER = 4,
217 OPAL_EEH_SEV_INF = 5
218};
219
220enum OpalErrinjectType {
221 OPAL_ERR_INJECT_TYPE_IOA_BUS_ERR = 0,
222 OPAL_ERR_INJECT_TYPE_IOA_BUS_ERR64 = 1,
223};
224
225enum OpalErrinjectFunc {
226 /* IOA bus specific errors */
227 OPAL_ERR_INJECT_FUNC_IOA_LD_MEM_ADDR = 0,
228 OPAL_ERR_INJECT_FUNC_IOA_LD_MEM_DATA = 1,
229 OPAL_ERR_INJECT_FUNC_IOA_LD_IO_ADDR = 2,
230 OPAL_ERR_INJECT_FUNC_IOA_LD_IO_DATA = 3,
231 OPAL_ERR_INJECT_FUNC_IOA_LD_CFG_ADDR = 4,
232 OPAL_ERR_INJECT_FUNC_IOA_LD_CFG_DATA = 5,
233 OPAL_ERR_INJECT_FUNC_IOA_ST_MEM_ADDR = 6,
234 OPAL_ERR_INJECT_FUNC_IOA_ST_MEM_DATA = 7,
235 OPAL_ERR_INJECT_FUNC_IOA_ST_IO_ADDR = 8,
236 OPAL_ERR_INJECT_FUNC_IOA_ST_IO_DATA = 9,
237 OPAL_ERR_INJECT_FUNC_IOA_ST_CFG_ADDR = 10,
238 OPAL_ERR_INJECT_FUNC_IOA_ST_CFG_DATA = 11,
239 OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_ADDR = 12,
240 OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_DATA = 13,
241 OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_MASTER = 14,
242 OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_TARGET = 15,
243 OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_ADDR = 16,
244 OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_DATA = 17,
245 OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_MASTER = 18,
246 OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_TARGET = 19,
247};
248
Michael Ellermand800ba12015-02-17 20:01:53 +1100249enum OpalMmioWindowType {
250 OPAL_M32_WINDOW_TYPE = 1,
251 OPAL_M64_WINDOW_TYPE = 2,
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100252 OPAL_IO_WINDOW_TYPE = 3
Michael Ellermand800ba12015-02-17 20:01:53 +1100253};
254
Michael Ellermand800ba12015-02-17 20:01:53 +1100255enum OpalExceptionHandler {
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100256 OPAL_MACHINE_CHECK_HANDLER = 1,
Michael Ellermand800ba12015-02-17 20:01:53 +1100257 OPAL_HYPERVISOR_MAINTENANCE_HANDLER = 2,
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100258 OPAL_SOFTPATCH_HANDLER = 3
Michael Ellermand800ba12015-02-17 20:01:53 +1100259};
260
261enum OpalPendingState {
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100262 OPAL_EVENT_OPAL_INTERNAL = 0x1,
263 OPAL_EVENT_NVRAM = 0x2,
264 OPAL_EVENT_RTC = 0x4,
265 OPAL_EVENT_CONSOLE_OUTPUT = 0x8,
266 OPAL_EVENT_CONSOLE_INPUT = 0x10,
267 OPAL_EVENT_ERROR_LOG_AVAIL = 0x20,
268 OPAL_EVENT_ERROR_LOG = 0x40,
269 OPAL_EVENT_EPOW = 0x80,
270 OPAL_EVENT_LED_STATUS = 0x100,
271 OPAL_EVENT_PCI_ERROR = 0x200,
272 OPAL_EVENT_DUMP_AVAIL = 0x400,
273 OPAL_EVENT_MSG_PENDING = 0x800,
Michael Ellermand800ba12015-02-17 20:01:53 +1100274};
275
276enum OpalThreadStatus {
277 OPAL_THREAD_INACTIVE = 0x0,
278 OPAL_THREAD_STARTED = 0x1,
279 OPAL_THREAD_UNAVAILABLE = 0x2 /* opal-v3 */
280};
281
282enum OpalPciBusCompare {
283 OpalPciBusAny = 0, /* Any bus number match */
284 OpalPciBus3Bits = 2, /* Match top 3 bits of bus number */
285 OpalPciBus4Bits = 3, /* Match top 4 bits of bus number */
286 OpalPciBus5Bits = 4, /* Match top 5 bits of bus number */
287 OpalPciBus6Bits = 5, /* Match top 6 bits of bus number */
288 OpalPciBus7Bits = 6, /* Match top 7 bits of bus number */
289 OpalPciBusAll = 7, /* Match bus number exactly */
290};
291
292enum OpalDeviceCompare {
293 OPAL_IGNORE_RID_DEVICE_NUMBER = 0,
294 OPAL_COMPARE_RID_DEVICE_NUMBER = 1
295};
296
297enum OpalFuncCompare {
298 OPAL_IGNORE_RID_FUNCTION_NUMBER = 0,
299 OPAL_COMPARE_RID_FUNCTION_NUMBER = 1
300};
301
302enum OpalPeAction {
303 OPAL_UNMAP_PE = 0,
304 OPAL_MAP_PE = 1
305};
306
307enum OpalPeltvAction {
308 OPAL_REMOVE_PE_FROM_DOMAIN = 0,
309 OPAL_ADD_PE_TO_DOMAIN = 1
310};
311
312enum OpalMveEnableAction {
313 OPAL_DISABLE_MVE = 0,
314 OPAL_ENABLE_MVE = 1
315};
316
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100317enum OpalM64Action {
Michael Ellermand800ba12015-02-17 20:01:53 +1100318 OPAL_DISABLE_M64 = 0,
319 OPAL_ENABLE_M64_SPLIT = 1,
320 OPAL_ENABLE_M64_NON_SPLIT = 2
321};
322
323enum OpalPciResetScope {
324 OPAL_RESET_PHB_COMPLETE = 1,
325 OPAL_RESET_PCI_LINK = 2,
326 OPAL_RESET_PHB_ERROR = 3,
327 OPAL_RESET_PCI_HOT = 4,
328 OPAL_RESET_PCI_FUNDAMENTAL = 5,
329 OPAL_RESET_PCI_IODA_TABLE = 6
330};
331
332enum OpalPciReinitScope {
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100333 /*
334 * Note: we chose values that do not overlap
335 * OpalPciResetScope as OPAL v2 used the same
336 * enum for both
337 */
Michael Ellermand800ba12015-02-17 20:01:53 +1100338 OPAL_REINIT_PCI_DEV = 1000
339};
340
341enum OpalPciResetState {
342 OPAL_DEASSERT_RESET = 0,
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100343 OPAL_ASSERT_RESET = 1
Michael Ellermand800ba12015-02-17 20:01:53 +1100344};
345
Michael Ellerman5d53be72015-08-22 09:33:55 +1000346enum OpalSlotLedType {
347 OPAL_SLOT_LED_TYPE_ID = 0, /* IDENTIFY LED */
348 OPAL_SLOT_LED_TYPE_FAULT = 1, /* FAULT LED */
349 OPAL_SLOT_LED_TYPE_ATTN = 2, /* System Attention LED */
350 OPAL_SLOT_LED_TYPE_MAX = 3
351};
352
353enum OpalSlotLedState {
354 OPAL_SLOT_LED_STATE_OFF = 0, /* LED is OFF */
355 OPAL_SLOT_LED_STATE_ON = 1 /* LED is ON */
356};
357
Michael Ellermand800ba12015-02-17 20:01:53 +1100358/*
359 * Address cycle types for LPC accesses. These also correspond
360 * to the content of the first cell of the "reg" property for
361 * device nodes on the LPC bus
362 */
363enum OpalLPCAddressType {
364 OPAL_LPC_MEM = 0,
365 OPAL_LPC_IO = 1,
366 OPAL_LPC_FW = 2,
367};
368
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100369enum opal_msg_type {
370 OPAL_MSG_ASYNC_COMP = 0, /* params[0] = token, params[1] = rc,
371 * additional params function-specific
372 */
373 OPAL_MSG_MEM_ERR,
374 OPAL_MSG_EPOW,
375 OPAL_MSG_SHUTDOWN, /* params[0] = 1 reboot, 0 shutdown */
376 OPAL_MSG_HMI_EVT,
377 OPAL_MSG_DPO,
Jeremy Kerr0d7cd852015-06-04 21:51:47 +0800378 OPAL_MSG_PRD,
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100379 OPAL_MSG_TYPE_MAX,
Michael Ellermand800ba12015-02-17 20:01:53 +1100380};
381
382struct opal_msg {
383 __be32 msg_type;
384 __be32 reserved;
385 __be64 params[8];
386};
387
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100388/* System parameter permission */
389enum OpalSysparamPerm {
390 OPAL_SYSPARAM_READ = 0x1,
391 OPAL_SYSPARAM_WRITE = 0x2,
392 OPAL_SYSPARAM_RW = (OPAL_SYSPARAM_READ | OPAL_SYSPARAM_WRITE),
393};
394
Michael Ellermand800ba12015-02-17 20:01:53 +1100395enum {
396 OPAL_IPMI_MSG_FORMAT_VERSION_1 = 1,
397};
398
399struct opal_ipmi_msg {
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100400 uint8_t version;
401 uint8_t netfn;
402 uint8_t cmd;
403 uint8_t data[];
Michael Ellermand800ba12015-02-17 20:01:53 +1100404};
405
406/* FSP memory errors handling */
407enum OpalMemErr_Version {
408 OpalMemErr_V1 = 1,
409};
410
411enum OpalMemErrType {
412 OPAL_MEM_ERR_TYPE_RESILIENCE = 0,
413 OPAL_MEM_ERR_TYPE_DYN_DALLOC,
Michael Ellermand800ba12015-02-17 20:01:53 +1100414};
415
416/* Memory Reilience error type */
417enum OpalMemErr_ResilErrType {
418 OPAL_MEM_RESILIENCE_CE = 0,
419 OPAL_MEM_RESILIENCE_UE,
420 OPAL_MEM_RESILIENCE_UE_SCRUB,
421};
422
423/* Dynamic Memory Deallocation type */
424enum OpalMemErr_DynErrType {
425 OPAL_MEM_DYNAMIC_DEALLOC = 0,
426};
427
Michael Ellermand800ba12015-02-17 20:01:53 +1100428struct OpalMemoryErrorData {
429 enum OpalMemErr_Version version:8; /* 0x00 */
430 enum OpalMemErrType type:8; /* 0x01 */
431 __be16 flags; /* 0x02 */
432 uint8_t reserved_1[4]; /* 0x04 */
433
434 union {
435 /* Memory Resilience corrected/uncorrected error info */
436 struct {
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100437 enum OpalMemErr_ResilErrType resil_err_type:8;
438 uint8_t reserved_1[7];
439 __be64 physical_address_start;
440 __be64 physical_address_end;
Michael Ellermand800ba12015-02-17 20:01:53 +1100441 } resilience;
442 /* Dynamic memory deallocation error info */
443 struct {
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100444 enum OpalMemErr_DynErrType dyn_err_type:8;
445 uint8_t reserved_1[7];
446 __be64 physical_address_start;
447 __be64 physical_address_end;
Michael Ellermand800ba12015-02-17 20:01:53 +1100448 } dyn_dealloc;
449 } u;
450};
451
452/* HMI interrupt event */
453enum OpalHMI_Version {
454 OpalHMIEvt_V1 = 1,
Mahesh Salgaonkarc33e11d2015-05-05 13:34:58 +0530455 OpalHMIEvt_V2 = 2,
Michael Ellermand800ba12015-02-17 20:01:53 +1100456};
457
458enum OpalHMI_Severity {
459 OpalHMI_SEV_NO_ERROR = 0,
460 OpalHMI_SEV_WARNING = 1,
461 OpalHMI_SEV_ERROR_SYNC = 2,
462 OpalHMI_SEV_FATAL = 3,
463};
464
465enum OpalHMI_Disposition {
466 OpalHMI_DISPOSITION_RECOVERED = 0,
467 OpalHMI_DISPOSITION_NOT_RECOVERED = 1,
468};
469
470enum OpalHMI_ErrType {
471 OpalHMI_ERROR_MALFUNC_ALERT = 0,
472 OpalHMI_ERROR_PROC_RECOV_DONE,
473 OpalHMI_ERROR_PROC_RECOV_DONE_AGAIN,
474 OpalHMI_ERROR_PROC_RECOV_MASKED,
475 OpalHMI_ERROR_TFAC,
476 OpalHMI_ERROR_TFMR_PARITY,
477 OpalHMI_ERROR_HA_OVERFLOW_WARN,
478 OpalHMI_ERROR_XSCOM_FAIL,
479 OpalHMI_ERROR_XSCOM_DONE,
480 OpalHMI_ERROR_SCOM_FIR,
481 OpalHMI_ERROR_DEBUG_TRIG_FIR,
482 OpalHMI_ERROR_HYP_RESOURCE,
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100483 OpalHMI_ERROR_CAPP_RECOVERY,
Michael Ellermand800ba12015-02-17 20:01:53 +1100484};
485
Mahesh Salgaonkarc33e11d2015-05-05 13:34:58 +0530486enum OpalHMI_XstopType {
487 CHECKSTOP_TYPE_UNKNOWN = 0,
488 CHECKSTOP_TYPE_CORE = 1,
489 CHECKSTOP_TYPE_NX = 2,
490};
491
492enum OpalHMI_CoreXstopReason {
493 CORE_CHECKSTOP_IFU_REGFILE = 0x00000001,
494 CORE_CHECKSTOP_IFU_LOGIC = 0x00000002,
495 CORE_CHECKSTOP_PC_DURING_RECOV = 0x00000004,
496 CORE_CHECKSTOP_ISU_REGFILE = 0x00000008,
497 CORE_CHECKSTOP_ISU_LOGIC = 0x00000010,
498 CORE_CHECKSTOP_FXU_LOGIC = 0x00000020,
499 CORE_CHECKSTOP_VSU_LOGIC = 0x00000040,
500 CORE_CHECKSTOP_PC_RECOV_IN_MAINT_MODE = 0x00000080,
501 CORE_CHECKSTOP_LSU_REGFILE = 0x00000100,
502 CORE_CHECKSTOP_PC_FWD_PROGRESS = 0x00000200,
503 CORE_CHECKSTOP_LSU_LOGIC = 0x00000400,
504 CORE_CHECKSTOP_PC_LOGIC = 0x00000800,
505 CORE_CHECKSTOP_PC_HYP_RESOURCE = 0x00001000,
506 CORE_CHECKSTOP_PC_HANG_RECOV_FAILED = 0x00002000,
507 CORE_CHECKSTOP_PC_AMBI_HANG_DETECTED = 0x00004000,
508 CORE_CHECKSTOP_PC_DEBUG_TRIG_ERR_INJ = 0x00008000,
509 CORE_CHECKSTOP_PC_SPRD_HYP_ERR_INJ = 0x00010000,
510};
511
512enum OpalHMI_NestAccelXstopReason {
513 NX_CHECKSTOP_SHM_INVAL_STATE_ERR = 0x00000001,
514 NX_CHECKSTOP_DMA_INVAL_STATE_ERR_1 = 0x00000002,
515 NX_CHECKSTOP_DMA_INVAL_STATE_ERR_2 = 0x00000004,
516 NX_CHECKSTOP_DMA_CH0_INVAL_STATE_ERR = 0x00000008,
517 NX_CHECKSTOP_DMA_CH1_INVAL_STATE_ERR = 0x00000010,
518 NX_CHECKSTOP_DMA_CH2_INVAL_STATE_ERR = 0x00000020,
519 NX_CHECKSTOP_DMA_CH3_INVAL_STATE_ERR = 0x00000040,
520 NX_CHECKSTOP_DMA_CH4_INVAL_STATE_ERR = 0x00000080,
521 NX_CHECKSTOP_DMA_CH5_INVAL_STATE_ERR = 0x00000100,
522 NX_CHECKSTOP_DMA_CH6_INVAL_STATE_ERR = 0x00000200,
523 NX_CHECKSTOP_DMA_CH7_INVAL_STATE_ERR = 0x00000400,
524 NX_CHECKSTOP_DMA_CRB_UE = 0x00000800,
525 NX_CHECKSTOP_DMA_CRB_SUE = 0x00001000,
526 NX_CHECKSTOP_PBI_ISN_UE = 0x00002000,
527};
528
Michael Ellermand800ba12015-02-17 20:01:53 +1100529struct OpalHMIEvent {
530 uint8_t version; /* 0x00 */
531 uint8_t severity; /* 0x01 */
532 uint8_t type; /* 0x02 */
533 uint8_t disposition; /* 0x03 */
534 uint8_t reserved_1[4]; /* 0x04 */
535
536 __be64 hmer;
537 /* TFMR register. Valid only for TFAC and TFMR_PARITY error type. */
538 __be64 tfmr;
Mahesh Salgaonkarc33e11d2015-05-05 13:34:58 +0530539
540 /* version 2 and later */
541 union {
542 /*
543 * checkstop info (Core/NX).
544 * Valid for OpalHMI_ERROR_MALFUNC_ALERT.
545 */
546 struct {
547 uint8_t xstop_type; /* enum OpalHMI_XstopType */
548 uint8_t reserved_1[3];
549 __be32 xstop_reason;
550 union {
551 __be32 pir; /* for CHECKSTOP_TYPE_CORE */
552 __be32 chip_id; /* for CHECKSTOP_TYPE_NX */
553 } u;
554 } xstop_error;
555 } u;
Michael Ellermand800ba12015-02-17 20:01:53 +1100556};
557
558enum {
559 OPAL_P7IOC_DIAG_TYPE_NONE = 0,
560 OPAL_P7IOC_DIAG_TYPE_RGC = 1,
561 OPAL_P7IOC_DIAG_TYPE_BI = 2,
562 OPAL_P7IOC_DIAG_TYPE_CI = 3,
563 OPAL_P7IOC_DIAG_TYPE_MISC = 4,
564 OPAL_P7IOC_DIAG_TYPE_I2C = 5,
565 OPAL_P7IOC_DIAG_TYPE_LAST = 6
566};
567
568struct OpalIoP7IOCErrorData {
569 __be16 type;
570
571 /* GEM */
572 __be64 gemXfir;
573 __be64 gemRfir;
574 __be64 gemRirqfir;
575 __be64 gemMask;
576 __be64 gemRwof;
577
578 /* LEM */
579 __be64 lemFir;
580 __be64 lemErrMask;
581 __be64 lemAction0;
582 __be64 lemAction1;
583 __be64 lemWof;
584
585 union {
586 struct OpalIoP7IOCRgcErrorData {
587 __be64 rgcStatus; /* 3E1C10 */
588 __be64 rgcLdcp; /* 3E1C18 */
589 }rgc;
590 struct OpalIoP7IOCBiErrorData {
591 __be64 biLdcp0; /* 3C0100, 3C0118 */
592 __be64 biLdcp1; /* 3C0108, 3C0120 */
593 __be64 biLdcp2; /* 3C0110, 3C0128 */
594 __be64 biFenceStatus; /* 3C0130, 3C0130 */
595
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100596 uint8_t biDownbound; /* BI Downbound or Upbound */
Michael Ellermand800ba12015-02-17 20:01:53 +1100597 }bi;
598 struct OpalIoP7IOCCiErrorData {
599 __be64 ciPortStatus; /* 3Dn008 */
600 __be64 ciPortLdcp; /* 3Dn010 */
601
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100602 uint8_t ciPort; /* Index of CI port: 0/1 */
Michael Ellermand800ba12015-02-17 20:01:53 +1100603 }ci;
604 };
605};
606
607/**
608 * This structure defines the overlay which will be used to store PHB error
609 * data upon request.
610 */
611enum {
612 OPAL_PHB_ERROR_DATA_VERSION_1 = 1,
613};
614
615enum {
616 OPAL_PHB_ERROR_DATA_TYPE_P7IOC = 1,
617 OPAL_PHB_ERROR_DATA_TYPE_PHB3 = 2
618};
619
620enum {
621 OPAL_P7IOC_NUM_PEST_REGS = 128,
622 OPAL_PHB3_NUM_PEST_REGS = 256
623};
624
Michael Ellermand800ba12015-02-17 20:01:53 +1100625struct OpalIoPhbErrorCommon {
626 __be32 version;
627 __be32 ioType;
628 __be32 len;
629};
630
631struct OpalIoP7IOCPhbErrorData {
632 struct OpalIoPhbErrorCommon common;
633
634 __be32 brdgCtl;
635
636 // P7IOC utl regs
637 __be32 portStatusReg;
638 __be32 rootCmplxStatus;
639 __be32 busAgentStatus;
640
641 // P7IOC cfg regs
642 __be32 deviceStatus;
643 __be32 slotStatus;
644 __be32 linkStatus;
645 __be32 devCmdStatus;
646 __be32 devSecStatus;
647
648 // cfg AER regs
649 __be32 rootErrorStatus;
650 __be32 uncorrErrorStatus;
651 __be32 corrErrorStatus;
652 __be32 tlpHdr1;
653 __be32 tlpHdr2;
654 __be32 tlpHdr3;
655 __be32 tlpHdr4;
656 __be32 sourceId;
657
658 __be32 rsv3;
659
660 // Record data about the call to allocate a buffer.
661 __be64 errorClass;
662 __be64 correlator;
663
664 //P7IOC MMIO Error Regs
665 __be64 p7iocPlssr; // n120
666 __be64 p7iocCsr; // n110
667 __be64 lemFir; // nC00
668 __be64 lemErrorMask; // nC18
669 __be64 lemWOF; // nC40
670 __be64 phbErrorStatus; // nC80
671 __be64 phbFirstErrorStatus; // nC88
672 __be64 phbErrorLog0; // nCC0
673 __be64 phbErrorLog1; // nCC8
674 __be64 mmioErrorStatus; // nD00
675 __be64 mmioFirstErrorStatus; // nD08
676 __be64 mmioErrorLog0; // nD40
677 __be64 mmioErrorLog1; // nD48
678 __be64 dma0ErrorStatus; // nD80
679 __be64 dma0FirstErrorStatus; // nD88
680 __be64 dma0ErrorLog0; // nDC0
681 __be64 dma0ErrorLog1; // nDC8
682 __be64 dma1ErrorStatus; // nE00
683 __be64 dma1FirstErrorStatus; // nE08
684 __be64 dma1ErrorLog0; // nE40
685 __be64 dma1ErrorLog1; // nE48
686 __be64 pestA[OPAL_P7IOC_NUM_PEST_REGS];
687 __be64 pestB[OPAL_P7IOC_NUM_PEST_REGS];
688};
689
690struct OpalIoPhb3ErrorData {
691 struct OpalIoPhbErrorCommon common;
692
693 __be32 brdgCtl;
694
695 /* PHB3 UTL regs */
696 __be32 portStatusReg;
697 __be32 rootCmplxStatus;
698 __be32 busAgentStatus;
699
700 /* PHB3 cfg regs */
701 __be32 deviceStatus;
702 __be32 slotStatus;
703 __be32 linkStatus;
704 __be32 devCmdStatus;
705 __be32 devSecStatus;
706
707 /* cfg AER regs */
708 __be32 rootErrorStatus;
709 __be32 uncorrErrorStatus;
710 __be32 corrErrorStatus;
711 __be32 tlpHdr1;
712 __be32 tlpHdr2;
713 __be32 tlpHdr3;
714 __be32 tlpHdr4;
715 __be32 sourceId;
716
717 __be32 rsv3;
718
719 /* Record data about the call to allocate a buffer */
720 __be64 errorClass;
721 __be64 correlator;
722
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100723 /* PHB3 MMIO Error Regs */
Michael Ellermand800ba12015-02-17 20:01:53 +1100724 __be64 nFir; /* 000 */
725 __be64 nFirMask; /* 003 */
726 __be64 nFirWOF; /* 008 */
Michael Ellermand800ba12015-02-17 20:01:53 +1100727 __be64 phbPlssr; /* 120 */
728 __be64 phbCsr; /* 110 */
729 __be64 lemFir; /* C00 */
730 __be64 lemErrorMask; /* C18 */
731 __be64 lemWOF; /* C40 */
732 __be64 phbErrorStatus; /* C80 */
733 __be64 phbFirstErrorStatus; /* C88 */
734 __be64 phbErrorLog0; /* CC0 */
735 __be64 phbErrorLog1; /* CC8 */
736 __be64 mmioErrorStatus; /* D00 */
737 __be64 mmioFirstErrorStatus; /* D08 */
738 __be64 mmioErrorLog0; /* D40 */
739 __be64 mmioErrorLog1; /* D48 */
740 __be64 dma0ErrorStatus; /* D80 */
741 __be64 dma0FirstErrorStatus; /* D88 */
742 __be64 dma0ErrorLog0; /* DC0 */
743 __be64 dma0ErrorLog1; /* DC8 */
744 __be64 dma1ErrorStatus; /* E00 */
745 __be64 dma1FirstErrorStatus; /* E08 */
746 __be64 dma1ErrorLog0; /* E40 */
747 __be64 dma1ErrorLog1; /* E48 */
748 __be64 pestA[OPAL_PHB3_NUM_PEST_REGS];
749 __be64 pestB[OPAL_PHB3_NUM_PEST_REGS];
750};
751
752enum {
753 OPAL_REINIT_CPUS_HILE_BE = (1 << 0),
754 OPAL_REINIT_CPUS_HILE_LE = (1 << 1),
755};
756
757typedef struct oppanel_line {
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100758 __be64 line;
759 __be64 line_len;
Michael Ellermand800ba12015-02-17 20:01:53 +1100760} oppanel_line_t;
761
Jeremy Kerr0d7cd852015-06-04 21:51:47 +0800762enum opal_prd_msg_type {
763 OPAL_PRD_MSG_TYPE_INIT = 0, /* HBRT --> OPAL */
764 OPAL_PRD_MSG_TYPE_FINI, /* HBRT/kernel --> OPAL */
765 OPAL_PRD_MSG_TYPE_ATTN, /* HBRT <-- OPAL */
766 OPAL_PRD_MSG_TYPE_ATTN_ACK, /* HBRT --> OPAL */
767 OPAL_PRD_MSG_TYPE_OCC_ERROR, /* HBRT <-- OPAL */
768 OPAL_PRD_MSG_TYPE_OCC_RESET, /* HBRT <-- OPAL */
769};
770
771struct opal_prd_msg_header {
772 uint8_t type;
773 uint8_t pad[1];
774 __be16 size;
775};
776
777struct opal_prd_msg;
778
Michael Ellermand800ba12015-02-17 20:01:53 +1100779/*
780 * SG entries
781 *
782 * WARNING: The current implementation requires each entry
783 * to represent a block that is 4k aligned *and* each block
784 * size except the last one in the list to be as well.
785 */
786struct opal_sg_entry {
787 __be64 data;
788 __be64 length;
789};
790
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100791/*
792 * Candiate image SG list.
793 *
794 * length = VER | length
795 */
Michael Ellermand800ba12015-02-17 20:01:53 +1100796struct opal_sg_list {
797 __be64 length;
798 __be64 next;
799 struct opal_sg_entry entry[];
800};
801
802/*
803 * Dump region ID range usable by the OS
804 */
805#define OPAL_DUMP_REGION_HOST_START 0x80
806#define OPAL_DUMP_REGION_LOG_BUF 0x80
807#define OPAL_DUMP_REGION_HOST_END 0xFF
808
Michael Ellermand7cf83f2015-02-17 20:01:54 +1100809/* CAPI modes for PHB */
810enum {
811 OPAL_PHB_CAPI_MODE_PCIE = 0,
812 OPAL_PHB_CAPI_MODE_CAPI = 1,
813 OPAL_PHB_CAPI_MODE_SNOOP_OFF = 2,
814 OPAL_PHB_CAPI_MODE_SNOOP_ON = 3,
815};
816
Michael Ellermand800ba12015-02-17 20:01:53 +1100817/* OPAL I2C request */
818struct opal_i2c_request {
819 uint8_t type;
820#define OPAL_I2C_RAW_READ 0
821#define OPAL_I2C_RAW_WRITE 1
822#define OPAL_I2C_SM_READ 2
823#define OPAL_I2C_SM_WRITE 3
824 uint8_t flags;
825#define OPAL_I2C_ADDR_10 0x01 /* Not supported yet */
826 uint8_t subaddr_sz; /* Max 4 */
827 uint8_t reserved;
828 __be16 addr; /* 7 or 10 bit address */
829 __be16 reserved2;
830 __be32 subaddr; /* Sub-address if any */
831 __be32 size; /* Data size */
832 __be64 buffer_ra; /* Buffer real address */
833};
834
Vipin K Parashar3b476aad2015-07-08 16:36:01 +0530835/*
836 * EPOW status sharing (OPAL and the host)
837 *
838 * The host will pass on OPAL, a buffer of length OPAL_SYSEPOW_MAX
839 * with individual elements being 16 bits wide to fetch the system
840 * wide EPOW status. Each element in the buffer will contain the
841 * EPOW status in it's bit representation for a particular EPOW sub
842 * class as defiend here. So multiple detailed EPOW status bits
843 * specific for any sub class can be represented in a single buffer
844 * element as it's bit representation.
845 */
846
847/* System EPOW type */
848enum OpalSysEpow {
849 OPAL_SYSEPOW_POWER = 0, /* Power EPOW */
850 OPAL_SYSEPOW_TEMP = 1, /* Temperature EPOW */
851 OPAL_SYSEPOW_COOLING = 2, /* Cooling EPOW */
852 OPAL_SYSEPOW_MAX = 3, /* Max EPOW categories */
853};
854
855/* Power EPOW */
856enum OpalSysPower {
857 OPAL_SYSPOWER_UPS = 0x0001, /* System on UPS power */
858 OPAL_SYSPOWER_CHNG = 0x0002, /* System power config change */
859 OPAL_SYSPOWER_FAIL = 0x0004, /* System impending power failure */
860 OPAL_SYSPOWER_INCL = 0x0008, /* System incomplete power */
861};
862
863/* Temperature EPOW */
864enum OpalSysTemp {
865 OPAL_SYSTEMP_AMB = 0x0001, /* System over ambient temperature */
866 OPAL_SYSTEMP_INT = 0x0002, /* System over internal temperature */
867 OPAL_SYSTEMP_HMD = 0x0004, /* System over ambient humidity */
868};
869
870/* Cooling EPOW */
871enum OpalSysCooling {
872 OPAL_SYSCOOL_INSF = 0x0001, /* System insufficient cooling */
873};
874
Mahesh Salgaonkare784b642015-07-31 21:24:38 +0530875/* Argument to OPAL_CEC_REBOOT2() */
876enum {
877 OPAL_REBOOT_NORMAL = 0,
878 OPAL_REBOOT_PLATFORM_ERROR = 1,
879};
880
Michael Ellermand800ba12015-02-17 20:01:53 +1100881#endif /* __ASSEMBLY__ */
882
883#endif /* __OPAL_API_H */