1 /*- 2 * Copyright (c) 2015 Nathan Whitehorn 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in the 12 * documentation and/or other materials provided with the distribution. 13 * 14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24 * SUCH DAMAGE. 25 * 26 * $FreeBSD$ 27 */ 28 29 #ifndef _POWERNV_OPAL_H 30 #define _POWERNV_OPAL_H 31 32 #include <sys/cdefs.h> 33 #include <sys/types.h> 34 #include <sys/_eventhandler.h> 35 36 /* Check if OPAL is correctly instantiated. Will try to instantiate it. */ 37 int opal_check(void); 38 39 /* Call an OPAL method. Any pointers passed must be real-mode accessible! */ 40 int opal_call(uint64_t token, ...); 41 42 #define OPAL_CONSOLE_WRITE 1 43 #define OPAL_CONSOLE_READ 2 44 #define OPAL_RTC_READ 3 45 #define OPAL_RTC_WRITE 4 46 #define OPAL_CEC_POWER_DOWN 5 47 #define OPAL_CEC_REBOOT 6 48 #define OPAL_READ_NVRAM 7 49 #define OPAL_WRITE_NVRAM 8 50 #define OPAL_HANDLE_INTERRUPT 9 51 #define OPAL_POLL_EVENTS 10 52 #define OPAL_PCI_CONFIG_READ_BYTE 13 53 #define OPAL_PCI_CONFIG_READ_HALF_WORD 14 54 #define OPAL_PCI_CONFIG_READ_WORD 15 55 #define OPAL_PCI_CONFIG_WRITE_BYTE 16 56 #define OPAL_PCI_CONFIG_WRITE_HALF_WORD 17 57 #define OPAL_PCI_CONFIG_WRITE_WORD 18 58 #define OPAL_PCI_EEH_FREEZE_STATUS 23 59 #define OPAL_PCI_EEH_FREEZE_CLEAR 26 60 #define OPAL_PCI_PHB_MMIO_ENABLE 27 61 #define OPAL_PCI_SET_PHB_MEM_WINDOW 28 62 #define OPAL_PCI_MAP_PE_MMIO_WINDOW 29 63 #define OPAL_PCI_SET_XIVE_PE 37 64 #define OPAL_PCI_RESET 49 65 #define OPAL_PCI_POLL 62 66 #define OPAL_SET_XIVE 19 67 #define OPAL_GET_XIVE 20 68 #define OPAL_PCI_SET_PE 31 69 #define OPAL_GET_MSI_32 39 70 #define OPAL_GET_MSI_64 40 71 #define OPAL_PCI_MSI_EOI 63 72 #define OPAL_PCI_GET_PHB_DIAG_DATA2 64 73 #define OPAL_START_CPU 41 74 #define OPAL_PCI_MAP_PE_DMA_WINDOW 44 75 #define OPAL_PCI_MAP_PE_DMA_WINDOW_REAL 45 76 #define OPAL_RETURN_CPU 69 77 #define OPAL_REINIT_CPUS 70 78 #define OPAL_CHECK_TOKEN 80 79 #define OPAL_GET_MSG 85 80 #define OPAL_CHECK_ASYNC_COMPLETION 86 81 #define OPAL_SENSOR_READ 88 82 #define OPAL_HANDLE_HMI 98 83 #define OPAL_IPMI_SEND 107 84 #define OPAL_IPMI_RECV 108 85 #define OPAL_I2C_REQUEST 109 86 #define OPAL_FLASH_READ 110 87 #define OPAL_FLASH_WRITE 111 88 #define OPAL_FLASH_ERASE 112 89 #define OPAL_INT_GET_XIRR 122 90 #define OPAL_INT_SET_CPPR 123 91 #define OPAL_INT_EOI 124 92 #define OPAL_INT_SET_MFRR 125 93 #define OPAL_PCI_TCE_KILL 126 94 #define OPAL_XIVE_RESET 128 95 #define OPAL_XIVE_GET_IRQ_INFO 129 96 #define OPAL_XIVE_GET_IRQ_CONFIG 130 97 #define OPAL_XIVE_SET_IRQ_CONFIG 131 98 #define OPAL_XIVE_GET_QUEUE_INFO 132 99 #define OPAL_XIVE_SET_QUEUE_INFO 133 100 #define OPAL_XIVE_DONATE_PAGE 134 101 #define OPAL_XIVE_ALLOCATE_VP_BLOCK 135 102 #define OPAL_XIVE_FREE_VP_BLOCK 136 103 #define OPAL_XIVE_GET_VP_INFO 137 104 #define OPAL_XIVE_SET_VP_INFO 138 105 #define OPAL_XIVE_ALLOCATE_IRQ 139 106 #define OPAL_XIVE_FREE_IRQ 140 107 #define OPAL_XIVE_SYNC 141 108 #define OPAL_XIVE_DUMP 142 109 #define OPAL_SENSOR_GROUP_CLEAR 156 110 #define OPAL_SENSOR_READ_U64 162 111 #define OPAL_SENSOR_GROUP_ENABLE 163 112 #define OPAL_HANDLE_HMI2 166 113 114 /* For OPAL_PCI_SET_PE */ 115 #define OPAL_UNMAP_PE 0 116 #define OPAL_MAP_PE 1 117 118 #define OPAL_PCI_BUS_ANY 0 119 #define OPAL_PCI_BUS_3BITS 2 120 #define OPAL_PCI_BUS_4BITS 3 121 #define OPAL_PCI_BUS_5BITS 4 122 #define OPAL_PCI_BUS_6BITS 5 123 #define OPAL_PCI_BUS_7BITS 6 124 #define OPAL_PCI_BUS_ALL 7 /* Match bus number exactly */ 125 126 #define OPAL_IGNORE_RID_DEVICE_NUMBER 0 127 #define OPAL_COMPARE_RID_DEVICE_NUMBER 1 128 129 #define OPAL_IGNORE_RID_FUNC_NUMBER 0 130 #define OPAL_COMPARE_RID_FUNC_NUMBER 1 131 132 /* For OPAL_PCI_TCE_KILL */ 133 #define OPAL_PCI_TCE_KILL_PAGE 0 134 #define OPAL_PCI_TCE_KILL_PE 1 135 #define OPAL_PCI_TCE_KILL_ALL 2 136 137 #define OPAL_SUCCESS 0 138 #define OPAL_PARAMETER -1 139 #define OPAL_BUSY -2 140 #define OPAL_CLOSED -5 141 #define OPAL_HARDWARE -6 142 #define OPAL_UNSUPPORTED -7 143 #define OPAL_RESOURCE -10 144 #define OPAL_BUSY_EVENT -12 145 #define OPAL_ASYNC_COMPLETION -15 146 #define OPAL_EMPTY -16 147 #define OPAL_XIVE_PROVISIONING -31 148 #define OPAL_XIVE_FREE_ACTIVE -32 149 150 #define OPAL_TOKEN_ABSENT 0 151 #define OPAL_TOKEN_PRESENT 1 152 153 #define OPAL_EVENT_OPAL_INTERNAL 0x1 154 #define OPAL_EVENT_NVRAM 0x2 155 #define OPAL_EVENT_RTC 0x4 156 #define OPAL_EVENT_CONSOLE_INPUT 0x8 157 #define OPAL_EVENT_CONSOLE_OUTPUT 0x10 158 #define OPAL_EVENT_ERROR_LOG_AVAIL 0x20 159 #define OPAL_EVENT_ERROR_LOG 0x40 160 #define OPAL_EVENT_EPOW 0x80 161 #define OPAL_EVENT_LED_STATUS 0x100 162 #define OPAL_EVENT_PCI_ERROR 0x200 163 #define OPAL_EVENT_DUMP_AVAIL 0x400 164 #define OPAL_EVENT_MSG_PENDING 0x800 165 166 #define OPAL_HMI_FLAGS_TB_RESYNC (1ull << 0) 167 #define OPAL_HMI_FLAGS_DEC_LOST (1ull << 1) 168 #define OPAL_HMI_FLAGS_HDEC_LOST (1ull << 2) 169 #define OPAL_HMI_FLAGS_TOD_TB_FAIL (1ull << 3) 170 #define OPAL_HMI_FLAGS_NEW_EVENT (1ull << 63) 171 172 #define OPAL_XIVE_XICS_MODE_EMU 0 173 #define OPAL_XIVE_XICS_MODE_EXP 1 174 175 #define OPAL_XIVE_VP_ENABLED 0x00000001 176 #define OPAL_XIVE_VP_SINGLE_ESCALATION 0x00000002 177 178 #define OPAL_XIVE_EQ_ENABLED 0x00000001 179 #define OPAL_XIVE_EQ_ALWAYS_NOTIFY 0x00000002 180 #define OPAL_XIVE_EQ_ESCALATE 0x00000004 181 182 struct opal_msg { 183 uint32_t msg_type; 184 uint32_t reserved; 185 uint64_t params[8]; 186 }; 187 188 enum opal_msg_type { 189 OPAL_MSG_ASYNC_COMP = 0, 190 OPAL_MSG_MEM_ERR = 1, 191 OPAL_MSG_EPOW = 2, 192 OPAL_MSG_SHUTDOWN = 3, 193 OPAL_MSG_HMI_EVT = 4, 194 OPAL_MSG_DPO = 5, 195 OPAL_MSG_PRD = 6, 196 OPAL_MSG_OCC = 7, 197 OPAL_MSG_TYPE_MAX, 198 }; 199 200 #define OPAL_IPMI_MSG_FORMAT_VERSION_1 1 201 202 struct opal_ipmi_msg { 203 uint8_t version; 204 uint8_t netfn; 205 uint8_t cmd; 206 uint8_t data[]; 207 }; 208 209 int opal_init_async_tokens(int); 210 int opal_alloc_async_token(void); 211 void opal_free_async_token(int); 212 int opal_wait_completion(void *, uint64_t, int); 213 214 typedef void (*opal_msg_handler_fn)(void *, struct opal_msg *); 215 EVENTHANDLER_DECLARE(OPAL_ASYNC_COMP, opal_msg_handler_fn); 216 EVENTHANDLER_DECLARE(OPAL_EPOW, opal_msg_handler_fn); 217 EVENTHANDLER_DECLARE(OPAL_SHUTDOWN, opal_msg_handler_fn); 218 EVENTHANDLER_DECLARE(OPAL_HMI_EVT, opal_msg_handler_fn); 219 EVENTHANDLER_DECLARE(OPAL_DPO, opal_msg_handler_fn); 220 EVENTHANDLER_DECLARE(OPAL_OCC, opal_msg_handler_fn); 221 EVENTHANDLER_LIST_DECLARE(OPAL_ASYNC_COMP); 222 EVENTHANDLER_LIST_DECLARE(OPAL_EPOW); 223 EVENTHANDLER_LIST_DECLARE(OPAL_SHUTDOWN); 224 EVENTHANDLER_LIST_DECLARE(OPAL_HMI_EVT); 225 EVENTHANDLER_LIST_DECLARE(OPAL_DPO); 226 EVENTHANDLER_LIST_DECLARE(OPAL_OCC); 227 #endif 228