opal-api.h 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801
  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. #ifndef __OPAL_API_H
  12. #define __OPAL_API_H
  13. /****** OPAL APIs ******/
  14. /* Return codes */
  15. #define OPAL_SUCCESS 0
  16. #define OPAL_PARAMETER -1
  17. #define OPAL_BUSY -2
  18. #define OPAL_PARTIAL -3
  19. #define OPAL_CONSTRAINED -4
  20. #define OPAL_CLOSED -5
  21. #define OPAL_HARDWARE -6
  22. #define OPAL_UNSUPPORTED -7
  23. #define OPAL_PERMISSION -8
  24. #define OPAL_NO_MEM -9
  25. #define OPAL_RESOURCE -10
  26. #define OPAL_INTERNAL_ERROR -11
  27. #define OPAL_BUSY_EVENT -12
  28. #define OPAL_HARDWARE_FROZEN -13
  29. #define OPAL_WRONG_STATE -14
  30. #define OPAL_ASYNC_COMPLETION -15
  31. #define OPAL_EMPTY -16
  32. #define OPAL_I2C_TIMEOUT -17
  33. #define OPAL_I2C_INVALID_CMD -18
  34. #define OPAL_I2C_LBUS_PARITY -19
  35. #define OPAL_I2C_BKEND_OVERRUN -20
  36. #define OPAL_I2C_BKEND_ACCESS -21
  37. #define OPAL_I2C_ARBT_LOST -22
  38. #define OPAL_I2C_NACK_RCVD -23
  39. #define OPAL_I2C_STOP_ERR -24
  40. /* API Tokens (in r0) */
  41. #define OPAL_INVALID_CALL -1
  42. #define OPAL_TEST 0
  43. #define OPAL_CONSOLE_WRITE 1
  44. #define OPAL_CONSOLE_READ 2
  45. #define OPAL_RTC_READ 3
  46. #define OPAL_RTC_WRITE 4
  47. #define OPAL_CEC_POWER_DOWN 5
  48. #define OPAL_CEC_REBOOT 6
  49. #define OPAL_READ_NVRAM 7
  50. #define OPAL_WRITE_NVRAM 8
  51. #define OPAL_HANDLE_INTERRUPT 9
  52. #define OPAL_POLL_EVENTS 10
  53. #define OPAL_PCI_SET_HUB_TCE_MEMORY 11
  54. #define OPAL_PCI_SET_PHB_TCE_MEMORY 12
  55. #define OPAL_PCI_CONFIG_READ_BYTE 13
  56. #define OPAL_PCI_CONFIG_READ_HALF_WORD 14
  57. #define OPAL_PCI_CONFIG_READ_WORD 15
  58. #define OPAL_PCI_CONFIG_WRITE_BYTE 16
  59. #define OPAL_PCI_CONFIG_WRITE_HALF_WORD 17
  60. #define OPAL_PCI_CONFIG_WRITE_WORD 18
  61. #define OPAL_SET_XIVE 19
  62. #define OPAL_GET_XIVE 20
  63. #define OPAL_GET_COMPLETION_TOKEN_STATUS 21 /* obsolete */
  64. #define OPAL_REGISTER_OPAL_EXCEPTION_HANDLER 22
  65. #define OPAL_PCI_EEH_FREEZE_STATUS 23
  66. #define OPAL_PCI_SHPC 24
  67. #define OPAL_CONSOLE_WRITE_BUFFER_SPACE 25
  68. #define OPAL_PCI_EEH_FREEZE_CLEAR 26
  69. #define OPAL_PCI_PHB_MMIO_ENABLE 27
  70. #define OPAL_PCI_SET_PHB_MEM_WINDOW 28
  71. #define OPAL_PCI_MAP_PE_MMIO_WINDOW 29
  72. #define OPAL_PCI_SET_PHB_TABLE_MEMORY 30
  73. #define OPAL_PCI_SET_PE 31
  74. #define OPAL_PCI_SET_PELTV 32
  75. #define OPAL_PCI_SET_MVE 33
  76. #define OPAL_PCI_SET_MVE_ENABLE 34
  77. #define OPAL_PCI_GET_XIVE_REISSUE 35
  78. #define OPAL_PCI_SET_XIVE_REISSUE 36
  79. #define OPAL_PCI_SET_XIVE_PE 37
  80. #define OPAL_GET_XIVE_SOURCE 38
  81. #define OPAL_GET_MSI_32 39
  82. #define OPAL_GET_MSI_64 40
  83. #define OPAL_START_CPU 41
  84. #define OPAL_QUERY_CPU_STATUS 42
  85. #define OPAL_WRITE_OPPANEL 43 /* unimplemented */
  86. #define OPAL_PCI_MAP_PE_DMA_WINDOW 44
  87. #define OPAL_PCI_MAP_PE_DMA_WINDOW_REAL 45
  88. #define OPAL_PCI_RESET 49
  89. #define OPAL_PCI_GET_HUB_DIAG_DATA 50
  90. #define OPAL_PCI_GET_PHB_DIAG_DATA 51
  91. #define OPAL_PCI_FENCE_PHB 52
  92. #define OPAL_PCI_REINIT 53
  93. #define OPAL_PCI_MASK_PE_ERROR 54
  94. #define OPAL_SET_SLOT_LED_STATUS 55
  95. #define OPAL_GET_EPOW_STATUS 56
  96. #define OPAL_SET_SYSTEM_ATTENTION_LED 57
  97. #define OPAL_RESERVED1 58
  98. #define OPAL_RESERVED2 59
  99. #define OPAL_PCI_NEXT_ERROR 60
  100. #define OPAL_PCI_EEH_FREEZE_STATUS2 61
  101. #define OPAL_PCI_POLL 62
  102. #define OPAL_PCI_MSI_EOI 63
  103. #define OPAL_PCI_GET_PHB_DIAG_DATA2 64
  104. #define OPAL_XSCOM_READ 65
  105. #define OPAL_XSCOM_WRITE 66
  106. #define OPAL_LPC_READ 67
  107. #define OPAL_LPC_WRITE 68
  108. #define OPAL_RETURN_CPU 69
  109. #define OPAL_REINIT_CPUS 70
  110. #define OPAL_ELOG_READ 71
  111. #define OPAL_ELOG_WRITE 72
  112. #define OPAL_ELOG_ACK 73
  113. #define OPAL_ELOG_RESEND 74
  114. #define OPAL_ELOG_SIZE 75
  115. #define OPAL_FLASH_VALIDATE 76
  116. #define OPAL_FLASH_MANAGE 77
  117. #define OPAL_FLASH_UPDATE 78
  118. #define OPAL_RESYNC_TIMEBASE 79
  119. #define OPAL_CHECK_TOKEN 80
  120. #define OPAL_DUMP_INIT 81
  121. #define OPAL_DUMP_INFO 82
  122. #define OPAL_DUMP_READ 83
  123. #define OPAL_DUMP_ACK 84
  124. #define OPAL_GET_MSG 85
  125. #define OPAL_CHECK_ASYNC_COMPLETION 86
  126. #define OPAL_SYNC_HOST_REBOOT 87
  127. #define OPAL_SENSOR_READ 88
  128. #define OPAL_GET_PARAM 89
  129. #define OPAL_SET_PARAM 90
  130. #define OPAL_DUMP_RESEND 91
  131. #define OPAL_ELOG_SEND 92 /* Deprecated */
  132. #define OPAL_PCI_SET_PHB_CAPI_MODE 93
  133. #define OPAL_DUMP_INFO2 94
  134. #define OPAL_WRITE_OPPANEL_ASYNC 95
  135. #define OPAL_PCI_ERR_INJECT 96
  136. #define OPAL_PCI_EEH_FREEZE_SET 97
  137. #define OPAL_HANDLE_HMI 98
  138. #define OPAL_CONFIG_CPU_IDLE_STATE 99
  139. #define OPAL_SLW_SET_REG 100
  140. #define OPAL_REGISTER_DUMP_REGION 101
  141. #define OPAL_UNREGISTER_DUMP_REGION 102
  142. #define OPAL_WRITE_TPO 103
  143. #define OPAL_READ_TPO 104
  144. #define OPAL_GET_DPO_STATUS 105
  145. #define OPAL_OLD_I2C_REQUEST 106 /* Deprecated */
  146. #define OPAL_IPMI_SEND 107
  147. #define OPAL_IPMI_RECV 108
  148. #define OPAL_I2C_REQUEST 109
  149. #define OPAL_FLASH_READ 110
  150. #define OPAL_FLASH_WRITE 111
  151. #define OPAL_FLASH_ERASE 112
  152. #define OPAL_PRD_MSG 113
  153. #define OPAL_LAST 113
  154. /* Device tree flags */
  155. /* Flags set in power-mgmt nodes in device tree if
  156. * respective idle states are supported in the platform.
  157. */
  158. #define OPAL_PM_NAP_ENABLED 0x00010000
  159. #define OPAL_PM_SLEEP_ENABLED 0x00020000
  160. #define OPAL_PM_WINKLE_ENABLED 0x00040000
  161. #define OPAL_PM_SLEEP_ENABLED_ER1 0x00080000 /* with workaround */
  162. /*
  163. * OPAL_CONFIG_CPU_IDLE_STATE parameters
  164. */
  165. #define OPAL_CONFIG_IDLE_FASTSLEEP 1
  166. #define OPAL_CONFIG_IDLE_UNDO 0
  167. #define OPAL_CONFIG_IDLE_APPLY 1
  168. #ifndef __ASSEMBLY__
  169. /* Other enums */
  170. enum OpalFreezeState {
  171. OPAL_EEH_STOPPED_NOT_FROZEN = 0,
  172. OPAL_EEH_STOPPED_MMIO_FREEZE = 1,
  173. OPAL_EEH_STOPPED_DMA_FREEZE = 2,
  174. OPAL_EEH_STOPPED_MMIO_DMA_FREEZE = 3,
  175. OPAL_EEH_STOPPED_RESET = 4,
  176. OPAL_EEH_STOPPED_TEMP_UNAVAIL = 5,
  177. OPAL_EEH_STOPPED_PERM_UNAVAIL = 6
  178. };
  179. enum OpalEehFreezeActionToken {
  180. OPAL_EEH_ACTION_CLEAR_FREEZE_MMIO = 1,
  181. OPAL_EEH_ACTION_CLEAR_FREEZE_DMA = 2,
  182. OPAL_EEH_ACTION_CLEAR_FREEZE_ALL = 3,
  183. OPAL_EEH_ACTION_SET_FREEZE_MMIO = 1,
  184. OPAL_EEH_ACTION_SET_FREEZE_DMA = 2,
  185. OPAL_EEH_ACTION_SET_FREEZE_ALL = 3
  186. };
  187. enum OpalPciStatusToken {
  188. OPAL_EEH_NO_ERROR = 0,
  189. OPAL_EEH_IOC_ERROR = 1,
  190. OPAL_EEH_PHB_ERROR = 2,
  191. OPAL_EEH_PE_ERROR = 3,
  192. OPAL_EEH_PE_MMIO_ERROR = 4,
  193. OPAL_EEH_PE_DMA_ERROR = 5
  194. };
  195. enum OpalPciErrorSeverity {
  196. OPAL_EEH_SEV_NO_ERROR = 0,
  197. OPAL_EEH_SEV_IOC_DEAD = 1,
  198. OPAL_EEH_SEV_PHB_DEAD = 2,
  199. OPAL_EEH_SEV_PHB_FENCED = 3,
  200. OPAL_EEH_SEV_PE_ER = 4,
  201. OPAL_EEH_SEV_INF = 5
  202. };
  203. enum OpalErrinjectType {
  204. OPAL_ERR_INJECT_TYPE_IOA_BUS_ERR = 0,
  205. OPAL_ERR_INJECT_TYPE_IOA_BUS_ERR64 = 1,
  206. };
  207. enum OpalErrinjectFunc {
  208. /* IOA bus specific errors */
  209. OPAL_ERR_INJECT_FUNC_IOA_LD_MEM_ADDR = 0,
  210. OPAL_ERR_INJECT_FUNC_IOA_LD_MEM_DATA = 1,
  211. OPAL_ERR_INJECT_FUNC_IOA_LD_IO_ADDR = 2,
  212. OPAL_ERR_INJECT_FUNC_IOA_LD_IO_DATA = 3,
  213. OPAL_ERR_INJECT_FUNC_IOA_LD_CFG_ADDR = 4,
  214. OPAL_ERR_INJECT_FUNC_IOA_LD_CFG_DATA = 5,
  215. OPAL_ERR_INJECT_FUNC_IOA_ST_MEM_ADDR = 6,
  216. OPAL_ERR_INJECT_FUNC_IOA_ST_MEM_DATA = 7,
  217. OPAL_ERR_INJECT_FUNC_IOA_ST_IO_ADDR = 8,
  218. OPAL_ERR_INJECT_FUNC_IOA_ST_IO_DATA = 9,
  219. OPAL_ERR_INJECT_FUNC_IOA_ST_CFG_ADDR = 10,
  220. OPAL_ERR_INJECT_FUNC_IOA_ST_CFG_DATA = 11,
  221. OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_ADDR = 12,
  222. OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_DATA = 13,
  223. OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_MASTER = 14,
  224. OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_TARGET = 15,
  225. OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_ADDR = 16,
  226. OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_DATA = 17,
  227. OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_MASTER = 18,
  228. OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_TARGET = 19,
  229. };
  230. enum OpalMmioWindowType {
  231. OPAL_M32_WINDOW_TYPE = 1,
  232. OPAL_M64_WINDOW_TYPE = 2,
  233. OPAL_IO_WINDOW_TYPE = 3
  234. };
  235. enum OpalExceptionHandler {
  236. OPAL_MACHINE_CHECK_HANDLER = 1,
  237. OPAL_HYPERVISOR_MAINTENANCE_HANDLER = 2,
  238. OPAL_SOFTPATCH_HANDLER = 3
  239. };
  240. enum OpalPendingState {
  241. OPAL_EVENT_OPAL_INTERNAL = 0x1,
  242. OPAL_EVENT_NVRAM = 0x2,
  243. OPAL_EVENT_RTC = 0x4,
  244. OPAL_EVENT_CONSOLE_OUTPUT = 0x8,
  245. OPAL_EVENT_CONSOLE_INPUT = 0x10,
  246. OPAL_EVENT_ERROR_LOG_AVAIL = 0x20,
  247. OPAL_EVENT_ERROR_LOG = 0x40,
  248. OPAL_EVENT_EPOW = 0x80,
  249. OPAL_EVENT_LED_STATUS = 0x100,
  250. OPAL_EVENT_PCI_ERROR = 0x200,
  251. OPAL_EVENT_DUMP_AVAIL = 0x400,
  252. OPAL_EVENT_MSG_PENDING = 0x800,
  253. };
  254. enum OpalThreadStatus {
  255. OPAL_THREAD_INACTIVE = 0x0,
  256. OPAL_THREAD_STARTED = 0x1,
  257. OPAL_THREAD_UNAVAILABLE = 0x2 /* opal-v3 */
  258. };
  259. enum OpalPciBusCompare {
  260. OpalPciBusAny = 0, /* Any bus number match */
  261. OpalPciBus3Bits = 2, /* Match top 3 bits of bus number */
  262. OpalPciBus4Bits = 3, /* Match top 4 bits of bus number */
  263. OpalPciBus5Bits = 4, /* Match top 5 bits of bus number */
  264. OpalPciBus6Bits = 5, /* Match top 6 bits of bus number */
  265. OpalPciBus7Bits = 6, /* Match top 7 bits of bus number */
  266. OpalPciBusAll = 7, /* Match bus number exactly */
  267. };
  268. enum OpalDeviceCompare {
  269. OPAL_IGNORE_RID_DEVICE_NUMBER = 0,
  270. OPAL_COMPARE_RID_DEVICE_NUMBER = 1
  271. };
  272. enum OpalFuncCompare {
  273. OPAL_IGNORE_RID_FUNCTION_NUMBER = 0,
  274. OPAL_COMPARE_RID_FUNCTION_NUMBER = 1
  275. };
  276. enum OpalPeAction {
  277. OPAL_UNMAP_PE = 0,
  278. OPAL_MAP_PE = 1
  279. };
  280. enum OpalPeltvAction {
  281. OPAL_REMOVE_PE_FROM_DOMAIN = 0,
  282. OPAL_ADD_PE_TO_DOMAIN = 1
  283. };
  284. enum OpalMveEnableAction {
  285. OPAL_DISABLE_MVE = 0,
  286. OPAL_ENABLE_MVE = 1
  287. };
  288. enum OpalM64Action {
  289. OPAL_DISABLE_M64 = 0,
  290. OPAL_ENABLE_M64_SPLIT = 1,
  291. OPAL_ENABLE_M64_NON_SPLIT = 2
  292. };
  293. enum OpalPciResetScope {
  294. OPAL_RESET_PHB_COMPLETE = 1,
  295. OPAL_RESET_PCI_LINK = 2,
  296. OPAL_RESET_PHB_ERROR = 3,
  297. OPAL_RESET_PCI_HOT = 4,
  298. OPAL_RESET_PCI_FUNDAMENTAL = 5,
  299. OPAL_RESET_PCI_IODA_TABLE = 6
  300. };
  301. enum OpalPciReinitScope {
  302. /*
  303. * Note: we chose values that do not overlap
  304. * OpalPciResetScope as OPAL v2 used the same
  305. * enum for both
  306. */
  307. OPAL_REINIT_PCI_DEV = 1000
  308. };
  309. enum OpalPciResetState {
  310. OPAL_DEASSERT_RESET = 0,
  311. OPAL_ASSERT_RESET = 1
  312. };
  313. /*
  314. * Address cycle types for LPC accesses. These also correspond
  315. * to the content of the first cell of the "reg" property for
  316. * device nodes on the LPC bus
  317. */
  318. enum OpalLPCAddressType {
  319. OPAL_LPC_MEM = 0,
  320. OPAL_LPC_IO = 1,
  321. OPAL_LPC_FW = 2,
  322. };
  323. enum opal_msg_type {
  324. OPAL_MSG_ASYNC_COMP = 0, /* params[0] = token, params[1] = rc,
  325. * additional params function-specific
  326. */
  327. OPAL_MSG_MEM_ERR,
  328. OPAL_MSG_EPOW,
  329. OPAL_MSG_SHUTDOWN, /* params[0] = 1 reboot, 0 shutdown */
  330. OPAL_MSG_HMI_EVT,
  331. OPAL_MSG_DPO,
  332. OPAL_MSG_PRD,
  333. OPAL_MSG_TYPE_MAX,
  334. };
  335. struct opal_msg {
  336. __be32 msg_type;
  337. __be32 reserved;
  338. __be64 params[8];
  339. };
  340. /* System parameter permission */
  341. enum OpalSysparamPerm {
  342. OPAL_SYSPARAM_READ = 0x1,
  343. OPAL_SYSPARAM_WRITE = 0x2,
  344. OPAL_SYSPARAM_RW = (OPAL_SYSPARAM_READ | OPAL_SYSPARAM_WRITE),
  345. };
  346. enum {
  347. OPAL_IPMI_MSG_FORMAT_VERSION_1 = 1,
  348. };
  349. struct opal_ipmi_msg {
  350. uint8_t version;
  351. uint8_t netfn;
  352. uint8_t cmd;
  353. uint8_t data[];
  354. };
  355. /* FSP memory errors handling */
  356. enum OpalMemErr_Version {
  357. OpalMemErr_V1 = 1,
  358. };
  359. enum OpalMemErrType {
  360. OPAL_MEM_ERR_TYPE_RESILIENCE = 0,
  361. OPAL_MEM_ERR_TYPE_DYN_DALLOC,
  362. };
  363. /* Memory Reilience error type */
  364. enum OpalMemErr_ResilErrType {
  365. OPAL_MEM_RESILIENCE_CE = 0,
  366. OPAL_MEM_RESILIENCE_UE,
  367. OPAL_MEM_RESILIENCE_UE_SCRUB,
  368. };
  369. /* Dynamic Memory Deallocation type */
  370. enum OpalMemErr_DynErrType {
  371. OPAL_MEM_DYNAMIC_DEALLOC = 0,
  372. };
  373. struct OpalMemoryErrorData {
  374. enum OpalMemErr_Version version:8; /* 0x00 */
  375. enum OpalMemErrType type:8; /* 0x01 */
  376. __be16 flags; /* 0x02 */
  377. uint8_t reserved_1[4]; /* 0x04 */
  378. union {
  379. /* Memory Resilience corrected/uncorrected error info */
  380. struct {
  381. enum OpalMemErr_ResilErrType resil_err_type:8;
  382. uint8_t reserved_1[7];
  383. __be64 physical_address_start;
  384. __be64 physical_address_end;
  385. } resilience;
  386. /* Dynamic memory deallocation error info */
  387. struct {
  388. enum OpalMemErr_DynErrType dyn_err_type:8;
  389. uint8_t reserved_1[7];
  390. __be64 physical_address_start;
  391. __be64 physical_address_end;
  392. } dyn_dealloc;
  393. } u;
  394. };
  395. /* HMI interrupt event */
  396. enum OpalHMI_Version {
  397. OpalHMIEvt_V1 = 1,
  398. };
  399. enum OpalHMI_Severity {
  400. OpalHMI_SEV_NO_ERROR = 0,
  401. OpalHMI_SEV_WARNING = 1,
  402. OpalHMI_SEV_ERROR_SYNC = 2,
  403. OpalHMI_SEV_FATAL = 3,
  404. };
  405. enum OpalHMI_Disposition {
  406. OpalHMI_DISPOSITION_RECOVERED = 0,
  407. OpalHMI_DISPOSITION_NOT_RECOVERED = 1,
  408. };
  409. enum OpalHMI_ErrType {
  410. OpalHMI_ERROR_MALFUNC_ALERT = 0,
  411. OpalHMI_ERROR_PROC_RECOV_DONE,
  412. OpalHMI_ERROR_PROC_RECOV_DONE_AGAIN,
  413. OpalHMI_ERROR_PROC_RECOV_MASKED,
  414. OpalHMI_ERROR_TFAC,
  415. OpalHMI_ERROR_TFMR_PARITY,
  416. OpalHMI_ERROR_HA_OVERFLOW_WARN,
  417. OpalHMI_ERROR_XSCOM_FAIL,
  418. OpalHMI_ERROR_XSCOM_DONE,
  419. OpalHMI_ERROR_SCOM_FIR,
  420. OpalHMI_ERROR_DEBUG_TRIG_FIR,
  421. OpalHMI_ERROR_HYP_RESOURCE,
  422. OpalHMI_ERROR_CAPP_RECOVERY,
  423. };
  424. struct OpalHMIEvent {
  425. uint8_t version; /* 0x00 */
  426. uint8_t severity; /* 0x01 */
  427. uint8_t type; /* 0x02 */
  428. uint8_t disposition; /* 0x03 */
  429. uint8_t reserved_1[4]; /* 0x04 */
  430. __be64 hmer;
  431. /* TFMR register. Valid only for TFAC and TFMR_PARITY error type. */
  432. __be64 tfmr;
  433. };
  434. enum {
  435. OPAL_P7IOC_DIAG_TYPE_NONE = 0,
  436. OPAL_P7IOC_DIAG_TYPE_RGC = 1,
  437. OPAL_P7IOC_DIAG_TYPE_BI = 2,
  438. OPAL_P7IOC_DIAG_TYPE_CI = 3,
  439. OPAL_P7IOC_DIAG_TYPE_MISC = 4,
  440. OPAL_P7IOC_DIAG_TYPE_I2C = 5,
  441. OPAL_P7IOC_DIAG_TYPE_LAST = 6
  442. };
  443. struct OpalIoP7IOCErrorData {
  444. __be16 type;
  445. /* GEM */
  446. __be64 gemXfir;
  447. __be64 gemRfir;
  448. __be64 gemRirqfir;
  449. __be64 gemMask;
  450. __be64 gemRwof;
  451. /* LEM */
  452. __be64 lemFir;
  453. __be64 lemErrMask;
  454. __be64 lemAction0;
  455. __be64 lemAction1;
  456. __be64 lemWof;
  457. union {
  458. struct OpalIoP7IOCRgcErrorData {
  459. __be64 rgcStatus; /* 3E1C10 */
  460. __be64 rgcLdcp; /* 3E1C18 */
  461. }rgc;
  462. struct OpalIoP7IOCBiErrorData {
  463. __be64 biLdcp0; /* 3C0100, 3C0118 */
  464. __be64 biLdcp1; /* 3C0108, 3C0120 */
  465. __be64 biLdcp2; /* 3C0110, 3C0128 */
  466. __be64 biFenceStatus; /* 3C0130, 3C0130 */
  467. uint8_t biDownbound; /* BI Downbound or Upbound */
  468. }bi;
  469. struct OpalIoP7IOCCiErrorData {
  470. __be64 ciPortStatus; /* 3Dn008 */
  471. __be64 ciPortLdcp; /* 3Dn010 */
  472. uint8_t ciPort; /* Index of CI port: 0/1 */
  473. }ci;
  474. };
  475. };
  476. /**
  477. * This structure defines the overlay which will be used to store PHB error
  478. * data upon request.
  479. */
  480. enum {
  481. OPAL_PHB_ERROR_DATA_VERSION_1 = 1,
  482. };
  483. enum {
  484. OPAL_PHB_ERROR_DATA_TYPE_P7IOC = 1,
  485. OPAL_PHB_ERROR_DATA_TYPE_PHB3 = 2
  486. };
  487. enum {
  488. OPAL_P7IOC_NUM_PEST_REGS = 128,
  489. OPAL_PHB3_NUM_PEST_REGS = 256
  490. };
  491. struct OpalIoPhbErrorCommon {
  492. __be32 version;
  493. __be32 ioType;
  494. __be32 len;
  495. };
  496. struct OpalIoP7IOCPhbErrorData {
  497. struct OpalIoPhbErrorCommon common;
  498. __be32 brdgCtl;
  499. // P7IOC utl regs
  500. __be32 portStatusReg;
  501. __be32 rootCmplxStatus;
  502. __be32 busAgentStatus;
  503. // P7IOC cfg regs
  504. __be32 deviceStatus;
  505. __be32 slotStatus;
  506. __be32 linkStatus;
  507. __be32 devCmdStatus;
  508. __be32 devSecStatus;
  509. // cfg AER regs
  510. __be32 rootErrorStatus;
  511. __be32 uncorrErrorStatus;
  512. __be32 corrErrorStatus;
  513. __be32 tlpHdr1;
  514. __be32 tlpHdr2;
  515. __be32 tlpHdr3;
  516. __be32 tlpHdr4;
  517. __be32 sourceId;
  518. __be32 rsv3;
  519. // Record data about the call to allocate a buffer.
  520. __be64 errorClass;
  521. __be64 correlator;
  522. //P7IOC MMIO Error Regs
  523. __be64 p7iocPlssr; // n120
  524. __be64 p7iocCsr; // n110
  525. __be64 lemFir; // nC00
  526. __be64 lemErrorMask; // nC18
  527. __be64 lemWOF; // nC40
  528. __be64 phbErrorStatus; // nC80
  529. __be64 phbFirstErrorStatus; // nC88
  530. __be64 phbErrorLog0; // nCC0
  531. __be64 phbErrorLog1; // nCC8
  532. __be64 mmioErrorStatus; // nD00
  533. __be64 mmioFirstErrorStatus; // nD08
  534. __be64 mmioErrorLog0; // nD40
  535. __be64 mmioErrorLog1; // nD48
  536. __be64 dma0ErrorStatus; // nD80
  537. __be64 dma0FirstErrorStatus; // nD88
  538. __be64 dma0ErrorLog0; // nDC0
  539. __be64 dma0ErrorLog1; // nDC8
  540. __be64 dma1ErrorStatus; // nE00
  541. __be64 dma1FirstErrorStatus; // nE08
  542. __be64 dma1ErrorLog0; // nE40
  543. __be64 dma1ErrorLog1; // nE48
  544. __be64 pestA[OPAL_P7IOC_NUM_PEST_REGS];
  545. __be64 pestB[OPAL_P7IOC_NUM_PEST_REGS];
  546. };
  547. struct OpalIoPhb3ErrorData {
  548. struct OpalIoPhbErrorCommon common;
  549. __be32 brdgCtl;
  550. /* PHB3 UTL regs */
  551. __be32 portStatusReg;
  552. __be32 rootCmplxStatus;
  553. __be32 busAgentStatus;
  554. /* PHB3 cfg regs */
  555. __be32 deviceStatus;
  556. __be32 slotStatus;
  557. __be32 linkStatus;
  558. __be32 devCmdStatus;
  559. __be32 devSecStatus;
  560. /* cfg AER regs */
  561. __be32 rootErrorStatus;
  562. __be32 uncorrErrorStatus;
  563. __be32 corrErrorStatus;
  564. __be32 tlpHdr1;
  565. __be32 tlpHdr2;
  566. __be32 tlpHdr3;
  567. __be32 tlpHdr4;
  568. __be32 sourceId;
  569. __be32 rsv3;
  570. /* Record data about the call to allocate a buffer */
  571. __be64 errorClass;
  572. __be64 correlator;
  573. /* PHB3 MMIO Error Regs */
  574. __be64 nFir; /* 000 */
  575. __be64 nFirMask; /* 003 */
  576. __be64 nFirWOF; /* 008 */
  577. __be64 phbPlssr; /* 120 */
  578. __be64 phbCsr; /* 110 */
  579. __be64 lemFir; /* C00 */
  580. __be64 lemErrorMask; /* C18 */
  581. __be64 lemWOF; /* C40 */
  582. __be64 phbErrorStatus; /* C80 */
  583. __be64 phbFirstErrorStatus; /* C88 */
  584. __be64 phbErrorLog0; /* CC0 */
  585. __be64 phbErrorLog1; /* CC8 */
  586. __be64 mmioErrorStatus; /* D00 */
  587. __be64 mmioFirstErrorStatus; /* D08 */
  588. __be64 mmioErrorLog0; /* D40 */
  589. __be64 mmioErrorLog1; /* D48 */
  590. __be64 dma0ErrorStatus; /* D80 */
  591. __be64 dma0FirstErrorStatus; /* D88 */
  592. __be64 dma0ErrorLog0; /* DC0 */
  593. __be64 dma0ErrorLog1; /* DC8 */
  594. __be64 dma1ErrorStatus; /* E00 */
  595. __be64 dma1FirstErrorStatus; /* E08 */
  596. __be64 dma1ErrorLog0; /* E40 */
  597. __be64 dma1ErrorLog1; /* E48 */
  598. __be64 pestA[OPAL_PHB3_NUM_PEST_REGS];
  599. __be64 pestB[OPAL_PHB3_NUM_PEST_REGS];
  600. };
  601. enum {
  602. OPAL_REINIT_CPUS_HILE_BE = (1 << 0),
  603. OPAL_REINIT_CPUS_HILE_LE = (1 << 1),
  604. };
  605. typedef struct oppanel_line {
  606. __be64 line;
  607. __be64 line_len;
  608. } oppanel_line_t;
  609. enum opal_prd_msg_type {
  610. OPAL_PRD_MSG_TYPE_INIT = 0, /* HBRT --> OPAL */
  611. OPAL_PRD_MSG_TYPE_FINI, /* HBRT/kernel --> OPAL */
  612. OPAL_PRD_MSG_TYPE_ATTN, /* HBRT <-- OPAL */
  613. OPAL_PRD_MSG_TYPE_ATTN_ACK, /* HBRT --> OPAL */
  614. OPAL_PRD_MSG_TYPE_OCC_ERROR, /* HBRT <-- OPAL */
  615. OPAL_PRD_MSG_TYPE_OCC_RESET, /* HBRT <-- OPAL */
  616. };
  617. struct opal_prd_msg_header {
  618. uint8_t type;
  619. uint8_t pad[1];
  620. __be16 size;
  621. };
  622. struct opal_prd_msg;
  623. /*
  624. * SG entries
  625. *
  626. * WARNING: The current implementation requires each entry
  627. * to represent a block that is 4k aligned *and* each block
  628. * size except the last one in the list to be as well.
  629. */
  630. struct opal_sg_entry {
  631. __be64 data;
  632. __be64 length;
  633. };
  634. /*
  635. * Candiate image SG list.
  636. *
  637. * length = VER | length
  638. */
  639. struct opal_sg_list {
  640. __be64 length;
  641. __be64 next;
  642. struct opal_sg_entry entry[];
  643. };
  644. /*
  645. * Dump region ID range usable by the OS
  646. */
  647. #define OPAL_DUMP_REGION_HOST_START 0x80
  648. #define OPAL_DUMP_REGION_LOG_BUF 0x80
  649. #define OPAL_DUMP_REGION_HOST_END 0xFF
  650. /* CAPI modes for PHB */
  651. enum {
  652. OPAL_PHB_CAPI_MODE_PCIE = 0,
  653. OPAL_PHB_CAPI_MODE_CAPI = 1,
  654. OPAL_PHB_CAPI_MODE_SNOOP_OFF = 2,
  655. OPAL_PHB_CAPI_MODE_SNOOP_ON = 3,
  656. };
  657. /* OPAL I2C request */
  658. struct opal_i2c_request {
  659. uint8_t type;
  660. #define OPAL_I2C_RAW_READ 0
  661. #define OPAL_I2C_RAW_WRITE 1
  662. #define OPAL_I2C_SM_READ 2
  663. #define OPAL_I2C_SM_WRITE 3
  664. uint8_t flags;
  665. #define OPAL_I2C_ADDR_10 0x01 /* Not supported yet */
  666. uint8_t subaddr_sz; /* Max 4 */
  667. uint8_t reserved;
  668. __be16 addr; /* 7 or 10 bit address */
  669. __be16 reserved2;
  670. __be32 subaddr; /* Sub-address if any */
  671. __be32 size; /* Data size */
  672. __be64 buffer_ra; /* Buffer real address */
  673. };
  674. /*
  675. * EPOW status sharing (OPAL and the host)
  676. *
  677. * The host will pass on OPAL, a buffer of length OPAL_SYSEPOW_MAX
  678. * with individual elements being 16 bits wide to fetch the system
  679. * wide EPOW status. Each element in the buffer will contain the
  680. * EPOW status in it's bit representation for a particular EPOW sub
  681. * class as defiend here. So multiple detailed EPOW status bits
  682. * specific for any sub class can be represented in a single buffer
  683. * element as it's bit representation.
  684. */
  685. /* System EPOW type */
  686. enum OpalSysEpow {
  687. OPAL_SYSEPOW_POWER = 0, /* Power EPOW */
  688. OPAL_SYSEPOW_TEMP = 1, /* Temperature EPOW */
  689. OPAL_SYSEPOW_COOLING = 2, /* Cooling EPOW */
  690. OPAL_SYSEPOW_MAX = 3, /* Max EPOW categories */
  691. };
  692. /* Power EPOW */
  693. enum OpalSysPower {
  694. OPAL_SYSPOWER_UPS = 0x0001, /* System on UPS power */
  695. OPAL_SYSPOWER_CHNG = 0x0002, /* System power config change */
  696. OPAL_SYSPOWER_FAIL = 0x0004, /* System impending power failure */
  697. OPAL_SYSPOWER_INCL = 0x0008, /* System incomplete power */
  698. };
  699. /* Temperature EPOW */
  700. enum OpalSysTemp {
  701. OPAL_SYSTEMP_AMB = 0x0001, /* System over ambient temperature */
  702. OPAL_SYSTEMP_INT = 0x0002, /* System over internal temperature */
  703. OPAL_SYSTEMP_HMD = 0x0004, /* System over ambient humidity */
  704. };
  705. /* Cooling EPOW */
  706. enum OpalSysCooling {
  707. OPAL_SYSCOOL_INSF = 0x0001, /* System insufficient cooling */
  708. };
  709. #endif /* __ASSEMBLY__ */
  710. #endif /* __OPAL_API_H */