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
282

source code of linux/drivers/gpu/drm/xe/abi/guc_actions_abi.h