FILE
guc_actions_abi.h
File preview with syntax highlighting.
linux-6.19.14/drivers/gpu/drm/xe/abi/guc_actions_abi.h
1/* SPDX-License-Identifier: MIT */ 2/* 3 * Copyright © 2014-2021 Intel Corporation 4 */ 5 6#ifndef _ABI_GUC_ACTIONS_ABI_H 7#define _ABI_GUC_ACTIONS_ABI_H 8 9/** 10 * DOC: HOST2GUC_SELF_CFG 11 * 12 * This message is used by Host KMD to setup of the `GuC Self Config KLVs`_. 13 * 14 * This message must be sent as `MMIO HXG Message`_. 15 * 16 * +---+-------+--------------------------------------------------------------+ 17 * | | Bits | Description | 18 * +===+=======+==============================================================+ 19 * | 0 | 31 | ORIGIN = GUC_HXG_ORIGIN_HOST_ | 20 * | +-------+--------------------------------------------------------------+ 21 * | | 30:28 | TYPE = GUC_HXG_TYPE_REQUEST_ | 22 * | +-------+--------------------------------------------------------------+ 23 * | | 27:16 | DATA0 = MBZ | 24 * | +-------+--------------------------------------------------------------+ 25 * | | 15:0 | ACTION = _`GUC_ACTION_HOST2GUC_SELF_CFG` = 0x0508 | 26 * +---+-------+--------------------------------------------------------------+ 27 * | 1 | 31:16 | **KLV_KEY** - KLV key, see `GuC Self Config KLVs`_ | 28 * | +-------+--------------------------------------------------------------+ 29 * | | 15:0 | **KLV_LEN** - KLV length | 30 * | | | | 31 * | | | - 32 bit KLV = 1 | 32 * | | | - 64 bit KLV = 2 | 33 * +---+-------+--------------------------------------------------------------+ 34 * | 2 | 31:0 | **VALUE32** - Bits 31-0 of the KLV value | 35 * +---+-------+--------------------------------------------------------------+ 36 * | 3 | 31:0 | **VALUE64** - Bits 63-32 of the KLV value (**KLV_LEN** = 2) | 37 * +---+-------+--------------------------------------------------------------+ 38 * 39 * +---+-------+--------------------------------------------------------------+ 40 * | | Bits | Description | 41 * +===+=======+==============================================================+ 42 * | 0 | 31 | ORIGIN = GUC_HXG_ORIGIN_GUC_ | 43 * | +-------+--------------------------------------------------------------+ 44 * | | 30:28 | TYPE = GUC_HXG_TYPE_RESPONSE_SUCCESS_ | 45 * | +-------+--------------------------------------------------------------+ 46 * | | 27:0 | DATA0 = **NUM** - 1 if KLV was parsed, 0 if not recognized | 47 * +---+-------+--------------------------------------------------------------+ 48 */ 49#define GUC_ACTION_HOST2GUC_SELF_CFG 0x0508 50 51#define HOST2GUC_SELF_CFG_REQUEST_MSG_LEN (GUC_HXG_REQUEST_MSG_MIN_LEN + 3u) 52#define HOST2GUC_SELF_CFG_REQUEST_MSG_0_MBZ GUC_HXG_REQUEST_MSG_0_DATA0 53#define HOST2GUC_SELF_CFG_REQUEST_MSG_1_KLV_KEY (0xffffu << 16) 54#define HOST2GUC_SELF_CFG_REQUEST_MSG_1_KLV_LEN (0xffffu << 0) 55#define HOST2GUC_SELF_CFG_REQUEST_MSG_2_VALUE32 GUC_HXG_REQUEST_MSG_n_DATAn 56#define HOST2GUC_SELF_CFG_REQUEST_MSG_3_VALUE64 GUC_HXG_REQUEST_MSG_n_DATAn 57 58#define HOST2GUC_SELF_CFG_RESPONSE_MSG_LEN GUC_HXG_RESPONSE_MSG_MIN_LEN 59#define HOST2GUC_SELF_CFG_RESPONSE_MSG_0_NUM GUC_HXG_RESPONSE_MSG_0_DATA0 60 61/** 62 * DOC: HOST2GUC_CONTROL_CTB 63 * 64 * This H2G action allows Vf Host to enable or disable H2G and G2H `CT Buffer`_. 65 * 66 * This message must be sent as `MMIO HXG Message`_. 67 * 68 * +---+-------+--------------------------------------------------------------+ 69 * | | Bits | Description | 70 * +===+=======+==============================================================+ 71 * | 0 | 31 | ORIGIN = GUC_HXG_ORIGIN_HOST_ | 72 * | +-------+--------------------------------------------------------------+ 73 * | | 30:28 | TYPE = GUC_HXG_TYPE_REQUEST_ | 74 * | +-------+--------------------------------------------------------------+ 75 * | | 27:16 | DATA0 = MBZ | 76 * | +-------+--------------------------------------------------------------+ 77 * | | 15:0 | ACTION = _`GUC_ACTION_HOST2GUC_CONTROL_CTB` = 0x4509 | 78 * +---+-------+--------------------------------------------------------------+ 79 * | 1 | 31:0 | **CONTROL** - control `CTB based communication`_ | 80 * | | | | 81 * | | | - _`GUC_CTB_CONTROL_DISABLE` = 0 | 82 * | | | - _`GUC_CTB_CONTROL_ENABLE` = 1 | 83 * +---+-------+--------------------------------------------------------------+ 84 * 85 * +---+-------+--------------------------------------------------------------+ 86 * | | Bits | Description | 87 * +===+=======+==============================================================+ 88 * | 0 | 31 | ORIGIN = GUC_HXG_ORIGIN_GUC_ | 89 * | +-------+--------------------------------------------------------------+ 90 * | | 30:28 | TYPE = GUC_HXG_TYPE_RESPONSE_SUCCESS_ | 91 * | +-------+--------------------------------------------------------------+ 92 * | | 27:0 | DATA0 = MBZ | 93 * +---+-------+--------------------------------------------------------------+ 94 */ 95#define GUC_ACTION_HOST2GUC_CONTROL_CTB 0x4509 96 97#define HOST2GUC_CONTROL_CTB_REQUEST_MSG_LEN (GUC_HXG_REQUEST_MSG_MIN_LEN + 1u) 98#define HOST2GUC_CONTROL_CTB_REQUEST_MSG_0_MBZ GUC_HXG_REQUEST_MSG_0_DATA0 99#define HOST2GUC_CONTROL_CTB_REQUEST_MSG_1_CONTROL GUC_HXG_REQUEST_MSG_n_DATAn 100#define GUC_CTB_CONTROL_DISABLE 0u 101#define GUC_CTB_CONTROL_ENABLE 1u 102 103#define HOST2GUC_CONTROL_CTB_RESPONSE_MSG_LEN GUC_HXG_RESPONSE_MSG_MIN_LEN 104#define HOST2GUC_CONTROL_CTB_RESPONSE_MSG_0_MBZ GUC_HXG_RESPONSE_MSG_0_DATA0 105 106/* legacy definitions */ 107 108enum xe_guc_action { 109 XE_GUC_ACTION_DEFAULT = 0x0, 110 XE_GUC_ACTION_REQUEST_PREEMPTION = 0x2, 111 XE_GUC_ACTION_REQUEST_ENGINE_RESET = 0x3, 112 XE_GUC_ACTION_ALLOCATE_DOORBELL = 0x10, 113 XE_GUC_ACTION_DEALLOCATE_DOORBELL = 0x20, 114 XE_GUC_ACTION_LOG_BUFFER_FILE_FLUSH_COMPLETE = 0x30, 115 XE_GUC_ACTION_UK_LOG_ENABLE_LOGGING = 0x40, 116 XE_GUC_ACTION_FORCE_LOG_BUFFER_FLUSH = 0x302, 117 XE_GUC_ACTION_ENTER_S_STATE = 0x501, 118 XE_GUC_ACTION_EXIT_S_STATE = 0x502, 119 XE_GUC_ACTION_GLOBAL_SCHED_POLICY_CHANGE = 0x506, 120 XE_GUC_ACTION_UPDATE_SCHEDULING_POLICIES_KLV = 0x509, 121 XE_GUC_ACTION_SCHED_CONTEXT = 0x1000, 122 XE_GUC_ACTION_SCHED_CONTEXT_MODE_SET = 0x1001, 123 XE_GUC_ACTION_SCHED_CONTEXT_MODE_DONE = 0x1002, 124 XE_GUC_ACTION_SCHED_ENGINE_MODE_SET = 0x1003, 125 XE_GUC_ACTION_SCHED_ENGINE_MODE_DONE = 0x1004, 126 XE_GUC_ACTION_SET_CONTEXT_PRIORITY = 0x1005, 127 XE_GUC_ACTION_SET_CONTEXT_EXECUTION_QUANTUM = 0x1006, 128 XE_GUC_ACTION_SET_CONTEXT_PREEMPTION_TIMEOUT = 0x1007, 129 XE_GUC_ACTION_CONTEXT_RESET_NOTIFICATION = 0x1008, 130 XE_GUC_ACTION_ENGINE_FAILURE_NOTIFICATION = 0x1009, 131 XE_GUC_ACTION_HOST2GUC_UPDATE_CONTEXT_POLICIES = 0x100B, 132 XE_GUC_ACTION_AUTHENTICATE_HUC = 0x4000, 133 XE_GUC_ACTION_GET_HWCONFIG = 0x4100, 134 XE_GUC_ACTION_REGISTER_CONTEXT = 0x4502, 135 XE_GUC_ACTION_DEREGISTER_CONTEXT = 0x4503, 136 XE_GUC_ACTION_REGISTER_COMMAND_TRANSPORT_BUFFER = 0x4505, 137 XE_GUC_ACTION_DEREGISTER_COMMAND_TRANSPORT_BUFFER = 0x4506, 138 XE_GUC_ACTION_REGISTER_G2G = 0x4507, 139 XE_GUC_ACTION_DEREGISTER_G2G = 0x4508, 140 XE_GUC_ACTION_DEREGISTER_CONTEXT_DONE = 0x4600, 141 XE_GUC_ACTION_REGISTER_CONTEXT_MULTI_LRC = 0x4601, 142 XE_GUC_ACTION_CLIENT_SOFT_RESET = 0x5507, 143 XE_GUC_ACTION_SET_ENG_UTIL_BUFF = 0x550A, 144 XE_GUC_ACTION_SET_DEVICE_ENGINE_ACTIVITY_BUFFER = 0x550C, 145 XE_GUC_ACTION_SET_FUNCTION_ENGINE_ACTIVITY_BUFFER = 0x550D, 146 XE_GUC_ACTION_OPT_IN_FEATURE_KLV = 0x550E, 147 XE_GUC_ACTION_NOTIFY_MEMORY_CAT_ERROR = 0x6000, 148 XE_GUC_ACTION_REPORT_PAGE_FAULT_REQ_DESC = 0x6002, 149 XE_GUC_ACTION_PAGE_FAULT_RES_DESC = 0x6003, 150 XE_GUC_ACTION_ACCESS_COUNTER_NOTIFY = 0x6004, 151 XE_GUC_ACTION_TLB_INVALIDATION = 0x7000, 152 XE_GUC_ACTION_TLB_INVALIDATION_DONE = 0x7001, 153 XE_GUC_ACTION_TLB_INVALIDATION_ALL = 0x7002, 154 XE_GUC_ACTION_STATE_CAPTURE_NOTIFICATION = 0x8002, 155 XE_GUC_ACTION_NOTIFY_FLUSH_LOG_BUFFER_TO_FILE = 0x8003, 156 XE_GUC_ACTION_NOTIFY_CRASH_DUMP_POSTED = 0x8004, 157 XE_GUC_ACTION_NOTIFY_EXCEPTION = 0x8005, 158 XE_GUC_ACTION_TEST_G2G_SEND = 0xF001, 159 XE_GUC_ACTION_TEST_G2G_RECV = 0xF002, 160 XE_GUC_ACTION_LIMIT 161}; 162 163enum xe_guc_preempt_options { 164 XE_GUC_PREEMPT_OPTION_DROP_WORK_Q = 0x4, 165 XE_GUC_PREEMPT_OPTION_DROP_SUBMIT_Q = 0x8, 166}; 167 168enum xe_guc_register_context_param_offsets { 169 XE_GUC_REGISTER_CONTEXT_DATA_0_MBZ = 0, 170 XE_GUC_REGISTER_CONTEXT_DATA_1_FLAGS, 171 XE_GUC_REGISTER_CONTEXT_DATA_2_CONTEXT_INDEX, 172 XE_GUC_REGISTER_CONTEXT_DATA_3_ENGINE_CLASS, 173 XE_GUC_REGISTER_CONTEXT_DATA_4_ENGINE_SUBMIT_MASK, 174 XE_GUC_REGISTER_CONTEXT_DATA_5_WQ_DESC_ADDR_LOWER, 175 XE_GUC_REGISTER_CONTEXT_DATA_6_WQ_DESC_ADDR_UPPER, 176 XE_GUC_REGISTER_CONTEXT_DATA_7_WQ_BUF_BASE_LOWER, 177 XE_GUC_REGISTER_CONTEXT_DATA_8_WQ_BUF_BASE_UPPER, 178 XE_GUC_REGISTER_CONTEXT_DATA_9_WQ_BUF_SIZE, 179 XE_GUC_REGISTER_CONTEXT_DATA_10_HW_LRC_ADDR, 180 XE_GUC_REGISTER_CONTEXT_MSG_LEN, 181}; 182 183enum xe_guc_register_context_multi_lrc_param_offsets { 184 XE_GUC_REGISTER_CONTEXT_MULTI_LRC_DATA_0_MBZ = 0, 185 XE_GUC_REGISTER_CONTEXT_MULTI_LRC_DATA_1_FLAGS, 186 XE_GUC_REGISTER_CONTEXT_MULTI_LRC_DATA_2_PARENT_CONTEXT, 187 XE_GUC_REGISTER_CONTEXT_MULTI_LRC_DATA_3_ENGINE_CLASS, 188 XE_GUC_REGISTER_CONTEXT_MULTI_LRC_DATA_4_ENGINE_SUBMIT_MASK, 189 XE_GUC_REGISTER_CONTEXT_MULTI_LRC_DATA_5_WQ_DESC_ADDR_LOWER, 190 XE_GUC_REGISTER_CONTEXT_MULTI_LRC_DATA_6_WQ_DESC_ADDR_UPPER, 191 XE_GUC_REGISTER_CONTEXT_MULTI_LRC_DATA_7_WQ_BUF_BASE_LOWER, 192 XE_GUC_REGISTER_CONTEXT_MULTI_LRC_DATA_8_WQ_BUF_BASE_UPPER, 193 XE_GUC_REGISTER_CONTEXT_MULTI_LRC_DATA_9_WQ_BUF_SIZE, 194 XE_GUC_REGISTER_CONTEXT_MULTI_LRC_DATA_10_NUM_CTXS, 195 XE_GUC_REGISTER_CONTEXT_MULTI_LRC_DATA_11_HW_LRC_ADDR, 196 XE_GUC_REGISTER_CONTEXT_MULTI_LRC_MSG_MIN_LEN = 11, 197}; 198 199enum xe_guc_report_status { 200 XE_GUC_REPORT_STATUS_UNKNOWN = 0x0, 201 XE_GUC_REPORT_STATUS_ACKED = 0x1, 202 XE_GUC_REPORT_STATUS_ERROR = 0x2, 203 XE_GUC_REPORT_STATUS_COMPLETE = 0x4, 204}; 205 206enum xe_guc_sleep_state_status { 207 XE_GUC_SLEEP_STATE_SUCCESS = 0x1, 208 XE_GUC_SLEEP_STATE_PREEMPT_TO_IDLE_FAILED = 0x2, 209 XE_GUC_SLEEP_STATE_ENGINE_RESET_FAILED = 0x3 210#define XE_GUC_SLEEP_STATE_INVALID_MASK 0x80000000 211}; 212 213#define GUC_LOG_CONTROL_LOGGING_ENABLED (1 << 0) 214#define GUC_LOG_CONTROL_VERBOSITY_SHIFT 4 215#define GUC_LOG_CONTROL_VERBOSITY_MASK (0xF << GUC_LOG_CONTROL_VERBOSITY_SHIFT) 216#define GUC_LOG_CONTROL_DEFAULT_LOGGING (1 << 8) 217 218enum xe_guc_state_capture_event_status { 219 XE_GUC_STATE_CAPTURE_EVENT_STATUS_SUCCESS = 0x0, 220 XE_GUC_STATE_CAPTURE_EVENT_STATUS_NOSPACE = 0x1, 221}; 222 223#define XE_GUC_STATE_CAPTURE_EVENT_STATUS_MASK 0x000000FF 224#define XE_GUC_ACTION_STATE_CAPTURE_NOTIFICATION_DATA_LEN 1 225 226#define XE_GUC_TLB_INVAL_TYPE_SHIFT 0 227#define XE_GUC_TLB_INVAL_MODE_SHIFT 8 228/* Flush PPC or SMRO caches along with TLB invalidation request */ 229#define XE_GUC_TLB_INVAL_FLUSH_CACHE (1 << 31) 230 231enum xe_guc_tlb_invalidation_type { 232 XE_GUC_TLB_INVAL_FULL = 0x0, 233 XE_GUC_TLB_INVAL_PAGE_SELECTIVE = 0x1, 234 XE_GUC_TLB_INVAL_PAGE_SELECTIVE_CTX = 0x2, 235 XE_GUC_TLB_INVAL_GUC = 0x3, 236}; 237 238/* 239 * 0: Heavy mode of Invalidation: 240 * The pipeline of the engine(s) for which the invalidation is targeted to is 241 * blocked, and all the in-flight transactions are guaranteed to be Globally 242 * Observed before completing the TLB invalidation 243 * 1: Lite mode of Invalidation: 244 * TLBs of the targeted engine(s) are immediately invalidated. 245 * In-flight transactions are NOT guaranteed to be Globally Observed before 246 * completing TLB invalidation. 247 * Light Invalidation Mode is to be used only when 248 * it can be guaranteed (by SW) that the address translations remain invariant 249 * for the in-flight transactions across the TLB invalidation. In other words, 250 * this mode can be used when the TLB invalidation is intended to clear out the 251 * stale cached translations that are no longer in use. Light Invalidation Mode 252 * is much faster than the Heavy Invalidation Mode, as it does not wait for the 253 * in-flight transactions to be GOd. 254 */ 255enum xe_guc_tlb_inval_mode { 256 XE_GUC_TLB_INVAL_MODE_HEAVY = 0x0, 257 XE_GUC_TLB_INVAL_MODE_LITE = 0x1, 258}; 259 260/* 261 * GuC to GuC communication (de-)registration fields: 262 */ 263enum xe_guc_g2g_type { 264 XE_G2G_TYPE_IN = 0x0, 265 XE_G2G_TYPE_OUT, 266 XE_G2G_TYPE_LIMIT, 267}; 268 269#define XE_G2G_REGISTER_DEVICE REG_GENMASK(16, 16) 270#define XE_G2G_REGISTER_TILE REG_GENMASK(15, 12) 271#define XE_G2G_REGISTER_TYPE REG_GENMASK(11, 8) 272#define XE_G2G_REGISTER_SIZE REG_GENMASK(7, 0) 273 274#define XE_G2G_DEREGISTER_DEVICE REG_GENMASK(16, 16) 275#define XE_G2G_DEREGISTER_TILE REG_GENMASK(15, 12) 276#define XE_G2G_DEREGISTER_TYPE REG_GENMASK(11, 8) 277 278/* invalid type for XE_GUC_ACTION_NOTIFY_MEMORY_CAT_ERROR */ 279#define XE_GUC_CAT_ERR_TYPE_INVALID 0xdeadbeef 280 281#endif
~/
Read-only file preview.