Loading...
1/*
2 * OPAL API definitions.
3 *
4 * Copyright 2011-2015 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
12#ifndef __OPAL_API_H
13#define __OPAL_API_H
14
15/****** OPAL APIs ******/
16
17/* Return codes */
18#define OPAL_SUCCESS 0
19#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
34#define OPAL_EMPTY -16
35#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) */
45#define OPAL_INVALID_CALL -1
46#define OPAL_TEST 0
47#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
89#define OPAL_WRITE_OPPANEL 43 /* unimplemented */
90#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
135#define OPAL_ELOG_SEND 92 /* Deprecated */
136#define OPAL_PCI_SET_PHB_CAPI_MODE 93
137#define OPAL_DUMP_INFO2 94
138#define OPAL_WRITE_OPPANEL_ASYNC 95
139#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
148#define OPAL_GET_DPO_STATUS 105
149#define OPAL_OLD_I2C_REQUEST 106 /* Deprecated */
150#define OPAL_IPMI_SEND 107
151#define OPAL_IPMI_RECV 108
152#define OPAL_I2C_REQUEST 109
153#define OPAL_FLASH_READ 110
154#define OPAL_FLASH_WRITE 111
155#define OPAL_FLASH_ERASE 112
156#define OPAL_PRD_MSG 113
157#define OPAL_LEDS_GET_INDICATOR 114
158#define OPAL_LEDS_SET_INDICATOR 115
159#define OPAL_CEC_REBOOT2 116
160#define OPAL_CONSOLE_FLUSH 117
161#define OPAL_LAST 117
162
163/* Device tree flags */
164
165/* Flags set in power-mgmt nodes in device tree if
166 * respective idle states are supported in the platform.
167 */
168#define OPAL_PM_NAP_ENABLED 0x00010000
169#define OPAL_PM_SLEEP_ENABLED 0x00020000
170#define OPAL_PM_WINKLE_ENABLED 0x00040000
171#define OPAL_PM_SLEEP_ENABLED_ER1 0x00080000 /* with workaround */
172
173/*
174 * OPAL_CONFIG_CPU_IDLE_STATE parameters
175 */
176#define OPAL_CONFIG_IDLE_FASTSLEEP 1
177#define OPAL_CONFIG_IDLE_UNDO 0
178#define OPAL_CONFIG_IDLE_APPLY 1
179
180#ifndef __ASSEMBLY__
181
182/* Other enums */
183enum OpalFreezeState {
184 OPAL_EEH_STOPPED_NOT_FROZEN = 0,
185 OPAL_EEH_STOPPED_MMIO_FREEZE = 1,
186 OPAL_EEH_STOPPED_DMA_FREEZE = 2,
187 OPAL_EEH_STOPPED_MMIO_DMA_FREEZE = 3,
188 OPAL_EEH_STOPPED_RESET = 4,
189 OPAL_EEH_STOPPED_TEMP_UNAVAIL = 5,
190 OPAL_EEH_STOPPED_PERM_UNAVAIL = 6
191};
192
193enum OpalEehFreezeActionToken {
194 OPAL_EEH_ACTION_CLEAR_FREEZE_MMIO = 1,
195 OPAL_EEH_ACTION_CLEAR_FREEZE_DMA = 2,
196 OPAL_EEH_ACTION_CLEAR_FREEZE_ALL = 3,
197
198 OPAL_EEH_ACTION_SET_FREEZE_MMIO = 1,
199 OPAL_EEH_ACTION_SET_FREEZE_DMA = 2,
200 OPAL_EEH_ACTION_SET_FREEZE_ALL = 3
201};
202
203enum OpalPciStatusToken {
204 OPAL_EEH_NO_ERROR = 0,
205 OPAL_EEH_IOC_ERROR = 1,
206 OPAL_EEH_PHB_ERROR = 2,
207 OPAL_EEH_PE_ERROR = 3,
208 OPAL_EEH_PE_MMIO_ERROR = 4,
209 OPAL_EEH_PE_DMA_ERROR = 5
210};
211
212enum OpalPciErrorSeverity {
213 OPAL_EEH_SEV_NO_ERROR = 0,
214 OPAL_EEH_SEV_IOC_DEAD = 1,
215 OPAL_EEH_SEV_PHB_DEAD = 2,
216 OPAL_EEH_SEV_PHB_FENCED = 3,
217 OPAL_EEH_SEV_PE_ER = 4,
218 OPAL_EEH_SEV_INF = 5
219};
220
221enum OpalErrinjectType {
222 OPAL_ERR_INJECT_TYPE_IOA_BUS_ERR = 0,
223 OPAL_ERR_INJECT_TYPE_IOA_BUS_ERR64 = 1,
224};
225
226enum OpalErrinjectFunc {
227 /* IOA bus specific errors */
228 OPAL_ERR_INJECT_FUNC_IOA_LD_MEM_ADDR = 0,
229 OPAL_ERR_INJECT_FUNC_IOA_LD_MEM_DATA = 1,
230 OPAL_ERR_INJECT_FUNC_IOA_LD_IO_ADDR = 2,
231 OPAL_ERR_INJECT_FUNC_IOA_LD_IO_DATA = 3,
232 OPAL_ERR_INJECT_FUNC_IOA_LD_CFG_ADDR = 4,
233 OPAL_ERR_INJECT_FUNC_IOA_LD_CFG_DATA = 5,
234 OPAL_ERR_INJECT_FUNC_IOA_ST_MEM_ADDR = 6,
235 OPAL_ERR_INJECT_FUNC_IOA_ST_MEM_DATA = 7,
236 OPAL_ERR_INJECT_FUNC_IOA_ST_IO_ADDR = 8,
237 OPAL_ERR_INJECT_FUNC_IOA_ST_IO_DATA = 9,
238 OPAL_ERR_INJECT_FUNC_IOA_ST_CFG_ADDR = 10,
239 OPAL_ERR_INJECT_FUNC_IOA_ST_CFG_DATA = 11,
240 OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_ADDR = 12,
241 OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_DATA = 13,
242 OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_MASTER = 14,
243 OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_TARGET = 15,
244 OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_ADDR = 16,
245 OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_DATA = 17,
246 OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_MASTER = 18,
247 OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_TARGET = 19,
248};
249
250enum OpalMmioWindowType {
251 OPAL_M32_WINDOW_TYPE = 1,
252 OPAL_M64_WINDOW_TYPE = 2,
253 OPAL_IO_WINDOW_TYPE = 3
254};
255
256enum OpalExceptionHandler {
257 OPAL_MACHINE_CHECK_HANDLER = 1,
258 OPAL_HYPERVISOR_MAINTENANCE_HANDLER = 2,
259 OPAL_SOFTPATCH_HANDLER = 3
260};
261
262enum OpalPendingState {
263 OPAL_EVENT_OPAL_INTERNAL = 0x1,
264 OPAL_EVENT_NVRAM = 0x2,
265 OPAL_EVENT_RTC = 0x4,
266 OPAL_EVENT_CONSOLE_OUTPUT = 0x8,
267 OPAL_EVENT_CONSOLE_INPUT = 0x10,
268 OPAL_EVENT_ERROR_LOG_AVAIL = 0x20,
269 OPAL_EVENT_ERROR_LOG = 0x40,
270 OPAL_EVENT_EPOW = 0x80,
271 OPAL_EVENT_LED_STATUS = 0x100,
272 OPAL_EVENT_PCI_ERROR = 0x200,
273 OPAL_EVENT_DUMP_AVAIL = 0x400,
274 OPAL_EVENT_MSG_PENDING = 0x800,
275};
276
277enum OpalThreadStatus {
278 OPAL_THREAD_INACTIVE = 0x0,
279 OPAL_THREAD_STARTED = 0x1,
280 OPAL_THREAD_UNAVAILABLE = 0x2 /* opal-v3 */
281};
282
283enum OpalPciBusCompare {
284 OpalPciBusAny = 0, /* Any bus number match */
285 OpalPciBus3Bits = 2, /* Match top 3 bits of bus number */
286 OpalPciBus4Bits = 3, /* Match top 4 bits of bus number */
287 OpalPciBus5Bits = 4, /* Match top 5 bits of bus number */
288 OpalPciBus6Bits = 5, /* Match top 6 bits of bus number */
289 OpalPciBus7Bits = 6, /* Match top 7 bits of bus number */
290 OpalPciBusAll = 7, /* Match bus number exactly */
291};
292
293enum OpalDeviceCompare {
294 OPAL_IGNORE_RID_DEVICE_NUMBER = 0,
295 OPAL_COMPARE_RID_DEVICE_NUMBER = 1
296};
297
298enum OpalFuncCompare {
299 OPAL_IGNORE_RID_FUNCTION_NUMBER = 0,
300 OPAL_COMPARE_RID_FUNCTION_NUMBER = 1
301};
302
303enum OpalPeAction {
304 OPAL_UNMAP_PE = 0,
305 OPAL_MAP_PE = 1
306};
307
308enum OpalPeltvAction {
309 OPAL_REMOVE_PE_FROM_DOMAIN = 0,
310 OPAL_ADD_PE_TO_DOMAIN = 1
311};
312
313enum OpalMveEnableAction {
314 OPAL_DISABLE_MVE = 0,
315 OPAL_ENABLE_MVE = 1
316};
317
318enum OpalM64Action {
319 OPAL_DISABLE_M64 = 0,
320 OPAL_ENABLE_M64_SPLIT = 1,
321 OPAL_ENABLE_M64_NON_SPLIT = 2
322};
323
324enum OpalPciResetScope {
325 OPAL_RESET_PHB_COMPLETE = 1,
326 OPAL_RESET_PCI_LINK = 2,
327 OPAL_RESET_PHB_ERROR = 3,
328 OPAL_RESET_PCI_HOT = 4,
329 OPAL_RESET_PCI_FUNDAMENTAL = 5,
330 OPAL_RESET_PCI_IODA_TABLE = 6
331};
332
333enum OpalPciReinitScope {
334 /*
335 * Note: we chose values that do not overlap
336 * OpalPciResetScope as OPAL v2 used the same
337 * enum for both
338 */
339 OPAL_REINIT_PCI_DEV = 1000
340};
341
342enum OpalPciResetState {
343 OPAL_DEASSERT_RESET = 0,
344 OPAL_ASSERT_RESET = 1
345};
346
347enum OpalSlotLedType {
348 OPAL_SLOT_LED_TYPE_ID = 0, /* IDENTIFY LED */
349 OPAL_SLOT_LED_TYPE_FAULT = 1, /* FAULT LED */
350 OPAL_SLOT_LED_TYPE_ATTN = 2, /* System Attention LED */
351 OPAL_SLOT_LED_TYPE_MAX = 3
352};
353
354enum OpalSlotLedState {
355 OPAL_SLOT_LED_STATE_OFF = 0, /* LED is OFF */
356 OPAL_SLOT_LED_STATE_ON = 1 /* LED is ON */
357};
358
359/*
360 * Address cycle types for LPC accesses. These also correspond
361 * to the content of the first cell of the "reg" property for
362 * device nodes on the LPC bus
363 */
364enum OpalLPCAddressType {
365 OPAL_LPC_MEM = 0,
366 OPAL_LPC_IO = 1,
367 OPAL_LPC_FW = 2,
368};
369
370enum opal_msg_type {
371 OPAL_MSG_ASYNC_COMP = 0, /* params[0] = token, params[1] = rc,
372 * additional params function-specific
373 */
374 OPAL_MSG_MEM_ERR,
375 OPAL_MSG_EPOW,
376 OPAL_MSG_SHUTDOWN, /* params[0] = 1 reboot, 0 shutdown */
377 OPAL_MSG_HMI_EVT,
378 OPAL_MSG_DPO,
379 OPAL_MSG_PRD,
380 OPAL_MSG_OCC,
381 OPAL_MSG_TYPE_MAX,
382};
383
384struct opal_msg {
385 __be32 msg_type;
386 __be32 reserved;
387 __be64 params[8];
388};
389
390/* System parameter permission */
391enum OpalSysparamPerm {
392 OPAL_SYSPARAM_READ = 0x1,
393 OPAL_SYSPARAM_WRITE = 0x2,
394 OPAL_SYSPARAM_RW = (OPAL_SYSPARAM_READ | OPAL_SYSPARAM_WRITE),
395};
396
397enum {
398 OPAL_IPMI_MSG_FORMAT_VERSION_1 = 1,
399};
400
401struct opal_ipmi_msg {
402 uint8_t version;
403 uint8_t netfn;
404 uint8_t cmd;
405 uint8_t data[];
406};
407
408/* FSP memory errors handling */
409enum OpalMemErr_Version {
410 OpalMemErr_V1 = 1,
411};
412
413enum OpalMemErrType {
414 OPAL_MEM_ERR_TYPE_RESILIENCE = 0,
415 OPAL_MEM_ERR_TYPE_DYN_DALLOC,
416};
417
418/* Memory Reilience error type */
419enum OpalMemErr_ResilErrType {
420 OPAL_MEM_RESILIENCE_CE = 0,
421 OPAL_MEM_RESILIENCE_UE,
422 OPAL_MEM_RESILIENCE_UE_SCRUB,
423};
424
425/* Dynamic Memory Deallocation type */
426enum OpalMemErr_DynErrType {
427 OPAL_MEM_DYNAMIC_DEALLOC = 0,
428};
429
430struct OpalMemoryErrorData {
431 enum OpalMemErr_Version version:8; /* 0x00 */
432 enum OpalMemErrType type:8; /* 0x01 */
433 __be16 flags; /* 0x02 */
434 uint8_t reserved_1[4]; /* 0x04 */
435
436 union {
437 /* Memory Resilience corrected/uncorrected error info */
438 struct {
439 enum OpalMemErr_ResilErrType resil_err_type:8;
440 uint8_t reserved_1[7];
441 __be64 physical_address_start;
442 __be64 physical_address_end;
443 } resilience;
444 /* Dynamic memory deallocation error info */
445 struct {
446 enum OpalMemErr_DynErrType dyn_err_type:8;
447 uint8_t reserved_1[7];
448 __be64 physical_address_start;
449 __be64 physical_address_end;
450 } dyn_dealloc;
451 } u;
452};
453
454/* HMI interrupt event */
455enum OpalHMI_Version {
456 OpalHMIEvt_V1 = 1,
457 OpalHMIEvt_V2 = 2,
458};
459
460enum OpalHMI_Severity {
461 OpalHMI_SEV_NO_ERROR = 0,
462 OpalHMI_SEV_WARNING = 1,
463 OpalHMI_SEV_ERROR_SYNC = 2,
464 OpalHMI_SEV_FATAL = 3,
465};
466
467enum OpalHMI_Disposition {
468 OpalHMI_DISPOSITION_RECOVERED = 0,
469 OpalHMI_DISPOSITION_NOT_RECOVERED = 1,
470};
471
472enum OpalHMI_ErrType {
473 OpalHMI_ERROR_MALFUNC_ALERT = 0,
474 OpalHMI_ERROR_PROC_RECOV_DONE,
475 OpalHMI_ERROR_PROC_RECOV_DONE_AGAIN,
476 OpalHMI_ERROR_PROC_RECOV_MASKED,
477 OpalHMI_ERROR_TFAC,
478 OpalHMI_ERROR_TFMR_PARITY,
479 OpalHMI_ERROR_HA_OVERFLOW_WARN,
480 OpalHMI_ERROR_XSCOM_FAIL,
481 OpalHMI_ERROR_XSCOM_DONE,
482 OpalHMI_ERROR_SCOM_FIR,
483 OpalHMI_ERROR_DEBUG_TRIG_FIR,
484 OpalHMI_ERROR_HYP_RESOURCE,
485 OpalHMI_ERROR_CAPP_RECOVERY,
486};
487
488enum OpalHMI_XstopType {
489 CHECKSTOP_TYPE_UNKNOWN = 0,
490 CHECKSTOP_TYPE_CORE = 1,
491 CHECKSTOP_TYPE_NX = 2,
492};
493
494enum OpalHMI_CoreXstopReason {
495 CORE_CHECKSTOP_IFU_REGFILE = 0x00000001,
496 CORE_CHECKSTOP_IFU_LOGIC = 0x00000002,
497 CORE_CHECKSTOP_PC_DURING_RECOV = 0x00000004,
498 CORE_CHECKSTOP_ISU_REGFILE = 0x00000008,
499 CORE_CHECKSTOP_ISU_LOGIC = 0x00000010,
500 CORE_CHECKSTOP_FXU_LOGIC = 0x00000020,
501 CORE_CHECKSTOP_VSU_LOGIC = 0x00000040,
502 CORE_CHECKSTOP_PC_RECOV_IN_MAINT_MODE = 0x00000080,
503 CORE_CHECKSTOP_LSU_REGFILE = 0x00000100,
504 CORE_CHECKSTOP_PC_FWD_PROGRESS = 0x00000200,
505 CORE_CHECKSTOP_LSU_LOGIC = 0x00000400,
506 CORE_CHECKSTOP_PC_LOGIC = 0x00000800,
507 CORE_CHECKSTOP_PC_HYP_RESOURCE = 0x00001000,
508 CORE_CHECKSTOP_PC_HANG_RECOV_FAILED = 0x00002000,
509 CORE_CHECKSTOP_PC_AMBI_HANG_DETECTED = 0x00004000,
510 CORE_CHECKSTOP_PC_DEBUG_TRIG_ERR_INJ = 0x00008000,
511 CORE_CHECKSTOP_PC_SPRD_HYP_ERR_INJ = 0x00010000,
512};
513
514enum OpalHMI_NestAccelXstopReason {
515 NX_CHECKSTOP_SHM_INVAL_STATE_ERR = 0x00000001,
516 NX_CHECKSTOP_DMA_INVAL_STATE_ERR_1 = 0x00000002,
517 NX_CHECKSTOP_DMA_INVAL_STATE_ERR_2 = 0x00000004,
518 NX_CHECKSTOP_DMA_CH0_INVAL_STATE_ERR = 0x00000008,
519 NX_CHECKSTOP_DMA_CH1_INVAL_STATE_ERR = 0x00000010,
520 NX_CHECKSTOP_DMA_CH2_INVAL_STATE_ERR = 0x00000020,
521 NX_CHECKSTOP_DMA_CH3_INVAL_STATE_ERR = 0x00000040,
522 NX_CHECKSTOP_DMA_CH4_INVAL_STATE_ERR = 0x00000080,
523 NX_CHECKSTOP_DMA_CH5_INVAL_STATE_ERR = 0x00000100,
524 NX_CHECKSTOP_DMA_CH6_INVAL_STATE_ERR = 0x00000200,
525 NX_CHECKSTOP_DMA_CH7_INVAL_STATE_ERR = 0x00000400,
526 NX_CHECKSTOP_DMA_CRB_UE = 0x00000800,
527 NX_CHECKSTOP_DMA_CRB_SUE = 0x00001000,
528 NX_CHECKSTOP_PBI_ISN_UE = 0x00002000,
529};
530
531struct OpalHMIEvent {
532 uint8_t version; /* 0x00 */
533 uint8_t severity; /* 0x01 */
534 uint8_t type; /* 0x02 */
535 uint8_t disposition; /* 0x03 */
536 uint8_t reserved_1[4]; /* 0x04 */
537
538 __be64 hmer;
539 /* TFMR register. Valid only for TFAC and TFMR_PARITY error type. */
540 __be64 tfmr;
541
542 /* version 2 and later */
543 union {
544 /*
545 * checkstop info (Core/NX).
546 * Valid for OpalHMI_ERROR_MALFUNC_ALERT.
547 */
548 struct {
549 uint8_t xstop_type; /* enum OpalHMI_XstopType */
550 uint8_t reserved_1[3];
551 __be32 xstop_reason;
552 union {
553 __be32 pir; /* for CHECKSTOP_TYPE_CORE */
554 __be32 chip_id; /* for CHECKSTOP_TYPE_NX */
555 } u;
556 } xstop_error;
557 } u;
558};
559
560enum {
561 OPAL_P7IOC_DIAG_TYPE_NONE = 0,
562 OPAL_P7IOC_DIAG_TYPE_RGC = 1,
563 OPAL_P7IOC_DIAG_TYPE_BI = 2,
564 OPAL_P7IOC_DIAG_TYPE_CI = 3,
565 OPAL_P7IOC_DIAG_TYPE_MISC = 4,
566 OPAL_P7IOC_DIAG_TYPE_I2C = 5,
567 OPAL_P7IOC_DIAG_TYPE_LAST = 6
568};
569
570struct OpalIoP7IOCErrorData {
571 __be16 type;
572
573 /* GEM */
574 __be64 gemXfir;
575 __be64 gemRfir;
576 __be64 gemRirqfir;
577 __be64 gemMask;
578 __be64 gemRwof;
579
580 /* LEM */
581 __be64 lemFir;
582 __be64 lemErrMask;
583 __be64 lemAction0;
584 __be64 lemAction1;
585 __be64 lemWof;
586
587 union {
588 struct OpalIoP7IOCRgcErrorData {
589 __be64 rgcStatus; /* 3E1C10 */
590 __be64 rgcLdcp; /* 3E1C18 */
591 }rgc;
592 struct OpalIoP7IOCBiErrorData {
593 __be64 biLdcp0; /* 3C0100, 3C0118 */
594 __be64 biLdcp1; /* 3C0108, 3C0120 */
595 __be64 biLdcp2; /* 3C0110, 3C0128 */
596 __be64 biFenceStatus; /* 3C0130, 3C0130 */
597
598 uint8_t biDownbound; /* BI Downbound or Upbound */
599 }bi;
600 struct OpalIoP7IOCCiErrorData {
601 __be64 ciPortStatus; /* 3Dn008 */
602 __be64 ciPortLdcp; /* 3Dn010 */
603
604 uint8_t ciPort; /* Index of CI port: 0/1 */
605 }ci;
606 };
607};
608
609/**
610 * This structure defines the overlay which will be used to store PHB error
611 * data upon request.
612 */
613enum {
614 OPAL_PHB_ERROR_DATA_VERSION_1 = 1,
615};
616
617enum {
618 OPAL_PHB_ERROR_DATA_TYPE_P7IOC = 1,
619 OPAL_PHB_ERROR_DATA_TYPE_PHB3 = 2
620};
621
622enum {
623 OPAL_P7IOC_NUM_PEST_REGS = 128,
624 OPAL_PHB3_NUM_PEST_REGS = 256
625};
626
627struct OpalIoPhbErrorCommon {
628 __be32 version;
629 __be32 ioType;
630 __be32 len;
631};
632
633struct OpalIoP7IOCPhbErrorData {
634 struct OpalIoPhbErrorCommon common;
635
636 __be32 brdgCtl;
637
638 // P7IOC utl regs
639 __be32 portStatusReg;
640 __be32 rootCmplxStatus;
641 __be32 busAgentStatus;
642
643 // P7IOC cfg regs
644 __be32 deviceStatus;
645 __be32 slotStatus;
646 __be32 linkStatus;
647 __be32 devCmdStatus;
648 __be32 devSecStatus;
649
650 // cfg AER regs
651 __be32 rootErrorStatus;
652 __be32 uncorrErrorStatus;
653 __be32 corrErrorStatus;
654 __be32 tlpHdr1;
655 __be32 tlpHdr2;
656 __be32 tlpHdr3;
657 __be32 tlpHdr4;
658 __be32 sourceId;
659
660 __be32 rsv3;
661
662 // Record data about the call to allocate a buffer.
663 __be64 errorClass;
664 __be64 correlator;
665
666 //P7IOC MMIO Error Regs
667 __be64 p7iocPlssr; // n120
668 __be64 p7iocCsr; // n110
669 __be64 lemFir; // nC00
670 __be64 lemErrorMask; // nC18
671 __be64 lemWOF; // nC40
672 __be64 phbErrorStatus; // nC80
673 __be64 phbFirstErrorStatus; // nC88
674 __be64 phbErrorLog0; // nCC0
675 __be64 phbErrorLog1; // nCC8
676 __be64 mmioErrorStatus; // nD00
677 __be64 mmioFirstErrorStatus; // nD08
678 __be64 mmioErrorLog0; // nD40
679 __be64 mmioErrorLog1; // nD48
680 __be64 dma0ErrorStatus; // nD80
681 __be64 dma0FirstErrorStatus; // nD88
682 __be64 dma0ErrorLog0; // nDC0
683 __be64 dma0ErrorLog1; // nDC8
684 __be64 dma1ErrorStatus; // nE00
685 __be64 dma1FirstErrorStatus; // nE08
686 __be64 dma1ErrorLog0; // nE40
687 __be64 dma1ErrorLog1; // nE48
688 __be64 pestA[OPAL_P7IOC_NUM_PEST_REGS];
689 __be64 pestB[OPAL_P7IOC_NUM_PEST_REGS];
690};
691
692struct OpalIoPhb3ErrorData {
693 struct OpalIoPhbErrorCommon common;
694
695 __be32 brdgCtl;
696
697 /* PHB3 UTL regs */
698 __be32 portStatusReg;
699 __be32 rootCmplxStatus;
700 __be32 busAgentStatus;
701
702 /* PHB3 cfg regs */
703 __be32 deviceStatus;
704 __be32 slotStatus;
705 __be32 linkStatus;
706 __be32 devCmdStatus;
707 __be32 devSecStatus;
708
709 /* cfg AER regs */
710 __be32 rootErrorStatus;
711 __be32 uncorrErrorStatus;
712 __be32 corrErrorStatus;
713 __be32 tlpHdr1;
714 __be32 tlpHdr2;
715 __be32 tlpHdr3;
716 __be32 tlpHdr4;
717 __be32 sourceId;
718
719 __be32 rsv3;
720
721 /* Record data about the call to allocate a buffer */
722 __be64 errorClass;
723 __be64 correlator;
724
725 /* PHB3 MMIO Error Regs */
726 __be64 nFir; /* 000 */
727 __be64 nFirMask; /* 003 */
728 __be64 nFirWOF; /* 008 */
729 __be64 phbPlssr; /* 120 */
730 __be64 phbCsr; /* 110 */
731 __be64 lemFir; /* C00 */
732 __be64 lemErrorMask; /* C18 */
733 __be64 lemWOF; /* C40 */
734 __be64 phbErrorStatus; /* C80 */
735 __be64 phbFirstErrorStatus; /* C88 */
736 __be64 phbErrorLog0; /* CC0 */
737 __be64 phbErrorLog1; /* CC8 */
738 __be64 mmioErrorStatus; /* D00 */
739 __be64 mmioFirstErrorStatus; /* D08 */
740 __be64 mmioErrorLog0; /* D40 */
741 __be64 mmioErrorLog1; /* D48 */
742 __be64 dma0ErrorStatus; /* D80 */
743 __be64 dma0FirstErrorStatus; /* D88 */
744 __be64 dma0ErrorLog0; /* DC0 */
745 __be64 dma0ErrorLog1; /* DC8 */
746 __be64 dma1ErrorStatus; /* E00 */
747 __be64 dma1FirstErrorStatus; /* E08 */
748 __be64 dma1ErrorLog0; /* E40 */
749 __be64 dma1ErrorLog1; /* E48 */
750 __be64 pestA[OPAL_PHB3_NUM_PEST_REGS];
751 __be64 pestB[OPAL_PHB3_NUM_PEST_REGS];
752};
753
754enum {
755 OPAL_REINIT_CPUS_HILE_BE = (1 << 0),
756 OPAL_REINIT_CPUS_HILE_LE = (1 << 1),
757};
758
759typedef struct oppanel_line {
760 __be64 line;
761 __be64 line_len;
762} oppanel_line_t;
763
764enum opal_prd_msg_type {
765 OPAL_PRD_MSG_TYPE_INIT = 0, /* HBRT --> OPAL */
766 OPAL_PRD_MSG_TYPE_FINI, /* HBRT/kernel --> OPAL */
767 OPAL_PRD_MSG_TYPE_ATTN, /* HBRT <-- OPAL */
768 OPAL_PRD_MSG_TYPE_ATTN_ACK, /* HBRT --> OPAL */
769 OPAL_PRD_MSG_TYPE_OCC_ERROR, /* HBRT <-- OPAL */
770 OPAL_PRD_MSG_TYPE_OCC_RESET, /* HBRT <-- OPAL */
771};
772
773struct opal_prd_msg_header {
774 uint8_t type;
775 uint8_t pad[1];
776 __be16 size;
777};
778
779struct opal_prd_msg;
780
781#define OCC_RESET 0
782#define OCC_LOAD 1
783#define OCC_THROTTLE 2
784#define OCC_MAX_THROTTLE_STATUS 5
785
786struct opal_occ_msg {
787 __be64 type;
788 __be64 chip;
789 __be64 throttle_status;
790};
791
792/*
793 * SG entries
794 *
795 * WARNING: The current implementation requires each entry
796 * to represent a block that is 4k aligned *and* each block
797 * size except the last one in the list to be as well.
798 */
799struct opal_sg_entry {
800 __be64 data;
801 __be64 length;
802};
803
804/*
805 * Candiate image SG list.
806 *
807 * length = VER | length
808 */
809struct opal_sg_list {
810 __be64 length;
811 __be64 next;
812 struct opal_sg_entry entry[];
813};
814
815/*
816 * Dump region ID range usable by the OS
817 */
818#define OPAL_DUMP_REGION_HOST_START 0x80
819#define OPAL_DUMP_REGION_LOG_BUF 0x80
820#define OPAL_DUMP_REGION_HOST_END 0xFF
821
822/* CAPI modes for PHB */
823enum {
824 OPAL_PHB_CAPI_MODE_PCIE = 0,
825 OPAL_PHB_CAPI_MODE_CAPI = 1,
826 OPAL_PHB_CAPI_MODE_SNOOP_OFF = 2,
827 OPAL_PHB_CAPI_MODE_SNOOP_ON = 3,
828};
829
830/* OPAL I2C request */
831struct opal_i2c_request {
832 uint8_t type;
833#define OPAL_I2C_RAW_READ 0
834#define OPAL_I2C_RAW_WRITE 1
835#define OPAL_I2C_SM_READ 2
836#define OPAL_I2C_SM_WRITE 3
837 uint8_t flags;
838#define OPAL_I2C_ADDR_10 0x01 /* Not supported yet */
839 uint8_t subaddr_sz; /* Max 4 */
840 uint8_t reserved;
841 __be16 addr; /* 7 or 10 bit address */
842 __be16 reserved2;
843 __be32 subaddr; /* Sub-address if any */
844 __be32 size; /* Data size */
845 __be64 buffer_ra; /* Buffer real address */
846};
847
848/*
849 * EPOW status sharing (OPAL and the host)
850 *
851 * The host will pass on OPAL, a buffer of length OPAL_SYSEPOW_MAX
852 * with individual elements being 16 bits wide to fetch the system
853 * wide EPOW status. Each element in the buffer will contain the
854 * EPOW status in it's bit representation for a particular EPOW sub
855 * class as defiend here. So multiple detailed EPOW status bits
856 * specific for any sub class can be represented in a single buffer
857 * element as it's bit representation.
858 */
859
860/* System EPOW type */
861enum OpalSysEpow {
862 OPAL_SYSEPOW_POWER = 0, /* Power EPOW */
863 OPAL_SYSEPOW_TEMP = 1, /* Temperature EPOW */
864 OPAL_SYSEPOW_COOLING = 2, /* Cooling EPOW */
865 OPAL_SYSEPOW_MAX = 3, /* Max EPOW categories */
866};
867
868/* Power EPOW */
869enum OpalSysPower {
870 OPAL_SYSPOWER_UPS = 0x0001, /* System on UPS power */
871 OPAL_SYSPOWER_CHNG = 0x0002, /* System power config change */
872 OPAL_SYSPOWER_FAIL = 0x0004, /* System impending power failure */
873 OPAL_SYSPOWER_INCL = 0x0008, /* System incomplete power */
874};
875
876/* Temperature EPOW */
877enum OpalSysTemp {
878 OPAL_SYSTEMP_AMB = 0x0001, /* System over ambient temperature */
879 OPAL_SYSTEMP_INT = 0x0002, /* System over internal temperature */
880 OPAL_SYSTEMP_HMD = 0x0004, /* System over ambient humidity */
881};
882
883/* Cooling EPOW */
884enum OpalSysCooling {
885 OPAL_SYSCOOL_INSF = 0x0001, /* System insufficient cooling */
886};
887
888/* Argument to OPAL_CEC_REBOOT2() */
889enum {
890 OPAL_REBOOT_NORMAL = 0,
891 OPAL_REBOOT_PLATFORM_ERROR = 1,
892};
893
894#endif /* __ASSEMBLY__ */
895
896#endif /* __OPAL_API_H */
1/* SPDX-License-Identifier: GPL-2.0-or-later */
2/*
3 * OPAL API definitions.
4 *
5 * Copyright 2011-2015 IBM Corp.
6 */
7
8#ifndef __OPAL_API_H
9#define __OPAL_API_H
10
11/****** OPAL APIs ******/
12
13/* Return codes */
14#define OPAL_SUCCESS 0
15#define OPAL_PARAMETER -1
16#define OPAL_BUSY -2
17#define OPAL_PARTIAL -3
18#define OPAL_CONSTRAINED -4
19#define OPAL_CLOSED -5
20#define OPAL_HARDWARE -6
21#define OPAL_UNSUPPORTED -7
22#define OPAL_PERMISSION -8
23#define OPAL_NO_MEM -9
24#define OPAL_RESOURCE -10
25#define OPAL_INTERNAL_ERROR -11
26#define OPAL_BUSY_EVENT -12
27#define OPAL_HARDWARE_FROZEN -13
28#define OPAL_WRONG_STATE -14
29#define OPAL_ASYNC_COMPLETION -15
30#define OPAL_EMPTY -16
31#define OPAL_I2C_TIMEOUT -17
32#define OPAL_I2C_INVALID_CMD -18
33#define OPAL_I2C_LBUS_PARITY -19
34#define OPAL_I2C_BKEND_OVERRUN -20
35#define OPAL_I2C_BKEND_ACCESS -21
36#define OPAL_I2C_ARBT_LOST -22
37#define OPAL_I2C_NACK_RCVD -23
38#define OPAL_I2C_STOP_ERR -24
39#define OPAL_XIVE_PROVISIONING -31
40#define OPAL_XIVE_FREE_ACTIVE -32
41#define OPAL_TIMEOUT -33
42
43/* API Tokens (in r0) */
44#define OPAL_INVALID_CALL -1
45#define OPAL_TEST 0
46#define OPAL_CONSOLE_WRITE 1
47#define OPAL_CONSOLE_READ 2
48#define OPAL_RTC_READ 3
49#define OPAL_RTC_WRITE 4
50#define OPAL_CEC_POWER_DOWN 5
51#define OPAL_CEC_REBOOT 6
52#define OPAL_READ_NVRAM 7
53#define OPAL_WRITE_NVRAM 8
54#define OPAL_HANDLE_INTERRUPT 9
55#define OPAL_POLL_EVENTS 10
56#define OPAL_PCI_SET_HUB_TCE_MEMORY 11
57#define OPAL_PCI_SET_PHB_TCE_MEMORY 12
58#define OPAL_PCI_CONFIG_READ_BYTE 13
59#define OPAL_PCI_CONFIG_READ_HALF_WORD 14
60#define OPAL_PCI_CONFIG_READ_WORD 15
61#define OPAL_PCI_CONFIG_WRITE_BYTE 16
62#define OPAL_PCI_CONFIG_WRITE_HALF_WORD 17
63#define OPAL_PCI_CONFIG_WRITE_WORD 18
64#define OPAL_SET_XIVE 19
65#define OPAL_GET_XIVE 20
66#define OPAL_GET_COMPLETION_TOKEN_STATUS 21 /* obsolete */
67#define OPAL_REGISTER_OPAL_EXCEPTION_HANDLER 22
68#define OPAL_PCI_EEH_FREEZE_STATUS 23
69#define OPAL_PCI_SHPC 24
70#define OPAL_CONSOLE_WRITE_BUFFER_SPACE 25
71#define OPAL_PCI_EEH_FREEZE_CLEAR 26
72#define OPAL_PCI_PHB_MMIO_ENABLE 27
73#define OPAL_PCI_SET_PHB_MEM_WINDOW 28
74#define OPAL_PCI_MAP_PE_MMIO_WINDOW 29
75#define OPAL_PCI_SET_PHB_TABLE_MEMORY 30
76#define OPAL_PCI_SET_PE 31
77#define OPAL_PCI_SET_PELTV 32
78#define OPAL_PCI_SET_MVE 33
79#define OPAL_PCI_SET_MVE_ENABLE 34
80#define OPAL_PCI_GET_XIVE_REISSUE 35
81#define OPAL_PCI_SET_XIVE_REISSUE 36
82#define OPAL_PCI_SET_XIVE_PE 37
83#define OPAL_GET_XIVE_SOURCE 38
84#define OPAL_GET_MSI_32 39
85#define OPAL_GET_MSI_64 40
86#define OPAL_START_CPU 41
87#define OPAL_QUERY_CPU_STATUS 42
88#define OPAL_WRITE_OPPANEL 43 /* unimplemented */
89#define OPAL_PCI_MAP_PE_DMA_WINDOW 44
90#define OPAL_PCI_MAP_PE_DMA_WINDOW_REAL 45
91#define OPAL_PCI_RESET 49
92#define OPAL_PCI_GET_HUB_DIAG_DATA 50
93#define OPAL_PCI_GET_PHB_DIAG_DATA 51
94#define OPAL_PCI_FENCE_PHB 52
95#define OPAL_PCI_REINIT 53
96#define OPAL_PCI_MASK_PE_ERROR 54
97#define OPAL_SET_SLOT_LED_STATUS 55
98#define OPAL_GET_EPOW_STATUS 56
99#define OPAL_SET_SYSTEM_ATTENTION_LED 57
100#define OPAL_RESERVED1 58
101#define OPAL_RESERVED2 59
102#define OPAL_PCI_NEXT_ERROR 60
103#define OPAL_PCI_EEH_FREEZE_STATUS2 61
104#define OPAL_PCI_POLL 62
105#define OPAL_PCI_MSI_EOI 63
106#define OPAL_PCI_GET_PHB_DIAG_DATA2 64
107#define OPAL_XSCOM_READ 65
108#define OPAL_XSCOM_WRITE 66
109#define OPAL_LPC_READ 67
110#define OPAL_LPC_WRITE 68
111#define OPAL_RETURN_CPU 69
112#define OPAL_REINIT_CPUS 70
113#define OPAL_ELOG_READ 71
114#define OPAL_ELOG_WRITE 72
115#define OPAL_ELOG_ACK 73
116#define OPAL_ELOG_RESEND 74
117#define OPAL_ELOG_SIZE 75
118#define OPAL_FLASH_VALIDATE 76
119#define OPAL_FLASH_MANAGE 77
120#define OPAL_FLASH_UPDATE 78
121#define OPAL_RESYNC_TIMEBASE 79
122#define OPAL_CHECK_TOKEN 80
123#define OPAL_DUMP_INIT 81
124#define OPAL_DUMP_INFO 82
125#define OPAL_DUMP_READ 83
126#define OPAL_DUMP_ACK 84
127#define OPAL_GET_MSG 85
128#define OPAL_CHECK_ASYNC_COMPLETION 86
129#define OPAL_SYNC_HOST_REBOOT 87
130#define OPAL_SENSOR_READ 88
131#define OPAL_GET_PARAM 89
132#define OPAL_SET_PARAM 90
133#define OPAL_DUMP_RESEND 91
134#define OPAL_ELOG_SEND 92 /* Deprecated */
135#define OPAL_PCI_SET_PHB_CAPI_MODE 93
136#define OPAL_DUMP_INFO2 94
137#define OPAL_WRITE_OPPANEL_ASYNC 95
138#define OPAL_PCI_ERR_INJECT 96
139#define OPAL_PCI_EEH_FREEZE_SET 97
140#define OPAL_HANDLE_HMI 98
141#define OPAL_CONFIG_CPU_IDLE_STATE 99
142#define OPAL_SLW_SET_REG 100
143#define OPAL_REGISTER_DUMP_REGION 101
144#define OPAL_UNREGISTER_DUMP_REGION 102
145#define OPAL_WRITE_TPO 103
146#define OPAL_READ_TPO 104
147#define OPAL_GET_DPO_STATUS 105
148#define OPAL_OLD_I2C_REQUEST 106 /* Deprecated */
149#define OPAL_IPMI_SEND 107
150#define OPAL_IPMI_RECV 108
151#define OPAL_I2C_REQUEST 109
152#define OPAL_FLASH_READ 110
153#define OPAL_FLASH_WRITE 111
154#define OPAL_FLASH_ERASE 112
155#define OPAL_PRD_MSG 113
156#define OPAL_LEDS_GET_INDICATOR 114
157#define OPAL_LEDS_SET_INDICATOR 115
158#define OPAL_CEC_REBOOT2 116
159#define OPAL_CONSOLE_FLUSH 117
160#define OPAL_GET_DEVICE_TREE 118
161#define OPAL_PCI_GET_PRESENCE_STATE 119
162#define OPAL_PCI_GET_POWER_STATE 120
163#define OPAL_PCI_SET_POWER_STATE 121
164#define OPAL_INT_GET_XIRR 122
165#define OPAL_INT_SET_CPPR 123
166#define OPAL_INT_EOI 124
167#define OPAL_INT_SET_MFRR 125
168#define OPAL_PCI_TCE_KILL 126
169#define OPAL_NMMU_SET_PTCR 127
170#define OPAL_XIVE_RESET 128
171#define OPAL_XIVE_GET_IRQ_INFO 129
172#define OPAL_XIVE_GET_IRQ_CONFIG 130
173#define OPAL_XIVE_SET_IRQ_CONFIG 131
174#define OPAL_XIVE_GET_QUEUE_INFO 132
175#define OPAL_XIVE_SET_QUEUE_INFO 133
176#define OPAL_XIVE_DONATE_PAGE 134
177#define OPAL_XIVE_ALLOCATE_VP_BLOCK 135
178#define OPAL_XIVE_FREE_VP_BLOCK 136
179#define OPAL_XIVE_GET_VP_INFO 137
180#define OPAL_XIVE_SET_VP_INFO 138
181#define OPAL_XIVE_ALLOCATE_IRQ 139
182#define OPAL_XIVE_FREE_IRQ 140
183#define OPAL_XIVE_SYNC 141
184#define OPAL_XIVE_DUMP 142
185#define OPAL_XIVE_GET_QUEUE_STATE 143
186#define OPAL_XIVE_SET_QUEUE_STATE 144
187#define OPAL_SIGNAL_SYSTEM_RESET 145
188#define OPAL_NPU_INIT_CONTEXT 146
189#define OPAL_NPU_DESTROY_CONTEXT 147
190#define OPAL_NPU_MAP_LPAR 148
191#define OPAL_IMC_COUNTERS_INIT 149
192#define OPAL_IMC_COUNTERS_START 150
193#define OPAL_IMC_COUNTERS_STOP 151
194#define OPAL_GET_POWERCAP 152
195#define OPAL_SET_POWERCAP 153
196#define OPAL_GET_POWER_SHIFT_RATIO 154
197#define OPAL_SET_POWER_SHIFT_RATIO 155
198#define OPAL_SENSOR_GROUP_CLEAR 156
199#define OPAL_PCI_SET_P2P 157
200#define OPAL_QUIESCE 158
201#define OPAL_NPU_SPA_SETUP 159
202#define OPAL_NPU_SPA_CLEAR_CACHE 160
203#define OPAL_NPU_TL_SET 161
204#define OPAL_SENSOR_READ_U64 162
205#define OPAL_SENSOR_GROUP_ENABLE 163
206#define OPAL_PCI_GET_PBCQ_TUNNEL_BAR 164
207#define OPAL_PCI_SET_PBCQ_TUNNEL_BAR 165
208#define OPAL_HANDLE_HMI2 166
209#define OPAL_NX_COPROC_INIT 167
210#define OPAL_XIVE_GET_VP_STATE 170
211#define OPAL_MPIPL_UPDATE 173
212#define OPAL_MPIPL_REGISTER_TAG 174
213#define OPAL_MPIPL_QUERY_TAG 175
214#define OPAL_SECVAR_GET 176
215#define OPAL_SECVAR_GET_NEXT 177
216#define OPAL_SECVAR_ENQUEUE_UPDATE 178
217#define OPAL_LAST 178
218
219#define QUIESCE_HOLD 1 /* Spin all calls at entry */
220#define QUIESCE_REJECT 2 /* Fail all calls with OPAL_BUSY */
221#define QUIESCE_LOCK_BREAK 3 /* Set to ignore locks. */
222#define QUIESCE_RESUME 4 /* Un-quiesce */
223#define QUIESCE_RESUME_FAST_REBOOT 5 /* Un-quiesce, fast reboot */
224
225/* Device tree flags */
226
227/*
228 * Flags set in power-mgmt nodes in device tree describing
229 * idle states that are supported in the platform.
230 */
231
232#define OPAL_PM_TIMEBASE_STOP 0x00000002
233#define OPAL_PM_LOSE_HYP_CONTEXT 0x00002000
234#define OPAL_PM_LOSE_FULL_CONTEXT 0x00004000
235#define OPAL_PM_NAP_ENABLED 0x00010000
236#define OPAL_PM_SLEEP_ENABLED 0x00020000
237#define OPAL_PM_WINKLE_ENABLED 0x00040000
238#define OPAL_PM_SLEEP_ENABLED_ER1 0x00080000 /* with workaround */
239#define OPAL_PM_STOP_INST_FAST 0x00100000
240#define OPAL_PM_STOP_INST_DEEP 0x00200000
241
242/*
243 * OPAL_CONFIG_CPU_IDLE_STATE parameters
244 */
245#define OPAL_CONFIG_IDLE_FASTSLEEP 1
246#define OPAL_CONFIG_IDLE_UNDO 0
247#define OPAL_CONFIG_IDLE_APPLY 1
248
249#ifndef __ASSEMBLY__
250
251/* Other enums */
252enum OpalFreezeState {
253 OPAL_EEH_STOPPED_NOT_FROZEN = 0,
254 OPAL_EEH_STOPPED_MMIO_FREEZE = 1,
255 OPAL_EEH_STOPPED_DMA_FREEZE = 2,
256 OPAL_EEH_STOPPED_MMIO_DMA_FREEZE = 3,
257 OPAL_EEH_STOPPED_RESET = 4,
258 OPAL_EEH_STOPPED_TEMP_UNAVAIL = 5,
259 OPAL_EEH_STOPPED_PERM_UNAVAIL = 6
260};
261
262enum OpalEehFreezeActionToken {
263 OPAL_EEH_ACTION_CLEAR_FREEZE_MMIO = 1,
264 OPAL_EEH_ACTION_CLEAR_FREEZE_DMA = 2,
265 OPAL_EEH_ACTION_CLEAR_FREEZE_ALL = 3,
266
267 OPAL_EEH_ACTION_SET_FREEZE_MMIO = 1,
268 OPAL_EEH_ACTION_SET_FREEZE_DMA = 2,
269 OPAL_EEH_ACTION_SET_FREEZE_ALL = 3
270};
271
272enum OpalPciStatusToken {
273 OPAL_EEH_NO_ERROR = 0,
274 OPAL_EEH_IOC_ERROR = 1,
275 OPAL_EEH_PHB_ERROR = 2,
276 OPAL_EEH_PE_ERROR = 3,
277 OPAL_EEH_PE_MMIO_ERROR = 4,
278 OPAL_EEH_PE_DMA_ERROR = 5
279};
280
281enum OpalPciErrorSeverity {
282 OPAL_EEH_SEV_NO_ERROR = 0,
283 OPAL_EEH_SEV_IOC_DEAD = 1,
284 OPAL_EEH_SEV_PHB_DEAD = 2,
285 OPAL_EEH_SEV_PHB_FENCED = 3,
286 OPAL_EEH_SEV_PE_ER = 4,
287 OPAL_EEH_SEV_INF = 5
288};
289
290enum OpalErrinjectType {
291 OPAL_ERR_INJECT_TYPE_IOA_BUS_ERR = 0,
292 OPAL_ERR_INJECT_TYPE_IOA_BUS_ERR64 = 1,
293};
294
295enum OpalErrinjectFunc {
296 /* IOA bus specific errors */
297 OPAL_ERR_INJECT_FUNC_IOA_LD_MEM_ADDR = 0,
298 OPAL_ERR_INJECT_FUNC_IOA_LD_MEM_DATA = 1,
299 OPAL_ERR_INJECT_FUNC_IOA_LD_IO_ADDR = 2,
300 OPAL_ERR_INJECT_FUNC_IOA_LD_IO_DATA = 3,
301 OPAL_ERR_INJECT_FUNC_IOA_LD_CFG_ADDR = 4,
302 OPAL_ERR_INJECT_FUNC_IOA_LD_CFG_DATA = 5,
303 OPAL_ERR_INJECT_FUNC_IOA_ST_MEM_ADDR = 6,
304 OPAL_ERR_INJECT_FUNC_IOA_ST_MEM_DATA = 7,
305 OPAL_ERR_INJECT_FUNC_IOA_ST_IO_ADDR = 8,
306 OPAL_ERR_INJECT_FUNC_IOA_ST_IO_DATA = 9,
307 OPAL_ERR_INJECT_FUNC_IOA_ST_CFG_ADDR = 10,
308 OPAL_ERR_INJECT_FUNC_IOA_ST_CFG_DATA = 11,
309 OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_ADDR = 12,
310 OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_DATA = 13,
311 OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_MASTER = 14,
312 OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_TARGET = 15,
313 OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_ADDR = 16,
314 OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_DATA = 17,
315 OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_MASTER = 18,
316 OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_TARGET = 19,
317};
318
319enum OpalMmioWindowType {
320 OPAL_M32_WINDOW_TYPE = 1,
321 OPAL_M64_WINDOW_TYPE = 2,
322 OPAL_IO_WINDOW_TYPE = 3
323};
324
325enum OpalExceptionHandler {
326 OPAL_MACHINE_CHECK_HANDLER = 1,
327 OPAL_HYPERVISOR_MAINTENANCE_HANDLER = 2,
328 OPAL_SOFTPATCH_HANDLER = 3
329};
330
331enum OpalPendingState {
332 OPAL_EVENT_OPAL_INTERNAL = 0x1,
333 OPAL_EVENT_NVRAM = 0x2,
334 OPAL_EVENT_RTC = 0x4,
335 OPAL_EVENT_CONSOLE_OUTPUT = 0x8,
336 OPAL_EVENT_CONSOLE_INPUT = 0x10,
337 OPAL_EVENT_ERROR_LOG_AVAIL = 0x20,
338 OPAL_EVENT_ERROR_LOG = 0x40,
339 OPAL_EVENT_EPOW = 0x80,
340 OPAL_EVENT_LED_STATUS = 0x100,
341 OPAL_EVENT_PCI_ERROR = 0x200,
342 OPAL_EVENT_DUMP_AVAIL = 0x400,
343 OPAL_EVENT_MSG_PENDING = 0x800,
344};
345
346enum OpalThreadStatus {
347 OPAL_THREAD_INACTIVE = 0x0,
348 OPAL_THREAD_STARTED = 0x1,
349 OPAL_THREAD_UNAVAILABLE = 0x2 /* opal-v3 */
350};
351
352enum OpalPciBusCompare {
353 OpalPciBusAny = 0, /* Any bus number match */
354 OpalPciBus3Bits = 2, /* Match top 3 bits of bus number */
355 OpalPciBus4Bits = 3, /* Match top 4 bits of bus number */
356 OpalPciBus5Bits = 4, /* Match top 5 bits of bus number */
357 OpalPciBus6Bits = 5, /* Match top 6 bits of bus number */
358 OpalPciBus7Bits = 6, /* Match top 7 bits of bus number */
359 OpalPciBusAll = 7, /* Match bus number exactly */
360};
361
362enum OpalDeviceCompare {
363 OPAL_IGNORE_RID_DEVICE_NUMBER = 0,
364 OPAL_COMPARE_RID_DEVICE_NUMBER = 1
365};
366
367enum OpalFuncCompare {
368 OPAL_IGNORE_RID_FUNCTION_NUMBER = 0,
369 OPAL_COMPARE_RID_FUNCTION_NUMBER = 1
370};
371
372enum OpalPeAction {
373 OPAL_UNMAP_PE = 0,
374 OPAL_MAP_PE = 1
375};
376
377enum OpalPeltvAction {
378 OPAL_REMOVE_PE_FROM_DOMAIN = 0,
379 OPAL_ADD_PE_TO_DOMAIN = 1
380};
381
382enum OpalMveEnableAction {
383 OPAL_DISABLE_MVE = 0,
384 OPAL_ENABLE_MVE = 1
385};
386
387enum OpalM64Action {
388 OPAL_DISABLE_M64 = 0,
389 OPAL_ENABLE_M64_SPLIT = 1,
390 OPAL_ENABLE_M64_NON_SPLIT = 2
391};
392
393enum OpalPciResetScope {
394 OPAL_RESET_PHB_COMPLETE = 1,
395 OPAL_RESET_PCI_LINK = 2,
396 OPAL_RESET_PHB_ERROR = 3,
397 OPAL_RESET_PCI_HOT = 4,
398 OPAL_RESET_PCI_FUNDAMENTAL = 5,
399 OPAL_RESET_PCI_IODA_TABLE = 6
400};
401
402enum OpalPciReinitScope {
403 /*
404 * Note: we chose values that do not overlap
405 * OpalPciResetScope as OPAL v2 used the same
406 * enum for both
407 */
408 OPAL_REINIT_PCI_DEV = 1000
409};
410
411enum OpalPciResetState {
412 OPAL_DEASSERT_RESET = 0,
413 OPAL_ASSERT_RESET = 1
414};
415
416enum OpalPciSlotPresence {
417 OPAL_PCI_SLOT_EMPTY = 0,
418 OPAL_PCI_SLOT_PRESENT = 1
419};
420
421enum OpalPciSlotPower {
422 OPAL_PCI_SLOT_POWER_OFF = 0,
423 OPAL_PCI_SLOT_POWER_ON = 1,
424 OPAL_PCI_SLOT_OFFLINE = 2,
425 OPAL_PCI_SLOT_ONLINE = 3
426};
427
428enum OpalSlotLedType {
429 OPAL_SLOT_LED_TYPE_ID = 0, /* IDENTIFY LED */
430 OPAL_SLOT_LED_TYPE_FAULT = 1, /* FAULT LED */
431 OPAL_SLOT_LED_TYPE_ATTN = 2, /* System Attention LED */
432 OPAL_SLOT_LED_TYPE_MAX = 3
433};
434
435enum OpalSlotLedState {
436 OPAL_SLOT_LED_STATE_OFF = 0, /* LED is OFF */
437 OPAL_SLOT_LED_STATE_ON = 1 /* LED is ON */
438};
439
440/*
441 * Address cycle types for LPC accesses. These also correspond
442 * to the content of the first cell of the "reg" property for
443 * device nodes on the LPC bus
444 */
445enum OpalLPCAddressType {
446 OPAL_LPC_MEM = 0,
447 OPAL_LPC_IO = 1,
448 OPAL_LPC_FW = 2,
449};
450
451enum opal_msg_type {
452 OPAL_MSG_ASYNC_COMP = 0, /* params[0] = token, params[1] = rc,
453 * additional params function-specific
454 */
455 OPAL_MSG_MEM_ERR = 1,
456 OPAL_MSG_EPOW = 2,
457 OPAL_MSG_SHUTDOWN = 3, /* params[0] = 1 reboot, 0 shutdown */
458 OPAL_MSG_HMI_EVT = 4,
459 OPAL_MSG_DPO = 5,
460 OPAL_MSG_PRD = 6,
461 OPAL_MSG_OCC = 7,
462 OPAL_MSG_PRD2 = 8,
463 OPAL_MSG_TYPE_MAX,
464};
465
466struct opal_msg {
467 __be32 msg_type;
468 __be32 reserved;
469 __be64 params[8];
470};
471
472/* System parameter permission */
473enum OpalSysparamPerm {
474 OPAL_SYSPARAM_READ = 0x1,
475 OPAL_SYSPARAM_WRITE = 0x2,
476 OPAL_SYSPARAM_RW = (OPAL_SYSPARAM_READ | OPAL_SYSPARAM_WRITE),
477};
478
479enum {
480 OPAL_IPMI_MSG_FORMAT_VERSION_1 = 1,
481};
482
483struct opal_ipmi_msg {
484 uint8_t version;
485 uint8_t netfn;
486 uint8_t cmd;
487 uint8_t data[];
488};
489
490/* FSP memory errors handling */
491enum OpalMemErr_Version {
492 OpalMemErr_V1 = 1,
493};
494
495enum OpalMemErrType {
496 OPAL_MEM_ERR_TYPE_RESILIENCE = 0,
497 OPAL_MEM_ERR_TYPE_DYN_DALLOC,
498};
499
500/* Memory Reilience error type */
501enum OpalMemErr_ResilErrType {
502 OPAL_MEM_RESILIENCE_CE = 0,
503 OPAL_MEM_RESILIENCE_UE,
504 OPAL_MEM_RESILIENCE_UE_SCRUB,
505};
506
507/* Dynamic Memory Deallocation type */
508enum OpalMemErr_DynErrType {
509 OPAL_MEM_DYNAMIC_DEALLOC = 0,
510};
511
512struct OpalMemoryErrorData {
513 enum OpalMemErr_Version version:8; /* 0x00 */
514 enum OpalMemErrType type:8; /* 0x01 */
515 __be16 flags; /* 0x02 */
516 uint8_t reserved_1[4]; /* 0x04 */
517
518 union {
519 /* Memory Resilience corrected/uncorrected error info */
520 struct {
521 enum OpalMemErr_ResilErrType resil_err_type:8;
522 uint8_t reserved_1[7];
523 __be64 physical_address_start;
524 __be64 physical_address_end;
525 } resilience;
526 /* Dynamic memory deallocation error info */
527 struct {
528 enum OpalMemErr_DynErrType dyn_err_type:8;
529 uint8_t reserved_1[7];
530 __be64 physical_address_start;
531 __be64 physical_address_end;
532 } dyn_dealloc;
533 } u;
534};
535
536/* HMI interrupt event */
537enum OpalHMI_Version {
538 OpalHMIEvt_V1 = 1,
539 OpalHMIEvt_V2 = 2,
540};
541
542enum OpalHMI_Severity {
543 OpalHMI_SEV_NO_ERROR = 0,
544 OpalHMI_SEV_WARNING = 1,
545 OpalHMI_SEV_ERROR_SYNC = 2,
546 OpalHMI_SEV_FATAL = 3,
547};
548
549enum OpalHMI_Disposition {
550 OpalHMI_DISPOSITION_RECOVERED = 0,
551 OpalHMI_DISPOSITION_NOT_RECOVERED = 1,
552};
553
554enum OpalHMI_ErrType {
555 OpalHMI_ERROR_MALFUNC_ALERT = 0,
556 OpalHMI_ERROR_PROC_RECOV_DONE,
557 OpalHMI_ERROR_PROC_RECOV_DONE_AGAIN,
558 OpalHMI_ERROR_PROC_RECOV_MASKED,
559 OpalHMI_ERROR_TFAC,
560 OpalHMI_ERROR_TFMR_PARITY,
561 OpalHMI_ERROR_HA_OVERFLOW_WARN,
562 OpalHMI_ERROR_XSCOM_FAIL,
563 OpalHMI_ERROR_XSCOM_DONE,
564 OpalHMI_ERROR_SCOM_FIR,
565 OpalHMI_ERROR_DEBUG_TRIG_FIR,
566 OpalHMI_ERROR_HYP_RESOURCE,
567 OpalHMI_ERROR_CAPP_RECOVERY,
568};
569
570enum OpalHMI_XstopType {
571 CHECKSTOP_TYPE_UNKNOWN = 0,
572 CHECKSTOP_TYPE_CORE = 1,
573 CHECKSTOP_TYPE_NX = 2,
574 CHECKSTOP_TYPE_NPU = 3
575};
576
577enum OpalHMI_CoreXstopReason {
578 CORE_CHECKSTOP_IFU_REGFILE = 0x00000001,
579 CORE_CHECKSTOP_IFU_LOGIC = 0x00000002,
580 CORE_CHECKSTOP_PC_DURING_RECOV = 0x00000004,
581 CORE_CHECKSTOP_ISU_REGFILE = 0x00000008,
582 CORE_CHECKSTOP_ISU_LOGIC = 0x00000010,
583 CORE_CHECKSTOP_FXU_LOGIC = 0x00000020,
584 CORE_CHECKSTOP_VSU_LOGIC = 0x00000040,
585 CORE_CHECKSTOP_PC_RECOV_IN_MAINT_MODE = 0x00000080,
586 CORE_CHECKSTOP_LSU_REGFILE = 0x00000100,
587 CORE_CHECKSTOP_PC_FWD_PROGRESS = 0x00000200,
588 CORE_CHECKSTOP_LSU_LOGIC = 0x00000400,
589 CORE_CHECKSTOP_PC_LOGIC = 0x00000800,
590 CORE_CHECKSTOP_PC_HYP_RESOURCE = 0x00001000,
591 CORE_CHECKSTOP_PC_HANG_RECOV_FAILED = 0x00002000,
592 CORE_CHECKSTOP_PC_AMBI_HANG_DETECTED = 0x00004000,
593 CORE_CHECKSTOP_PC_DEBUG_TRIG_ERR_INJ = 0x00008000,
594 CORE_CHECKSTOP_PC_SPRD_HYP_ERR_INJ = 0x00010000,
595};
596
597enum OpalHMI_NestAccelXstopReason {
598 NX_CHECKSTOP_SHM_INVAL_STATE_ERR = 0x00000001,
599 NX_CHECKSTOP_DMA_INVAL_STATE_ERR_1 = 0x00000002,
600 NX_CHECKSTOP_DMA_INVAL_STATE_ERR_2 = 0x00000004,
601 NX_CHECKSTOP_DMA_CH0_INVAL_STATE_ERR = 0x00000008,
602 NX_CHECKSTOP_DMA_CH1_INVAL_STATE_ERR = 0x00000010,
603 NX_CHECKSTOP_DMA_CH2_INVAL_STATE_ERR = 0x00000020,
604 NX_CHECKSTOP_DMA_CH3_INVAL_STATE_ERR = 0x00000040,
605 NX_CHECKSTOP_DMA_CH4_INVAL_STATE_ERR = 0x00000080,
606 NX_CHECKSTOP_DMA_CH5_INVAL_STATE_ERR = 0x00000100,
607 NX_CHECKSTOP_DMA_CH6_INVAL_STATE_ERR = 0x00000200,
608 NX_CHECKSTOP_DMA_CH7_INVAL_STATE_ERR = 0x00000400,
609 NX_CHECKSTOP_DMA_CRB_UE = 0x00000800,
610 NX_CHECKSTOP_DMA_CRB_SUE = 0x00001000,
611 NX_CHECKSTOP_PBI_ISN_UE = 0x00002000,
612};
613
614struct OpalHMIEvent {
615 uint8_t version; /* 0x00 */
616 uint8_t severity; /* 0x01 */
617 uint8_t type; /* 0x02 */
618 uint8_t disposition; /* 0x03 */
619 uint8_t reserved_1[4]; /* 0x04 */
620
621 __be64 hmer;
622 /* TFMR register. Valid only for TFAC and TFMR_PARITY error type. */
623 __be64 tfmr;
624
625 /* version 2 and later */
626 union {
627 /*
628 * checkstop info (Core/NX).
629 * Valid for OpalHMI_ERROR_MALFUNC_ALERT.
630 */
631 struct {
632 uint8_t xstop_type; /* enum OpalHMI_XstopType */
633 uint8_t reserved_1[3];
634 __be32 xstop_reason;
635 union {
636 __be32 pir; /* for CHECKSTOP_TYPE_CORE */
637 __be32 chip_id; /* for CHECKSTOP_TYPE_NX */
638 } u;
639 } xstop_error;
640 } u;
641};
642
643/* OPAL_HANDLE_HMI2 out_flags */
644enum {
645 OPAL_HMI_FLAGS_TB_RESYNC = (1ull << 0), /* Timebase has been resynced */
646 OPAL_HMI_FLAGS_DEC_LOST = (1ull << 1), /* DEC lost, needs to be reprogrammed */
647 OPAL_HMI_FLAGS_HDEC_LOST = (1ull << 2), /* HDEC lost, needs to be reprogrammed */
648 OPAL_HMI_FLAGS_TOD_TB_FAIL = (1ull << 3), /* TOD/TB recovery failed. */
649 OPAL_HMI_FLAGS_NEW_EVENT = (1ull << 63), /* An event has been created */
650};
651
652enum {
653 OPAL_P7IOC_DIAG_TYPE_NONE = 0,
654 OPAL_P7IOC_DIAG_TYPE_RGC = 1,
655 OPAL_P7IOC_DIAG_TYPE_BI = 2,
656 OPAL_P7IOC_DIAG_TYPE_CI = 3,
657 OPAL_P7IOC_DIAG_TYPE_MISC = 4,
658 OPAL_P7IOC_DIAG_TYPE_I2C = 5,
659 OPAL_P7IOC_DIAG_TYPE_LAST = 6
660};
661
662struct OpalIoP7IOCErrorData {
663 __be16 type;
664
665 /* GEM */
666 __be64 gemXfir;
667 __be64 gemRfir;
668 __be64 gemRirqfir;
669 __be64 gemMask;
670 __be64 gemRwof;
671
672 /* LEM */
673 __be64 lemFir;
674 __be64 lemErrMask;
675 __be64 lemAction0;
676 __be64 lemAction1;
677 __be64 lemWof;
678
679 union {
680 struct OpalIoP7IOCRgcErrorData {
681 __be64 rgcStatus; /* 3E1C10 */
682 __be64 rgcLdcp; /* 3E1C18 */
683 }rgc;
684 struct OpalIoP7IOCBiErrorData {
685 __be64 biLdcp0; /* 3C0100, 3C0118 */
686 __be64 biLdcp1; /* 3C0108, 3C0120 */
687 __be64 biLdcp2; /* 3C0110, 3C0128 */
688 __be64 biFenceStatus; /* 3C0130, 3C0130 */
689
690 uint8_t biDownbound; /* BI Downbound or Upbound */
691 }bi;
692 struct OpalIoP7IOCCiErrorData {
693 __be64 ciPortStatus; /* 3Dn008 */
694 __be64 ciPortLdcp; /* 3Dn010 */
695
696 uint8_t ciPort; /* Index of CI port: 0/1 */
697 }ci;
698 };
699};
700
701/**
702 * This structure defines the overlay which will be used to store PHB error
703 * data upon request.
704 */
705enum {
706 OPAL_PHB_ERROR_DATA_VERSION_1 = 1,
707};
708
709enum {
710 OPAL_PHB_ERROR_DATA_TYPE_P7IOC = 1,
711 OPAL_PHB_ERROR_DATA_TYPE_PHB3 = 2,
712 OPAL_PHB_ERROR_DATA_TYPE_PHB4 = 3
713};
714
715enum {
716 OPAL_P7IOC_NUM_PEST_REGS = 128,
717 OPAL_PHB3_NUM_PEST_REGS = 256,
718 OPAL_PHB4_NUM_PEST_REGS = 512
719};
720
721struct OpalIoPhbErrorCommon {
722 __be32 version;
723 __be32 ioType;
724 __be32 len;
725};
726
727struct OpalIoP7IOCPhbErrorData {
728 struct OpalIoPhbErrorCommon common;
729
730 __be32 brdgCtl;
731
732 // P7IOC utl regs
733 __be32 portStatusReg;
734 __be32 rootCmplxStatus;
735 __be32 busAgentStatus;
736
737 // P7IOC cfg regs
738 __be32 deviceStatus;
739 __be32 slotStatus;
740 __be32 linkStatus;
741 __be32 devCmdStatus;
742 __be32 devSecStatus;
743
744 // cfg AER regs
745 __be32 rootErrorStatus;
746 __be32 uncorrErrorStatus;
747 __be32 corrErrorStatus;
748 __be32 tlpHdr1;
749 __be32 tlpHdr2;
750 __be32 tlpHdr3;
751 __be32 tlpHdr4;
752 __be32 sourceId;
753
754 __be32 rsv3;
755
756 // Record data about the call to allocate a buffer.
757 __be64 errorClass;
758 __be64 correlator;
759
760 //P7IOC MMIO Error Regs
761 __be64 p7iocPlssr; // n120
762 __be64 p7iocCsr; // n110
763 __be64 lemFir; // nC00
764 __be64 lemErrorMask; // nC18
765 __be64 lemWOF; // nC40
766 __be64 phbErrorStatus; // nC80
767 __be64 phbFirstErrorStatus; // nC88
768 __be64 phbErrorLog0; // nCC0
769 __be64 phbErrorLog1; // nCC8
770 __be64 mmioErrorStatus; // nD00
771 __be64 mmioFirstErrorStatus; // nD08
772 __be64 mmioErrorLog0; // nD40
773 __be64 mmioErrorLog1; // nD48
774 __be64 dma0ErrorStatus; // nD80
775 __be64 dma0FirstErrorStatus; // nD88
776 __be64 dma0ErrorLog0; // nDC0
777 __be64 dma0ErrorLog1; // nDC8
778 __be64 dma1ErrorStatus; // nE00
779 __be64 dma1FirstErrorStatus; // nE08
780 __be64 dma1ErrorLog0; // nE40
781 __be64 dma1ErrorLog1; // nE48
782 __be64 pestA[OPAL_P7IOC_NUM_PEST_REGS];
783 __be64 pestB[OPAL_P7IOC_NUM_PEST_REGS];
784};
785
786struct OpalIoPhb3ErrorData {
787 struct OpalIoPhbErrorCommon common;
788
789 __be32 brdgCtl;
790
791 /* PHB3 UTL regs */
792 __be32 portStatusReg;
793 __be32 rootCmplxStatus;
794 __be32 busAgentStatus;
795
796 /* PHB3 cfg regs */
797 __be32 deviceStatus;
798 __be32 slotStatus;
799 __be32 linkStatus;
800 __be32 devCmdStatus;
801 __be32 devSecStatus;
802
803 /* cfg AER regs */
804 __be32 rootErrorStatus;
805 __be32 uncorrErrorStatus;
806 __be32 corrErrorStatus;
807 __be32 tlpHdr1;
808 __be32 tlpHdr2;
809 __be32 tlpHdr3;
810 __be32 tlpHdr4;
811 __be32 sourceId;
812
813 __be32 rsv3;
814
815 /* Record data about the call to allocate a buffer */
816 __be64 errorClass;
817 __be64 correlator;
818
819 /* PHB3 MMIO Error Regs */
820 __be64 nFir; /* 000 */
821 __be64 nFirMask; /* 003 */
822 __be64 nFirWOF; /* 008 */
823 __be64 phbPlssr; /* 120 */
824 __be64 phbCsr; /* 110 */
825 __be64 lemFir; /* C00 */
826 __be64 lemErrorMask; /* C18 */
827 __be64 lemWOF; /* C40 */
828 __be64 phbErrorStatus; /* C80 */
829 __be64 phbFirstErrorStatus; /* C88 */
830 __be64 phbErrorLog0; /* CC0 */
831 __be64 phbErrorLog1; /* CC8 */
832 __be64 mmioErrorStatus; /* D00 */
833 __be64 mmioFirstErrorStatus; /* D08 */
834 __be64 mmioErrorLog0; /* D40 */
835 __be64 mmioErrorLog1; /* D48 */
836 __be64 dma0ErrorStatus; /* D80 */
837 __be64 dma0FirstErrorStatus; /* D88 */
838 __be64 dma0ErrorLog0; /* DC0 */
839 __be64 dma0ErrorLog1; /* DC8 */
840 __be64 dma1ErrorStatus; /* E00 */
841 __be64 dma1FirstErrorStatus; /* E08 */
842 __be64 dma1ErrorLog0; /* E40 */
843 __be64 dma1ErrorLog1; /* E48 */
844 __be64 pestA[OPAL_PHB3_NUM_PEST_REGS];
845 __be64 pestB[OPAL_PHB3_NUM_PEST_REGS];
846};
847
848struct OpalIoPhb4ErrorData {
849 struct OpalIoPhbErrorCommon common;
850
851 __be32 brdgCtl;
852
853 /* PHB4 cfg regs */
854 __be32 deviceStatus;
855 __be32 slotStatus;
856 __be32 linkStatus;
857 __be32 devCmdStatus;
858 __be32 devSecStatus;
859
860 /* cfg AER regs */
861 __be32 rootErrorStatus;
862 __be32 uncorrErrorStatus;
863 __be32 corrErrorStatus;
864 __be32 tlpHdr1;
865 __be32 tlpHdr2;
866 __be32 tlpHdr3;
867 __be32 tlpHdr4;
868 __be32 sourceId;
869
870 /* PHB4 ETU Error Regs */
871 __be64 nFir; /* 000 */
872 __be64 nFirMask; /* 003 */
873 __be64 nFirWOF; /* 008 */
874 __be64 phbPlssr; /* 120 */
875 __be64 phbCsr; /* 110 */
876 __be64 lemFir; /* C00 */
877 __be64 lemErrorMask; /* C18 */
878 __be64 lemWOF; /* C40 */
879 __be64 phbErrorStatus; /* C80 */
880 __be64 phbFirstErrorStatus; /* C88 */
881 __be64 phbErrorLog0; /* CC0 */
882 __be64 phbErrorLog1; /* CC8 */
883 __be64 phbTxeErrorStatus; /* D00 */
884 __be64 phbTxeFirstErrorStatus; /* D08 */
885 __be64 phbTxeErrorLog0; /* D40 */
886 __be64 phbTxeErrorLog1; /* D48 */
887 __be64 phbRxeArbErrorStatus; /* D80 */
888 __be64 phbRxeArbFirstErrorStatus; /* D88 */
889 __be64 phbRxeArbErrorLog0; /* DC0 */
890 __be64 phbRxeArbErrorLog1; /* DC8 */
891 __be64 phbRxeMrgErrorStatus; /* E00 */
892 __be64 phbRxeMrgFirstErrorStatus; /* E08 */
893 __be64 phbRxeMrgErrorLog0; /* E40 */
894 __be64 phbRxeMrgErrorLog1; /* E48 */
895 __be64 phbRxeTceErrorStatus; /* E80 */
896 __be64 phbRxeTceFirstErrorStatus; /* E88 */
897 __be64 phbRxeTceErrorLog0; /* EC0 */
898 __be64 phbRxeTceErrorLog1; /* EC8 */
899
900 /* PHB4 REGB Error Regs */
901 __be64 phbPblErrorStatus; /* 1900 */
902 __be64 phbPblFirstErrorStatus; /* 1908 */
903 __be64 phbPblErrorLog0; /* 1940 */
904 __be64 phbPblErrorLog1; /* 1948 */
905 __be64 phbPcieDlpErrorLog1; /* 1AA0 */
906 __be64 phbPcieDlpErrorLog2; /* 1AA8 */
907 __be64 phbPcieDlpErrorStatus; /* 1AB0 */
908 __be64 phbRegbErrorStatus; /* 1C00 */
909 __be64 phbRegbFirstErrorStatus; /* 1C08 */
910 __be64 phbRegbErrorLog0; /* 1C40 */
911 __be64 phbRegbErrorLog1; /* 1C48 */
912
913 __be64 pestA[OPAL_PHB4_NUM_PEST_REGS];
914 __be64 pestB[OPAL_PHB4_NUM_PEST_REGS];
915};
916
917enum {
918 OPAL_REINIT_CPUS_HILE_BE = (1 << 0),
919 OPAL_REINIT_CPUS_HILE_LE = (1 << 1),
920
921 /* These two define the base MMU mode of the host on P9
922 *
923 * On P9 Nimbus DD2.0 and Cumlus (and later), KVM can still
924 * create hash guests in "radix" mode with care (full core
925 * switch only).
926 */
927 OPAL_REINIT_CPUS_MMU_HASH = (1 << 2),
928 OPAL_REINIT_CPUS_MMU_RADIX = (1 << 3),
929
930 OPAL_REINIT_CPUS_TM_SUSPEND_DISABLED = (1 << 4),
931};
932
933typedef struct oppanel_line {
934 __be64 line;
935 __be64 line_len;
936} oppanel_line_t;
937
938enum opal_prd_msg_type {
939 OPAL_PRD_MSG_TYPE_INIT = 0, /* HBRT --> OPAL */
940 OPAL_PRD_MSG_TYPE_FINI, /* HBRT/kernel --> OPAL */
941 OPAL_PRD_MSG_TYPE_ATTN, /* HBRT <-- OPAL */
942 OPAL_PRD_MSG_TYPE_ATTN_ACK, /* HBRT --> OPAL */
943 OPAL_PRD_MSG_TYPE_OCC_ERROR, /* HBRT <-- OPAL */
944 OPAL_PRD_MSG_TYPE_OCC_RESET, /* HBRT <-- OPAL */
945};
946
947struct opal_prd_msg_header {
948 uint8_t type;
949 uint8_t pad[1];
950 __be16 size;
951};
952
953struct opal_prd_msg;
954
955#define OCC_RESET 0
956#define OCC_LOAD 1
957#define OCC_THROTTLE 2
958#define OCC_MAX_THROTTLE_STATUS 5
959
960struct opal_occ_msg {
961 __be64 type;
962 __be64 chip;
963 __be64 throttle_status;
964};
965
966/*
967 * SG entries
968 *
969 * WARNING: The current implementation requires each entry
970 * to represent a block that is 4k aligned *and* each block
971 * size except the last one in the list to be as well.
972 */
973struct opal_sg_entry {
974 __be64 data;
975 __be64 length;
976};
977
978/*
979 * Candidate image SG list.
980 *
981 * length = VER | length
982 */
983struct opal_sg_list {
984 __be64 length;
985 __be64 next;
986 struct opal_sg_entry entry[];
987};
988
989/*
990 * Dump region ID range usable by the OS
991 */
992#define OPAL_DUMP_REGION_HOST_START 0x80
993#define OPAL_DUMP_REGION_LOG_BUF 0x80
994#define OPAL_DUMP_REGION_HOST_END 0xFF
995
996/* CAPI modes for PHB */
997enum {
998 OPAL_PHB_CAPI_MODE_PCIE = 0,
999 OPAL_PHB_CAPI_MODE_CAPI = 1,
1000 OPAL_PHB_CAPI_MODE_SNOOP_OFF = 2,
1001 OPAL_PHB_CAPI_MODE_SNOOP_ON = 3,
1002 OPAL_PHB_CAPI_MODE_DMA = 4,
1003 OPAL_PHB_CAPI_MODE_DMA_TVT1 = 5,
1004};
1005
1006/* OPAL I2C request */
1007struct opal_i2c_request {
1008 uint8_t type;
1009#define OPAL_I2C_RAW_READ 0
1010#define OPAL_I2C_RAW_WRITE 1
1011#define OPAL_I2C_SM_READ 2
1012#define OPAL_I2C_SM_WRITE 3
1013 uint8_t flags;
1014#define OPAL_I2C_ADDR_10 0x01 /* Not supported yet */
1015 uint8_t subaddr_sz; /* Max 4 */
1016 uint8_t reserved;
1017 __be16 addr; /* 7 or 10 bit address */
1018 __be16 reserved2;
1019 __be32 subaddr; /* Sub-address if any */
1020 __be32 size; /* Data size */
1021 __be64 buffer_ra; /* Buffer real address */
1022};
1023
1024/*
1025 * EPOW status sharing (OPAL and the host)
1026 *
1027 * The host will pass on OPAL, a buffer of length OPAL_SYSEPOW_MAX
1028 * with individual elements being 16 bits wide to fetch the system
1029 * wide EPOW status. Each element in the buffer will contain the
1030 * EPOW status in it's bit representation for a particular EPOW sub
1031 * class as defined here. So multiple detailed EPOW status bits
1032 * specific for any sub class can be represented in a single buffer
1033 * element as it's bit representation.
1034 */
1035
1036/* System EPOW type */
1037enum OpalSysEpow {
1038 OPAL_SYSEPOW_POWER = 0, /* Power EPOW */
1039 OPAL_SYSEPOW_TEMP = 1, /* Temperature EPOW */
1040 OPAL_SYSEPOW_COOLING = 2, /* Cooling EPOW */
1041 OPAL_SYSEPOW_MAX = 3, /* Max EPOW categories */
1042};
1043
1044/* Power EPOW */
1045enum OpalSysPower {
1046 OPAL_SYSPOWER_UPS = 0x0001, /* System on UPS power */
1047 OPAL_SYSPOWER_CHNG = 0x0002, /* System power config change */
1048 OPAL_SYSPOWER_FAIL = 0x0004, /* System impending power failure */
1049 OPAL_SYSPOWER_INCL = 0x0008, /* System incomplete power */
1050};
1051
1052/* Temperature EPOW */
1053enum OpalSysTemp {
1054 OPAL_SYSTEMP_AMB = 0x0001, /* System over ambient temperature */
1055 OPAL_SYSTEMP_INT = 0x0002, /* System over internal temperature */
1056 OPAL_SYSTEMP_HMD = 0x0004, /* System over ambient humidity */
1057};
1058
1059/* Cooling EPOW */
1060enum OpalSysCooling {
1061 OPAL_SYSCOOL_INSF = 0x0001, /* System insufficient cooling */
1062};
1063
1064/* Argument to OPAL_CEC_REBOOT2() */
1065enum {
1066 OPAL_REBOOT_NORMAL = 0,
1067 OPAL_REBOOT_PLATFORM_ERROR = 1,
1068 OPAL_REBOOT_FULL_IPL = 2,
1069 OPAL_REBOOT_MPIPL = 3,
1070 OPAL_REBOOT_FAST = 4,
1071};
1072
1073/* Argument to OPAL_PCI_TCE_KILL */
1074enum {
1075 OPAL_PCI_TCE_KILL_PAGES,
1076 OPAL_PCI_TCE_KILL_PE,
1077 OPAL_PCI_TCE_KILL_ALL,
1078};
1079
1080/* The xive operation mode indicates the active "API" and
1081 * corresponds to the "mode" parameter of the opal_xive_reset()
1082 * call
1083 */
1084enum {
1085 OPAL_XIVE_MODE_EMU = 0,
1086 OPAL_XIVE_MODE_EXPL = 1,
1087};
1088
1089/* Flags for OPAL_XIVE_GET_IRQ_INFO */
1090enum {
1091 OPAL_XIVE_IRQ_TRIGGER_PAGE = 0x00000001,
1092 OPAL_XIVE_IRQ_STORE_EOI = 0x00000002,
1093 OPAL_XIVE_IRQ_LSI = 0x00000004,
1094 OPAL_XIVE_IRQ_SHIFT_BUG = 0x00000008, /* P9 DD1.0 workaround */
1095 OPAL_XIVE_IRQ_MASK_VIA_FW = 0x00000010, /* P9 DD1.0 workaround */
1096 OPAL_XIVE_IRQ_EOI_VIA_FW = 0x00000020, /* P9 DD1.0 workaround */
1097 OPAL_XIVE_IRQ_STORE_EOI2 = 0x00000040,
1098};
1099
1100/* Flags for OPAL_XIVE_GET/SET_QUEUE_INFO */
1101enum {
1102 OPAL_XIVE_EQ_ENABLED = 0x00000001,
1103 OPAL_XIVE_EQ_ALWAYS_NOTIFY = 0x00000002,
1104 OPAL_XIVE_EQ_ESCALATE = 0x00000004,
1105};
1106
1107/* Flags for OPAL_XIVE_GET/SET_VP_INFO */
1108enum {
1109 OPAL_XIVE_VP_ENABLED = 0x00000001,
1110 OPAL_XIVE_VP_SINGLE_ESCALATION = 0x00000002,
1111};
1112
1113/* "Any chip" replacement for chip ID for allocation functions */
1114enum {
1115 OPAL_XIVE_ANY_CHIP = 0xffffffff,
1116};
1117
1118/* Xive sync options */
1119enum {
1120 /* This bits are cumulative, arg is a girq */
1121 XIVE_SYNC_EAS = 0x00000001, /* Sync irq source */
1122 XIVE_SYNC_QUEUE = 0x00000002, /* Sync irq target */
1123};
1124
1125/* Dump options */
1126enum {
1127 XIVE_DUMP_TM_HYP = 0,
1128 XIVE_DUMP_TM_POOL = 1,
1129 XIVE_DUMP_TM_OS = 2,
1130 XIVE_DUMP_TM_USER = 3,
1131 XIVE_DUMP_VP = 4,
1132 XIVE_DUMP_EMU_STATE = 5,
1133};
1134
1135/* "type" argument options for OPAL_IMC_COUNTERS_* calls */
1136enum {
1137 OPAL_IMC_COUNTERS_NEST = 1,
1138 OPAL_IMC_COUNTERS_CORE = 2,
1139 OPAL_IMC_COUNTERS_TRACE = 3,
1140};
1141
1142
1143/* PCI p2p descriptor */
1144#define OPAL_PCI_P2P_ENABLE 0x1
1145#define OPAL_PCI_P2P_LOAD 0x2
1146#define OPAL_PCI_P2P_STORE 0x4
1147
1148/* MPIPL update operations */
1149enum opal_mpipl_ops {
1150 OPAL_MPIPL_ADD_RANGE = 0,
1151 OPAL_MPIPL_REMOVE_RANGE = 1,
1152 OPAL_MPIPL_REMOVE_ALL = 2,
1153 OPAL_MPIPL_FREE_PRESERVED_MEMORY = 3,
1154};
1155
1156/* Tag will point to various metadata area. Kernel will
1157 * use tag to get metadata value.
1158 */
1159enum opal_mpipl_tags {
1160 OPAL_MPIPL_TAG_CPU = 0,
1161 OPAL_MPIPL_TAG_OPAL = 1,
1162 OPAL_MPIPL_TAG_KERNEL = 2,
1163 OPAL_MPIPL_TAG_BOOT_MEM = 3,
1164};
1165
1166/* Preserved memory details */
1167struct opal_mpipl_region {
1168 __be64 src;
1169 __be64 dest;
1170 __be64 size;
1171};
1172
1173/* Structure version */
1174#define OPAL_MPIPL_VERSION 0x01
1175
1176struct opal_mpipl_fadump {
1177 u8 version;
1178 u8 reserved[7];
1179 __be32 crashing_pir; /* OPAL crashing CPU PIR */
1180 __be32 cpu_data_version;
1181 __be32 cpu_data_size;
1182 __be32 region_cnt;
1183 struct opal_mpipl_region region[];
1184} __packed;
1185
1186#endif /* __ASSEMBLY__ */
1187
1188#endif /* __OPAL_API_H */